Remplacement des en-têtes EDI

Lors de l'envoi d'un message codé EDI, l'enveloppe EDI appliquée au message est généralement basée sur les propriétés EDI de l'accord récepteur ou sur celles de l'accord de secours. Cependant, il est souvent utile de définir les propriétés de l'enveloppe EDI en fonction de valeurs générées par le composant d'exécution.

Dans BizTalk Server, vous pouvez utiliser les propriétés de contexte EdiOverride pour spécifier les valeurs utilisées pour générer l’enveloppe EDI sur les documents sortants.

Utilisation des propriétés de contexte EdiOverride

Les propriétés de contexte EdiOverride offrent un moyen de remplacer tout ou partie des valeurs utilisées pour générer l'enveloppe EDI. Le pipeline d'envoi EDI utilise les propriétés de contexte EdiOverride contenant une valeur valide pour construire l'enveloppe. Si une propriété n'est pas renseignée, le pipeline utilise la valeur spécifiée dans les propriétés de l'accord, ou dans les propriétés de l'accord de secours si aucun accord n'est défini. Si une propriété contient une valeur non valide, le pipeline interrompt le message et signale une erreur de validation.

Notes

Les valeurs spécifiées dans la collection EdiOverride ne sont utilisées que si la EdiOverride.OverrideEdiHeader propriété est écrite dans le contexte d’un message et contient la valeur « True ».

La valeur par défaut n'est pas définie.

Propriétés EdiOverride pour les valeurs d'une enveloppe X12

Le tableau suivant répertorie les propriétés de contexte EdiOverride et l'en-tête d'enveloppe X12 correspondant :

En-tête	Propriétés
En-tête de contrôle de l'échange (ISA)	ISA01, ISA02, ISA03, ISA04, ISA05, ISA06, ISA07, ISA08, ISA09, ISA10, ISA11, ISA12, ISA13, ISA14, ISA15, ISA16
En-têtes de groupe fonctionnel (GS)	GS01, GS02, GS03, GS04, GS05, GS06, GS07, GS08
En-tête du jeu de transactions	ST02

Propriétés EdiOverride pour les valeurs d'une enveloppe EDIFACT

Le tableau suivant répertorie les propriétés de contexte EdiOverride et le segment d'enveloppe EDIFACT correspondant :

Segment	Propriétés
Options de l'échange (UNA)	UNA1, UNA2, UNA3, UNA4, UNA5, UNA6, UNA6Suffix
En-tête de contrôle de l'échange (UNB)	UNB1_1, UNB1_2, UNB2_1, UNB2_2, UNB2_3, UNB3_1, UNB3_2, UNB3_3, UNB4_1, UNB4_2, UNB5, UNB6_1, UNB7, UNB8, UNB9, UNB10, UNB11
En-têtes de groupe fonctionnel (UNG)	UNG1, UNG2_1, UNG2_2, UNG3_1, UNG3_2, UNG4_1, UNG4_2, UNG5, UNG6, UNG7_1, UNG7_2, UNG7_3, UNG8
En-tête du message (UNH)	UNH1

Étant donné que les segments EDIFACT UNA et UNG sont facultatifs, les propriétés GenerateUNA et GenerateUNG peuvent être utilisées pour déterminer si ces en-têtes sont générés, quel que soit le paramètre d’accord de segment Appliquer UNA . Les tableaux suivants indiquent les valeurs provoquant la génération de ces segments :

Propriété de conxte GenerateUNA	Paramètre d'accord Appliquer le segment UNA	Comportement du moteur
TRUE	CHECKED	Générer UNA
TRUE	UNCHECKED	Générer UNA
FALSE	CHECKED	Ne pas générer un UNA
FALSE	UNCHECKED	Ne pas générer un UNA
Absent (OverrideEDIHeader est faux)	CHECKED	Générer UNA
Absent (OverrideEDIHeader est faux)	UNCHECKED	Ne pas générer un UNA

Propriété de conxte GenerateUNG	Paramètre d'accord Appliquer les segments UNG	Comportement du moteur
TRUE	CHECKED	Générer UNG
TRUE	UNCHECKED	Générer UNG
FALSE	CHECKED	Ne pas générer un UNG
FALSE	UNCHECKED	Ne pas générer un UNG
Absent (OverrideEDIHeader est faux)	CHECKED	Générer UNG
Absent (OverrideEDIHeader est faux)	UNCHECKED	Ne pas générer un UNG

Enveloppes de groupe

Les enveloppes de groupe sont particulièrement délicates à utiliser car l'échange peut avoir plusieurs groupes. Pour surmonter cette difficulté, le pipeline d'envoi EDI peut appliquer l'enveloppe à tous les groupes de l'échange ou au seul groupe de l'échange.

Pour les transactions uniques, tous les champs GS ou UNG peuvent être remplacés alors que pour les échanges par lot, seuls les champs suivants peuvent être remplacés :

• GS04

• GS05

• UNG4_1

• UNG4_2

Traitement par lot

L'orchestration du traitement par lot gère le remplacement du numéro de contrôle du document informatisé des messages traités par lot. Les propriétés suivantes peuvent être écrites dans le contexte de tout message qui sera traité par lot pour remplacer le numéro de contrôle du document informatisé :

• ST02 (pour les messages X12)

• UNH1 (pour les messages EDIFACT)

Notes

Si plusieurs messages entrants contiennent le même numéro de contrôle dans le même groupe, les messages dont les numéros sont dupliqués sont suspendus.

Notes

Ne faites pas la promotion des propriétés de contexte EdiOverride ISA, UNA, GS ou UNG pour les messages qui ne sont pas traités par lot. Si vous devez remplacer ces propriétés, faites-en la promotion sur le message de sortie de l'orchestration de traitement par lot avant l'envoi au pipeline d'envoi EDI.

Collision entre délimiteurs

Les délimiteurs, comme les en-têtes UNA, doivent contenir une valeur unique pour chaque champ. Lorsque vous remplacez des valeurs de délimiteurs, comme les en-têtes UNA, vous devez vous assurer que chaque valeur de délimiteur est unique, non seulement au sein des valeurs que vous remplacez mais également parmi les valeurs de délimiteur utilisées à partir des paramètres de l'accord ou des paramètres de l'accord de secours.

Si, par exemple, vous remplacez UNA1, UNA2 et UNA4 et UNA3, UNA5, UNA6 et UNA6Suffix provenant des propriétés de l'accord, chaque propriété doit contenir une valeur unique par rapport aux autres.

Voir aussi

Envoi des messages EDI par BizTalk Server