Expressions de l'adaptateur Windows SharePoint Services
Cette rubrique décrit le format et la signification des chaînes qui peuvent être spécifiées en tant que valeurs pour les propriétés File NameProperty Source de l’adaptateur Windows SharePoint Services. Il décrit également les propriétés de contexte associées, WSS. Nom de fichier et WSS. ConfigPropertiesXml. Ces expressions permettent de définir aisément la valeur de nom de fichier ou la valeur de colonne Windows SharePoint Service personnalisée, à l'aide de littéraux et de valeurs extraites du message ou du système BizTalk.
Les expressions peuvent contenir des littéraux et des macros. Les littéraux apparaissent dans le nom de fichier tels que vous les avez tapés. Les macros doivent être placées entre des caractères « % ». Un exemple de macro est %MessageID% celui qui, au moment de l’exécution, sera remplacé par le GUID du message.
Notes
Lorsque le caractère % est utilisé comme littéral ou dans une expression XPATH, il doit être assorti d'un caractère d'échappement comme suit : \%. Le caractère % seul est considéré comme un délimiteur de macro, tandis que les caractères \% sont remplacés par un seul caractère % au moment de l'exécution. Le caractère \ doit être assorti d'un caractère d'échappement comme suit : \\.
Exemples d’expressions
| Valeur au moment de la conception | Valeur d’exécution |
|---|---|
| XYZ | XYZ |
| PurchaseOrder | PurchaseOrder |
| %MessageID% | 55B93F27-7455-4066-ABE1-B4EBE6839A1A |
| PurchaseOrder - %MessageID% | PurchaseOrder - 55B93F27-7455-4066-ABE1-B4EBE6839A1A |
| Discount \%10 | Discount %10 |
| PurchaseOrder - %XPATH=//ns0:PurchaseOrder/ns0:ID% | PurchaseOrder – 10001 |
| PurchaseOrder - %XPATH=//ns0:PurchaseOrder/ns0:PartnerName%-%XPATH=//ns0:PurchaseOrder/ns0:ID% | PurchaseOrder – Contoso-10001 |
Macros prises en charge
| Valeur au moment de la conception | Valeur d’exécution |
|---|---|
| %MessageID% | ID de message BizTalk qui est un GUID unique. |
| %SendingOrchestrationID% | ID BizTalk de l'instance d'orchestration dont provient le message. |
| %SendingOrchestrationType% | Nom de type de l'orchestration dont provient le message. |
| %XPATH=<xpath>% | Permet de spécifier une syntaxe XPATH à utiliser pour extraire la valeur du message. «< xpath> » doit être remplacé par une expression XPATH valide. Note: L’alias d’espace de noms doit être défini en dehors de l’expression dans les « Alias d’espace de noms » ou WSS. Champ ConfigNamespaceAliases. |
| %Filename% | Remplacé par la valeur de nom de fichier extraite de la propriété de contexte de message WSS.Filename. La valeur de la propriété de contexte WSS.Filename des messages reçus de SharePoint est définie sur le nom du fichier SharePoint. La valeur renvoyée est prétraitée à l'aide de la méthode Path.GetFilenameWithoutExtension. Note: Cette macro ne peut pas être utilisée dans les propriétés de contexte WSS.Config* (à partir de l’orchestration). |
| %Extension% | Remplacé par la valeur d'extension de fichier extraite de la propriété de contexte de message WSS.Filename. La valeur de la propriété de contexte WSS.Filename des messages reçus de SharePoint est définie sur le nom du fichier SharePoint. La valeur renvoyée est prétraitée à l'aide de la méthode Path.GetExtension. La valeur renvoyée ne contient pas le caractère « . ». Note: Cette macro ne peut pas être utilisée dans les propriétés de contexte WSS.Config* (à partir de l’orchestration). |
Les expressions valides prises en charge par la promotion de propriétés constituent des noms de fichier valides au moment de la conception. Les noms de fichier au moment de la conception sont développés lors de l'exécution en noms de fichier Windows SharePoint Services. Les limites applicables aux noms de fichier Windows SharePoint Services sont décrites ci-après.
Les noms de fichiers Windows valides peuvent contenir des caractères Unicode à l’exception des éléments suivants : / \ : * ? <> | « " # { } % & ~ ou de tabulation et plusieurs points.
Un nom de fichier peut inclure jusqu'à 256 caractères, de même que l'URL entière.
Si le nom de fichier Windows SharePoint Services complet contient des caractères non valides, ou si le nom de fichier complet et/ou l'URL sont trop longs, une erreur est consignée dans le journal des événements de l'application et le message est suspendu. L'erreur et l'état du message sont également visibles dans la page Hub du groupe via le suivi des messages et des instances de service.
Voir aussi
Configuration d'un emplacement de réception Windows SharePoint Services
Configuration d'un gestionnaire d'envoi Windows SharePoint Services
Guide pratique pour configurer un port d’envoi Windows SharePoint Services
Référence aux propriétés de l’adaptateur Windows SharePoint Services
Types de colonnes Windows SharePoint Services pris en charge