Présentation
Étendez vos fonctions de feuille de calcul de chargement en masse en incluant des segments de champ flexible préconfigurés et personnalisés dans vos modèles du chargeur de données de feuille de calcul HCM.
Les champs flexibles descriptifs étendent l'enregistrement de l'objet de base, de sorte que vous pouvez inclure un contexte de champ flexible descriptif par rangée de feuille de calcul. Dans ce tutoriel, vous apprendrez à ajouter des attributs de champ flexible descriptif pour un contexte ainsi que des attributs du contexte global.
Les champs flexibles extensibles sont conservés dans les enregistrements enfants. Vous pouvez donc inclure plusieurs contextes à l'aide de plusieurs occurrences de l'objet enfant. Dans ce tutoriel, vous apprendrez à ajouter des attributs EFF à partir de contextes multiples.
Objectifs
Dans ce tutoriel, vous allez :
- Générer des mappages d'attributs pour vos segments de champ flexible personnalisé.
- Créez le modèle Modifier le service qui comprend des segments de champ flexible descriptif.
- Étendre le modèle pour ajouter des segments de champ flexible extensible à partir de deux contextes.
Vous devez déjà être familiarisé avec la création de modèles de feuille de calcul. Si vous n'avez pas déjà utilisé la tâche Modèles de feuille de calcul, suivez d'abord le tutoriel Création de modèles de chargeur de données de feuille de calcul HCM.
Préalables
Pour terminer ce tutoriel, vous devez :
- Accès à la tâche Voir les objets d'affaires.
- Accès aux tâches de modèles de feuille de calcul avec un rôle auquel l'accès est affecté pour créer des modèles pour l'objet d'affaires Organisation.
Suivez les tâches 2 et 3 du tutoriel Configurer l'accès à la conception et à la mise à jour des modèles du chargeur de données de feuille de calcul HCM pour créer un tel rôle.
Note :
Ce tutoriel suppose que vous avez activé Redwood. Suivez la version 25C de ce tutoriel pour la navigation et les captures d'écran si ce n'est pas le cas.Tâche 1 : Mettre à jour et réviser les attributs d'un objet d'affaires
La tâche View Business Objects (Voir les objets d'affaires) est le dictionnaire de données pour le chargeur de données HCM (HDL) et le HSDL. Dans cette tâche, vous apprendrez à mettre à jour les attributs d'un objet d'affaires pour inclure les segments de champ flexible nouvellement configurés et à trouver les détails dont vous aurez besoin pour ajouter des attributs de segment de champ flexible à vos modèles de feuille de calcul.
Mettre à jour les attributs pour un objet d'affaires
Les 'cartes' d'attribut permettent de comprendre la forme des objets d'affaires pour lesquels vous pouvez charger des données en masse. Lorsque vous configurez et déployez des modifications de champ flexible, vous devez également actualiser les mappages d'attributs afin que HDL et HSDL puissent voir les attributs disponibles pour charger des données dans vos segments de champ flexible.
Dans les étapes suivantes, vous allez mettre à jour les attributs de l'objet d'affaires Organisation car vous utiliserez cet objet pour les tâches suivantes. Toutefois, ces étapes s'appliquent à tous les objets fonctionnels HDL.
Note :
Avant de mettre à jour les attributs d'un objet d'affaires, assurez-vous que les contextes de champ flexible personnalisé sont configurés et déployés.- Dans l'application Oracle HCM, naviguez jusqu'à Mes groupes de clients > Échange de données > Voir les objets d'affaires.
- Recherchez l'objet d'affaires Organisation.
- Cliquez sur le menu Actions pour l'objet d'affaires et sélectionnez l'action Mettre à jour les attributs.
- Cliquez sur Soumettre dans le panneau Mettre à jour les attributs d'objet d'affaires.
Le panneau se fermera et vous recevrez un message confirmant la soumission.
- Actualisez le contenu de la table périodiquement jusqu'à ce que la date de la dernière mise à jour le soit la date courante. Cela confirme que la demande de mise à jour des attributs est terminée.
Identification des codes de catégorie et de contexte de champ flexible
Lorsque vous incluez des attributs de segment de champ flexible dans vos modèles HSDL, vous devez configurer le contexte de champ flexible et, dans le cas des attributs EFF, la catégorie de champ flexible pour ces attributs. Pour ce faire, vous définissez par défaut les attributs de contexte de champ flexible et de catégorie de champ flexible dans votre modèle HSDL avec le code de contexte de champ flexible et le code de catégorie de champ flexible.
Ces étapes vous montrent comment trouver ces codes dans les pages Voir les objets d'affaires pour les attributs utilisés dans la tâche 3 et la tâche 4.
Conseil :
Vous pouvez effectuer ces étapes avant d'ajouter vos attributs de segment de champ flexible à votre modèle ou parallèlement.- Dans la page Voir les objets d'affaires, cliquez sur le nom de l'objet pour naviguer jusqu'à la page Attributs.
- Cliquez sur l'onglet Attributs de champ flexible pour vérifier les attributs disponibles pour charger les segments de champ flexible descriptif configurés pour l'objet.
- Utilisez les filtres de recherche pour sélectionner le contexte de champ flexible qui a été mis à jour. Dans la tâche 3, nous utilisons le contexte de salaire du service.
- Utilisez le panneau Gestion des colonnes pour afficher la colonne Code de contexte.
- Notez le code de contexte pour le contexte de champ flexible descriptif. Vous attribuerez par défaut cette valeur à l'attribut Contexte de champ flexible dans votre modèle HSDL.
- Cliquez sur l'en-tête de la page pour faire passer l'objet en évidence à Informations supplémentaires sur l'organisation. Il s'agit d'un exemple de champ flexible extensible (EFF). Les champs flexibles extensibles ont une catégorie de champ flexible en plus du contexte de champ flexible.
- Naviguez jusqu'à l'onglet Attributs de champ flexible.
- Utilisez le panneau Gestion des colonnes pour afficher les colonnes Category Code (Code de catégorie) et Context Code (Code de contexte).
- Recherchez le nom du rapport.
- Effacez les critères de recherche et filtrez la liste des attributs en fonction de la catégorie Service et du contexte Informations sur les jours de travail.
- Notez le code de catégorie et le code de contexte pour le contexte Informations sur les jours de travail. Vous attribuerez par défaut les attributs Contexte de champ flexible et Catégorie de champ flexible extensible à ces valeurs dans votre modèle de feuille de calcul dans la tâche 4.
Note :
Les segments de champ flexible descriptif (DFF) étendent l'enregistrement de base et se trouvent donc sur le même composant de la hiérarchie d'objets.
Conseil :
L'onglet Attributs de champ flexible n'est disponible que pour les objets qui prennent en charge les champs flexibles.
Vous remarquerez qu'il existe plusieurs attributs de nom de rapport dans plusieurs catégories et contextes de champ flexible.
Dans la tâche 4, nous ajoutons le nom de rapport pour la catégorie Service. Notez donc le code de catégorie DEPARTMENT et le code de contexte PER_ORG_MANAGER_INFO pour cette entrée.
Conseil :
Le tutoriel Présentation des objets d'affaires du chargeur de données HCM explique plus en détail la tâche Voir les objets d'affaires.Liste de vérification
Valeurs à noter pour les tâches suivantes :
| Valeur | Exemple | Utilisé pour |
|---|---|---|
| Code de contexte de champ flexible descriptif | Contexte du salaire du service | La valeur par défaut du champ Valeur de contexte est Tâche 3 |
| Code de catégorie de champ flexible extensible | SERVICE | EFF_CATEGORY_CODE par défaut dans la tâche 4 |
| Code de contexte de champ flexible extensible | PER_ORG_MANAGER_INFO / PER_WORK_DAY_INFO | Code de contexte par défaut dans la tâche 4 |
Conseil :
Certains codes de contexte sont des valeurs de texte descriptif plutôt que des valeurs de code majuscules. Utilisez la valeur exacte indiquée dans la colonne Exemple.Tâche 2 : Créer un modèle de service de maintenance
Dans cette tâche, vous allez créer un modèle pour tenir à jour les services, qui est ensuite utilisé pour les tâches suivantes.
Si vous avez déjà un modèle, vous pouvez ignorer cette tâche. Avant de continuer, vérifiez que le modèle a été testé avec succès. Pour les attributs de champ flexible descriptif, il doit inclure l'objet propriétaire du champ flexible descriptif. Pour les attributs de champ flexible extensible, il doit inclure l'objet parent de l'objet propriétaire du champ flexible extensible.
Entrer les informations sur le modèle
- Naviguez jusqu'à Mes groupes de clients > Échange de données > Modèles de feuille de calcul.
- Cliquez sur Ajouter.
- À l'étape Entrer les informations sur le modèle, entrez le nom Modifier le service. Spécifiez Organisation comme objet d'affaires.
- Cliquez sur Continuer
Sélectionner des attributs
- Sélectionnez l'attribut Nom de la classification.
- Sélectionnez Classification d'organisation dans l'en-tête Attributs disponibles pour voir les attributs Classification d'organisation.
- Ajoutez ces attributs à votre modèle :
- Statut
- Code de jeu
Conseil :
L'attribut Définir un code est obligatoire lors de la création de services. - Cliquez sur Continuer.
Sélectionner des identificateurs d'enregistrement
Vous avez sélectionné des attributs dans les objets Organisation et Classification d'organisation. Ces deux éléments sont affichés à l'étape Sélectionner des identificateurs d'enregistrement. 
Nous laisserons le type d'attribut Clé d'utilisateur car ce modèle crée de nouveaux enregistrements et les clés de remplacement ne peuvent être utilisées que pour tenir à jour des enregistrements existants.
Il n'y a aucune option de clé utilisateur supplémentaire pour ces objets, donc aucune action à effectuer.
- Cliquez sur Continuer.
configurer les attributs
- Cliquez sur l'en-tête de l'attribut Nom de la classification pour ouvrir le panneau Modifier.
- Configurez une constante par défaut de Service et décochez la case Afficher.
- Cliquez sur Save (Enregistrer).
- Modifiez Définir le code pour configurer une constante par défaut COMMON.
- Configurez une constante par défaut pour l'attribut Statut de A et décochez la case Afficher.
- Cliquez sur Save (Enregistrer).
Vous disposez maintenant d'un modèle qui peut être étendu pour inclure des attributs de segment de champ flexible descriptif et extensible.
Tâche 3 : Segments de champ flexible descriptif
Les segments de champ flexible descriptif sont définis dans le même enregistrement que les attributs de base, de sorte que vous ne pouvez pas avoir plusieurs contextes de champ flexible descriptif pour la même rangée de feuille de calcul. Vous êtes donc limité à inclure des segments d'un contexte de champ flexible en plus des segments du contexte Éléments de données globales.
- Naviguez jusqu'à l'étape Sélectionner des attributs de votre modèle.
- Réglez le filtre Objet à Organisation.
- Définissez le filtre Nom du champ flexible, de sorte que seuls les attributs de segment de champ flexible sont affichés et fournissent tous les critères de recherche requis.
- Cliquez sur le lien d'étiquette d'attribut pour n'importe quel segment de champ flexible dans le contexte de champ flexible sélectionné.
- Sélectionnez les attributs de segment de champ flexible à partir du contexte de champ flexible descriptif à utiliser et ajoutez-les au modèle, ainsi que tous les attributs de contexte d'éléments de données globales dont vous avez besoin.
- Cliquez sur Continuer jusqu'à ce que vous soyez à l'étape Configurer les attributs.
Conseil :
L'ajout d'attributs de segment de champ flexible pour un objet entraîne automatiquement l'ajout de l'attribut Valeur de contexte pour cet objet. - Modifiez la valeur de contexte pour attribuer par défaut le code de contexte du champ flexible descriptif. Cet attribut peut être masqué.
Conseil :
Comme l'objet Organisation comporte un champ flexible descriptif, le filtre Nom du champ flexible s'affiche.
Le champ Code de contexte de champ flexible pour les attributs de segment de champ flexible est disponible ici. Vous avez peut-être déjà trouvé ces données dans les pages de consultation des objets fonctionnels.
Votre modèle peut maintenant être utilisé pour charger des données dans les segments de champ flexible descriptif sélectionnés.
Tâche 4 : Segments de champ flexible extensible
Les champs flexibles extensibles sont conservés dans un enregistrement enfant, ce qui permet de fournir plusieurs contextes pour le même parent.
Dans cette tâche, vous allez ajouter des segments de champ flexible extensible de deux contextes à votre modèle.
Ajouter des segments de champ flexible extensible
Nous allons d'abord ajouter le segment de champ flexible Nom du rapport de la catégorie Service à notre modèle.
- Dans le processus guidé Modèles de feuille de calcul pour votre modèle, naviguez jusqu'à l'étape Sélectionner des attributs.
- Recherchez Nom du rapport.
Conseil :
Il n'y a que deux occurrences de l'attribut Nom du rapport vu, une pour chaque contexte de champ flexible. Il n'y a qu'un seul attribut de nom de rapport disponible dans le contexte Informations sur le gestionnaire de l'organisation, mais il est configuré dans plusieurs catégories de champ flexible. La table Sélectionner des attributs affiche uniquement l'attribut disponible et ne comprend pas les configurations de catégorie de champ flexible.Les codes de catégorie et de contexte de champ flexible affichés dans la page Voir les objets d'affaires seront spécifiés dans la configuration du modèle pour s'assurer que les données sont chargées dans la catégorie et le contexte de champ flexible extensible appropriés.
- Sélectionnez l'attribut Nom du rapport qui est défini dans le contexte de champ flexible Informations sur le gestionnaire de l'organisation.
- Cliquez sur Continuer.
Vous avez maintenant ajouté des attributs à partir de l'objet Informations supplémentaires sur l'organisation dans la hiérarchie de l'organisation et vous verrez qu'ils sont ajoutés à la liste des objets utilisés par ce modèle.
- Cliquez sur Continuer.
Des attributs obligatoires sont automatiquement ajoutés lors de la sélection de votre premier attribut pour un objet.
Les attributs permettant d'identifier l'enregistrement parent sont automatiquement attribués par défaut aux valeurs de l'enregistrement parent et sont masqués.
Les autres attributs obligatoires pour les champs flexibles extensibles sont les suivants :
Attributs de champ flexible extensible obligatoires pour les informations supplémentaires sur l'organisation Attribut Description Code du contexte Code de contexte de champ flexible des segments de champ flexible sélectionnés. Il est automatiquement ajouté aux définitions d'objet d'affaires qui ont des attributs de segment de champ flexible.
OrgInformationContext Code de contexte de champ flexible des segments de champ flexible sélectionnés pour l'objet Informations supplémentaires sur l'organisation. Cet attribut est propre à cet objet et peut être attribué par défaut à la même valeur que le code de contexte. EFF_CATEGORY_CODE Code de catégorie de champ flexible extensible. Numéro séquentiel Séquence de l'enregistrement de contexte de champ flexible. Conseil :
Ces attributs identifient la catégorie et le contexte de champ flexible extensible que l'enregistrement de feuille de calcul doit créer ou mettre à jour. Ils sont généralement masqués par l'utilisateur de la feuille de calcul après avoir configuré ses valeurs par défaut. - Modifiez l'attribut Context Code pour définir une valeur par défaut constante du code de contexte pour l'attribut Nom du rapport.
- Notez la clé d'attribut; vous en aurez besoin pour configurer la valeur par défaut de l'attribut OrgInformationContext qui copie la valeur de cet attribut.
- Décochez la case Afficher pour masquer l'attribut dans vos feuilles de calcul modèles, puis cliquez sur Enregistrer.
- Configurez une valeur par défaut d'attribut sélectionné existant pour l'attribut OrgInformationContext, en spécifiant la clé d'attribut de l'attribut Context Code.
- Masquez cet attribut et enregistrez vos modifications.
- Modifiez l'attribut EFF_CATEGORY_CODE, en définissant une valeur par défaut du champ flexible Code de catégorie pour l'attribut Nom du rapport et masquez-le.
- Modifiez l'attribut Numéro de séquence, en définissant une valeur par défaut constante de 1 et masquez-le.
- Ajoutez tout autre attribut de segment de champ flexible dont vous avez besoin à partir du même contexte de champ flexible.
Conseil :
Seuls les attributs de segment de champ flexible du composant Informations supplémentaires sur l'organisation seront affichés sous forme de colonnes dans les feuilles de calcul générées à partir de ce modèle. Tous les autres attributs ont des valeurs par défaut configurées et sont masqués pour simplifier l'entrée de données pour l'utilisateur final.Ajout de segments de champ flexible à partir d'un autre contexte
Lorsque vous fournissez des segments de champ flexible à partir d'autres contextes, vous devez fournir une autre occurrence de l'objet Informations supplémentaires sur l'organisation.
Pour ce faire dans un modèle de feuille de calcul, vous dupliquez d'abord les attributs de cet objet, ajoutez les attributs de segment de champ flexible pour le contexte suivant et configurez le contexte de champ flexible pour l'objet dupliqué. À la fin de cette tâche, vous aurez les attributs suivants dans votre modèle pour l'objet Informations supplémentaires sur l'organisation.
| Occurrence d'objet | Attribut | Valeur par défaut | Affiché |
|---|---|---|---|
| 1 | Nom du rapport | Oui | |
| 1 | Heures de travail standard | ||
| 1 | Fréquence des heures de travail standard | ||
| 1 | Heure de début de travail | ||
| 1 | Heure de fin de travail | ||
| 1 | Code du contexte | PER_ORG_MANAGER_INFO | |
| 1 | EFF_CATEGORY_CODE; | SERVICE | |
| 1 | Contexte OrgInformation | OrgInformation_OrgInformationContext | |
| 1 | Numéro séquentiel | 1 | |
| 2 | Nom du rapport | ||
| 2 | Heures de travail standard | Oui | |
| 2 | Fréquence des heures de travail standard | Oui | |
| 2 | Heure de début de travail | Oui | |
| 2 | Heure de fin de travail | Oui | |
| 2 | Code du contexte | PER_WORK_DAY_INFO | |
| 2 | EFF_CATEGORY_CODE; | SERVICE | |
| 2 | Contexte OrgInformation | OrgInformation_1_OrgInformationContext | |
| 2 | Numéro séquentiel | 2 |
Note :
Les attributs qui existent pour chaque occurrence d'un enregistrement doivent être les mêmes. Vous allez configurer les valeurs par défaut appropriées à chaque contexte et masquer les attributs qui ne sont pas applicables à un contexte.Duplication des informations supplémentaires sur l'organisation
- Dans la barre d'outils de la table Configurer les attributs, cliquez sur Actions supplémentaires > Dupliquer les attributs.
- Modifiez l'enregistrement Informations supplémentaires sur l'organisation et spécifiez 1. Enregistrez la modification.
- Cliquez sur Créer. Cela crée une copie de chaque attribut sélectionné pour le composant Informations supplémentaires sur l'organisation.
- Modifiez l'attribut Nom du rapport | 1 pour le masquer.
Ce double des informations supplémentaires sur l'organisation concerne un contexte de champ flexible différent. Vous devez masquer tous les attributs pour les segments de champ flexible définis dans l'enregistrement Informations supplémentaires sur l'organisation initial.
- Cliquez sur Save (Enregistrer).
Conseil :
Un numéro sera ajouté à l'en-tête de colonne, au nom d'attribut et à la clé d'attribut des nouveaux attributs pour identifier la nouvelle occurrence à laquelle ils appartiennent.
Ajout de segments pour un autre contexte
- Naviguez jusqu'à l'étape Sélectionner des attributs du processus guidé.
- Filtrer les attributs de l'objet Informations supplémentaires sur l'organisation, du nom de champ flexible EFF Informations sur l'organisation et du contexte de champ flexible Informations sur les jours de travail.
- Ajoutez ces attributs à votre modèle à partir du contexte Informations sur les jours ouvrables :
- Heures de travail standard
- Fréquence des heures de travail standard
- Heure de début de travail
- Heure de fin de travail
Note :
Il existe parfois deux attributs portant le même nom. L'un accepte un code de consultation ou un ID, l'autre accepte une signification ou une valeur. Utilisez le nom d'attribut pour déterminer lequel; le nom d'attribut qui se termine par _Display accepte la signification ou la valeur. - Cliquez sur Continuer jusqu'à ce que vous soyez à l'étape Configurer les attributs.
- Filtrez Objet pour Informations supplémentaires sur l'organisation.
Il y aura deux occurrences de chacun des nouveaux attributs de segment de champ flexible. Lorsque vous ajoutez des attributs à un composant dupliqué, ces attributs sont ajoutés à chaque occurrence.
- Masquer les attributs Informations sur les jours de travail de l'occurrence initiale des informations supplémentaires sur l'organisation.
- Modifiez chacun des attributs d'informations sur les jours de travail à partir de l'occurrence en double des informations supplémentaires sur l'organisation. Modifiez l'en-tête de colonne pour supprimer le numéro ajouté et, facultativement, ajoutez ou modifiez l'en-tête de colonne.
- Cliquez sur Afficher les attributs masqués.
- Modifiez ces attributs masqués dans votre enregistrement dupliqué pour spécifier le contexte et la séquence de champ flexible corrects :
Attributs obligatoires de champ flexible extensible pour les informations supplémentaires sur l'organisation Attribut Description Type par défaut Valeur Code de contexte | 1 Code de contexte de champ flexible pour le deuxième contexte de champ flexible. Constante PER_WORK_DAY_INFO Numéro de séquence | 1 Séquence de l'enregistrement de contexte de champ flexible. Constante 2 OrgInformationContext | 1 Code de contexte de champ flexible pour le deuxième contexte de champ flexible. Copiez la valeur de l'attribut Context Code | 1. Attribut sélectionné existant OrgInformation_1_OrgInformationContext - Enregistrer les modifications.
- Effacez tous les filtres et réorganisez les rangées dans l'ordre dans lequel vous voulez que les colonnes soient affichées dans vos feuilles de calcul. Par exemple, cliquez sur l'heure de début du travail et faites-la glisser au-dessus de l'heure de fin du travail.
Vous avez maintenant créé un modèle pour tenir à jour les services tout en alimentant plusieurs contextes de champ flexible.
Conseil :
Il s'agit des attributs qui n'ont pas de numéro ajouté au nom de l'attribut.La liste des attributs de l'objet Informations supplémentaires sur l'organisation doit maintenant ressembler à ceci. 
Liens connexes
Tutoriels connexes
- Configurer l'accès à la conception et à la mise à jour des modèles du chargeur de données de feuille de calcul HCM (HSDL)
- Création de modèles du chargeur de données de feuille de calcul HCM
- Définition de modèles HSDL pour créer plusieurs enregistrements enfants dans une ligne de feuille de calcul
- Présentation des objets fonctionnels du chargeur de données HCM (HDL)
Les derniers tutoriels pour HDL et HSDL sont publiés dans cette rubrique sur Cloud Customer Connect :
Remerciements
- Auteurs - Ema Johnson (Gestionnaire principal de produit, Chargeur de données HCM et IA)
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.
Inclusion de segments de champ flexible dans les modèles du chargeur de données de feuille de calcul HCM
G35064-03
Mai 2026