PeopleSoft

Les connecteurs PeopleSoft permettent la synchronisation des données entre PeopleSoft et RAC/M Identity.

Connecteur de lecture

INFO

Le connecteur de lecture PeopleSoft est un connecteur SQL scripté.

Le connecteur PeopleSoft permet le transfert de données de PeopleSoft vers RAC/M Identity en établissant une connexion directe à la base de données PeopleSoft.

INFO

Le connecteur de lecture de PeopleSoft a été créé à des fins de performance. Bien que le connecteur d'écriture puisse théoriquement gérer les opérations de recherche, les requêtes ne sont pas efficaces.

WARNING

Bien que le connecteur SQL scripté soit capable de gérer la modification demandée par le serveur ICF, il n'est pas recommandé. Les modifications apportées à PeopleSoft doivent être effectuées par l'intermédiaire d'une interface de composant (CI), ce qui est l'approche utilisée par le connecteur Write.

Configuration

Les paramètres suivants sont nécessaires:

Configuration	Description
URL de connexion JDBC	L'URL de connexion JDBC pour se connecter à la base de données, par exemple jdbc:oracle:thin:@//<url>:<port>/<dbName>
Pilote JDBC	oracle.jdbc.driver.OracleDriver
Utilisateur	L'utilisateur pour la connexion.
Mot de passe utilisateur	Le mot de passe pour la connexion.
Langage de script	groovy
Nom du fichier de script du schéma	Le chemin du fichier du script de schéma, par exemple ./ICF/reference-scripts/oracle-peoplesoft/SchemaOraclePeopleSoftHCM.groovy.
Nom du fichier de script de recherche	Le chemin du fichier du script de recherche, par exemple ./ICF/reference-scripts/oracle-peoplesoft/SearchOraclePeopleSoft.groovy.

Connecteur d'écriture

INFO

Le connecteur d'écriture PeopleSoft est un connecteur d'API scripté. Veuillez consulter la documentation de l'API scripté pour plus de détails.

Le connecteur PeopleSoft permet la synchronisation des données entre PeopleSoft et RAC/M Identity. Pour ce faire, le connecteur utilise le serveur Jolt disponible sur l'instance PeopleSoft via des bibliothèques Java.

Comme tous les scripts utilisés par le connecteur d'API scripté, ce connecteur peut être modifié pour répondre à des exigences spécifiques. Vous pouvez consulter d'autres scripts de référence pour voir comment les scripts peuvent être modifiés.

Configuration

Les paramètres suivants sont requis pour tous les connecteurs Scripted API :

Configuration	Description
Script Path	Chemin vers le script Groovy
API URL	L'URL du serveur Jolt à laquelle se connecter.

Pour l'URL du serveur JOLT, cette URL est composée de l'adresse IP et du port séparés par un deux-points.
Pour le port, la valeur peut être trouvée dans le fichier de configuration /home/psadm2/psft/pt/<version>/appserv/APPDOM/psappsrv.cfg sur la machine où PeopleSoft est installé.
Un exemple de valeur est instance-2222222-1234.subnet00000.vcn111111.oraclevcn.com:9010.

WARNING

Le serveur Jolt peut avoir des gestionnaires (handlers) configurés. Dans ce cas, assurez-vous que les ports des gestionnaires sont également accessibles par le serveur ICF.

D'autres paramètres sont également requis pour le connecteur PeopleSoft.

Authentification

Configuration	Doit contenir
Méthode d'authentification préférée	password
Nom d'utilisateur	Le nom d'utilisateur utilisé pour se connecter à l'API.
Mot de passe	Le mot de passe utilisé pour se connecter à l'API.
Configuration secrète 1	Le mot de passe de connexion au domaine pour Jolt.

Autres particularités

Configuration	Doit contenir
Thread Pool Size	Le nombre de threads à utiliser (par défaut : tous les threads disponibles)

Pour l'URL du server JOLT, cette URL est composé de l'adresse IP et du port séparés par un "deux-points". L'IP est le même que API URL. Pour le port, la valeur peut être trouvée dans le fichier de configuration /home/psadm2/psft/pt/8.61/appserv/APPDOM/psappsrv.cfg sur la machine où est installé PeopleSoft. Un exemple de valeur est instance-20220105-9271.subnet12450112.vcn02564144.oraclevcn.com:9033.

Ajout des librairies Java nécessaires pour le bon fonctionnement du connecteur

Pour certaines fonctionnalités du connecteur, il est nécessaire de fournir les librairies suivantes:

• psjoa.jar
• psft.jar

Ces deux dépendances doivent être déposées dans le répertoire d'installation du serveur ICF sous [Répertoire d'installation du server ICF]/server/lib. Pour le server ICF local à RAC/M, ces dépendances doivent êtres mises sous [Répertoire d'installation de RAC/M]/ICF/server/lib

Dépandence psjoa.jar

Si cette dépandence ne vous est pas fournie, elle est disponible sur la machine où est déployé PeopleSoft sous [PS_HOME]/class/psjoa.jar (Pour une instance de démo, le lien complet est /opt/oracle/psft/pt/ps_home8.61.03/class/psjoa.jar).

Dépendance psft.jar

Si cette dépendance ne vous est pas fourni, elle doit être compilée. Pour la compiler, il faut suivre les étapes suivantes:

• Ouvrir Application Designer (pside.exe) de PeopleSoft et se connecter à l'instance de PeopleSoft.

  Note

  Application Designer est disponible via le logiciel PeopleTools. Celui-ci peut être téléchargé via le site eDelivery de Oracle.

  Pour que Application Designer démarre correctement et soit en mesure de se connecter à l'instance de PeopleSoft, il faut :

  • qu'une instance de Oracle Instant Client soit installé et que le %PATH% pointe vers cette installation. (Si ce n'est pas le cas, l'erreur suivante peut survenir: "Missing or invalid version of SQL library PSORA64")
  • que le fichier tnsnames.ora est disponible dans le répertoire d'installation du Oracle Instant Client (Si ce n'est pas le cas, l'erreur suivante peut survenir: "File: SQL Access ManagerSQL error. Stmt #: 2 Error Position: 0 Return: 12154 - ORA-12154: Cannot connect to database. Cannot find alias CSFTO5 in [Répertoire d'installation du client]\instantclient_23_5\network\admin\tnsnames.ora and LDAP. Help: https://docs.oracle.com/error-help/db/ora-12154/"). Ce fichier est disponible sur la machine où est installé PeopleSoft sous /opt/oracle/psft/db/tnsnames.ora. Voici un exemple valide de ce fichier:

    CSFTO5 =
        (DESCRIPTION =
            (ADDRESS_LIST =
                (ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521))
            )
            (CONNECT_DATA =
                (SERVICE_NAME = CSFTO5)
            )
        )

• Ouvrir n'importe quel "Component Interface"
  • Sélectionner File > Open...
  • Dans "Definition", sélectionner "Component Interface"
  • Dans le champ "Name", entrer "%" puis la touche "Entrée"
  • Double-cliquer sur n'importe quel élément de la liste
• Sélectionner Build > PeopleSoft Apis...
• Dans la fenêtre qui ouvre, sélectionner Build sous Java, sélectionner All sous Select APIs to build
• Noter le Target Directory pour les classes Java qui sont construites
• Cliquer sur OK pour démarrer.

  Note

  Cette opération peut prendre beaucoup de temps. Une fois que l'opération est terminée, le message "Done" apparait dans les journaux de Build.

• Compiler la librairie

  cd [Répertoire noté précédemment]
  javac -cp "[Chemin du fichier vers psjoa.jar]" .\PeopleSoft\Generated\CompIntfc\*.java
  jar cf .\psft.jar .\PeopleSoft\Generated\CompIntfc\*.class