Partage via


Génération d’une instance (EDI)

Vous pouvez générer une instance de message à partir d’un schéma EDI au moment du design. Pour ce faire, vous utilisez les extensions d’outil XML pour BizTalk Server dans l’environnement Visual Studio.

Vous pouvez générer un échange par lots complet (avec des en-têtes d’échange et de groupe) ou un jeu de transactions (sans en-têtes d’échange et de groupe). Si vous exécutez l’opération pour générer un échange complet, BizTalk Server génère un fichier avec un en-tête d’échange, un groupe pour chaque schéma et trois jeux de transactions identiques par groupe pour chaque schéma. Si vous exécutez l’opération pour générer un jeu de transactions, BizTalk Server génère un fichier avec un seul jeu de transactions.

Pour générer un échange par lots complet, vous exécutez la commande generate-instance sur le schéma de traitement par lots. BizTalk Server détecte les schémas de message dans le projet et inclut automatiquement les jeux de transactions pour ces schémas.

Pour générer un jeu de transactions unique, vous exécutez la commande generate-instance sur un schéma de message. Dans ce cas, le schéma de traitement par lots n’a pas besoin d’être ajouté au projet. Toutefois, l’instance générée n’inclut pas d’en-tête d’échange ou de groupe. Vous devrez donc les ajouter manuellement pour avoir un échange EDI fonctionnel.

Lorsque vous générez une instance, BizTalk Server affiche une boîte de dialogue dans laquelle vous spécifiez la configuration utilisée dans cette instance, y compris les séparateurs et l’identificateur de syntaxe.

Conditions préalables

Vous devez être connecté en tant que membre du groupe Administrateurs BizTalk Server.

Pour générer une instance d’un échange par lots

  1. Dans Visual Studio, ouvrez un projet. Ajoutez un schéma de message au projet dans l’Explorateur de solutions pour chaque type de jeu de transactions souhaité dans l’instance de message. Ajoutez le schéma de lot pour le type d’encodage au projet : Edifact_BatchSchema.xsd ou X12_BatchSchema.xsd.

    Remarque

    Les schémas de lot se trouvent dans le dossier \Program Files (x86)\Microsoft BizTalk Server <VERSION>XSD_Schema\EDI.

    Remarque

    Vous n'avez pas besoin de construire le projet pour créer une instance.

  2. Cliquez avec le bouton droit sur le schéma de traitement par lots dans l’Explorateur de solutions, puis cliquez sur Propriétés.

  3. Dans la fenêtre Propriétés , définissez Generate Instance Output Type sur Native ou XML. La sélection de Native invite la génération d’un fichier plat avec une extension .txt. La sélection du code XML invite la génération d’un fichier XML.

  4. Pour le nom de fichier de l’instance de sortie, entrez un nom ou accédez à un fichier, puis sélectionnez le fichier.

    Remarque

    Si vous n’entrez pas de valeur pour le nom de fichier de l’instance de sortie, vous en aurez choisi une. Le nom de fichier s’affiche dans la fenêtre Sortie de Visual Studio.

    Remarque

    Si vous sélectionnez un fichier existant, le contenu du fichier existant sera remplacé par le contenu généré par cette opération.

  5. Cliquez avec le bouton droit sur le schéma de lot, puis cliquez sur Générer une instance.

  6. Dans la boîte de dialogue Propriétés de l’instance EDI , sélectionnez les séparateurs, les identificateurs et d’autres options de configuration à utiliser dans cette instance, puis cliquez sur OK.

  7. Vérifiez que l’opération a fonctionné dans la fenêtre Sortie .

  8. Pour afficher le fichier, appuyez sur Ctrl et cliquez sur le lien dans la fenêtre Sortie . Visual Studio affiche le contenu du fichier dans la fenêtre Éditeur BizTalk.

    Remarque

    Lors de la génération d’une instance qui contient un 837I, 837D ou 837P, la valeur de GS08 est incorrectement définie sur 00401. Pour plus d’informations, consultez Problèmes connus liés aux outils XML utilisés avec des solutions EDI.

Pour générer une instance d’un jeu de transactions

  1. Dans Visual Studio, ouvrez un projet. Ajoutez le schéma pour le type de jeu de transactions pour lequel vous souhaitez générer une instance.

    Remarque

    Vous n’avez pas besoin d’ajouter le schéma de lot au projet pour générer une instance d’un jeu de transactions.

    Remarque

    Vous n’avez pas besoin de construire le projet pour générer une instance.

  2. Cliquez avec le bouton droit sur le schéma du message dans l’Explorateur de solutions, puis cliquez sur Propriétés.

  3. Dans la fenêtre Propriétés, définissez Generate Instance Output Type sur Native ou XML. La sélection de Native invite la génération d’un fichier plat avec une extension .txt. La sélection du code XML invite la génération d’un fichier XML.

  4. Pour le nom de fichier de l’instance de sortie, entrez un nom ou accédez à un fichier, puis sélectionnez le fichier.

    Remarque

    Si vous n’entrez pas de valeur pour le nom de fichier de l’instance de sortie, vous en aurez choisi une. Le nom de fichier s’affiche dans la fenêtre Sortie de Visual Studio.

    Remarque

    Si vous sélectionnez un fichier existant, le contenu du fichier existant sera remplacé par le contenu généré par cette opération.

  5. Cliquez avec le bouton droit sur le schéma du message, puis cliquez sur Générer une instance.

  6. Dans la boîte de dialogue Propriétés de l’instance EDI , sélectionnez les options de configuration souhaitées, puis cliquez sur OK.

  7. Vérifiez qu’il existe un message dans la fenêtre Sortie indiquant que l’opération a réussi.

  8. Pour afficher le fichier, appuyez sur Ctrl et cliquez sur le lien dans la fenêtre Sortie. BizTalk Server affiche le contenu du fichier dans la fenêtre Éditeur BizTalk.

  9. Pour créer un message EDI fonctionnel, ajoutez les en-têtes d’échange et de groupe au message dans un éditeur de texte.

Voir aussi

Utilisation des outils XML Design-Time
Validation d’une instance (EDI)