Introduction

Ce tutoriel explique les étapes à suivre pour générer et modifier des fichiers de mappage propres à un objet métier, qui peuvent ensuite être importés dans Oracle Integration Cloud (OIC) pour transformer des données en forme de fichier d'objet métier du chargeur de données HCM.

Objectifs

Dans ce tutoriel, vous allez effectuer les opérations suivantes :

  • Activer la génération des fichiers de mapping.
  • Générer des fichiers de mappage génériques et personnalisés.
  • Modifier les fichiers de mapping générés.

Prérequis

Pour effectuer les étapes de ce tutoriel, vous aurez besoin d'accéder aux éléments suivants :

  • Tâche Configurer le chargeur de données HCM pour activer la génération de fichiers de mapping.
  • Tâche Afficher les objets métier permettant de générer des fichiers de mapping génériques.
  • Chargeur de données HCM pour importer des fichiers de test et générer des fichiers de mappage personnalisés.

Pour connaître les étapes de configuration de cet accès, reportez-vous au tutoriel Configurer l'accès au chargeur de données HCM (HDL) et comprendre les options de sécurité HDL.


Tâche 1 : Activer la génération du fichier de mapping

Cette étape permet de générer des fichiers de mappage OIC dans le chargeur de données HCM.

Il existe deux méthodes pour générer des fichiers de mapping :

  • Générer des fichiers complets d'objets fonctionnels génériques.

    Utilisez la tâche Afficher les objets métier pour générer et télécharger des fichiers de mapping décrivant des hiérarchies d'objets métier complètes.

  • Générer des fichiers d'objet métier personnalisés.

    Importez et chargez les fichiers de test pour confirmer la forme de votre fichier lors de la génération d'un fichier de mapping en forme de fichier importé.

Pour activer la génération des fichiers de mapping :

  1. Connectez-vous à Oracle HCM Cloud Application.
  2. Accédez à Mon entreprise > Configuration et maintenance.
  3. Sélectionnez le domaine fonctionnel Chargeur de données HCM.
  4. Cliquez sur la tâche Configurer le chargeur de données HCM.
    5. Cliquez sur la tâche du chargeur de données HCM dans le domaine fonctionnel du chargeur de données HCM.

  5. Recherchez le paramètre Générer des fichiers de mappage des objets fonctionnels.
    6. Utilisez le champ Requête par l'exemple pour rechercher le paramètre.

  6. Définissez Remplacer sur Oui.

    7. Deux options de remplacement sont disponibles lors de l'activation de la génération des fichiers de mappage :

    Valeur de remplacement Description
    Personnalisé uniquement Permet de générer des fichiers de mappage pour les fichiers de données d'objet fonctionnel que vous chargez avec le chargeur de données HCM.
    Oui Permet de générer des fichiers de mapping génériques à partir de la tâche Afficher les objets fonctionnels en plus des fichiers personnalisés.

  7. Cliquez sur Enregistrer.

Conseil :

Pour plus d'informations, recherchez Générer des fichiers de mapping d'objet métier dans la rubrique Paramètres de configuration du chargeur de données HCM.


Tâche 2 : Générer des fichiers de mapping complets

Cette étape consiste à générer un fichier de mappage pour une hiérarchie d'objets métier complète.

  1. Connectez-vous à Oracle HCM Cloud Application.
  2. Accédez à Mes groupes de client > Echange de données > Afficher les objets fonctionnels.
  3. Recherchez et sélectionnez l'objet métier Enregistrement de document, puis cliquez sur Actualiser l'objet.
    4. Utilisez la requête par exemple pour rechercher Document Recor et cliquez sur Refresh Object

  4. Actualisez le contenu de la table jusqu'à ce que la colonne Fichier de mapping d'intégration affiche une icône de fichier de téléchargement pour l'objet métier Enregistrement de document.
    5. Actualisez la table jusqu'à ce que l'icône du fichier de téléchargement apparaisse pour l'objet Enregistrement de document.

  5. Cliquez sur l'icône de téléchargement du fichier, le fichier de mappage sera téléchargé.

Remarques :

Vous allez modifier ce fichier dans la tâche 4.


Tâche 3 : Générer des fichiers de mapping personnalisés

Il s'agit de l'approche recommandée pour générer des fichiers de mappage pour OIC. Vous commencez par créer un fichier du chargeur de données HCM dans la forme dans laquelle vous souhaitez que votre intégration OIC génère des fichiers. Cela présente l'avantage de vérifier que la forme de fichier HDL est correcte avant de créer votre intégration.

  1. Définissez un fichier d'objet métier HDL. Vous pouvez télécharger le fichier Worker Mapping File.zip pour les besoins de ce tutoriel.
  2. Connectez-vous à Oracle HCM Cloud Application.
  3. Accédez à Mes groupes de clients > Echange de données > Importer et charger des données.
  4. Cliquez sur Importer un fichier.
  5. Faites glisser le fichier Worker Mapping File.zip téléchargé vers le bouton Choose File et cliquez sur Review Parameters (Vérifier les paramètres).
    6. Sélectionnez le fichier source et cliquez sur Vérifier les paramètres

  6. Cochez la case Générer le fichier du mappage de l'objet fonctionnel.
    7. Cochez la case Générer le fichier du mappage de l'objet fonctionnel

  7. Cliquez sur Soumettre.
  8. Cliquez sur OK pour fermer la fenêtre de confirmation Soumis.
  9. Actualisez la table Ensembles de données jusqu'à ce que le fichier test soit affiché.
  10. Vous pouvez parfois actualiser la table Business Objects de votre jeu de données jusqu'à ce que l'importation soit terminée.
  11. Cliquez sur Télécharger le fichier de mapping dans la barre d'outils de la table Objets métier pour télécharger le fichier de mapping personnalisé.

    Ce bouton est activé une fois le fichier d'objet métier importé.

    12. Cliquez sur le bouton Download Mapping File.

Conseil :

Si vous rencontrez des erreurs d'import, il est probable que la forme du fichier soit incorrecte. Vérifiez et corrigez les erreurs et téléchargez le fichier de mappage uniquement lorsque vous avez importé le fichier de test avec succès.


Tâche 4 : modifier les fichiers de mapping

Vous pouvez modifier les fichiers de mappage générés par le chargeur de données HCM. Dans cette tâche, vous allez modifier le fichier de mappage des enregistrements de document que vous avez généré dans la tâche 2.

Présentation de la forme de fichier

  1. Ouvrez le fichier DocumentsOfRecord.nxsd que vous avez généré dans Tâche 2.
  2. Vérifiez le contenu du fichier. Tous les fichiers de mapping suivent la même structure ; il existe 3 types de groupes d'éléments :
    • Groupe ObjectFileData

      Un groupe ObjectFileData se trouve en haut du fichier. Pour chaque objet métier de la hiérarchie, ce groupe inclut un élément ObjectLabel et un élément objet :

      • L'élément ObjectLabel définit la ligne METADATA.
      • L'élément Objet définit la ligne MERGE (données).

      Conseil :

      Le formatage des lignes est également défini.

    • Groupe ObjectLabel

      Il existe un groupe ObjectLabel pour chaque objet métier dans la hiérarchie des objets. Le groupe ObjectLabel inclut des éléments permettant de définir les noms des attributs disponibles pour l'objet métier. Lorsque OIC génère un fichier à l'aide de ce mapping, les noms d'attribut (et les terminaisons) sont ajoutés à la fin de l'élément ObjectLabel défini dans le groupe ObjectFileData ci-dessus.

    • Groupe Object

      Il existe un groupe d'objets pour chaque objet métier de la hiérarchie d'objets. Le groupe d'objets inclut des éléments permettant de mapper les valeurs des attributs disponibles pour l'objet métier. Lorsque OIC génère un fichier à l'aide de ce mapping, les valeurs d'attribut (et les terminaisons) sont ajoutées à l'élément d'objet défini dans le groupe ObjectFileData ci-dessus.

  3. Consultez le groupe ObjectFileData DocumentOfRecordFileData.

    4. La hiérarchie d'objets métier DocumentsOfRecord comporte deux objets : DocumentOfRecord et DocumentAttachment. Un élément ObjectLabel et un élément Objet sont générés pour chaque objet métier de la hiérarchie :


  4. Consultez le groupe ObjectLabel DocumentOfRecordsLabel.

    5. Ce groupe inclut un élément pour définir le nom de chaque attribut disponible pour l'objet métier DocumentsOfRecord, y compris tous les attributs de segment de champ flexible déployé.


    Remarques :

    Le groupe complet est trop grand pour s'afficher ici.
  5. Vérifiez le groupe d'objets DocumentOfRecord.

    6. Ce groupe inclut un élément permettant de mapper les valeurs de chaque attribut disponible avec l'objet métier DocumentsOfRecord.


    Conseil :

    L'ordre des attributs dans les groupes ObjectLabel et Objet pour le même objet métier doit correspondre.
  6. Consultez le groupe ObjectLabel DocumentAttachmentLabel.

    7. Ce groupe inclut un élément permettant de définir le nom de chaque attribut disponible pour l'objet métier DocumentAttachment.


  7. Vérifiez le groupe d'objets DocumentAttachment.

    8. Ce groupe inclut un élément permettant de mapper les valeurs de chaque attribut disponible avec l'objet métier DocumentAttachment.


Modifiez la forme DocumentOfRecord.

OIC exige que vous fournissiez une valeur pour chaque attribut défini par les éléments du fichier de mapping. Si vous n'avez pas besoin d'attributs dans le fichier HDL généré, enlevez les deux éléments de l'attribut des groupes ObjectLabel et Object.

  1. Supprimez les éléments des groupes DocumentsOfRecordLabel et DocumentsOfRecord pour tous les attributs à l'exception des suivants :
    • DocumentName
    • DocumentCode
    • PersonNumber
    • DocumentType
  2. Réorganisez les éléments de ces groupes de sorte qu'ils apparaissent dans l'ordre suivant :
    • PersonNumber
    • DocumentType
    • DocumentCode
    • DocumentName

    Remarques :

    Le dernier élément du groupe a une valeur terminatedBy différente. La plupart des éléments sont terminés par le caractère pipe, le dernier est terminé par un caractère de fin de ligne. Lorsque vous modifiez votre fichier, assurez-vous que le dernier élément de chaque groupe a la fin de ligne.

    Conseil :

    L'ordre des éléments dans ces groupes détermine l'ordre dans lequel les attributs sont inclus dans le fichier généré par OIC. Par exemple, cette structure générera la ligne METADATA suivante : 
    METADATA|DocumentsOfRecord|PersonNumber|DocumentType|DocumentCode|DocumentName

Modifiez la forme DocumentAttachment.

  1. Supprimez les éléments des groupes DocumentAttachmentLabel et DocumentAttachment pour tous les attributs à l'exception des suivants :
    • Fonction
    • Fichier
    • DataTypeCode
    • DocumentCode
    • PersonNumber
    • DocumentType
    • URLorTextorFileName
  2. Réorganisez les éléments de ces groupes de sorte qu'ils apparaissent dans l'ordre suivant :
    • PersonNumber
    • DocumentType
    • DocumentCode
    • DataTypeCode
    • URLorTextorFileName
    • Fonction
    • Fichier

    Cette ligne METADATA sera générée : 

    METADATA|DocumentAttachment|PersonNumber|DocumentType|DocumentCode|DataTypeCode|URLorTextorFileName|Title|File

Vous pouvez désormais importer votre fichier dans OIC pour générer un fichier DocumentOfRecord.dat HDL.

Remarques :

Vous pouvez retirer des définitions d'objet fonctionnel entières de vos fichiers de mappage générés si vous n'avez pas besoin de fournir de données pour ces fichiers. Pour ce faire, veillez à enlever les groupes ObjectLabel et Objet de l'objet métier, en plus des éléments ObjectLabel et Objet du groupe ObjectFileData.

Ajout d'instructions SET à votre forme de fichier

Vous devrez peut-être inclure des instructions SET dans votre fichier d'objet métier. La façon la plus simple de le faire est de modifier le nxsd pour créer un élément qui vous permet de définir les instructions SET dans votre mapping OIC.

Au cours de cette étape, vous allez modifier le fichier Worker.nxsd généré dans la tâche 3.

  1. Ouvrez le fichier Worker.nxsd que vous avez généré dans Tâche 3 dans un éditeur de texte.

    2. L'élément WorkerFileData doit se présenter comme suit :


  2. Modifiez cet élément pour introduire une entrée de référence avant la référence WorkerLabel. Ajouter : 
    3. <element ref="tns:SetInstructions" minOccurs="0" nxsd:startsWith="">
  3. Créez un nouvel élément SetInstructions immédiatement sous l'élément WorkerFileData :
    4. <!-- SetInstructions -->
  <element name="SetInstructions">
      <complexType>
         <sequence>
            <element name="Instruction" type="string" nxsd:style="terminated" nxsd:terminatedBy="${eol}" />
         </sequence>
      </complexType>
   </element>

    Conseil :

    Cela prend en charge une instruction SET. Créez des éléments supplémentaires, tels que Instruction1 et Instruction2, si vous devez définir plusieurs instructions SET dans le fichier à générer par OIC.


Etapes suivantes

Suivez les étapes de ce tutoriel pour générer un fichier de mappage utilisé par OIC pour générer vos données source dans la forme du fichier d'objet fonctionnel du chargeur de données HCM.

Remerciements

  • Auteurs - Ema Johnson (Responsable produit principal)

Ressources de formation supplémentaires

Explorez d'autres ateliers sur le site docs.oracle.com/learn ou accédez à d'autres contenus d'apprentissage gratuits sur le canal Oracle Learning YouTube. En outre, visitez le site education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

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