Créer et charger de nouvelles embauches à l'aide du chargeur de données HCM (HDL)

Présentation

L'objet fonctionnel Worker est complexe et comporte environ 30 composants dans la hiérarchie d'objets. Ce tutoriel ne tente pas de couvrir tous les composants disponibles de cet objet complexe mais fournit des conseils sur les règles à suivre lors du chargement des nouvelles embauches.

Lorsque vous créez une nouvelle embauche, vous devez fournir des données pour les composants suivants de la hiérarchie d'objets Travailleur :

Travailleur
PersonName
WorkRelationship
Conditions de travail
Affectation

Il est recommandé de fournir également PersonLegislativeData. Si vous ne le fournissez pas, un enregistrement de données juridiques sera généré automatiquement, avec une clé source générée automatiquement.

Note :

Vous devez comprendre les clés sources et savoir comment charger des fichiers à l'aide du chargeur de données HCM (HDL). Si vous débutez avec HDL, vous devez d'abord suivre le tutoriel Créer et tenir à jour des données à l'aide du chargeur de données HCM.

Objectifs

Dans ce tutoriel, vous allez :

Créez et chargez un fichier Worker.dat du chargeur de données HCM pour charger les nouvelles embauches.
Comprendre les règles propres au chargement des nouvelles embauches.

Préalables

Pour terminer ce tutoriel, vous aurez besoin des éléments suivants :

Accès à l'importation et au chargement de données à l'aide du chargeur de données HCM.

Conseil :
Reportez-vous au tutoriel Configurer l'accès au chargeur de données HCM (HDL) et comprendre les options de sécurité HDL.
Accès à Configuration et maintenance pour mettre à jour un type de consultation.
Un éditeur de texte pour créer vos fichiers.
Compresseur de fichiers pour compresser vos fichiers de données d'objet d'affaires.

Tâche 1 : Créer le responsable du système source

Avant de charger un fichier qui utilise des clés sources, vous devez d'abord enregistrer la valeur du responsable du système source.

Dans l'application, cliquez sur votre nom d'utilisateur et cliquez sur Configuration et maintenance.

Cliquez sur l'icône du tiroir latéral et cliquez sur Rechercher.

Recherchez et sélectionnez la tâche Manage Common Lookups (Gérer les consultations communes).
Recherchez le type de consultation HRC_SOURCE_SYSTEM_OWNER.
Cliquez sur l'icône Ajouter dans la table Codes de consultation.

Spécifiez EMP dans le code de consultation et la signification, spécifiez la date de début du 01/01/2000.
Cliquez sur Save (Enregistrer).

Tâche 2 : Créer le fichier du travailleur

Au cours de cette étape, vous allez créer un fichier Worker.dat contenant des enregistrements pour les composants obligatoires et recommandés de la hiérarchie d'objets du travailleur.

Travailleur

Le composant Worker (Travailleur) identifie le travailleur avec le numéro de personne et la date de naissance.

Créez un fichier et ajoutez les lignes suivantes :

METADATA|Worker|SourceSystemOwner|SourceSystemId|EffectiveStartDate|PersonNumber|StartDate|DateOfBirth|ActionCode
MERGE|Worker|EMP|HDL001|2001/09/08|HDL-1001|2001/09/08|1952/05/21|HIRE
MERGE|Worker|EMP|HDL002|2005/02/08|HDL-1002|2005/02/08|1966/04/21|HIRE

Dans cet exemple :

Chaque enregistrement de travailleur est identifié de manière unique par une clé source au moyen des attributs SourceSystemOwner et SourceSystemId. Par exemple, EMP et HDL001, EMP et HDL002.
L'attribut PersonNumber est la clé utilisateur et est également fourni, mais si vous générez automatiquement des numéros de personne, vous n'avez pas besoin de l'indiquer.

Conseil :

Si vous générez automatiquement des nombres, la fourniture d'une clé source devient obligatoire car l'attribut de clé utilisateur, PersonNumber, ne peut pas être fourni.

Une adresse ActionCode de HIRE est nécessaire pour les nouvelles embauches.
La valeur de EffectiveStartDate doit correspondre à la valeur StartDate lors de la création de nouvelles embauches.

Nom de personne

Le composant PersonName enregistre le nom de votre employé.

Ajoutez ces lignes de fichier à votre fichier :

METADATA|PersonName|SourceSystemOwner|SourceSystemId|EffectiveStartDate|PersonId(SourceSystemId)|NameType|LegislationCode|Title|LastName|FirstName
MERGE|PersonName|EMP|HDL001_NME|2001/09/08|HDL001|GLOBAL|US|MR.|Wells|Christopher
MERGE|PersonName|EMP|HDL002_NME|2005/02/08|HDL002|GLOBAL|US|MRS.|Hugh|Lorraine

Dans cet exemple :

Chaque enregistrement PersonName est identifié de manière unique par une clé source au moyen des attributs SourceSystemOwner et SourceSystemId. Par exemple, EMP, HDL001_NME.
Pour identifier l'enregistrement de travailleur associé à chaque PersonName, l'ID système source est fourni à l'attribut d'ID remplacement parent PersonId avec le conseil (SourceSystemId). Par exemple, HDL001 ou HDL002.

Conseil :

Comme l'enregistrement PersonName local et l'enregistrement de travailleur parent utilisent le même responsable de système source, le responsable de système source parent peut hériter de sa valeur de l'attribut SourceSystemOwner local.

LegislationCode détermine les valeurs valides pour l'attribut Titre. Par conséquent, si vous modifiez le code de législation, vous devrez peut-être modifier la valeur de l'attribut Titre.

Conseil :

Utilisez la tâche Voir les objets d'affaires pour rechercher le type de consultation utilisé pour valider les attributs validés de la consultation.

La valeur de EffectiveStartDate dans l'enregistrement PersonName doit correspondre à celle de l'enregistrement de travailleur pour les nouvelles embauches.

Données juridiques de la personne

Le composant PersonLegislativeData permet de saisir l'état matrimonial et le sexe de votre employé.

Ajoutez ces lignes de fichiers à votre fichier :

METADATA|PersonLegislativeData|SourceSystemOwner|SourceSystemId|EffectiveStartDate|PersonId(SourceSystemId)|LegislationCode|Sex|MaritalStatus
MERGE|PersonLegislativeData|EMP|HDL001_LEG|2001/09/08|HDL001|US|M|M
MERGE|PersonLegislativeData|EMP|HDL002_LEG|2005/02/08|HDL002|US|F|S

Dans cet exemple :

Chaque enregistrement PersonLegislativeData est identifié de manière unique par une clé source. Par exemple, EMP, HDL001_LEG.
L'enregistrement parent étant Travailleur, vous référencez l'enregistrement parent de la même manière que pour PersonName, à l'aide de l'attribut PersonId(SourceSystemId).
LegislationCode détermine les valeurs valides pour les attributs Sex et MaritalStatus.
La valeur de EffectiveStartDate dans l'enregistrement PersonLegislativeData doit correspondre à celle de l'enregistrement de travailleur pour les nouvelles embauches.

Relation professionnelle

Le composant WorkRelationship indique l'employeur légal de votre employé.

Ajoutez ces lignes de fichier à votre fichier :

METADATA|WorkRelationship|SourceSystemOwner|SourceSystemId|PersonId(SourceSystemId)|LegalEmployerName|DateStart|WorkerType|PrimaryFlag
MERGE|WorkRelationship|EMP|HDL001_POS|HDL001|Vision Corporation|2001/09/08|E|Y
MERGE|WorkRelationship|EMP|HDL002_POS|HDL002|Vision Corporation|2005/02/08|E|Y

Dans cet exemple :

Chaque enregistrement WorkRelationship est identifié de manière unique par une clé source. Par exemple, EMP, HDL001_POS.
L'enregistrement parent étant toujours l'enregistrement de travailleur, vous référencez l'enregistrement parent à l'aide de l'attribut PersonId(SourceSystemId).
La valeur de l'attribut DateStart doit correspondre à la valeur StartDate fournie dans l'enregistrement de travailleur parent pour les nouvelles embauches.

Conseil :

Vous devrez modifier la valeur LegalEmployerName de Vision Corporation avec un employeur légal disponible dans votre base de données.

Conditions d'emploi

Les conditions d'emploi ne sont plus visibles dans Oracle HCM, mais vous devez fournir un squelette d'enregistrement WorkTerms pour lier les enregistrements WorkRelationship et Affectation.

Ajoutez ces lignes de fichier à votre fichier :

METADATA|WorkTerms|SourceSystemOwner|SourceSystemId|PeriodOfServiceId(SourceSystemId)|ActionCode|EffectiveStartDate|EffectiveSequence|EffectiveLatestChange|AssignmentName|AssignmentNumber|PrimaryWorkTermsFlag
MERGE|WorkTerms|EMP|HDL001_TRM|HDL001_POS|HIRE|2001/09/08|1|Y|ET-HDL001|ET-HDL001|Y
MERGE|WorkTerms|EMP|HDL002_TRM|HDL002_POS|HIRE|2005/02/08|1|Y|ET-HDL002|ET-HDL002|Y

Dans cet exemple :

Chaque enregistrement WorkTerms est identifié de manière unique par une clé source. Par exemple, EMP, HDL001_TRM.
Le parent pour WorkTerms est WorkRelationship, l'enregistrement parent est identifié par l'attribut PeriodOfServiceId. Le conseil SourceSystemId est ajouté afin que vous puissiez fournir la clé source pour identifier la relation de travail parent.
Comme l'enregistrement de relation de travail parent et l'enregistrement des conditions d'emploi locales utilisent tous les deux le même responsable de système source, les deux références utilisent le même attribut SourceSystemOwner.
La valeur EffectiveStartDate doit correspondre à celle de l'enregistrement WorkRelationship.

Note :

Vous devez seulement fournir les attributs obligatoires lors du chargement de l'enregistrement des conditions de travail. L'échelon, l'emplacement, le service, etc. ne sont désormais alimentés que dans le groupe de pages Affectation.

Affectation

Le type d'enregistrement Affectation permet de spécifier le service, l'emplacement, le poste, l'emploi de l'employé, etc.

Ajoutez ces lignes de fichier à votre fichier :

METADATA|Assignment|SourceSystemOwner|SourceSystemId|ActionCode|EffectiveStartDate|EffectiveSequence|EffectiveLatestChange|WorkTermsAssignmentId(SourceSystemId)|AssignmentName|AssignmentNumber|AssignmentStatusTypeCode|PersonTypeCode|BusinessUnitShortCode|PrimaryAssignmentFlag|JobId(SourceSystemId)|JobId(SourceSystemOwner)
MERGE|Assignment|EMP|HDL001_ASG|HIRE|2001/09/08|1|Y|HDL001_TRM|HDL001|HDL001|ACTIVE_PROCESS|Employee|Vision Operations|Y|SCN|VISION
MERGE|Assignment|EMP|HDL002_ASG|HIRE|2005/02/08|1|Y|HDL002_TRM|HDL002|HDL002|ACTIVE_PROCESS|Employee|Vision Operations|Y|MGR|VISION

Dans cet exemple :

Chaque enregistrement d'affectation est identifié de manière unique par une clé source. Par exemple, EMP, HDL001_ASG.
Le parent de l'affectation est WorkTerms, l'enregistrement parent est identifié par l'attribut WorkTermsAssignmentId. À l'aide du conseil SourceSystemId, vous pouvez utiliser la clé source pour identifier l'enregistrement WorkTerms parent.
La tâche est également référencée par sa clé source, mais comme elle a une valeur de responsable de système source différente, elle ne peut pas utiliser la valeur fournie à l'attribut SourceSystemOwner.
Pour spécifier un autre responsable du système source pour une référence d'objet étranger, ajoutez le conseil SourceSystemOwner à l'attribut qui identifie l'objet étranger, c'est-à-dire JobId(SourceSystemOwner).

Conseil :

Les tâches référencées dans cet exemple sont créées par le tutoriel Créer et tenir à jour des données avec le chargeur de données HCM (HDL).

La valeur EffectiveStartDate doit correspondre à celle de l'enregistrement WorkTerms.

Conseil :

Vous devrez modifier la valeur BusinessUnitShortCode des opérations de visualisation avec une unité d'affaires disponible dans votre base de données.

Conseil :

Vous pouvez utiliser ces étapes pour étendre ce fichier afin d'inclure d'autres composants de la hiérarchie des travailleurs, tels que PersonEmail.

Tâche 3 : Enregistrer et charger votre fichier

Enregistrez votre fichier et nommez-le Worker.dat. Vous pouvez également télécharger et modifier le fichier Worker.dat.
Compressez (zip) le fichier Worker.dat dans le nom de fichier de votre choix, mais il doit avoir une extension de fichier .zip.
Chargez votre fichier à l'aide du chargeur de données HCM.

Étapes suivantes

Les tutoriels suivants approfondiront vos connaissances sur le chargeur de données HCM :

Liens connexes

Les derniers tutoriels pour HDL et HSDL sont publiés dans cette rubrique sur Cloud Customer Connect :

Oracle by Example Tutorials - Chargeur de données HCM

Pour plus d'informations, reportez-vous aux rubriques d'aide suivantes :

Remerciements

Auteurs - Ema Johnson (Gestionnaire principal de produit principal)

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.

Informations sur le titre et les droits d'auteur

Créer et charger de nouvelles embauches à l'aide du chargeur de données HCM (HDL)

G34016-01

Mai 2025

Oracle et/ou ses sociétés affiliées.