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

Concept : codes de périmètre, 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 périmètres, valeurs de dimensions personnalisées 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 codes de référence issus de Workday ou d'autres imports pour rendre les libellés uniques dans Adaptive Planning.
  • Simplifie le chargement des métadonnées lorsque les libellés coïncident.

Activer les noms d'affichage

Chaque périmètre, valeur de dimension personnalisée et valeur d'attribut reçoit un code unique.
Ce code fonctionne comme une clé.
Pour les formules qui incluaient un périmètre, une valeur de dimension ou une valeur d'attribut :
code
 remplace
name
 pour éviter toute ambiguïté. Vos chargeurs Integration fonctionneront comme d'habitude et utiliseront 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 périmètre, 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 périmètres, 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 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 indiqué 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 périmètres, 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 imports de structures

L'import de structures de périmètres, de dimensions personnalisées et d'attributs prend en charge le code en exigeant la présence de colonnes Format du nom d'affichage, Value Code et Value Name dans les modèles d'import. La colonne Nom est remplacée par les colonnes Value Code et Value Name.
Pensez à toujours télécharger les nouveaux modèles d'import 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 imports pour modifier les noms ou les codes des périmètres. Vous devez effectuer ces modifications manuellement dans l'application.
Pour les hiérarchies, vous devez indiquer des valeurs parents en référençant le code parent.
Les imports de structures requièrent que les colonnes suivantes prennent en charge les noms d'affichage :
Import des périmètres
  • Format du nom d'affichage du périmètre
  • Périmètre Code
  • Code de la valeur d'attribut
  • Nom de la valeur d'attribut
Import 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
Import des attributs
  • Format du nom d'affichage de l'attribut
  • Code de la valeur d'attribut
  • Nom de la valeur d'attribut
Import des comptes
  • Code de la valeur d'attribut
  • Nom de la valeur d'attribut
Les vues imprimables de périmètres, dimensions et attributs contiennent toutes des colonnes Format du nom d'affichage, Value Code et Value Name.

Éléments du nom d'affichage dans Integration

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'informations, en aidant les utilisateurs d'Integration à faire la distinction entre les différents libellés en double.
  • Recherche, en aidant les utilisateurs à trouver des éléments spécifiques 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 périmètres, 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 périmètres, des dimensions et des attributs ou appliquer des filtres sur ces derniers :
  • Source personnalisée.
  • Feuille cube.
  • Feuille modèle.
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 Integration

Suite à l'introduction des noms d'affichage, les chargeurs de dimensions, d'attributs et de périmètres 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 via l'onglet
Mappage de colonnes
, mappez 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 la source de données du chargeur de données Planning
L'onglet Paramètres de la 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, périmètres ou valeurs de dimension lors de l'exécution du chargeur. Le mappage automatique des périmètres 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 source à un code.

Éléments du nom d'affichage dans les API

Suite à l'introduction des noms d'affichage, vos API peuvent prendre en charge les métadonnées.
code
 si :
  • Vous utilisez des API version 30 ou ultérieure dans votre appel.
  • Vous incluez les éléments
    displayNameEnabled=1
     paramètre dans le
    dimensions
     élément,
    attributes
     élément et
    levels
     élément.
Inclus
displayNameEnabled=0
 pour un élément désactive les noms d'affichage pour cet élément, empêchant l'utilisation de
code
 et utilise
name
 à la place.
Ces API de traitement en bloc prennent en charge
code
 lorsque vous activez les noms d'affichage, mais que tous utilisent Identifiant comme clé :
  • updateAttributes
  • updateDimensions
  • updateLevels
  • importDimensionMapping
Ces API de données prennent en charge
code
 Suite à l'introduction des noms d'affichage :
  • eraseData
  • exportConfigurableModelData
  • exportData
  • importConfigurableModelData
  • importStandardData
  • importCubeData
  • importTransactions
Pour plus d'informations 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 traitement en bloc de métadonnées dans les API v32 et V33
Ces API de traitement en bloc prennent en charge
valueCode
 et
valueName
 pour API v32 et API v33 avec l'introduction des noms d'affichage et de l'utilisation
displayNameEnabled=1
:
  • updateLevels
     contribue à
    valueCode
     et
    valueName
     dans la section
    dimension
     et
    attribute
     éléments.
  • updateAccounts
     contribue à
    valueCode
     et
    valueName
     dans la section
    attribute
     élément.
  • updateDimensions
     contribue à
    valueCode
     et
    valueName
     dans la section
    attribute
     élément.
  • exportLevels
     contribue à
    valueCode
     et
    valueName
     dans la section
    dimension
     et
    attribute
     éléments.
  • exportAccounts
     contribue à
    valueCode
     et
    valueName
     dans la section
    attribute
     élément.
  • exportDimensions
     contribue à
    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 attribute.
API de métadonnées uniques
Les API de métadonnées uniques suivantes ne prennent pas en charge les noms d'affichage :
  • updateDimensions
  • updateDimensionValue
  • updateLevels
  • createDimension
  • createDimensionValue
  • createLevel

Éléments du nom d'affichage dans Formules

Suite à l'introduction des noms d'affichage, vous devez utiliser le code pour référencer un périmètre, 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.
Éléments du nom d'affichage et notation par points des formules pour les propriétés
L'introduction des noms d'affichage entraîne l'utilisation de
code
 dans la notation par points des formules pour les propriétés. Lorsque vous créez des formules à l'aide de la notation par points des propriétés, vous pouvez référencer des périmètres, des valeurs de dimensions personnalisées et des valeurs d'attributs par :
code
.
Pour la notation par points, vous devez modifier manuellement
.name
 fait référence à
.code
 Suite à l'introduction des noms d'affichage.
Vous ne pouvez pas utiliser le nom d'affichage dans la notation par points, car le caractère unique lors du calcul ne peut pas être garanti.
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èles sont disponibles :
  • Télécharger
     : exporte les codes relatifs aux périmètres, 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èle.
  • Vue imprimable
     : exporte le nom d'affichage configuré pour les périmètres, 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èles dans l'Aperçu des feuilles, cliquez sur la flèche en regard du bouton
    Télécharger
    .
  • Lorsque vous ouvrez des feuilles modèles 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 périmètres, 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 périmètres liés

Suite à l'introduction des noms d'affichage pour les instances parents et enfants dans un environnement multi-instance, les actualisations des périmètres 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.

Modèles d'import

Les formats de modèle d'import et les instructions fournies dans
Integration
Importer des données
 indiquent la nécessité d'utiliser des codes comme identifiants uniques dans les imports pour les éléments suivants :
  • Import de données standard
  • Import de données de feuille modèle
  • Import de données de feuille cube
  • Import 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 périmètres indiquent :
  • Périmètre 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 imports depuis d'anciens modèles créés avant l'introduction des noms d'affichage. Lorsque vous activez l'option
Activer l'import/export des données d'une seule colonne pour le nom d'affichage
 dans
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 sur la page Importer.