Partage via

Didacticiel : écriture de données vers PeopleSoft Enterprise à l'aide de l'adaptateur BizTalk pour PeopleSoft Enterprise

  • Article

L'adaptateur BizTalk pour PeopleSoft Enterprise permet d'écrire des données dans un système PeopleSoft à l'aide des informations reçues d'un partenaire commercial ou d'une application interne. Cette procédure pas à pas décrit un exemple de Kit de développement logiciel (SDK) qui illustre ces fonctionnalités.

Prérequis

  • La plateforme Java 2 doit être installée sur le BizTalk Server sur lequel l’adaptateur BizTalk pour PeopleSoft Enterprise s’exécute.

  • Le fichier JAR de l’adaptateur d’objet Java PeopleSoft, psjoa.jar doit être copié dans un dossier accessible au BizTalk Server sur lequel l’adaptateur BizTalk pour PeopleSoft Enterprise s’exécute.

  • Visual Studio doit être installé sur le BizTalk Server sur lequel l’adaptateur BizTalk pour PeopleSoft Enterprise s’exécute afin de générer et de déployer l’exemple.

Fonctions de l'exemple

Cet exemple récupère un fichier XML dans un dossier, le transmet à une orchestration, puis utilise l'adaptateur BizTalk pour PeopleSoft Enterprise pour créer un enregistrement dans le système PeopleSoft pour les données dans le fichier XML.

Comment cet exemple est conçu et pourquoi

Cet exemple a été conçu dans Visual Studio et a été créé pour illustrer les fonctionnalités de base à l’aide de l’adaptateur BizTalk pour PeopleSoft Enterprise avec une orchestration BizTalk.

Accès à l'exemple

L'exemple se trouve dans le dossier suivant :

\Program Files\Microsoft BizTalk Adapters for Enterprise Applications\PeopleSoft Enterprise(r)\Sdk\PeopleSoftOneWaySend

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

Nom du fichier de projet au moment de l'exécution Description du fichier de projet au moment de l'exécution
OneWaySend.btproj,

OneWaySend.sln		 Fichiers de projet et de solution de l'application.
LOCATIONService.xsd,

LOCATIONService_1.xsd,

LOCATIONService_2.xsd		 Fichiers de schéma de l'application. Note: Les fichiers de schéma d’adaptateur dans le projet ont été créés à l’origine à l’aide de l’Assistant Ajout de métadonnées d’adaptateur. Pour plus d’informations sur l’Assistant Ajout de métadonnées d’adaptateur, consultez la rubrique « Comment ajouter des métadonnées d’adaptateur à un projet BizTalk » dans la documentation BizTalk Server.
PeopleSoftOneWaySend.odx Orchestration utilisée par l'application.
PeopleSoftOneWaySend.snk Fichier de clé de nom fort.

Guide pratique pour utiliser cet exemple

Pour créer une instance de l'adaptateur PeopleSoft Enterprise

  1. Lancez la console d’administration BizTalk Server. Cliquez sur Démarrer, Tous les programmes, Microsoft BizTalk Server 20xx,BizTalk Server Administration.

  2. Dans la console d’administration BizTalk Server, développez BizTalk Server Administration, Groupe BizTalk, Paramètres de la plateforme, puis cliquez sur Adaptateurs.

  3. Cliquez avec le bouton droit sur Adaptateurs et pointez sur Nouveau, Adaptateur... pour afficher la boîte de dialogue Propriétés de l’adaptateur.

  4. Entrez une valeur pour le champ Nom , par exemple PeopleSoft.

  5. Sélectionnez PeopleSoft Enterprise(r) dans la liste des adaptateurs disponibles dans la liste déroulante Adaptateur , puis cliquez sur OK.

Pour créer un port d'envoi BizTalk

  1. Dans la console d’administration BizTalk Server, développez BizTalk Server Administration, Groupe BizTalk, Applications, Application BizTalk 1, puis cliquez sur Envoyer des ports.

  2. Cliquez avec le bouton droit sur Ports d’envoi et pointez sur Nouveau, statique One-Way Port d’envoi pour afficher la boîte de dialogue Propriétés du port d’envoi .

  3. Entrez une valeur pour le champ Nom , par exemple PeopleSoftOneWaySP.

  4. Sélectionnez l’adaptateur PeopleSoft dans la liste des adaptateurs disponibles dans la zone de liste déroulante Type , puis cliquez sur le bouton Configurer pour afficher la boîte de dialogue Propriétés de transport de l’adaptateur.

    Notes

    Cette valeur est le nom qui a été spécifié lors de la création de l’adaptateur PeopleSoft Enterprise dans la console d’administration BizTalk Server.

  5. Entrez les valeurs suivantes pour les propriétés requises de l’adaptateur :

    Propriété Valeur
    Chemin d'accès au serveur de l'application Emplacement de l'ordinateur et du port du serveur de PeopleSoft, par exemple //PSServer:8888 Note: Si vous ne spécifiez pas de numéro de port, le port par défaut 9000 est utilisé. Ainsi, dans l’exemple ci-dessus, vous pouvez entrer la valeur //PSServer si le serveur PeopleSoft utilise la valeur de port par défaut 9000.
    JAVA_HOME Chemin d'accès au répertoire de base associé aux fichiers du Kit de développement logiciel de la plateforme Java 2, par exemple C:\j2sdk1.4.2_08
    Mot de passe Mot de passe de connexion au système PeopleSoft.
    Fichiers JAR PeopleSoft 8.x Emplacement du fichier JAR de l’adaptateur d’objet Java PeopleSoft, psjoa.jar, par exemple C :\JARS\psjoa.jar.
    Nom d’utilisateur Nom d'utilisateur pour la connexion au système PeopleSoft.

  6. Cliquez sur OK.

  7. Sélectionnez le pipeline de transmission XML dans la liste des pipelines disponibles dans la liste déroulante Envoyer le pipeline , puis cliquez sur OK.

  8. Cliquez avec le bouton droit sur le port d’envoi, puis cliquez sur Démarrer pour inscrire et démarrer le port d’envoi.

Pour créer un port de réception du fichier

  1. Dans la console d’administration BizTalk Server, développez BizTalk Server Administration, Groupe BizTalk, Applications, BizTalk Application 1, puis cliquez sur Ports de réception.

  2. Cliquez avec le bouton droit sur le dossier Ports de réception, puis cliquez sur Nouveau port de réception unidirectionnel pour afficher la boîte de dialogue Propriétés du port de réception.

  3. Entrez une valeur pour le champ Nom , par exemple PeopleSoftOneWayFileRP, puis cliquez sur OK.

Pour créer un emplacement de réception du fichier

  1. Créez un dossier à surveiller par l'emplacement de réception du fichier (par exemple, C:\Filesource).

  2. Cliquez avec le bouton droit sur le nouveau port de réception, puis cliquez sur Nouveau, Emplacement de réception pour afficher la boîte de dialogue Propriétés de l’emplacement de réception.

  3. Entrez une valeur pour le champ Nom , par exemple PeopleSoftOneWayFileRL.

  4. Sélectionnez FICHIER dans la liste des adaptateurs disponibles dans la zone de liste déroulante Type , puis cliquez sur le bouton Configurer pour afficher la boîte de dialogue Propriétés de transport de l’adaptateur.

  5. Entrez l’emplacement du dossier que vous avez créé précédemment pour la propriété Receive Folder et cliquez sur OK.

  6. Sélectionnez XMLReceive dans la liste des pipelines disponibles dans la zone de liste déroulante Recevoir le pipeline , puis cliquez sur OK.

  7. Cliquez avec le bouton droit sur l’emplacement de réception, puis cliquez sur Activer.

Pour modifier la propriété d'espace de noms cible du schéma de l'adaptateur

  1. Lancez Visual Studio et ouvrez OneWaySend.sln. Cliquez sur Fichier, Ouvrir, Projet/Solution... pour afficher la boîte de dialogue Ouvrir le projet .

  2. Accédez au fichier OneWaySend.sln, cliquez pour sélectionner ce fichier, puis cliquez sur Ouvrir pour ouvrir la solution qui contient l’exemple de projet.

  3. Cliquez sur le menu Affichage et sélectionnez Explorateur de solutions pour afficher le Explorateur de solutions.

  4. Double-cliquez sur le fichier LOCATIONService_1.xsd dans l'Explorateur de solutions pour l'ouvrir.

  5. Cliquez avec le bouton droit sur le nœud Schéma de LOCATIONService_1.xsd et sélectionnez l’option de menu Propriétés pour afficher les propriétés du schéma.

  6. Modifiez la propriété Espace de noms cible pour utiliser les valeurs appropriées pour le nom de l’adaptateur. Par exemple, la propriété Espace de noms cible doit se lire comme suit :

    http://schemas.microsoft.com/[PeopleSoft://CI/LOCATION]

    Où PeopleSoft est le nom de l’adaptateur PeopleSoft comme indiqué dans la console d’administration BizTalk.

    Important

    Si la valeur configurée pour l’espace de noms cible ne correspond pas à l’espace de noms spécifié dans le document d’entrée instance un échec de routage se produit lorsque le document d’entrée instance est traité par BizTalk Server.

Pour générer une instance de document à partir du schéma de l'adaptateur

  1. Double-cliquez sur LOCATIONService_1.xsd dans le Explorateur de solutions pour ouvrir le fichier dans l’Éditeur de schéma.

  2. Cliquez avec le bouton droit sur le <nœud Schéma> dans l’Éditeur de schéma, puis cliquez sur Propriétés pour afficher les propriétés du nœud.

  3. Sélectionnez CréerEx dans la liste des nœuds disponibles dans la zone de liste déroulante Référence racine . Cette opération doit être effectuée afin que lorsque vous générez un exemple de document instance il soit généré à partir du nœud CreateEx du schéma.

  4. Cliquez avec le bouton droit sur LOCATIONService_1.xsd dans Explorateur de solutions, puis cliquez sur Propriétés.

  5. Dans le Fenêtre Propriétés, cliquez pour sélectionner l’option Nom de fichier de l’instance de sortie sous la section Général.

  6. Cliquez sur le bouton de sélection (...) pour afficher la boîte de dialogue Sélectionner un fichier de sortie .

  7. Spécifiez un dossier et un nom pour le fichier de sortie instance, par exemple C:\instance.xml et cliquez sur Enregistrer.

    Notes

    Ne spécifiez pas l'emplacement de dossier spécifié pour l'emplacement de réception du fichier dans ce champ.

  8. Cliquez avec le bouton droit sur LOCATIONService_1.xsd dans Explorateur de solutions, puis cliquez sur Générer une instance pour générer un document instance à l’emplacement spécifié.

  9. Cliquez avec le bouton droit sur le <nœud Schéma> dans l’Éditeur de schéma, puis cliquez sur Propriétés pour afficher les propriétés du nœud.

  10. Sélectionnez (Par défaut) dans la liste des nœuds disponibles dans la zone de liste déroulante Référence racine .

Pour modifier l'instance de document générée

  1. Ouvrez l'instance de document générée dans un éditeur de texte tel que le Bloc-notes et modifiez le contenu de telle sorte que les données de ces champs génèrent un enregistrement unique dans le système PeopleSoft : par exemple, le fichier XML ci-dessous décrit les champs d'un enregistrement qui définit un emplacement :

    <ns0:CreateEx xmlns:ns0="http://schemas.microsoft.com/[PeopleSoft://CI/LOCATION]">  
  <ns0:SETID>SHARE</ns0:SETID>  
  <ns0:LOCATION>9991</ns0:LOCATION>  
  <ns0:interactiveMode>true</ns0:interactiveMode>  
   <ns0:properties>  
    <ns0:LOCATION_TBL_sequence>  
      <ns0:LOCATION_TBL>  
        <ns0:COUNTRY>USA</ns0:COUNTRY>  
        <ns0:DESCR>Adapter Test</ns0:DESCR>  
        <ns0:EFFDT>2006-05-31</ns0:EFFDT>  
        <ns0:EFF_STATUS>A</ns0:EFF_STATUS>  
        <ns0:SETID>SHARE</ns0:SETID>  
      </ns0:LOCATION_TBL>  
    </ns0:LOCATION_TBL_sequence>  
  </ns0:properties>  
</ns0:CreateEx>

    Notes

    Dans l’exemple ci-dessus, PeopleSoft est un espace réservé pour le nom réel de l’adaptateur, comme indiqué dans la console d’administration BizTalk.

  2. Enregistrez l'instance de document modifiée.

création et déploiement du projet ;

  1. Cliquez avec le bouton droit sur le projet OneWaySend dans Explorateur de solutions, puis cliquez sur Propriétés pour lancer le projet Designer.

  2. Cliquez sur l’onglet Déploiement .

  3. Entrez les valeurs appropriées pour la propriété Server et la propriété Base de données de configuration sous Groupe BizTalk.

  4. Cliquez avec le bouton droit sur le projet OneWaySend dans Explorateur de solutions, puis cliquez sur Déployer pour générer le projet et déployer l’assembly dans la base de données de configuration BizTalk Server.

Pour lier et inscrire l'orchestration

  1. Dans la console d’administration BizTalk Server, développez BizTalk Server Administration, Groupe BizTalk, Applications, Application BizTalk 1, puis cliquez sur Orchestrations.

  2. Cliquez sur le bouton Actualiser dans la barre d’outils MMC ou appuyez sur la touche F5 de votre clavier pour actualiser l’affichage de la console d’administration BizTalk Server.

  3. Double-cliquez sur l’orchestration pour afficher la boîte de dialogue Propriétés de l’orchestration .

  4. Cliquez sur Liaisons dans le volet gauche de la boîte de dialogue pour afficher les options Liaisons pour l’orchestration.

  5. Spécifiez les valeurs appropriées pour les options de liaison, par exemple :

    Paramètre Valeur
    Host BizTalkServerApplication
    FileReceivePort PeopleSoftOneWayFileRP
    PeopleSoftOneWaySendPort PeopleSoftOneWaySP

  6. Cliquez sur OK.

Démarrer l'orchestration

  • Dans la console d’administration BizTalk Server, cliquez avec le bouton droit sur l’orchestration, puis cliquez sur Démarrer pour inscrire et démarrer l’orchestration.

Pour placer une instance de document dans le dossier surveillé par l'emplacement de réception du fichier

  • Copiez l'instance de document créée précédemment dans le dossier surveillé par l'emplacement de réception du fichier.

Pour vérifier la mise à jour du système PeopleSoft

  • Utilisez l'interface Web PeopleSoft pour vérifier que l'enregistrement a été créé à partir des données du fichier XML.

    La séquence suivante d'événements se produit si l'instance de document est traitée avec succès :

  1. L'adaptateur FILE récupère le fichier dans le dossier et le publie dans la base de données MessageBox comme message BizTalk.

  2. L'orchestration s'abonne à ce message publié et le moteur de messagerie BizTalk active une instance de l'orchestration avant d'envoyer le message à l'instance d'orchestration.

  3. L'instance d'orchestration traite le message à l'aide de la logique spécifiée dans l'orchestration, puis republie le message dans la base de données MessageBox.

  4. Le port d'envoi PeopleSoft s'abonne à ce message publié et le moteur de messagerie BizTalk envoie le message au port d'envoi PeopleSoft.

  5. Le port d'envoi remet le message à l'adaptateur BizTalk pour PeopleSoft Enterprise.

  6. L'adaptateur BizTalk pour PeopleSoft Enterprise appelle la méthode CreateEx pour créer un enregistrement à l'aide des données du fichier XML.

Voir aussi

Didacticiels : Utilisation de l’adaptateur BizTalk pour PeopleSoft Enterprise