OpenXMLDocuments.MergeDocuments2, méthode

Windows SharePoint Services 3

Ouvre le formulaire ou document XML pour une fusion, ou pour gérer plusieurs formulaires ou documents XML, dans son application associée, en fonction de l'instance spécifiée d'Internet Explorer.


expression.MergeDocuments2(pdisp, bstrTemplateLocation, varDocuments, bstrDefaultSaveLocation)

Paramètres

expression

Expression qui renvoie un objet OpenXMLDocuments, contrôle.

pdisp

Object représentant un pointeur vers l'instance d'Internet Explorer qui appelle la méthode MergeDocuments2. L’utilisation d’une valeur NULL pour cet argument entraîne l’exécution de la méthode sur le thread Internet Explorer principal. En guise d’alternative, vous pouvez utiliser la méthode MergeDocuments si vous n’avez pas besoin de passer un objet avec cet argument.

bstrTemplateLocation

Chaîne qui contient l'URL de l'emplacement du formulaire ou document XML à ouvrir en vue de la fusion.

varDocuments

Object représentant une collection de formulaires ou documents XML, exprimée sous la forme de variantes, à fusionner. L’implémentation permet de passer une variante unique, une collection de variantes ou NULL. La page combine.aspx de la bibliothèque de formulaires Windows SharePoint Services passe la valeur NULL, une URL de formulaire ou de document XML unique, ou bien une collection d’URL de formulaire ou de document XML.

bstrDefaultSaveLocation

Chaîne contenant l'URL qui spécifie l'emplacement par défaut pour l'enregistrement du formulaire ou du document XML résultant qui a été fusionné.

true si le modèle de formulaire ou de document XML s'ouvre avec succès ; sinon false.

L’exemple suivant ouvre un ou plusieurs formulaires ou documents XML à des fins de fusion, dont le modèle et l’emplacement d’enregistrement sont spécifiés par les valeurs des variables strTempLoc et strSaveLoc qui sont passées à la méthode MergeDocuments2. L’argument varDocuments de la méthode MergeDocuments2 accepte un objet contenant une collection de documents ou de formulaires XML qui seront utilisés pendant la fusion. L’exemple suppose l’existence d’un formulaire nommé frmMergeDoc qui contient deux zones de saisie, TempLocation et SaveLocation.

<script language="JavaScript">
function mergeDocuments()
{
   // Create an instance of the OpenXMLDocuments object.
   xmlDocObject = new ActiveXObject("SharePoint.OpenXMLDocuments");

   // If the OpenXMLDocuments object was successfully created,
   // get the document location and document program ID values
   // from the form's input boxes.
   if (xmlDocObject)
   {
      var strTempLoc = document.frmMergeDoc.TempLocation.value;
      var strSaveLoc = document.frmMergeDoc.SaveLocation.value;

      // Build the collection of documents to merge.  MergeDocuments is
      // optimized to work with a collection of HTML checkbox controls like
      // document.all.chk for the following HTML:
      //    <checkbox id="chk" HREF="type a location here">
      //    <checkbox id="chk" HREF="type a location here">
      // The same result chan be acheived from script by wrapping and
      // array of values and an iterator like this:
      var docCol = Array(
      {checked:true, HREF:"type a location here"},
      {checked:true, HREF:"type a location here"});

      // Declare an iterator function for the collection of documents.
      function item(index)
      {
         return docCol[index];
      }

      // Wrap the collection and the interator into an object suitable
      // for MergeDocuments2 call.
      var docWrap = {length:docCol.length, item:item};
      // Open the XML document or form template for customization.
      xmlDocObject.MergeDocuments2(window, strTempLoc, docWrap, strSaveLoc);
   }
}
</script>

Afficher: