Propriétés de contexte EDI
Les propriétés de contexte de message du schéma de propriété global EDI étant exposées publiquement, vous pouvez les utiliser pour le routage des messages. Elles sont définies dans le fichier PropertySchema.xsd dans l'assembly Microsoft.BizTalk.Edi.BaseArtifacts. L’espace de noms des propriétés est http://schemas.microsoft.com/ Edi/PropertySchema. Si elles sont promues, ces propriétés de contexte de message sont disponibles en tant qu’Edi.<Nom >de la propriété dans la page Filtres de la boîte de dialogue Propriétés du port d’envoi dans l’aide de l’interface utilisateur et informations de référence sur l’espace de noms d’API des développeurs.
Liste des propriétés de contexte
Les propriétés de contexte EDI sont également disponibles dans une orchestration, tant qu’une référence à l’assembly Microsoft.BizTalk.Edi.BaseArtifacts a été ajoutée au projet d’orchestration.
| Nom | Type | Description |
|---|---|---|
| AK901 | string | Indique si le groupe fonctionnel identifié dans le segment AK1 de l'accusé de réception a été accepté ou rejeté (accusé de réception X12 997 uniquement). |
| AttachmentId | String | ID de la pièce jointe du message. |
| AgreementID | Int | Écrit par le pipeline de réception EDI. Spécifie l'ID de l'accord vers lequel le message entrant est résolu. Pour un accord de secours, cette valeur est 0. |
| AgreementName | String | Écrit par le pipeline de réception EDI. Spécifie le nom de l'accord vers lequel le message entrant est résolu. Pour un contrat de secours, cette valeur est BTSGuestParty. |
| AgreementNameForSend | String | Utilisé par le pipeline d'envoi EDI pour résoudre l'accord pour le document sortant. |
| AgreementPartIDForSend | Int | Utilisé par le pipeline d'envoi EDI pour résoudre l'accord pour le document sortant. Cette valeur est écrite par l'orchestration de traitement par lot. |
| AgreementPartIDOnReceive | Int | Écrit par le pipeline de réception EDI. Spécifie l'ID de l'accord unidirectionnel de l'accord vers lequel le message entrant est résolu. Pour un accord de secours, cette valeur est 0. |
| BatchElementValidationFailure | boolean | Indique qu'une erreur a été promue par le système de traitement par lot lorsque la validation d'un élément du lot a échoué. |
| BatchEncodingType | string | Type de codage que BizTalk Server doit utiliser pour encoder un échange traité par lot sortant. |
| BatchId | Int | ID de lot de la configuration de lot à utiliser lors du traitement de ce document, si celui-ci ne correspond qu'à un seul filtre par lot. |
| BatchIds | String | Liste des ID de lot du filtre par lot correspondant, définie si le document correspond à plusieurs filtres par lot. |
| BatchingError | string | Description de l'erreur promue par le système de traitement par lot lorsqu'un élément du lot est suspendu. |
| BatchName | String | Nom de la configuration de lot à utiliser lors du traitement de ce document. |
| CodePage | string | Page de codes à utiliser pour valider l'échange. |
| CONTRL_UCI4 | string | Champ Code d'action d'un accusé de réception CONTRL, indiquant si l'échange à été accepté (valeur de « 8 ») ou rejeté à cause d'une erreur dans le segment UNA ou UNB (valeur de « 4 ») (accusé de réception EDIFACT CONTRL uniquement). |
| DestinationPartyID (déconseillé dans BizTalk Server) | int | ID du tiers de destination à qui le message doit être envoyé. |
| DestinationPartyName (déconseillé dans BizTalk Server) | string | Nom du tiers de destination à qui le message doit être envoyé. |
| DestinationPartyReceiver Identificateur |
string | Identificateur du tiers de destination à qui le message doit être envoyé. Cette propriété peut être promue dans un composant personnalisé pour permettre la résolution du tiers dans le pipeline d'envoi. |
| DestinationPartyReceiver Qualificateur |
string | Qualificateur du tiers de destination à qui le message doit être envoyé. Cette propriété peut être promue dans un composant personnalisé pour permettre la résolution du tiers dans le pipeline d'envoi. |
| DestinationPartySender Identificateur |
string | Identificateur du tiers qui a envoyé le message au tiers de destination. Cette propriété peut être promue dans un composant personnalisé pour permettre la résolution du tiers dans le pipeline d'envoi. |
| DestinationPartySender Qualificateur |
string | Qualificateur du tiers qui a envoyé le message au tiers de destination. Cette propriété peut être promue dans un composant personnalisé pour permettre la résolution du tiers dans le pipeline d'envoi. |
| EncodingType | short | Type de codage que BizTalk Server doit utiliser pour encoder un message sortant. |
| ErrorDescription | string | Contient une copie du message d'erreur pour un message interrompu (semblable au message dans EventViewer). |
| GS_Segment | string | Segment GS (groupe fonctionnel) complet (X12). Le pipeline de réception EDI écrit cette propriété au contexte lorsque l'échange est divisé en documents informatisés, et non pas lorsqu'il est conservé. |
| GS01 | string | Code d'identificateur fonctionnel (X12) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| GS02 | string | Code de l'expéditeur de l'application (X12) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| GS03 | string | Code du récepteur d’application (X12) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| GS07 | string | Entité responsable (X12) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| GS08 | string | Code identificateur de la version, de la version finale, de l'activité (X12) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| ISA_Segment | string | Segment ISA (Interchange Control Header, en-tête de contrôle de l'échange) complet (X12). BizTalk Server écrit cette propriété au contexte quand l'échange est divisé en documents informatisés, et non pas lorsqu'il est conservé. Cette propriété contient des informations de sécurité ou d'autorisation (ISA2, informations d'autorisation, et ISA4, informations de sécurité) qui peuvent entraîner une divulgation d'informations. Vous pouvez utiliser la propriété Mask security/authorization/password information (dans la page Validation et génération D’ACK ) pour remplacer chaque caractère des champs ISA2 et ISA4 par un caractère « # ». Il s’agit d’un processus unidirectionnel : les caractères « # » ne peuvent pas être convertis en caractères réels. Le pipeline de réception EDI écrit cette propriété au contexte lorsque l'échange est divisé en documents informatisés, et non pas lorsqu'il est conservé. |
| ISA05 | string | Qualificateur d'expéditeur des échanges (X12) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| ISA06 | string | ID de l'expéditeur des échanges (X12) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| ISA07 | string | Qualificateur de récepteur des échanges (X12) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| ISA08 | string | ID du récepteur des échanges (X12) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| ISA15 | string | Indicateur d'utilisation (X12) Le pipeline de réception EDI promeut cette propriété au contexte (si l'échange n'est pas un échange traité par lot conservé). |
| IsResendControlMessage | int | Utilisé par le moteur AS2 pour indiquer qu'un message AS2 envoyé doit être retransmis, lorsqu'aucune réponse MDN n'a été reçue au cours de la durée configurée. |
| IsSystemGeneratedACK | boolean | Indique que le message est un accusé de réception (X12 TA1 ou 997, ou EDIFACT CONTRL) généré par le système. Peut avoir la valeur True ou False. Il s’agit d’une propriété de contexte de message qui est disponible en tant que EDI. IsSystemGeneratedACK dans la page Filtres de la boîte de dialogue Propriétés du port d’envoi . |
| ReceiverPartyName | String | Écrit par le pipeline de réception EDI. Spécifie le nom du partenaire de destination fourni dans l'accord vers lequel le message est résolu. Pour un contrat de secours, cette valeur est RECEIVE-PARTNER. |
| ReceiverPartyNameForSend | String | Utilisé par le pipeline d'envoi EDI pour résoudre l'accord pour les documents sortants. |
| ReuseEnvelope | boolean | Indique si un échange est préservé ou fractionné. Si l'échange est préservé, BizTalk Server va réutiliser l'enveloppe lors du traitement de l'échange pour l'envoi. |
| SenderPartyName | String | Écrit par le pipeline de réception EDI. Spécifie le nom du partenaire source fourni dans l'accord vers lequel le message entrant est résolu. Pour un contrat de secours, cette valeur serait BTS-SENDER. |
| SenderPartyNameForSend | String | Utilisé par le pipeline d'envoi EDI pour résoudre l'accord pour les documents sortants. |
| ST01 | string | Code d'identificateur du document informatisé (X12) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| ST03 | string | Code identificateur de la version, de la version finale, de l'activité (X12) Vous pouvez écrire et promouvoir cette propriété pour le contexte et l'utiliser pour le routage des messages. |
| TA1_TA104 | string | Champ Comportement du moteur d'un accusé de réception TA104, indiquant si l'échange est accepté (valeur « A »), accepté avec des erreurs (valeur « E ») ou rejeté/suspendu (valeur « R ») (accusés de réception X12 TA1 uniquement). |
| ToBeBatched | boolean | Indique si le message doit être traité par lot avec les autres messages par l'orchestration de traitement par lot. Après avoir traité un échange par lot, l'orchestration de traitement par lot définit cette propriété sur « False ». |
| ToBeRouted | boolean | Indique que le message doit être récupéré par l'orchestration de routage, qui créé autant de copies de l'élément du lot qu'il y a d'abonnement à cet élément, puis route les copies vers la MessageBox. |
| UNA_Segment | string | Segment UNA (options de l'échange) complet (EDIFACT) Le pipeline de réception EDI écrit cette propriété au contexte lorsque l'échange est divisé en documents informatisés, et non pas lorsqu'il est conservé. |
| UNB_Segment | string | Segment UNB (en-tête de contrôle de l'échange) complet (EDIFACT) Le pipeline de réception EDI écrit cette propriété au contexte lorsque l'échange est divisé en documents informatisés, et non pas lorsqu'il est conservé. Cette propriété contient des informations de sécurité ou d'autorisation (UNB6.1 et UNB6.2) qui peuvent entraîner une divulgation d'informations. Vous pouvez utiliser la propriété Masquer les informations de sécurité/d'autorisation/de mot de passe pour remplacer les valeurs des champs UNB6.1 et UNB6.2 par des caractères « # ». Remarque : les caractères « # » ne peuvent pas être reconvertis en leur forme initiale. |
| UNB11 | string | Indicateur d'utilisation (EDIFACT) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| UNB2_1 | string | ID de l'expéditeur des échanges (EDIFACT) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| UNB2_2 | string | Code du qualificateur d'expéditeur des échanges (EDIFACT) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| UNB2_3 | string | Adresse de routage inverse (EDIFACT) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| UNB3_1 | string | ID du destinataire de l'échange (EDIFACT) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| UNB3_2 | string | Code du qualificateur du destinataire de l'échange (EDIFACT) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| UNG_Segment | string | Segment UNG (groupe fonctionnel) complet (X12). Le pipeline de réception EDI écrit cette propriété au contexte lorsque l'échange est divisé en documents informatisés, et non pas lorsqu'il est conservé. |
| UNG1 | string | Identification du groupe fonctionnel (EDIFACT) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| UNG2_1 | string | Identification de l’expéditeur de l’application (EDIFACT) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| UNG3_1 | string | Identification du destinataire de l'application (EDIFACT) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| UNH2_1 | string | Type de message (EDIFACT) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| UNH2_2 | string | Numéro de version du message (EDIFACT) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
| UNH2_3 | string | Numéro de version finale du message (EDIFACT) Le pipeline de réception EDI promeut cette propriété dans le contexte (si l’échange n’est pas un échange par lots en cours de conservation). |
Extraction de champs individuels des propriétés de contexte du segment
Certaines propriétés ne sont pas écrites ou promues pour le contexte du message par les pipelines de réception EDI en tant que propriétés individuelles, mais uniquement en tant que chaînes d'un segment. Cette opération est effectuée pour des raisons de performances, car la promotion des propriétés a des conséquences sur les performances. Par exemple, les champs ISA ISA5, ISA6, ISA7, ISA8 et ISA15 du segment ISA sont promus par les pipelines de réception en tant que propriétés individuelles, mais le reste des champs ISA sont uniquement écrits dans le contexte du message en tant que propriétés ISA_Segment. Ces propriétés sont écrites ou promues uniquement lorsque ReuseEnvelope n’est pas défini sur True, ce qui indique qu’un échange par lot reçu n’est pas conservé.
Si le champ de l'un des segments (ISA, GS, UNB, UNG ou UNA) doit être écrit dans le contexte du message, mais que ce champ n'est pas écrit dans le contexte par défaut, vous devez écrire un composant personnalisé pour qu'il écrive ce champ dans le contexte du message. Ce composant personnalisé doit analyser les champs du segment et écrire un champ individuel dans le contexte du message.
L'exemple d'enrichissement de message décrit l'utilisation d'un analyseur pour extraire des champs d'un segment et les écrire dans le contexte. Cet exemple est inclus dans le <lecteur> :\Program Files\Microsoft BizTalk Server\SDK\Samples\EDI\MessageEnrichment. Pour plus d’informations, consultez Exemple d’enrichissement de message (exemple BizTalk Server).
Voir aussi
Développement et configuration de solutions EDI BizTalk Server