Personnalisation des énumérations dans le schéma d'enveloppe
BizTalk Server vous permet de personnaliser les énumérations de champs d’ID dans le schéma de service (enveloppe). Cela vous permet de recevoir et d'envoyer des échanges contenant des valeurs non standard (étrangères à l'ensemble de valeurs définies par le corps de normes X12) dans les champs d'ID d'expéditeur ou de récepteur de l'enveloppe. Cela permet également de modifier les qualificateurs disponibles dans les listes déroulantes pour les valeurs d'en-tête dans les définitions de propriété d'accord.
Important
Lorsque vous modifiez un schéma, cette modification s'applique à toutes les transactions pour la norme en question. Vous ne pouvez pas introduire de modification dans le schéma d'enveloppe pour un seul tiers.
BizTalk Server extrait la liste des valeurs autorisées à partir de schémas de service statiques dans le Microsoft.BizTalk.Edi.BaseArtifacts.dll, qui est fourni avec le produit. Pour étendre l’ensemble de valeurs de base, vous devez développer et déployer une extension de schéma de service. BizTalk Server fournit des modèles de schéma de service (enveloppe) que vous pouvez utiliser pour modifier les énumérations dans. Ces schémas de service sont X12_ServiceSchemaExtension.xsd et EDIFACT_ServiceSchemaExtension.xsd. Chaque schéma personnalisé aura l’un des espaces de noms suivants, en fonction de la norme. Il n'est pas possible de modifier cet espace de noms.
| standard | Espace de noms |
|---|---|
| X 12 et HIPAA | http://schemas.microsoft.com/BizTalk/EDI/X12/2006 |
| EDIFACT | http://schemas.microsoft.com/BizTalk/EDI/EDIFACT/2006 |
Vous apportez les modifications au schéma dans l’éditeur BizTalk dans Visual Studio (voir la procédure ci-dessous). Après avoir apporté les modifications requises, vous devez déployer le schéma.
Du côté de la réception et de l’envoi, quand BizTalk Server valide les segments d’enveloppe (ISA et GS pour X12, ou UNB et UNG pour EDIFACT), il case activée pour l’existence du schéma de service personnalisé en fonction de son espace de noms. Si le schéma personnalisé est déployé, BizTalk Server fusionnera ce schéma avec le schéma de service standard et utilisera des valeurs d’énumération personnalisées et standard lorsque cela est spécifié. Vous pouvez personnaliser le schéma pour étendre une liste d'énumération, mais vous ne pouvez pas en retirer de valeurs. Si un schéma personnalisé n’est pas déployé, BizTalk Server utiliserez le schéma de service standard.
Une fois que vous avez déployé un schéma personnalisé, l’interface utilisateur TPM (Trading Partner Management) de la console d’administration BizTalk Server utilise les valeurs d’une énumération personnalisée pour remplir les listes déroulantes appropriées dans les pages de propriétés TPM. Si vous n’avez pas déployé de schéma personnalisé, TPM utilise les valeurs des énumérations dans le schéma de service standard. En outre, le runtime BizTalk Server utilise l’énumération personnalisée pour valider un message.
Si vous utilisez les outils XML fournis avec BizTalk Server pour valider un instance avec son enveloppe et que vous avez personnalisé le schéma de service, vous devez inclure le schéma de service personnalisé dans le projet BizTalk, en plus des schémas de document (jeu de transactions) et, si nécessaire, le schéma de traitement par lots. Cela n'est pas nécessaire si vous validez une instance de document informatisé dépourvue d'enveloppe.
Prérequis
Vous devez ouvrir une session en tant que membre du groupe Administrateurs BizTalk Server.
Champs d'enveloppe qui peuvent être modifiés
Seuls les champs d'enveloppe suivants peuvent être modifiés. Seuls ces champs sont inclus dans les schémas d'extension. D'autres champs ajoutés dans le schéma d'extension de service n'auront aucun effet sur le traitement.
| standard | Champ |
|---|---|
| X 12 et HIPAA | ISA01 – Qualificateur d'autorisation ISA03 – Qualificateur de sécurité ISA05 – Qualificateur d'ID d'expéditeur ISA07 - Qualificateur d'ID de récepteur GS01 - code fonctionnel GS07 - Entité responsable |
| EDIFACT | UNB2.2 - Qualificateur de code de l'expéditeur UNB3.2 - Qualificateur de code du récepteur |
Champs d'enveloppe à ne pas modifier
Certains champs de l'enveloppe déterminent des comportements dans le moteur. Par conséquent, vous ne devez pas ajouter de valeurs à une liste d'énumération existante pour aucun de ces champs. Ces champs sont les suivants :
| standard | Champ |
|---|---|
| X 12 et HIPAA | ISA11 – Identificateur de normes de contrôle d'échange ISA12 – Numéro de version de contrôle d'échange ISA14 – Accusé de réception demandé |
| EDIFACT | UNB1.1 – Identificateur de syntaxe UNB1.2 – Numéro de version de syntaxe UNB9 – Demande d'accusé de réception |
Pour personnaliser une énumération dans le schéma d'enveloppe
Dans Visual Studio, créez un projet.
Ajoutez le schéma X12_ServiceSchemaExtension.xsd (pour modifier les énumérations X12 ou HIPAA) ou le schéma EDIFACT_ServiceSchemaExtension.xsd dans \Program Files (x86)\Microsoft BizTalk Server <VERSION>XSD_Schema\EDI à un projet BizTalk dans l’éditeur BizTalk. Ouvrez le schéma.
Pour modifier les valeurs d’une énumération, sélectionnez l’énumération dans le volet Propriétés , puis cliquez sur les points de suspension pour ouvrir l’Éditeur d’énumération. Ajoutez à la liste des valeurs, si nécessaire, en vous assurant qu’il existe une valeur sur chaque ligne dans le volet Valeurs . Cliquez sur OK.
Important
Vous ne pouvez pas modifier l'espace de noms pour le schéma de service. Le schéma doit avoir les mêmes espace de nom et nom de nœud racine que le schéma d'extension original installé avec le produit.
Notes
Si vous ajoutiez un champ aux schémas, il serait ignoré. Seuls les champs répertoriés dans la section Champs d’enveloppe pouvant être modifiés ci-dessus peuvent être modifiés.
Enregistrez le schéma.
Cliquez avec le bouton droit sur le schéma, puis cliquez sur Déployer.
Notes
Le schéma doit être déployé dans le groupe BizTalk actif.