Extension de BTARN avec un nouveau processus PIP
Cette rubrique explique comment étendre Microsoft BizTalk Accelerator pour RosettaNet (BTARN) avec un nouveau schéma PIP (Partner Interface Process). Cela vous permet d’ajouter un schéma basé sur un pip RosettaNet lorsque ce PIP n’est associé à aucun des schémas installés par le programme d’installation BTARN.
Lorsque vous étendez BTARN avec un nouveau PIP, vous déployez le nouveau schéma dans son propre assembly. Vous pouvez également modifier un schéma existant déployé dans l’assembly RNPIPs BTARN. Pour plus d’informations, consultez Modification d’un pip existant dans les PPPN.
Pour étendre BTARN avec un nouveau PIP
Cliquez sur Démarrer, sur Exécuter, tapez cmd, puis cliquez sur OK.
À l’invite de commandes, accédez à <drive> :\Program Files\Microsoft BizTalk 2013 Accelerator for RosettaNet\SDK\Utilities\Schema Generator.
À l’invite de commandes, tapez CScript InstallDTD.vbs, puis appuyez sur Entrée.
Notes
Vous ne devrez effectuer les étapes 1 à 3 qu’une seule fois après avoir installé BizTalk Server.
Démarrez Visual Studio.
Dans le menu Fichier , pointez sur Nouveau, puis cliquez sur Projet.
Dans la boîte de dialogue Nouveau projet, sélectionnez Projets BizTalk dans le volet gauche, puis cliquez sur Vider BizTalk Server Projet dans le volet droit.
Cliquez sur Parcourir et pointez sur le répertoire dans lequel vous souhaitez enregistrer votre projet.
Dans la zone Nom , tapez un nom de projet, par exemple MyCustomPIP, puis cliquez sur OK.
Démarrez l’invite de commandes Visual Studio.
À l’invite de commandes, accédez à l’emplacement entré à l’étape 7, tapez sn -k <project name.snk>, puis appuyez sur Entrée.
Dans Solutions Explorer, cliquez avec le bouton droit sur le nom du projet, puis cliquez sur Propriétés.
Dans la boîte de dialogue Pages de propriétés, cliquez sur Assembly sous Propriétés communes dans le volet gauche.
Dans le volet droit, faites défiler jusqu’à Nom fort, cliquez sur Fichier de clé d’assembly, puis cliquez sur le bouton de sélection (...) dans le volet droit. Accédez à l’emplacement entré à l’étape 7, puis sélectionnez le nom du fichier .snk créé à l’étape 10.
Dans la boîte de dialogue Pages de propriétés, développez Propriétés de configuration, puis cliquez sur Déploiement. Dans le volet droit, cliquez sur Redéployer, sélectionnez
True
, puis cliquez sur OK.Dans Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, pointez sur Ajouter, puis cliquez sur Élément existant.
Dans la boîte de dialogue Ajouter un élément existant , accédez à <drive> :\Program Files\Microsoft BizTalk 2013 Accelerator for RosettaNet\SDK\Schemas, sélectionnez xml.xsd, puis cliquez sur Ajouter.
Téléchargez le PIP que vous allez étendre avec RosettaNet.org. Pour plus d’informations, consultez Incorporation d’un nouveau processus d’interface partenaire.
Dans Explorateur de solutions, développez le nom du projet, cliquez avec le bouton droit sur Référence, puis cliquez sur Ajouter une référence.
Dans la boîte de dialogue Ajouter une référence , cliquez sur Parcourir, puis accédez à <drive> :\Program Files\Microsoft BizTalk 2013 Accelerator for RosettaNet\Bin, puis sélectionnez Microsoft.Solutions.BTARN.Schemas.RNPIPs.dll. Cliquez sur Ouvrir, puis sur OK.
Dans Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, pointez sur Ajouter, puis cliquez sur Ajouter des éléments générés.
Dans la boîte de dialogue Ajouter des éléments générés , dans le volet Catégories , cliquez sur Générer des schémas. Dans le volet Modèles , cliquez sur Générer des schémas, puis sur Ajouter.
Dans la boîte de dialogue Générer des schémas, procédez comme suit :
Propriété Pour Type du document Sélectionnez Schéma DTD. Fichier d'entrée Cliquez sur Parcourir, accédez au dossier qui contient le fichier DTD à partir de RosettaNet.org, sélectionnez le fichier DTD souhaité, puis cliquez sur Ouvrir. Dans la boîte de dialogue Générer des schémas, cliquez sur OK.
Dans Explorateur de solutions, double-cliquez sur le fichier .xsd que vous venez d’importer.
Dans l’Éditeur BizTalk, sélectionnez le < nœud Schéma>.
Dans le Fenêtre Propriétés, faites défiler jusqu’à Type de document. Dans la zone Type de document , code PIP<à trois chiffres>, par exemple PIP3A2. Dans la zone Version du document , tapez v<xx.xx> ou R<xx.xx.xx>, par exemple R01.02. Cette version doit être décrite dans la spécification PIP RosettaNet.
Dans le Fenêtre Propriétés, faites défiler jusqu’à Référence racine. Cliquez sur Référence racine et, dans la liste déroulante, sélectionnez le nœud racine du schéma, par exemple, sélectionnez Pip3C5BillingStatementNotification.
Dans le Fenêtre Propriétés, faites défiler jusqu’à Espace de noms cible. Pour Espace de noms cible, tapez
http://schemas.microsoft.com/biztalk/btarn/2004/{DTD file name}.dtd
, où le nom du fichier DTD est, par exemple , 3C5_MS_R01_00_BillingStatementNotification.dtd.Notes
Cette convention d’affectation de noms pour l’espace de noms cible est requise pour BTARN. Si vous utilisez une autre convention d’espace de noms, BTARN ne traite pas les documents PIP pour la validation du schéma.
Notes
Le nom de fichier DTD dans la propriété d’espace de noms cible inclut le numéro de version du pip. Cela vous permet d’utiliser plusieurs versions du même code PIP.
Dans le Fenêtre Propriétés, faites défiler jusqu’à Importations. Cliquez sur le bouton de sélection (...) en regard de Importations, puis cliquez sur Ajouter.
Dans la boîte de dialogue Sélecteur de types BizTalk , développez <Nom> du projet, Références, Microsoft.Solutions.BTARN.Schemas.RNPIPs, Schémas, sélectionnez Microsoft.Solutions.BTARN.Schemas.RNPIPs.BaseDataTypes, cliquez sur OK, puis à nouveau sur OK .
Cliquez avec le bouton droit sur le nom du projet, puis cliquez sur Déployer.
Cliquez sur Démarrer, pointez sur Tous les programmes, sur MicrosoftBizTalk Server, puis sur administration BizTalk Server.
Dans la console d’administration BizTalk, développez MicrosoftBizTalk Server(Local), puis développez Hôtes. Sous Hôte, cliquez sur BizTalkServerApplication.
Dans le volet droit, cliquez avec le bouton droit sur le nom de l’hôte, puis cliquez sur Redémarrer.
Notes
Après avoir étendu les RNPIP avec un PIP nouvellement importé, vous devez créer la configuration PIP correcte et un contrat à l’aide de ce pip dans la console de gestion BTARN.
Voir aussi
Incorporation d’un nouveau processus PIP
Utilisation des processus PIP
Modification d’un processus PIP existant dans les processus PIP RosettaNet