Présentation

Lors de la définition d'intégrations à l'aide d'Oracle Integration Cloud (OIC), des tâches de configuration doivent être effectuées. Ce tutoriel explique la configuration typique requise pour les intégrations qui utilisent HCM Data Loader (HDL) pour gérer Oracle HCM Cloud.

Objectifs

Dans ce tutoriel, vous allez :

  • Créer des rôles et des comptes d'utilisateur pour accéder à la fonctionnalité du chargeur de données HCM.
  • Créer les connexions OIC nécessaires pour l'intégration d'un serveur FTP à Oracle HCM Cloud.

Préalables

Pour effectuer les étapes de ce tutoriel, vous devez accéder aux éléments suivants :

  • Oracle Integration Cloud (OIC).
  • Console de sécurité pour créer des rôles et des comptes d'utilisateur personnalisés.
  • La tâche Accès aux objets d'affaires du chargeur de données HCM permet de configurer les objets d'affaires pour lesquels vos comptes d'utilisateur HDL peuvent charger des données en masse.

    Ces hiérarchies de rôles permettent d'accéder aux éléments suivants :

    Nom de rôle Code du rôle Accès accordé
    Gérer l'accès aux objets d'affaires du chargeur de données HCM HRC_MANAGE_HDL_BO_ACCESS_PRIV Tâche d'accès aux objets d'affaires du chargeur de données HCM
    Utilisateur des configurations fonctionnelles ORA_ASM_FUNCTIONAL_SETUPS_USER_ABSTRACT Configuration et maintenance

Note :

Ce tutoriel suppose que vous avez activé l'objet d'affaires basé sur le rôle pour HDL. Pour activer cette fonctionnalité, voir Tâche 1 du tutoriel Configurer l'accès au chargeur de données HCM (HDL) et comprendre les options de sécurité HDL.

Pour chiffrer les fichiers dans OIC, vous devez effectuer les étapes de la tâche 5 du tutoriel Configurer l'accès au chargeur de données HCM (HDL) et comprendre les options de sécurité HDL pour générer le certificat PGP fusion-key et extraire la clé publique.

Attention :

Il est recommandé de chiffrer tous les fichiers avant de les charger dans Oracle WebCenter. Tout utilisateur ayant accès au compte hcm$/dataloader$/import$ peut télécharger n'importe quel fichier qui y est placé.


Tâche 1 : Définir les comptes d'utilisateur du chargeur de données HCM

Trois comptes d'utilisateur doivent être pris en compte lors de la création d'intégrations OIC avec le chargeur de données HCM.

  • Un compte de développement pour tester la forme de votre fichier HDL et générer des fichiers de mappage.
  • Compte d'utilisateur de votre connexion Oracle WebCenter Content qui n'a accès qu'au compte d'importation du chargeur de données HCM.
  • Compte d'utilisateur pour votre connexion REST au chargeur de données HCM qui n'a accès qu'à l'API REST HDL et qui est configuré pour charger uniquement les données des objets d'affaires que l'intégration tient à jour.

Cette tâche décrit comment créer ces comptes.

Conseil :

Consultez le tutoriel Configurer l'accès au chargeur de données HCM et comprendre les options de sécurité HDL pour obtenir des conseils plus détaillés sur la création de rôles HDL et l'affectation de l'accès aux objets d'affaires.

Compte de développement

Vous utiliserez ce compte pour lancer le chargeur de données HCM afin de tester la forme de votre fichier et de générer des fichiers de mappage OIC.

Note :

Ce compte ne sera requis que dans votre environnement de développement où vous pourrez configurer et tester vos intégrations.
  1. Ajoutez les hiérarchies de rôles suivantes :
    2. Nom de rôle Code du rôle Accès aux autorisations
    Chargement des données HCM ORA_HRC_HCM_DATA_LOAD_DUTY Tâches du chargeur de données HCM dans la zone de travail Échange de données.
    Charger des données pour l'importation de fichiers Human Capital Management HCM_DATALOADER_IMPORT_RWD Répertoire hcm/dataloader/import sur le serveur Oracle WebCenter Content.
    Télécharger des données provenant d'une exportation de fichiers Human Capital Management HCM_DATALOADER_EXPORT_RWD Répertoire hcm/dataloader/export sur le serveur Oracle WebCenter Content. Obligatoire pour exporter les fichiers d'erreurs.

  2. Utilisez la tâche Accès aux objets d'affaires du chargeur de données HCM dans Configuration et maintenance pour accorder l'accès aux objets d'affaires auxquels l'utilisateur de développement a besoin d'accéder. Il peut s'agir de tous les objets fonctionnels.

Compte HDL Oracle WebCenter Content

Ce compte n'aura accès qu'au compte hcm$/dataloader$/import$ sur le serveur de contenu Oracle WebCenter. Ce compte sera ensuite utilisé pour définir la connexion HDL d'Oracle WebCenter qui peut être utilisée par toutes vos intégrations du chargeur de données HCM. Vous allez créer cette connexion dans la tâche 4.

  1. Créez un rôle professionnel avec la hiérarchie de rôles suivante :
    2. Nom de rôle Code du rôle Accès aux autorisations
    Charger des données pour l'importation de fichiers Human Capital Management HCM_DATALOADER_IMPORT_RWD Répertoire hcm/dataloader/import sur le serveur Oracle WebCenter Content.

  2. Créez un compte d'utilisateur, par exemple HDL_UPLOAD_FILE, et accordez l'accès à ce rôle professionnel.

Compte REST HDL

Il est recommandé de créer des comptes individuels pour chaque intégration du chargeur de données HCM afin de s'assurer que le compte d'utilisateur n'a accès qu'aux objets d'affaires dont il a besoin pour tenir à jour. Créer un compte qui aura accès à :

  • API REST du chargeur de données HCM.
  • Action personnalisée createFileDataSet sur l'API REST du chargeur de données HCM.
  • Le compte Oracle WebCenter hcm$/dataloader$/import$ requis pour lire le fichier soumis pour chargement.
  • Objets fonctionnels propres à l'intégration.

Voici la marche à suivre :

  1. Suivez les étapes sous l'en-tête Accès REST dans la tâche deux du tutoriel Configurer l'accès au chargeur de données HCM et comprendre les options de sécurité HDL pour créer un rôle avec l'accès REST HDL.
  2. Utilisez la tâche Accès aux objets d'affaires du chargeur de données HCM dans Configuration et maintenance pour accorder l'accès aux objets d'affaires dont votre intégration est responsable.

    Conseil :

    Si vous utilisez Redwood, cette interface utilisateur est désormais disponible à partir de la zone de travail Échange de données.
  3. Créez un compte d'utilisateur nommé pour votre intégration et accordez l'accès à ce rôle professionnel.

Vous utiliserez ce compte pour créer la connexion REST du chargeur de données HCM dans la tâche 5 de ce tutoriel.


Tâche 2 : Importer la clé de chiffrement dans OIC

Le chargeur de données HCM utilise la clé privée du certificat PGP fusion-key pour déchiffrer les fichiers chiffrés soumis pour importation.

Note :

Il est recommandé de chiffrer tous les fichiers avant de les charger dans Oracle WebCenter. Tout utilisateur ayant accès au compte hcm$/dataloader$/import$ peut télécharger n'importe quel fichier qui y est placé.

Cette étape importe la clé publique du certificat PGP fusion-key dans OIC, afin que vous puissiez chiffrer les fichiers transformés prêts à être traités par HDL.

  1. Connectez-vous à OIC.
  2. Naviguez jusqu'à Paramètres > Certificats.
  3. Cliquez sur Charger. La page Charger un certificat s'affiche.
  4. Spécifiez un nom, par exemple fusion-key-pub et fournissez éventuellement une description pour le certificat.
  5. Spécifiez un type de PGP (chiffrement et déchiffrement).
  6. Utilisez le bouton Parcourir pour sélectionner le fichier public fusion-key que vous avez téléchargé à partir de la console de sécurité.
  7. Indiquez des valeurs pour les questions restantes.
    8. Cliquez sur le bouton Générer au niveau de la page.

  8. Cliquez sur Charger

    9. Conseil :

    Ce certificat sera maintenant répertorié lorsque vous exécuterez l'action de fichier intermédiaire Chiffrer le fichier dans OIC.


Tâche 3 : Définir une connexion FTP pour lire les fichiers sources

Dans cette tâche, vous allez définir une connexion FTP dans OIC qui peut être utilisée pour lire et déchiffrer les fichiers sources à partir d'un serveur FTP externe.

Conseil :

Ces étapes décrivent une connexion FTP avec une clé privée PGP pour déchiffrer les fichiers sources. D'autres options de chiffrement sont disponibles.
  1. Connectez-vous à OIC et naviguez jusqu'à Conception > Connexions.
  2. Cliquez sur Créer.
  3. Recherchez et sélectionnez FTP dans la page Créer une connexion.
    4. Recherchez FTP.

  4. Indiquez un nom et, facultativement, une description. Cliquez sur Créer.
    5. Spécifier un nom et une description

  5. Spécifiez l'adresse de l'hôte du serveur FTP et réglez le port du serveur FTP à 21.
  6. Définissez la politique de sécurité et fournissez le nom d'utilisateur et les informations d'accès au compte.
    7. Spécifiez les détails de la connexion.

  7. Si vos fichiers sources sont chiffrés PGP, vous devez spécifier la clé privée pour le déchiffrement des fichiers.
    • Développez la section Sécurité facultative.
    • Cliquez sur l'icône Charger à droite du champ Clé privée PGP.
      • Charger le fichier de clé privée
    • Sélectionnez votre fichier de clé privée et cliquez sur Charger.
      • Charger le fichier.
    • Spécifiez votre mot de passe de clé privée dans le champ Mot de passe de clé privée PGP.
  8. Cliquez sur Test.
  9. Enregistrez votre connexion.


Tâche 4 : Définir la connexion à Oracle WebCenter

Cette connexion peut être utilisée par toutes vos intégrations HDL pour charger des fichiers HDL sur le serveur Oracle WebCenter Content, prêts à être traités par HDL.

Avant de créer cette connexion, assurez-vous d'avoir un compte d'utilisateur qui a accès au compte d'importation de fichier du chargeur de données HCM hcm$/dataloader$/import$. Les étapes de création de cet utilisateur sont fournies dans la tâche 1.

  1. Connectez-vous à OIC et naviguez jusqu'à Conception > Connexions.
  2. Cliquez sur Créer.
  3. Recherchez HCM et sélectionnez l'adaptateur Oracle HCM Cloud.
    4. Rechercher HCM.

  4. Spécifiez un nom pour l'importation HDL d'Oracle WebCenter. L'identificateur sera généré automatiquement.
    5. Spécifier un nom et une description

  5. Réglez le rôle à Appeler et, facultativement, spécifiez une description.
  6. Cliquez sur Créer.
  7. Spécifiez l'hôte HCM Cloud avec l'URL de votre environnement.
  8. Spécifiez le nom d'utilisateur et le mot de passe de votre compte d'utilisateur Oracle WebCenter.
    9. Spécifier l'URL, le nom d'utilisateur et le mot de passe de l'environnement

  9. Cliquez sur Tester et sur Enregistrer.


Tâche 5 : Définir la connexion REST du chargeur de données HCM

Cette étape crée un connecteur pour l'API REST du chargeur de données HCM utilisée pour lancer le chargeur de données HCM.

Il est recommandé de créer une connexion distincte pour chacune de vos intégrations HDL, sécurisée par un compte d'utilisateur qui n'a accès qu'au chargement en masse des données pour les objets d'affaires gérés par l'intégration.

Avant de créer cette connexion, assurez-vous que ce compte d'utilisateur est configuré. Les étapes pour créer un tel compte sont fournies dans la tâche 1.

  1. Connectez-vous à OIC et naviguez jusqu'à Conception > Connexions.
  2. Cliquez sur Créer.
  3. Recherchez REST et sélectionnez l'adaptateur REST.
    4. Rechercher REST.

  4. Spécifiez un nom propre à votre intégration, par exemple HDL - Nouvelles embauches. L'identificateur sera généré automatiquement.
    5. Spécifier un nom et une description

  5. Réglez le rôle à Appeler et, facultativement, spécifiez une description.
  6. Cliquez sur Créer.
  7. Spécifiez un type de connexion pour l'URL de base de l'API REST.
  8. Spécifiez une URL de connexion de : 
    https://{host}/hcmRestApi/resources/11.13.18.05/dataLoadDataSets

    9. Note :

    Remplacez {host} par les détails de votre hôte.
    Spécifier l'URL de l'environnement

  9. Indiquez le nom d'utilisateur et le mot de passe de votre compte d'utilisateur d'intégration.
    10. Spécifier l'URL de l'environnement

Étapes suivantes

Suivez les étapes de ce tutoriel pour générer un fichier de mappage qu'OIC utilise pour générer vos données sources dans la forme du fichier d'objet d'affaires du chargeur de données HCM.

Fournissez des liens vers des ressources supplémentaires. Cette section est facultative. Supprimez-la si nécessaire.

Autres ressources d'apprentissage

Explorez d'autres laboratoires sur le site docs.oracle.com/learn ou accédez à plus de contenu d'apprentissage gratuit sur le canal Oracle Learning YouTube. De plus, visitez education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

Pour obtenir la documentation sur le produit, visitez Oracle Help Center.