Passer au contenu principal
Documentation
Documentation
Adaptive Planning
Dernière mise à jour : 2023-06-23
Concept : codes de niveau, de dimension et d’attribut pour les noms d’affichage

Concept : codes de niveau, de dimension et d’attribut pour les noms d’affichage

L’activation des noms d’affichage dans Workday Adaptive Planning permet d’utiliser le même libellé pour plusieurs niveaux, valeurs de dimension personnalisée ou valeurs d’attribut. Cette fonctionnalité :
  • Simplifie le chargement des structures provenant de Workday Financials, Workday HCM ou d’autres systèmes externes.
  • Évite de devoir concaténer des libellés et des identifiants de référence issus de Workday ou d’autres importations pour rendre les libellés uniques dans Adaptive Planning.
  • Simplifie le processus de chargement des métadonnées lorsque les libellés coïncident.

Activer les noms d’affichage

Chaque niveau, valeur de dimension personnalisée et valeur d’attribut reçoit un code unique.
Le code fonctionne comme une clé.
Pour les formules qui incluaient un niveau, une valeur de dimension ou une valeur d’attribut,
code
 remplace
name
 pour éviter toute ambiguité. Vos chargeurs d’intégration fonctionnent tels quels et utilisent automatiquement le code pour les mappages de colonnes.
L’activation des noms d’affichage réinitialise les seuils de détection des anomalies à 40 %.

Codes des métadonnées

Avant l’introduction des noms d’affichage, les noms dans un niveau, une dimension personnalisée ou un attribut devaient être uniques.
Pour une instance préexistante, nous générons automatiquement des codes à votre intention en réutilisant les noms que vous avez déjà créés.
Les codes sont toujours affichés entre crochets dans Workday Adaptive Planning, ce qui facilite leur identification. Exemple : [westeu01].

Nom d’affichage et format du nom d’affichage

Les noms d’affichage ajoutent le champ
Nom d’affichage
 en lecture seule pour les niveaux, les valeurs de dimension et les valeurs d’attribut. Le nom d’affichage constitue le libellé que voient les utilisateurs pour les éléments de métadonnées (auparavant le champ de nom) dans toute l’interface Workday Adaptive Planning. Chaque fois qu’un utilisateur choisit, sélectionne ou consulte un élément de métadonnées, son nom d’affichage apparaît.
Pour les instances Workday Adaptive Planning préexistantes,
Nom
 est automatiquement chargé en tant que format de nom d’affichage. Vous pouvez sélectionner le format de nom d’affichage de votre choix, parmi les possibilités suivantes, dans les pages d’administration des niveaux, des dimensions et des attributs :
  • Nom
  • Code
  • Nom [Code]
  • [Code] Nom
Vous pouvez configurer le format du nom d’affichage au niveau de la racine de chaque dimension. Le code s’affiche pour chaque valeur.
Les paramètres Nom d’affichage et Code peuvent chacun contenir 2 048 caractères, ou 4 096 caractères à eux deux.
Tout changement apporté aux composants d’un nom d’affichage est susceptible de modifier l’ordre de tri des éléments dans les fenêtres d’administration des dimensions ou des attributs, lorsque l’option
Conserver le tri
 est activée.

Noms d’affichage dans les importations de structures

L’importation de structures de niveaux, de dimensions personnalisées et d’attributs prend en charge le code en exigeant la présence de colonnes Format du nom d’affichage, Code de la valeur et Nom de la valeur dans les modèles d’importation. La colonne Nom est remplacée par les colonnes Code de la valeur et Nom de la valeur.
Pensez à toujours télécharger les nouveaux modèles d’importation et suivez les instructions figurant sur la première feuille. L’introduction des noms d’affichage modifie les colonnes et noms de colonne requis dans les modèles. Ne réutilisez pas d’anciens modèles ou des modèles venant d’instances sans noms d’affichage.
N’utilisez pas les importations pour changer les noms ou les codes de niveaux. Vous devez effectuer ces changements manuellement dans l’application.
Pour les hiérarchies, vous devez indiquer des valeurs parents en référençant le code parent.
Les importations de structures requièrent que les colonnes suivantes prennent en charge les noms d’affichage :
Importation des niveaux
  • Format du nom d’affichage du niveau
  • Niveau Code
  • Code de la valeur d’attribut
  • Nom de la valeur d’attribut
Importation des dimensions
  • Format du nom d’affichage de la dimension
  • Code de la valeur de dimension
  • Nom de la valeur de dimension
  • Code de la valeur d’attribut
  • Nom de la valeur d’attribut
Importation des attributs
  • Format du nom d’affichage de l’attribut
  • Code de la valeur d’attribut
  • Nom de la valeur d’attribut
Importation des comptes
  • Code de la valeur d’attribut
  • Nom de la valeur d’attribut
Les vues imprimables de niveaux, de dimensions et d’attributs contiennent toutes des colonnes Format du nom d’affichage, Code de la valeur et Nom de la valeur.

Éléments du nom d’affichage dans Intégration

L’introduction de codes de métadonnées dans les intégrations Workday Adaptive Planning facilite les opérations suivantes :
  • Mappage, en aidant les utilisateurs à associer des éléments de métadonnées externes aux éléments internes à Workday Adaptive Planning.
  • Affichage d’information, en aidant les utilisateurs d’Intégration à faire la distinction entre les différents libellés en double.
  • Recherche, en aidant les utilisateurs à trouver des éléments précis en fonction du code de métadonnées.
Le mappage, l’affichage et la recherche ont lieu pendant la création et la maintenance de sources de données, de chargeurs de données et de chargeurs de métadonnées.

Éléments du nom d’affichage dans la source de données Planning

Lorsque vous créez des paramètres partagés dans une source de données Planning, vous pouvez :
  • Voir le nom d’affichage et le code relatifs aux niveaux, valeurs de dimension et valeurs d’attribut.
  • Rechercher des paramètres partagés par nom d’affichage ou par code.
Inclure les codes des sources gérées
Suite à l’introduction des noms d’affichage pour une instance existante, vous pouvez cliquer sur
Gérer les sources
 et sélectionner
Inclure les codes
 pour les sources ci-après, qui peuvent inclure des niveaux, des dimensions et des attributs, ou appliquer des filtres sur ces derniers :
  • Source personnalisée.
  • Feuille cube.
  • Feuille modélisée.
Une fois que vous avez sélectionné
Inclure les codes
, vous ne pouvez plus désactiver cette option.
Pour les nouvelles sources gérées que vous créez après l’introduction des noms d’affichage, l’option
Inclure les codes
 est automatiquement sélectionnée par défaut.

Éléments du nom d’affichage dans les chargeurs Intégration

À la suite de l’introduction des noms d’affichage, les chargeurs de dimensions, d’attributs et de niveaux sont automatiquement mappés au code pour les mappages de colonnes. Si vous avez besoin de mapper automatiquement les colonnes, vous pouvez sélectionner le mappage automatique par code ou par nom.
Mappage de colonnes de chargeur de données Planning
Lorsque vous soumettez des données, elles sont chargées par code plutôt que par nom. Lorsque vous mappez des colonnes au moyen de l’onglet
Mappage de colonnes
, mappez la Colonne Identifiant source à Code. Mappez la colonne Nom d’affichage de la source à Nom.
Mappage de données de chargeur de données Planning
Lorsque vous cliquez sur l’onglet
Mappage de données
, vous pouvez mapper automatiquement toutes les colonnes ou seulement certaines d’entre elles par :
  • Colonne Identifiant source.
  • Colonne Nom d’affichage de la source.
Lorsque vous téléchargez des mappages à partir de l’onglet
Mappage de données
, le modèle utilise le code dans la Colonne Identifiant source. Lorsque vous téléchargez des mappages, le modèle attend un code dans la Colonne Identifiant source.
Paramètres de source de données du chargeur de données Planning
L’onglet Paramètres de source de données du chargeur de données Planning comprend une section de mappage automatique. Cette section vous permet éventuellement de mapper automatiquement les nouveaux comptes, niveaux ou valeurs de dimension lors de l’exécution du chargeur. Le mappage automatique des niveaux et des dimensions prend en charge le code avec les options suivantes :
  • Mapper automatiquement l’identifiant source à un code.
  • Mapper automatiquement le nom d’affichage de la source à un code.

Afficher des éléments de nom dans les API

Grâce à l'introduction de noms d'affichage, vos API peuvent prendre en charge les métadonnées
code
 si :
  • Vous utilisez l'API v30 ou une version plus récente dans votre appel.
  • Vous incluez
    displayNameEnabled=1
     paramètre dans
    dimensions
     élément,
    attributes
     élément, et
    levels
     élément.
Inclusion
displayNameEnabled=0
 pour un élément désactive les noms d’affichage pour cet élément, ce qui empêche l’utilisation de
code
 et utilise
name
 plutôt.
Ces API en bloc prennent en charge
code
 lorsque vous activez les noms d’affichage, mais que tous utilisent l’identifiant comme clé :
  • updateAttributes
  • updateDimensions
  • updateLevels
  • importDimensionMapping
Ces API de données prennent en charge
code
 avec l’introduction des noms d’affichage :
  • eraseData
  • exportConfigurableModelData
  • exportData
  • importConfigurableModeleData
  • importStandardData
  • importCubeData
  • importTransactions
Pour plus d’information sur l’utilisation des éléments de nom d’affichage dans les demandes et les réponses, consultez la page de documentation de chaque API.
Marquage d'attributs d'API de métadonnées en bloc dans les API v32 et v33
Ces API en bloc prennent en charge
valueCode
 Et
valueName
 pour l’API v32 et l’API v33 avec ajout de noms d’affichage et d’utilisation
displayNameEnabled=1
:
  • updateLevels
     participation
    valueCode
     Et
    valueName
     dans la section
    dimension
     Et
    attribute
     éléments.
  • updateAccounts
     participation
    valueCode
     Et
    valueName
     dans la section
    attribute
     élément.
  • updateDimensions
     participation
    valueCode
     Et
    valueName
     dans la section
    attribute
     élément.
  • exportLevels
     participation
    valueCode
     Et
    valueName
     dans la section
    dimension
     Et
    attribute
     éléments.
  • exportAccounts
     participation
    valueCode
     Et
    valueName
     dans la section
    attribute
     élément.
  • exportDimensions
     participation
    valueCode
     Et
    valueName
     dans la section
    attribute
     élément.
Une fois que vous avez activé les noms d’affichage et utilisé l’API v32 ou l’API v33, ces API ne prennent plus en charge
name
 dans l'élément d'attribut.
API de métadonnées uniques
Les API de métadonnées uniques suivantes ne prennent pas en charge les noms d’affichage :
  • updateDimension
  • updateDimensionValue
  • updateLevel
  • createDimension
  • createDimensionValue
  • createLevel

Éléments du nom d’affichage dans Formules

À la suite de l’introduction des noms d’affichage, vous devez utiliser le code pour référencer un niveau, une valeur de dimension personnalisée ou une valeur d’attribut dans une formule. Dans l’assistant de formule, là où vous avez vu un nom, c’est maintenant un nom d’affichage qui apparaît.
Le sélecteur d’éléments de l’assistant de formule génère des résultats de recherche en fonction à la fois du nom d’affichage et du code. Seul le code d’un élément devient une partie de la formule.
Afficher des éléments de nom et une notation par points de formule pour les propriétés
L'introduction de noms d'affichage déclenche l'utilisation de
code
 en notation par points de la formule pour les propriétés. Quand vous créez des formules à l’aide de la notation par points pour les propriétés, vous pouvez référencer des niveaux, des valeurs de dimension personnalisées et des valeurs d’attributs par
code
.
Pour la notation par points, vous devez modifier manuellement toute valeur existante.
.name
 références à
.code
 avec l’introduction de noms d’affichage.
Vous ne pouvez pas utiliser le nom d’affichage dans la notation par points, car il ne peut garantir l’unicité pendant le calcul.
Si vous modifiez le format du nom d’affichage après avoir utilisé des formules pour les calculs personnalisés dans des rapports, vérifiez que ces formules sont correctes.

Éléments du nom d’affichage dans Feuilles

Suite à l’introduction des noms d’affichage, deux options de téléchargement des données de feuilles modélisées sont disponibles :
  • Télécharger
     : exporte les codes relatifs aux niveaux, valeurs de dimension et valeurs d’attributs dans la feuille. Utilisez cette option si vous prévoyez de réimporter ensuite les données dans la feuille modélisée.
  • Vue imprimable
     : exporte le nom d’affichage configuré pour les niveaux, les valeurs de dimension et les valeurs d’attribut. Utilisez cette option si vous souhaitez que la feuille de calcul corresponde à vos
    Options d’affichage
     actuelles. Vous ne pouvez pas importer cette version de la feuille de calcul.
Pour sélectionner l’une des options suivantes :
  • Lorsque vous ouvrez des feuilles modélisées dans l’Aperçu des feuilles, cliquez sur la flèche en regard du bouton
    Télécharger
    .
  • Lorsque vous ouvrez des feuilles modélisées dans un tableau de bord, cliquez sur l’icône
    Plus
    .
Pour les feuilles standard et cubes, l’option
Télécharger
 continue d’exporter les noms d’affichage des niveaux, des valeurs de dimension et des valeurs d’attribut. Elle continue également de faire correspondre les
Options d’affichage
 que vous avez définies dans la feuille.

Éléments du nom d’affichage dans Rapports

Les générateurs de rapports présentent les éléments de métadonnées par nom d’affichage, en fonction du format de nom d’affichage que vous avez sélectionné dans les éléments suivants :
  • Rapports matriciels.
  • Rapports modèles.
Lorsque vous consultez un rapport, les éléments sont chargés avec leur nom d’affichage. Lorsque vous créez des rapports en faisant glisser des éléments vers un générateur, seul le nom d’affichage apparaît.
L’assistant de formule des rapports matriciels affiche les éléments dans le sélecteur par nom d’affichage. Les formules des calculs personnalisés utilisent toujours le code pour les éléments que vous sélectionnez.
Les filtres de rapport modèle utilisent le nom d’affichage.

Éléments de nom d’affichage dans les actualisations des niveaux liés

À la suite de l’introduction des noms d’affichage pour les instances parents et enfants dans un environnement multi-instance, les actualisations des niveaux liés remplacent les noms par des noms d’affichage.

Noms d’affichage dans OfficeConnect

Pour tous les éléments de rapport OfficeConnect, nous fournissons la valeur du type de libellé Nom d’affichage dans les définitions de libellé. Cette valeur de type de libellé prend en charge les noms de métadonnées en double dans Adaptive Planning.

Importer des modèles

Les formats de modèles d’importation et les instructions fournies dans
Integration
Import Data
 indiquent qu’il est nécessaire de disposer de codes comme identifiants uniques dans les importations pour les éléments suivants :
  • Importation de données standard
  • Importation de données de feuille modélisée
  • Importation de données de feuille cube
  • Importation de données de transaction
Toutes les colonnes de dimension sont divisées en 2 colonnes :
  • Dimension Code
  • Dimension Nom
La colonne Dimension Nom est facultative. Si cette colonne n’existe pas, Dimension Code devient Dimension Nom. Il peut y avoir des valeurs de nom de dimension en double si les codes de dimension varient.
Les en-têtes de colonne des niveaux indiquent :
  • Niveau Code
Les en-têtes de colonne des comptes acceptent l’un ou l’autre des libellés suivants :
  • Code du compte
  • Compte
Vous pouvez sélectionner
Importer sans les colonnes Code et Nom pour les noms d’affichage
 pour importer des modèles sans colonnes pour les champs Code et Nom. Cette option permet également d’effectuer des importations depuis d’anciens modèles créés avant l’introduction des noms d’affichage. Lorsque vous activez
Activer l’importation/exportation des données d’une seule colonne pour le nom d’affichage
 dans le
Paramétrage général
, nous appliquons
Importer sans les colonnes Code et Nom pour les noms d’affichage
 dans l’ensemble de l’application et masquons l’option dans la page Importer.