Partager via

AS2 via FILE (exemple BizTalk Server)

  • Article

L'exemple AS2 via FILE présente la réception d'un message AS2 via un emplacement de réception FILE. Cela vous permet d'utiliser un adaptateur FILE pour recevoir le message AS2, plutôt qu'un adaptateur HTTP normalement utilisé. Pour ce faire, cette solution écrit les en-têtes HTTP du message AS2 dans la propriété de contexte InboundHTTPHeaders, comme requis par le Décodeur AS2.

Fonctions de l'exemple

Cet exemple illustre le traitement des en-têtes HTTP d'un message AS2 sans adaptateur HTTP. Plus précisément, cet exemple effectue les opérations suivantes :

  1. Lorsque vous déposez le message test dans un dossier d'entrée, l'emplacement de réception FILE le récupère.

  2. Le composant de pipeline personnalisé dans le pipeline de réception AS2 personnalisé traite le message, en écrivant ses en-têtes HTTP dans la propriété de contexte InboundHTTPHeaders.

    Notes

    En cas d'échec du traitement du message en aval du composant de pipeline personnalisé, la reprise du traitement du message risque d'être difficile car il est déjà converti en code XML.

  3. Le Décodeur AS2 dans le pipeline de réception personnalisé traite le message, en lisant les propriétés dans la propriété de contexte InboundHTTPHeaders.

  4. Un port d'envoi s'abonne au message XML généré par le pipeline de réception, le transmet par l'intermédiaire d'un pipeline d'envoi PassThrough et le dépose dans un dossier de sortie.

Accès à l'exemple

Cet exemple se trouve dans le dossier d’installation BizTalk Server : \Program Files (x86)\Microsoft BizTalk Server <SDK VERSION>\Samples\AS2\AS2 Over File.

Le tableau suivant présente les fichiers de cet exemple et décrit leur fonction.

Fichier(s) Description
AS2OverFile.csproj Projet contenant le code du composant de pipeline personnalisé.
AS2OverFile.sln Solution contenant le projet AS2OverFile.btproj.
Program.cs Inclut des classes représentant des données d'en-têtes.
SampleMessage.txt Exemple de message contenant des en-têtes HTTP.

Implémentation et exécution de cet exemple

Pour implémenter l'exemple AS2 via FILE, vous devez effectuer les opérations suivantes :

  • Créer et déployer le projet BizTalk pour cet exemple, puis créer le composant de pipeline personnalisé

  • Créer un pipeline personnalisé à l'aide du composant de pipeline personnalisé, puis créer et déployer un projet avec ce pipeline personnalisé

  • Créer des dossiers de fichiers d'entrée et de sortie

  • Configurer un port et un emplacement de réception, puis activer l'emplacement de réception

  • Configurer un port d'envoi, puis le démarrer

  • Créer un tiers pour l'envoi de l'exemple de message.

Pour créer un pipeline personnalisé avec le composant de pipeline Émulateur AS2 via FILE

  1. Dans Visual Studio, ouvrez le projet AS2OverFile dans le dossier \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\AS2\AS2 Over File.

  2. Créez un fichier de clé de nom fort, ouvrez la boîte de dialogue Propriétés du projet AS2OverFile, puis attribuez le fichier de clé au projet.

  3. Créez le projet.

  4. Dans Visual Studio, créez un projet BizTalk nommé AS2OverFile_Pipeline.

  5. Cliquez avec le bouton droit sur le projet AS2OverFile_Pipeline, pointez sur Ajouter, puis cliquez sur Nouvel élément.

  6. Dans la boîte de dialogue Ajouter un nouvel élément , sélectionnez Fichiers de pipeline dans le volet gauche, sélectionnez Pipeline de réception dans le volet de droite, nommez le pipeline AS2OverFile_Receive.btp, puis cliquez sur Ajouter.

  7. Cliquez sur Affichage dans la barre de menus, puis sur Boîte à outils pour afficher la boîte à outils.

  8. Dans la boîte à outils, cliquez avec le bouton droit sur Composants de pipeline BizTalk, puis cliquez sur Choisir des éléments.

  9. Dans la boîte de dialogue Choisir des éléments de boîte à outils , cliquez sur l’onglet Composants de pipeline BizTalk . Cliquez sur AS2 Sur l’émulateur de fichiers, puis sur OK.

  10. Ajoutez le fichier AS2OverFile.dll au global assembly cache en ouvrant une invite de commandes Visual Studio et en exécutant la commande gacutil /if "<file name and path>" sur le Microsoft.BizTalk.Sdk.Components.AS2OverFile.dll dans le dossier \AS2 Over File\obj\Debug.

  11. Dans Visual Studio, faites glisser le composant de pipeline AS2 Over File Emulator de la boîte à outils vers la phase Décodage du pipeline personnalisé.

  12. Faites glisser le composant décodeur AS2 dans l’étape Décodage du pipeline personnalisé, après le composant AS2 Over File.

    Notes

    Si vous voulez générer un MDN, ajoutez un Désassembleur AS2 dans l'étape Désassembler du pipeline personnalisé. Si vous ne renvoyez pas de MDN, le Désassembleur AS2 n'est pas nécessaire.

  13. Créez un fichier de clé de nom fort, ouvrez la boîte de dialogue Propriétés du projet AS2OverFile_Pipeline, puis attribuez le fichier de clé au projet.

  14. Construisez et déployez le pipeline personnalisé.

  15. Dans la console d’administration BizTalk Server, ajoutez le pipeline personnalisé au nœud Pipelines en cliquant sur le nœud Pipelines, puis sur Actualiser.

Pour implémenter la solution de cet exemple

  1. Dans Windows Explorer, dans le dossier \Program Files (x86)\Microsoft BizTalk Server <SDK VERSION>\Samples\AS2\AS2 Over File, créez un dossier d’entrée in et un dossier de sortie.

  2. Dans la console d’administration BizTalk Server, créez un port de réception unidirectionnel nommé AS2OverFile_Receive. Dans le port de réception, créez un emplacement de réception avec les propriétés suivantes :

    Propriété Paramètre
    Nom AS2OverFile_Receive
    Type FILE
    Dossier Receive \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\AS2\AS2 over File/in
    Masque de fichier *.txt
    Pipeline de réception AS2OverFile

  3. Dans le nœud Emplacements de réception, cliquez avec le bouton droit sur le AS2OverFile_Receive emplacement de réception, puis cliquez sur Activer.

  4. Dans le nœud Ports d'envoi, créez un port d'envoi unidirectionnel statique avec les propriétés suivantes :

    Propriété Paramètre
    Nom AS2OverFile_Send
    Type FILE
    Dossier Receive \Program Files (x86)\Microsoft BizTalk Server <>VERSION SDK\Samples\AS2\AS2 over File/Out
    Masque de fichier %IDmessage%.xml
    Pipeline d’envoi Passthru
    Filtrer BTS.REceivePortName == AS2OverFile_Receive

  5. Dans le nœud Ports d’envoi, cliquez avec le bouton droit sur le port d’envoi AS2OverFile_Send, puis cliquez sur Démarrer.

  6. Dans le nœud Tiers, créez un tiers nommé « Partenaire ». À la liste Alias, ajoutez un alias avec le nomEDIINT-AS2 From Value, un qualificateurAS2-From et une valeurpartenaire.

    BizTalk Server est maintenant prêt à utiliser cet exemple.

Exécution de cet exemple

Utilisez la procédure suivante pour exécuter l'exemple AS2 via FILE.

Pour exécuter l'exemple

  1. Copiez le fichier SampleMessage.txt du dossier \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Samples\AS2\AS2 Over File dans le dossier \AS2 Over File\In.

  2. Vérifiez qu'un message XML de sortie est déposé dans le dossier de sortie \AS2 Over File\Out.

  3. Ouvrez le message d’entrée SampleMessage.txt dans un éditeur de texte, puis ouvrez le GUID> du message <de sortie.xml dans un éditeur de texte. Vérifiez que le message d'entrée SampleMessage.txt a des en-têtes HTTP (et AS2) et que le message de sortie n'a pas d'en-têtes HTTP.

Classes ou méthodes utilisées dans l'exemple

None

Voir aussi

EDI et AS2 (dossier d’exemples BizTalk Server)
Envoi d’un message AS2 via un port d’envoi FILE