Configuration des objets MDF

La plupart des configurations d’objets MDF sont gérées à l'aide de la fonction Configurer les définitions d’objet dans le Centre d’administration. Avant de commencer à utiliser ou à renseigner des données pour un objet MDF, vous devez créer une définition d’objet générique ou vérifier a définition d’objet générique existante. Les différentes zones d’un objet générique contrôlent différents aspects de l'objet.

Utilisez la Recherche d'actions pour accéder à l'outil Configurer les définitions d'objet et sélectionnez Créer : Définition d'objet.

Une fois qu'une nouvelle définition d'objet est ouverte, les différentes zones qui peuvent être configurées s'affichent.

Cette section détermine le comportement global de l’objet générique.

• Code : identificateur unique pour l'objet. Tous les objets personnalisés créés sont automatiquement précédés de cust_.

• Date d’entrée en vigueur : définit si une instance d’objet ne peut avoir qu’un seul enregistrement ou plusieurs enregistrements basés sur des dates différentes. Ne confondez pas cela avec l'audit, qui peut être activé quelle que soit la configuration de ce champ.

Les options de Date d'entrée en vigueur disponibles sont les suivantes :

Aucun : un seul enregistrement peut être géré pour une instance d'objet donnée. Lorsque vous apportez des modifications, vous écrasez les informations sauvegardées précédemment.

De base : plusieurs enregistrements peuvent être gérés pour une instance d'objet donnée, mais un seul enregistrement peut être ajouté pour une date donnée.

Modifications multiples par jour : plusieurs enregistrements peuvent être gérés pour chaque date donnée.

Du parent : utilisé pour les objets enfants afin qu'ils correspondent à la date d'entrée en vigueur du parent. Les relations parent/enfant entre les objets seront abordées dans la section d'association. Une instance d'objet pour un objet enfant peut pas être gérée indépendamment et ne peut être gérée qu'avec l'objet parent. 

• Visibilité de l’API : il est possible d’accéder à toutes les données d’objets MDF et à certaines configurations d’objets MDF via l’API OData à l’aide de ce paramètre. 

  Les options disponibles sont les suivantes :

  Non visible : il s'agit de la valeur par défaut. L'accès à l'objet ne sera pas autorisé via OData. 

  Lecture seule : l'instance d'objet est accessible en lecture seule sans fonctionnalité de modification. 

  Modifiable : l'instance d'objet est accessible avec les fonctionnalités de lecture et d'écriture telles que Créer, Mettre à jour, Insérer et Supprimer. 

• Statut : définissez le statut de l'objet.

  Les options disponibles sont les suivantes :

  Actif : l'objet peut être utilisé.

  Inactif : ce statut ne peut pas être utilisé si une instance d'objet existe ou si l'objet est référencé par un autre objet actif. Un objet inactif ne sera visible nulle part dans le système, y compris le concepteur d’IU configurable, les règles, les autorisations basées sur les rôles ou l’importation/exportation.

• Historique de la version MDF : l’historique de la version MDF vous permet de capturer les données d’audit pour toutes les modifications apportées aux instances d’objet. Toute opération telle que Créer, Mettre à jour, Insérer ou Supprimer ajoutera des enregistrements d'audit dans le système.

Les options disponibles sont les suivantes :

Aucune sélection/Non : si l'une de ces options est sélectionnée, aucun enregistrement d'audit ne sera créé pour l'une des opérations.

Historique de suppression : seule l'opération Supprimer créera des enregistrements d'audit. 

Historique complet : des enregistrements d'audit seront créés pour toutes les opérations telles que Créer, Insérer, Mettre à jour et Supprimer. 

• Écran par défaut : les utilisateurs peuvent créer une interface utilisateur de configuration pour un objet donné. Si vous souhaitez utiliser l'interface utilisateur de configuration créée pour être affichée dans Gérer les données, vous pouvez affecter l'interface utilisateur de configuration ici. Si vous ne renseignez pas cette zone, l’objet générique s’affichera dans l’interface utilisateur standard.

• Étiquette : il s'agit du nom de l'objet affiché dans les différentes IU. 

• Description : permet de capturer un bref résumé de l'objet.

• Sous-version de l'API : cette zone contrôle si des zones techniques sont exposées ou non dans l'API OData.

Options disponibles :

Pas de sélection : avec cette option, le système se comportera comme si vous aviez sélectionné V1.1.

V1.0 : les zones système peu utilisées seront exposées dans l'API OData.

V1.1 : les zones système ne seront pas exposées dans l'API OData. Il s'agit de l'option recommandée si vous créez un nouvel objet.

• Champ Sujet : définit quelle zone contient des informations sur le sujet pour l'objet, ce qui permet ensuite de déterminer l'acheminement du workflow. Seuls les champs dont le type de données est Utilisateur peuvent être utilisés pour cette configuration. Si le champ Code externe est défini avec le type de données Utilisateur, il sera utilisé comme valeur par défaut pour cette configuration.

• Acheminement du workflow : permet l’acheminement du workflow vers l’objet. Si vous sélectionnez un enregistrement de configuration de workflow, le workflow correspondant sera déclenché pour toute opération effectuée sur une instance d'objet. L’acheminement du workflow nécessite l’activation de la fonctionnalité Objets de base d’Employee Central dans Provisioning.

• Données en attente : vous pouvez ainsi contrôler si les modifications doivent être disponibles avec ou sans approbation. Si vous avez sélectionné un acheminement du workflow qui implique une approbation et que vous souhaitez que les modifications prennent effet uniquement après l'approbation, définissez cette zone sur Oui.

• Catégorie À faire : cette option est utilisée lorsque l'option Données en attente est définie sur Oui. Cela détermine pour quelle sous-section du workflow sous forme de liste À faire les approbateurs verront des notifications pour cet objet générique sur la page d’accueil.

• Catégorie d'objet : il existe différentes catégories d'objets disponibles pour déterminer le type de données qu'un objet représente : Non catégorisé, Configuration, Transactionnel par l'utilisateur, Transactionnel non utilisateur et Technique.

• Nom : il s’agit de l’identifiant de la zone et il doit être unique dans la définition d’objet actuelle, y compris les noms d’association. L'application ajoute automatiquement « cust_ » devant le nom de n'importe quelle zone personnalisée.

• Longueur maximale : applicable uniquement pour les types de données Chaîne, Traduisible, Nombre et Décimale. Elle définit le nombre de caractères pouvant être saisis pour cette zone. La longueur par défaut des zones est 255 caractères pour Chaîne et Traduisible, 38 caractères pour Nombre et 21 caractères pour Décimale, mais elle peut être modifiée par l'utilisateur final. La valeur maximale autorisée pour la zone prédéfinie peut varier d'un objet à l'autre et être pilotée par différentes applications.

• Type de données : détermine le type de valeur pouvant être indiqué pour une zone. Il existe plusieurs types de données à sélectionner, notamment :

  • Chaîne : accepte tout texte.

  • Traduisible : identique à Chaîne, mais la valeur saisie peut être traduite dans les langues disponibles.

  • Nombre : accepte uniquement les nombres sans valeur décimale. L'affichage de cette valeur de zone sera déterminé en fonction des paramètres régionaux sélectionnés par l'utilisateur connecté.

  • Décimale : accepte les nombres avec des valeurs décimales. L'affichage de cette valeur de zone sera déterminé en fonction des paramètres régionaux sélectionnés par l'utilisateur connecté.

  • Numérotation automatique : le système génère automatiquement un nouveau numéro pour chaque enregistrement. Cette zone doit toujours être définie en lecture seule. L'utilisateur final ne doit pas être autorisé à saisir des valeurs manuellement.

  • Booléen : indique Oui ou Non comme valeurs autorisées.

  • Liste de choix : les utilisateurs doivent sélectionner une option parmi les valeurs prédéfinies configurées dans une liste de choix.

  • Objet générique : crée une référence à un autre objet générique et l’utilisateur final peut sélectionner n’importe quelle instance d’objet générique référencé lors de la saisie des données.

  • Objet de base : créez une référence aux objets de base d’Employee Central. L’emplacement est un exemple d’objet de base d'Employee Central géré en dehors de MDF.

• Source de données : cette zone est utilisée uniquement pour les zones prédéfinies et ne peut pas être modifiée par les utilisateurs finaux.

• Utilisateur : fait référence tout utilisateur actif ou inactif dans le système.

• Date : accepte les informations de date. L'affichage de cette valeur de zone est déterminé en fonction des paramètres régionaux sélectionnés par l'utilisateur connecté.

• Date/heure : accepte les informations de date et d'heure (heures, minutes et secondes).

• Heure : accepte uniquement les informations d'heure (heures, minutes, secondes)

• Pièce jointe : autorise le chargement d'un document ou d'un fichier vers une instance d'objet.

• Source des valeurs valides : cet attribut s’applique uniquement à la liste de choix de type de données, à l’objet générique, à l’objet de base et à la source de données. Saisissez l'identifiant/le code de l'objet référencé. Pour faire référence à une zone de l’objet générique Pays, saisissez la valeur « Pays ». Pour une configuration de liste de choix, prenons l’exemple suivant : l’objet Poste comporte une zone appelée Importance stratégique et vous souhaitez créer une connexion entre cette zone et une liste de choix MDF. Vous devez d’abord déterminer le code de la liste de choix que vous souhaitez lier à cette zone dans le Centre de liste de choix, puis indiquer le code de la liste de choix dans Source des valeurs valides de la zone Importance stratégique dans l’objet Poste.
• Masquer l'ancienne valeur : pour l'objet avec date d'effet, les valeurs de zone modifiées à partir des enregistrements avec date d'effet précédents sont affichées avec l'ancienne valeur barrée. Si cette option est définie sur Oui, l'ancienne valeur ne sera pas affichée.
• Précision des décimales : applicable uniquement au type de données Décimale. Indique combien de chiffres après la virgule sont autorisés.
• Afficher les zéros à la fin : applicable au type de données Décimale. Si cette option est définie sur Oui, le système affichera des zéros à la fin si le nombre de chiffres après la virgule ne correspond pas à la précision des décimales.
• Inclure les utilisateurs inactifs : applicable uniquement au type de données Utilisateur. Si la valeur est définie sur Oui, les utilisateurs inactifs seront inclus dans la sélection. La valeur par défaut est Non.
• Générateur de rendu de champ d’interface : cette zone peut modifier le comportement de l’interface utilisateur. Par exemple, si vous activez la valeur displayPickListWithoutExternalCode, le système masquera le code pour la liste déroulante de liste de choix et si vous utilisez la valeur displayGOWithoutExternalCode, le système masquera le code externe pour la sélection d’objet générique. Notez qu'il s'agit de valeurs prédéfinies qui s'appliquent à un type de données spécifique. Si elles sont mal appliquées, cela entraînera un comportement indésirable ou des erreurs d'application.
• Temporaire : définissez cette option sur Oui pour que la zone devienne temporaire. Les valeurs d'une zone temporaire ne sont pas stockées dans la base de données, mais sont renseignées dans l'interface utilisateur au moment de l'exécution, avec l'aide de règles en général. Par exemple, l'âge d'une personne est déterminé en fonction de la date de naissance.
• Texte d'aide : il s'agit d'une option traduisible. Si une valeur est indiquée, une icône s'affichera en regard de la zone pour afficher l'instruction.
• Informations privées ou sensibles : vous pouvez masquer les informations sensibles dans l'interface utilisateur pour éviter d'exposer accidentellement la valeur. Si vous définissez cette option sur Oui, des astérisques (*****) seront affichés à la place de la valeur réelle. L'utilisateur doit sélectionner la zone et confirmer son intention d'afficher les valeurs dans l'interface utilisateur.
• Valeur par défaut : vous pouvez définir une valeur par défaut pour cette zone. Tous les types de données ne prennent pas en charge cette configuration.
• Masquer les secondes : utilisé pour les types de données Date/heure et Heure. Supprime les informations sur les secondes si cette option est définie sur Oui.

• Obligatoire : si ce paramètre est défini sur Oui, le champ est obligatoire et l'utilisateur doit saisir une valeur pour qu'un enregistrement puisse être sauvegardé.
• Visibilité : détermine si la zone est Modifiable, en Lecture seule ou Non visible dans l'interface utilisateur.
• Statut : la zone peut être définie comme Active ou Inactive. Les zones inactives ne sont pas disponibles dans le système. Notez qu'une zone personnalisée ne peut pas être définie sur inactive.
• Étiquette : une zone traduisible qui vous permet de modifier le descripteur de zone affiché dans l'interface utilisateur et d'autres domaines de l'application.
• Fin de la période : s'applique uniquement au type de données Date/heure. Permet de distinguer si 00:00:00 marque le début d'une date ou la fin d'une date.
• Accès en lecture au journal : activez cette option si une zone doit être suivie pour l’accès en lecture. Cette fonctionnalité n'est pas encore disponible.
• Nom du champ de base de données : zone en lecture seule et déterminée par le système.
• Règles : cette section permet d'ajouter une ou plusieurs règles métier à la zone. Lorsqu'une valeur de zone est modifiée, ces règles sont déclenchées.
• Critères de champ : vous permet de limiter les valeurs possibles pour la zone en indiquant les zones associées dans cette section.
• Condition/Valeurs de condition : vous permet d'afficher ou de masquer la zone en fonction d'une valeur saisie dans une autre zone disponible sur l'objet.

MDF prend en charge les types d’association suivants :

1. Valide quand (VQ) : pour ce type d'association, les objets associés ont leur propre cycle de vie et existent sans l'objet en cours de configuration. Les associations Valide quand sont souvent utilisées pour créer des fonctionnalités de filtrage entre les zones d'un objet donné. Par exemple, dans les données emploi de l'employé, vous disposez des zones Unité commerciale et Division. Lorsque vous sélectionnez la zone Division, vous souhaitez voir les valeurs de division valides qui s'appliquent à l'unité commerciale sélectionnée. Cependant, les divisions et les unités commerciales peuvent être gérées indépendamment de l'enregistrement de l'employé. Dans ce cas, vous devez définir une association Valide quand sur la division en référençant « Unité commerciale ».
2. Composite : ce type d'association crée une relation parent-enfant. L'entité associée est une entité enfant et ne peut pas exister en dehors de l'objet parent. L'objet enfant doit avoir une date d'entrée en vigueur « Depuis parent » pour ce type d'association. L'objet enfant peut également être associé à un seul objet parent.

   Par exemple, les valeurs de la liste de choix sont l’entité enfant de l’entité de liste de choix. Il n’est pas logique de créer une entité Valeur de liste de choix qui n’existe pas avec une entité de liste de choix (le parent).

3. Joindre par colonne (JPC) : ce type d'association permet d'associer deux objets avec une relation Un envers un, chaque objet référençant toujours l'autre objet. Définissez une zone de la définition d'objet parent comme colonne d'objet source et une zone de la définition d'objet enfant comme colonne d'objet de destination, puis l'association Joindre par colonne fera se référencer la valeur de ces deux colonnes d'objet.

   Par exemple, une Personne peut être un objet qui représente une personne réelle et les Informations personnelles peuvent être un autre objet qui stocke des informations sur la personne. Les objets Personne et Informations personnelles peuvent être des relations composites Un envers un. Dans ce cas, les informations personnelles ne peuvent pas exister sans une Personne.

   Cependant, si l'association était une association de personne JPC Un envers un, un utilisateur serait en mesure de gérer les informations personnelles en dehors de l'objet Personne. Dans cette configuration, vous devez configurer le code externe de la Personne pour faire référence au code externe de l’objet Informations personnelles.

Vous pouvez définir des zones pouvant être utilisés pour rechercher une instance d’objet MDF. Chacune des zones ajoutées à cette section sera incluse dans la recherche à différents endroits de l'application. Dans la zone, saisissez les noms des zones et/ou de l'association que vous voulez rendre accessibles à la recherche. Vous pouvez également utiliser la référence de zone pour l'inclure dans la recherche. Par exemple, si vous avez un objet avec une zone Pays qui fait référence à un objet Pays, vous pouvez ajouter cust_country.code pour effectuer une recherche en fonction du code pays.

Lorsqu’une zone est associée à une liste de choix, vous pouvez ajouter le nom de zone + « .label » comme dans la capture d’écran.

Les zones de clé de gestion sont une combinaison de deux zones ou plus et sont définies pour un objet afin que vous puissiez identifier de manière unique ses enregistrements. Vous pouvez saisir les zones de clé de gestion dans cet emplacement. Vous pouvez également supprimer ou ajouter d'autres zones en sélectionnant l'icône correspondante.

La configuration de la sécurité vous permet de contrôler quels utilisateurs peuvent afficher, modifier ou importer/exporter des données pour un objet ou une zone. Avec MDF, vous pouvez configurer la sécurité au niveau de l’objet ou de la zone. Pour les objets et les zones, vous pouvez contrôler l'accès en fonction des rôles avec autorisations basées sur les rôles dans le système.

Vous pouvez également définir les champs de la définition d’objet à utiliser pour déterminer la population cible dans les autorisations basées sur les rôles. Vous pouvez spécifier n’importe quelle zone utilisateur dans la définition d’objet actuelle en tant que zone Sujet d’autorisations basées sur les rôles. La valeur de la zone Sujet d’autorisations basées sur les rôles spécifiée peut ensuite être utilisée pour créer des groupes d’autorisations basées sur les utilisateurs dans les autorisations basées sur les rôles. Vous pouvez utiliser n’importe quelle zone dans la définition d’objet actuelle de type « utilisateur » comme zone Sujet avec autorisations basées sur les rôles. Il ne s'agit pas nécessairement du code externe.

• Sécurisé : tous les nouveaux objets MDF personnalisés exigent que le champ Sécurisé soit défini sur Oui au moment de la création. Les objets MDF existants et les objets liés aux enregistrements parents restent inchangés. Vous recevez une erreur de validation si vous tentez d’enregistrer un nouvel objet MDF personnalisé avec le champ Sécurisé défini sur Non. Les objets MDF avec une date d’entrée en vigueur FROM_PARENT et les objets MDF personnalisés existants ne sont pas impactés et le champ Sécurisé reste défini sur Non. Une fois que vous avez modifié le champ Sécurisé d’un objet MDF personnalisé existant de Non en Oui, cette action est irréversible. Vous ne pouvez pas revenir à Non. Vous ne pouvez plus créer un objet MDF personnalisé non sécurisé ou remplacer un objet MDF sécurisé par un objet non sécurisé.

  Depuis la mise à jour de version 2605, pour les nouveaux clients, les objets standard suivants ont été définis comme sécurisés par défaut :

  • Correction de la date d’embauche
  • Configuration du motif d’événement de repli
  • Autre ventilation des coûts
  • Retenues récurrentes
  • Retenues ponctuelles
  • Modèle de génération de documents
  • Options d’e-mail du modèle de génération de documents
  • Groupe de génération de documents
  • Recherche dans l’écran de création de documents
  • Déclarations d'impôt sur le revenu (ItDeclaration)
  • Type de déclaration (DeclarationType)
  • Limite temporelle pour déclarations d'impôt sur le revenu (ItDeclarationTimeBound)
  • Déclaration de régime fiscal (TaxRegimeDeclaration)
  • Version d'exercice (FiscalYearVariant)
  • Mappage d'exercice comptable sur pays/région (FiscalYearToCountryMap)

  Remarque

  Ne sélectionnez pas Personnalisé. L'option n'est pas prise en charge et sera supprimée dans les prochaines versions.

  Cette zone Sécurisé est définie sur Oui par défaut pour la création d'objets personnalisés. Il est recommandé de conserver tous les objets personnalisés comme Sécurisé = Oui, afin que les autorisations basées sur les rôles soient accordées avant de pouvoir accéder à l’objet. Vous pouvez accorder l’accès à des objets non sécurisés (Sécurisé = Non) en utilisant l’autorisation Metadata Framework pour « Accès aux objets non sécurisés et non basés sur les rôles ».

• Catégorie d’autorisation : indique la zone de la section Autorisations dans le rôle d’autorisation basée sur les rôles que l’objet peut trouver.
• Champ Sujet d’autorisations basées sur les rôles : spécifiez une zone utilisateur obligatoire dans la définition d’objet actuelle. La valeur de cette zone est utilisée pour configurer la population cible dans les autorisations basées sur les rôles.

Une fois la définition d’objet MDF créée, vous pouvez créer des instances d’objet de cette définition dans votre application. La création d’une instance d’un objet MDF permet de renseigner l’objet avec des données. À partir de la Recherche d'actions, accédez à Gérer les données. Les résultats de la recherche dans Gérer les données affichent les enregistrements créés et ceux qui sont en attente d'approbation dans un workflow configuré.