Configuration des ports d'envoi à l'aide des propriétés de contexte Windows Sharepoint Services

Cette rubrique décrit la configuration des ports d'envoi Windows SharePoint Services, au moment de l'exécution, à l'aide des propriétés de contexte Windows SharePoint Services, à partir d'une orchestration BizTalk. Le même mécanisme peut être utilisé pour configurer les ports d'envoi dynamiques et à liaison tardive Windows SharePoint Services. Les propriétés de configuration pour un port d'envoi dynamique sont définies dans une orchestration au moment de l'exécution. Les propriétés de l’adaptateur exposées dans la boîte de dialogue Propriétés de transport Windows SharePoint Services peuvent également être appliquées à un port d’envoi dynamique ou à liaison tardive. Pour définir les propriétés de configuration d'un port d'envoi dynamique ou à liaison tardive à l'aide des propriétés de contexte de l'adaptateur Windows Sharepoint Services, procédez comme suit :

Pour définir les propriétés de configuration d'un port d'envoi à l'aide des propriétés de contexte de l'adaptateur Windows Sharepoint Services

1. Pour les ports d’envoi dynamiques, pour créer un port d’envoi unidirectionnel dynamique, suivez les étapes de la rubrique Création d’un port d’envoi.

2. Utilisez une forme d’affectation de message dans une forme de message de construction dans une orchestration pour définir les propriétés de configuration du message sortant. Pour obtenir un exemple de définition des propriétés de configuration d’un message sortant , consultez Procédure pas à pas : Module 3 - Accès aux propriétés SharePoint à partir d’une orchestration. La section Construire un nouveau message de cette rubrique montre comment définir les propriétés de configuration d’un message sortant. Les propriétés de contexte de l’adaptateur qui sont corrélées aux propriétés qui peuvent être définies dans la boîte de dialogue Propriétés de transport Windows SharePoint Services sont répertoriées dans le tableau ci-dessous :

   Transport, propriété	Propriétés de contexte de l'adaptateur	Type de données	Commentaires
   Port de service Web d'adaptateur	WSS.ConfigAdapterWSPort	Int	Les valeurs valides sont comprises entre 1 et 65535 La valeur par défaut est 80.
   Délai d'expiration	WSS.ConfigTimeout	Int	Les valeurs valides sont comprises entre 1000 et 2147483647 La valeur par défaut est 1000000 Spécifiez une valeur de 0 pour indiquer un délai d'expiration infini.
   URL Dossier de destination	N/D	N/D	Pour les ports dynamiques, cela est défini indirectement en définissant la propriété Microsoft.XLANGs.BaseTypes.Address du port dynamique avec une forme d’expression dans une orchestration. Pour les ports à liaison tardive, cette propriété ne peut pas être définie au moment de l'exécution car elle est toujours remplacée par la valeur du port d'envoi physique.
   Nom de fichier	WSS.Filename	String	Prend en charge l’utilisation de toutes les macros de nom de fichier qui peuvent être utilisées dans les propriétés de transport, à l’exception des macros %Filename% et %Extension%.
   Alias d'espaces de noms	WSS.ConfigNamespaceAliases	String	Si un alias d'espace de noms défini pour un message au moment de l'exécution correspond exactement à l'alias d'espace de noms défini pour le port d'envoi vers lequel le message est routé, alors les espaces de noms sont fusionnés et une erreur de routage se produit. Pour empêcher ce problème, assurez-vous que les alias d'espaces de noms spécifiés ne sont pas identiques. Par exemple, si l'expression suivante est utilisée dans une orchestration pour définir l'alias d'espace de noms pour un message : Message_Task(WSS.ConfigNamespaceAliases)= "orchns='http://OrderProcess.PurchaseOrder'"; et si ce message est acheminé vers un port d’envoi qui spécifie la valeur suivante pour la propriété Alias d’espace de noms : orchns='http://OrderProcess.PurchaseOrder' alors une erreur se produit lorsque BizTalk Server tente de router le message vers ce port d'envoi. Pour résoudre ce problème, vous pouvez spécifier la valeur suivante pour la propriété Alias d’espace de noms du port d’envoi : orchns2='http://OrderProcess.PurchaseOrder'
   Remplacer	WSS.ConfigOverwrite	String	Les valeurs autorisées sont : - « oui » - « non » - « renommer »
   URL de site SharePoint	WSS.InListUrl	String	Pour les ports dynamiques, cela est défini indirectement en définissant la propriété Microsoft.XLANGs.BaseTypes.Address du port dynamique avec une forme d’expression dans une orchestration. Pour les ports à liaison tardive, cette propriété ne peut pas être définie au moment de l'exécution car elle est toujours remplacée par la valeur du port d'envoi physique.
   Intégration de Microsoft Office	WSS.ConfigOfficeIntegration	String	Les valeurs autorisées sont : - « oui » - « non » - « yesformlibrary » - « facultatif »
   Bibliothèque de documents Modèles	WSS.ConfigTemplatesDocLib	String	None
   Bibliothèque de documents Modèles de secours	WSS.ConfigCustomTemplatesDocLib	String	None
   Colonne espaces de noms Modèles de secours	WSS.ConfigCustomTemplatesNamespaceCol	String	None
   Colonne d'espace de noms des modèles	WSS.ConfigTemplatesNamespaceCol	String	None
   Colonne n	WSS.ConfigPropertiesXml Le nom de colonne est défini dans le <champ PropertyNamex>columnname</PropertyNamex> .	String	None
   Valeur de colonne n	WSS.ConfigPropertiesXml La valeur de colonne est définie dans le <champ PropertySourcex>columnvalue</PropertySourcex> .	String	Prend en charge l’utilisation de toutes les macros de nom de fichier qui peuvent être utilisées dans les propriétés de transport, à l’exception des macros %Filename% et %Extension%.

   Notes

   Les valeurs fournies pour les propriétés de contexte respectent la casse. Lors de la définition de valeurs de configuration pour un port dynamique avec des propriétés de contexte, veillez à utiliser la casse appropriée, sans quoi une erreur se produit quand BizTalk tente de router le document vers le port d'envoi désigné.

3. Utilisez une forme d’expression dans une orchestration pour définir la propriété Microsoft.XLANGs.BaseTypes.Address pour le port d’envoi dynamique. Cette propriété sert à spécifier l'URI vers lequel le port d'envoi dynamique route le message. Pour obtenir un exemple de définition de la propriété Microsoft.XLANGs.BaseTypes.Address pour un port d’envoi dynamique, consultez la section Créer une expression de la rubrique Procédure pas à pas : Module 3 - Accès aux propriétés SharePoint à partir d’une orchestration. Pour plus d’informations sur les propriétés du contexte de l’adaptateur Windows Sharepoint Services, consultez Windows SharePoint Services Informations de référence sur les propriétés de l’adaptateur.

   Il est également possible de définir de manière dynamique certaines propriétés d'un port d'envoi à liaison tardive Windows Sharepoint Services dans une orchestration. Si cela est fait, le port Windows Sharepoint Services est configuré deux fois : la première via les propriétés de contexte Windows SharePoint Services et la seconde via la boîte de dialogue Propriétés du transport Windows SharePoint Services. Par défaut, la configuration spécifiée dans la boîte de dialogue Propriétés du transport Windows SharePoint Services a priorité sur les propriétés de configuration spécifiées dans les propriétés de contexte. Pour utiliser la configuration spécifiée dans les propriétés de contexte, procédez comme suit :

   1. Pour créer un port d’envoi unidirectionnel statique, suivez les étapes de la rubrique Création d’un port d’envoi.

   2. Lorsque vous définissez les propriétés du port d’envoi, définissez l’URI du port d’envoi en entrant les valeurs appropriées pour les propriétés URL du site Sharepoint et URL du dossier de destination .

   3. Définissez la valeur de la propriété Overwrite sur Orchestration si vous souhaitez utiliser la valeur définie par la propriété de contexte WSS. ConfigOverwrite dans une orchestration.

   4. Définissez la propriété d’intégration Microsoft Office sur Orchestration si vous souhaitez utiliser la valeur définie par la propriété de contexte WSS. ConfigOfficeIntegration dans une orchestration.

   5. Entrez la valeur -1 pour toutes les propriétés de port d’envoi qui utilisent le type de données integer si vous souhaitez définir ces valeurs avec une propriété de contexte dans une orchestration.

   6. N'entrez aucune valeur pour toute propriété du port d'envoi qui utilise le type de données Chaîne si vous voulez définir ces valeurs avec une propriété de contexte dans une orchestration. Cela ne s’applique pas aux propriétés URL du site Sharepoint et URL du dossier de destination . Ces propriétés doivent être spécifiées dans la boîte de dialogue Propriétés de transport Windows Sharepoint Services .

   7. Utilisez une forme d’affectation de message dans une forme de message de construction dans une orchestration pour définir les propriétés de configuration du message sortant. Pour obtenir un exemple de définition des propriétés de configuration d’un message sortant , consultez Procédure pas à pas : Module 3 - Accès aux propriétés SharePoint à partir d’une orchestration. La section Construire un nouveau message de cette rubrique montre comment définir les propriétés de configuration d’un message sortant.

   8. Toute propriété du port d'envoi qui est configurée sur la valeur -1 (pour les propriétés utilisant le type de données Entier), sur « Orchestration » (pour les propriétés d'énumération d'une liste déroulante) ou laissée vide (pour les propriétés utilisant le type de données Chaîne), est définie au moment de l'exécution avec la propriété de contexte spécifiée dans l'orchestration.

   Si vous utilisez l'adaptateur Windows SharePoint Services pour recevoir des formulaires InfoPath avec des pièces jointes incorporées, puis envoyer les formulaires InfoPath à une bibliothèque de documents SharePoint, effectuez les opérations suivantes pour conserver les instructions de traitement InfoPath présentes dans le formulaire :

Pour conserver les instructions de traitement InfoPath pour les formulaires InfoPath, avec des pièces jointes incorporées, traités par BizTalk Server

1. Si vous utilisez une carte dans l’orchestration pour mapper des données d’un formulaire InfoPath à un autre formulaire InfoPath, vérifiez que vous avez défini la propriété Instructions de traitement de copie dans le mappage sur Oui. Ce paramètre est défini sous la section En-tête personnalisé de la page Propriétés de la grille pour la carte.

2. Si vous n'utilisez pas de mappage dans l'orchestration, mettez à jour le message de sortie à l'aide de l'expression suivante dans une forme Assignation de message :

   NewMessage(XMLNORM.ProcessingInstructionOption) = 1;  
   NewMessage(XMLNORM.ProcessingInstruction) = "<?mso-infoPath-file-attachment-present?>"  
   

   Dans l’expression ci-dessus, NewMessage est le message de sortie auquel vous ajoutez les instructions de traitement.

Voir aussi

Comment créer un port d’envoi