Partage via

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

  • Article

L'adaptateur BizTalk pour PeopleSoft Enterprise permet d'exécuter une requête sur un système PeopleSoft et de renvoyer les résultats de la requête. 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 Geis 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 exécuter une requête dans le système PeopleSoft. Le résultat de la requête est écrit dans un 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\PeopleSoftTwoWaySend

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
TwoWaySend.btproj,

TwoWaySend.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.
PeopleSoftTwoWaySend.odx Orchestration utilisée par l'application.
PeopleSoftTwoWaySend.snk Fichier de clé de nom fort.

Comment 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, Programmes, MicrosoftBizTalk Server, BizTalk Server Administration.

  2. Dans la console d’administration BizTalk Server, développez BizTalk Server Administration, BizTalk Group, 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 cartes disponibles dans la liste déroulante Adaptateur , puis cliquez sur OK.

Pour créer un port d'envoi BizTalk de type sollicitation-réponse

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

  2. Cliquez avec le bouton droit sur Ports d’envoi et pointez sur Nouveau port statique Solicit-Response 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 PeopleSoftTwoWaySP.

  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 du transport de l’adaptateur.

    Notes

    Cette valeur correspond au nom spécifié lors de la création de l'adaptateur PeopleSoft Enterprise dans la console Administration.

  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é. Dans l’exemple ci-dessus, vous pouvez donc entrer la valeur //PSServer si PeopleSoft Server 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 XMLTransmit dans la liste des pipelines disponibles dans la liste déroulante Envoyer le pipeline .

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

  9. 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 d'envoi BizTalk unidirectionnel

  1. Créez un dossier cible destiné à l'usage du port d'envoi (par exemple, C:\Files\Out).

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

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

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

  5. 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 du transport de l’adaptateur.

  6. Entrez l’emplacement du dossier que vous avez créé précédemment pour la propriété Dossier de destination , puis cliquez sur OK.

  7. Sélectionnez le pipeline XMLTransmit 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, BizTalk Group, 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 Nouveauport 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 PeopleSoftTwoWayFileRP, 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:\Files\In).

  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 PeopleSoftTwoWayFileRL.

  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 du transport de l’adaptateur.

  5. Entrez l’emplacement du dossier que vous avez créé précédemment pour la propriété Dossier de réception , puis 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 TwoWaySend.sln. Cliquez sur Fichier, Ouvrir, Projet/Solution pour afficher la boîte de dialogue Ouvrir un projet .

  2. Accédez au fichier TwoWaySend.sln, sélectionnez 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 Server.

    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 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 Obtenir dans la liste des nœuds disponibles dans la zone de liste déroulante Référence racine . Cela doit être fait de sorte que lorsque vous générez un exemple de document instance il soit généré à partir du nœud Get du schéma.

  4. Cliquez avec le bouton droit sur LOCATIONService_1.xsd dans Explorateur de solutions, puis cliquez sur Propriétés pour afficher les propriétés dans le Fenêtre 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.

  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-en le contenu de telle sorte que les données de ces champs génèrent un enregistrement existant :

    <ns0:Get xmlns:ns0="http://schemas.microsoft.com/[PeopleSoft://CI/LOCATION]">  
<ns0:SETID>SHARE</ns0:SETID>  
<ns0:LOCATION>WFKLOC</ns0:LOCATION>  
<ns0:getHistory>true</ns0:getHistory>  
</ns0:Get>

    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. SHARE et WFKLOC sont des espaces réservés pour les valeurs utilisées pour identifier un enregistrement particulier dans le système PeopleSoft.

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

création et déploiement du projet ;

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

  2. Cliquez sur l’onglet Déploiement dans le Designer Projet.

  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 TwoWaySend 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 BizTalk Server Console d’administration ou appuyez sur la touche F5 de votre clavier pour actualiser l’affichage BizTalk Server Console d’administration.

  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 PeopleSoftTwoWayFileRP
    PeopleSoftTwoWaySend678 PeopleSoftTwoWaySP
    ResponsePort PeopleSoftTwoWayFileSP

  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.

Vérifiez que l'instance de document a été traitée par l'adaptateur BizTalk pour PeopleSoft Enterprise.

  • Ouvrez le dossier utilisé par le port d'envoi du fichier et vérifiez qu'un document de sortie a été généré. Ce fichier doit contenir les résultats de la requête traitée par l'adaptateur BizTalk pour PeopleSoft Enterprise.

    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é afin que le moteur de messagerie BizTalk active une instance de l’orchestration et envoie le message à l’instance d’orchestration.

  3. L'instance d'orchestration republie le message dans la base de données MessageBox.

  4. Le port d'envoi de type sollicitation-réponse 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 exécute une instruction Get sur le système PeopleSoft à l'aide des paramètres définis dans le fichier d'entrée.

  7. L'adaptateur BizTalk pour PeopleSoft Enterprise renvoie les résultats de l'instruction Get comme message de réponse pour le port de sollicitation-réponse dans l'orchestration.

  8. L'orchestration publie l'ensemble des résultats dans la base de données MessageBox.

  9. Le port d'envoi du fichier s'abonne à ce message et BizTalk envoie le message à l'adaptateur FILE.

  10. L'adaptateur FILE écrit le message contenant l'ensemble des résultats dans le dossier de sortie désigné.

Voir aussi

Didacticiels : Utilisation de l’adaptateur BizTalk pour PeopleSoft Enterprise