Modification des schémas EDI
Vous pouvez modifier un schéma EDI existant fourni dans BizTalk Server. Lorsque vous et vos partenaires commerciaux êtes d’accord sur les modifications apportées aux schémas standard et que vous avez peut-être modifié le fichier mig (Message Implementation Guideline) approprié, vous pouvez modifier les schémas dans l’éditeur BizTalk dans Visual Studio.
Notes
Certaines modifications de schéma (validation de champ croisé et fractionnement en sous-documents HIPAA) impliquent la modification des annotations d'un schéma EDI. Ces modifications ne peuvent pas être apportées dans l'Éditeur BizTalk, mais dans un éditeur de texte comme le Bloc-Notes.
Prérequis
Vous devez ouvrir une session en tant que membre du groupe Administrateurs BizTalk Server.
Convention d'affectation de noms de schémas
Un schéma EDI est identifié par son nom racine et son espace de noms. Vous ne pouvez pas déployer, dans le même groupe BizTalk, deux schémas ayant les mêmes nom racine et espace de noms. Vous ne pouvez pas modifier le nom racine d'un schéma EDI ou l'ajouter au nom racine car il doit contenir la version et le type de document dans une convention d'affectation de noms standard. Par conséquent, si vous voulez déployer, dans le même groupe BizTalk, deux schémas ayant le même nom racine, vous devez utiliser des espaces de noms différents.
Il n'est pas inhabituel pour une société de déployer, dans le même groupe BizTalk, une version différente du même schéma pour deux partenaires commerciaux ou plus. Dans ce cas, les deux schémas ont la même version et le même type de document. Pour déployer ces deux schémas, vous devez avoir des espaces de noms différents pour chaque schéma.
Modifications du schéma EDI
Vous pouvez apporter les modifications suivantes à un schéma EDI dans Visual Studio :
| Action à réaliser | Action |
|---|---|
| Modifier une énumération (telle que la liste de valeurs dans une liste de codes) |
Dans les propriétés d’un élément, ouvrez l’Éditeur d’énumération et ajoutez une valeur à la liste d’énumération ou supprimez une valeur. |
| Modifier le caractère facultatif d'un élément de données | Modifiez la propriété Min Occurs . Changez-la en 0 pour rendre le champ facultatif ou en 1 pour le rendre obligatoire. |
| Modifier le nombre maximal de fois qu'un élément de données peut apparaître dans le fichier | Modifiez la propriété Max Occurs . |
| Modifier le nombre de caractères dans l'élément de données | Modifiez la propriété Length . |
| Modifier le type de données d'un élément de données | Modifiez la propriété Type de données de base ou Type de date . |
| Ajouter un champ personnalisé | Insérez un nœud de schéma Élément de champ enfant et définissez ses propriétés. Note: L’ajout d’un attribut de champ enfant à un enregistrement dans un schéma EDI n’est pas autorisé, car la séquence des éléments n’est pas garantie. La tentative d'ajout d'un attribut de champ enfant entraîne un schéma non valide. Vous pouvez uniquement ajouter un élément de champ enfant à un enregistrement dans un schéma EDI. |
| Ajouter un enregistrement personnalisé | Insérez un nœud de schéma Enregistrement enfant, définissez ses propriétés, puis ajoutez les éléments de champ enfant. |
| Supprimer un champ ou enregistrement personnalisé | Supprimez un champ ou enregistrement personnalisé avec ses éléments de champ enfant. |
| Activer la validation de champ croisé | Définissez l’indicateur de validation entre champs dans l’annotation de la section appinfo du schéma sur Oui. Cet indicateur est X12ConditionDesignator_Check (pour les schémas X12 ou HIPAA) ou EdifactDependencyRule_Check (pour les schémas EDIFACT). Activez la validation de champ croisé pour un élément spécifique en spécifiant les conditions relationnelles (X12 et HIPAA) ou les règles de dépendance (EDIFACT). Pour plus d’informations, consultez Configuration de la validation inter-champs. Vous devez également définir la propriété de validation de type Edi sur oui. La validation de champ croisé est activée par défaut pour les schémas HIPAA. |
| Activer le fractionnement en sous-documents HIPAA | Dans l’un des schémas HIPAA dans lesquels vous pouvez définir le fractionnement du sous-document, définissez les propriétés subdocument_break et Split_Without_Sibling_Data du schéma sur oui et la propriété subdocument_creation_break pour un élément spécifique du schéma sur oui. Vous devez également définir la propriété contrat d’option de traitement par lots entrant sur Fractionner l’échange en tant que ensembles de transactions. Pour plus d’informations, consultez Fractionnement des sous-documents HIPAA. |
| Ajouter des champs déclencheurs à un document HIPAA | Vous pouvez permettre au Désassembleur EDI de créer des enregistrements XML uniques pour un segment de votre document HIPAA, en fonction d'un élément de qualification nommé champ déclencheur. Vous devez spécifier les attributs décrivant le segment et la valeur de déclenchement qui provoque la création d'un enregistrement XML unique pour le segment. Pour plus d’informations, consultez Annotations de champ du déclencheur de schéma HIPAA. |
| Ajouter un segment à un document informatisé X12 | Lorsque vous ajoutez un nouveau segment à un document informatisé X12, les trois premiers caractères du nom du segment servent d'identificateur de segment. Par conséquent, nous vous recommandons de nommer un segment en veillant à ce que les trois premiers caractères soient uniques. |
| Ajouter une boucle à un document informatisé HIPAA | Lorsque vous ajoutez une nouvelle boucle à un document informatisé HIPAA, nous vous recommandons d'inclure « Loop » dans le nom de la boucle. Par exemple, le format d'une boucle est « TS837_2010AB_Loop ». Note: Le premier segment d’une boucle est obligatoire (minOccurs du segment doit être égal à 1) afin d’éviter toute ambiguïté. |
| Ajouter une boucle à sens quelconque à un document informatisé HIPAA | Lorsqu'un document informatisé a des segments équivalents avec des sémantiques différentes, vous devez les définir dans une SubLoop. Un SubLoop avec l’annotation XML de <xs :all> permet aux segments équivalents de se produire dans n’importe quel ordre. Nous vous recommandons d'inclure « SubLoop » dans le nom de la boucle à sens quelconque. Un exemple de format est « TS837Q1_2010A_SubLoop » Remarque : Les éléments d’une boucle d’ordre ne doivent se produire qu’une seule fois dans la boucle. Les frères d'une SubLoop doivent avoir un maxOccurs défini sur 1, afin d'éviter toute ambiguïté. |
Pour modifier un schéma EDI existant dans l'Éditeur BizTalk
Dans Visual Studio, ajoutez le schéma que vous souhaitez modifier à un projet et ouvrez le schéma dans l’éditeur BizTalk.
Notes
Vous pouvez afficher le schéma sous forme graphique en cliquant sur l’onglet EDI en bas de l’écran Éditeur de schéma. Il est beaucoup plus facile d'accéder aux nœuds du schéma à l'aide de ce format tabulaire.
Pour modifier les propriétés d'un élément ou enregistrement de données, cliquez sur le nœud approprié sur le volet gauche de l'Éditeur BizTalk, puis modifiez ses propriétés dans la fenêtre Propriétés.
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 ou supprimez de la liste des valeurs, si nécessaire, en veillant à ce qu’il y ait une valeur sur chaque ligne dans le volet Valeurs . Cliquez sur OK.
Pour ajouter un champ personnalisé au schéma, cliquez avec le bouton droit sur un nœud d’enregistrement dans l’arborescence de console de BizTalk Editor, pointez sur Insérer un nœud de schéma, puis cliquez sur Élément champ enfant. Nommez l'élément de données, puis faites glisser l'élément de données sur la position appropriée dans l'enregistrement. Définissez les propriétés de champ personnalisé comme requises.
Notes
L'ajout d'un attribut de champ enfant à un enregistrement dans un schéma EDI n'est pas autorisé car la séquence des éléments ne serait pas garantie. La tentative d'ajout d'un attribut de champ enfant entraîne un schéma non valide.
Pour ajouter un enregistrement personnalisé au schéma, cliquez avec le bouton droit sur un nœud d’enregistrement dans l’arborescence de la console de l’Éditeur de schéma, pointez sur Insérer un nœud de schéma, puis cliquez sur Enregistrement enfant. Nommez l'enregistrement, puis faites glisser l'enregistrement sur la position appropriée dans le schéma. Ajoutez au moins un élément de données à l'enregistrement. Définissez les propriétés de l'enregistrement personnalisé comme requises.
Après avoir apporté les modifications souhaitées au schéma, vous pouvez modifier l’espace de noms cible qui s’applique à la propriété de schéma en cliquant sur le nœud racine (<Schéma>), puis en modifiant la propriété Espace de noms cible .
Enregistrez le schéma.
Validez le schéma en cliquant avec le bouton droit sur le schéma dans Explorateur de solutions, puis en cliquant sur Valider le schéma.
Notes
La commande Valider le schéma EDI valide le schéma EDI, car la propriété Extension de l’éditeur de schéma du nœud racine (<Schéma>) est définie sur Extension de l’éditeur de schéma EDI.
Pour modifier les propriétés d'annotation dans un schéma EDI existant
Ouvrez le schéma dans un éditeur de texte, tel que le Bloc-Notes.
Pour activer la validation de champ croisé, procédez comme suit. Pour plus d’informations, consultez Configuration de la validation inter-champs.
Dans l’annotation appinfo en haut du schéma, définissez l’indicateur de validation inter-champs ( X12ConditionDesignator_Check pour les schémas X12 ou HIPAA ou EdifactDependencyRule_Check pour les schémas EDIFACT) sur Oui.
Notes
L’indicateur de validation inter-champs est Oui par défaut pour BizTalk Server schémas HIPAA.
Dans l'annotation pour un élément spécifique, spécifiez les conditions relationnelles (X12 ou HIPAA) ou les règles de dépendance (EDIFACT) pour l'élément. Pour plus d’informations sur ces paramètres, consultez Validation Field-Segment croisée.
Notes
Dans la page Validation (sous la section Paramètres de l’ensemble de transactions) de l’onglet Contrat unidirectionnel de la boîte de dialogue Propriétés du contrat correspondant, vérifiez que la propriété Validation de type EDI est sélectionnée.
Pour activer le fractionnement en sous-documents HIPAA, procédez comme suit. Pour plus d’informations, consultez Fractionnement des sous-documents HIPAA.
Dans l’annotation appinfo en haut du schéma, définissez les indicateurs subdocument_break et Split_Without_Sibling_Data sur Oui.
Dans l’annotation appinfo d’un élément spécifique, consultez l’indicateur subdocument_creation_break sur oui.
Notes
Dans la page Paramètres de l’hôte local (sous la section Paramètres d’échange ) de l’onglet Contrat unidirectionnel de la boîte de dialogue Propriétés du contrat correspondant, vérifiez que la propriété de l’option Traitement par lots entrants est définie sur Fractionner l’échange en tant que Jeux de transactions.