Passer au contenu principal
Documentation
Documentation
Adaptive Planning
Dernière mise à jour : 2023-06-23
Créer des chargeurs de dimensions Planning

Créer des chargeurs de dimensions Planning

Les chargeurs de métadonnées synchronisent les informations hiérarchiques des systèmes sources dans les hiérarchies de votre modèle de planification. Vos hiérarchies doivent déjà exister dans votre système source avant que vous ne tentiez de synchroniser.
Les demandes d'un chargeur de dimensions Planning sont limitées à la mise à jour de 10 000 valeurs de dimensions maximum dans une dimension hiérarchique ou de 40 000 valeurs de dimensions dans une dimension plate. Ces limites ne s'appliquent pas à la création de nouvelles valeurs de dimensions dans la demande d'un chargeur.
Le chargeur de dimensions Planning vous permet de mapper des métadonnées relatives aux valeurs de dimensions de la zone de stockage temporaire à
Adaptive Planning
. Le principal avantage du chargeur de dimensions Planning est qu'il vous permet d'importer des valeurs de dimensions en bloc plutôt que d'en créer une à la fois dans Modélisation > Gestion du modèle > Dimensions. Une fois le chargeur créé, vous pouvez l'exécuter manuellement ou planifier son exécution dans le cadre d'une tâched'intégration.

Pour créer un chargeur de dimensions Planning, procédez comme suit :
  1. Saisir les paramètres de la source de données
  2. Configurer le mappage des colonnes
  3. Créer des règles de gestion
  4. Prévisualiser la sortie du chargeur
  5. Exécuter ou planifier le chargeur

Avant de commencer

Le chargeur de dimensions Planning nécessite des données temporaires issues de l'import d'une source de donnéesexistante.

Saisir les paramètres de la source de données

Les paramètres de source de données vous permettent de sélectionner la table source que vous souhaitez utiliser dans les données temporaires, sélectionnez la dimension Planning à charger et indiquez si de nouvelles valeurs de dimensions doivent être créées automatiquement ou pas.
  1. Accédez à
    Intégration > Concevoir des intégrations
    .
  2. Cliquez sur
    Créer un nouveau chargeur
     dans la zone Chargeurs de la Bibliothèque de composants.
  3. Sélectionnez
    Chargeur de dimensions Planning
     comme type de chargeur. Donnez un nom au chargeur.
  4. Cliquez sur
    Créer
    .
Une bonne pratique consiste à enregistrer régulièrement votre travail lorsque vous créez et modifiez votre chargeur en cliquant sur
Enregistrer
 dans le panneau Actions. Vous pouvez ignorer toute modification non enregistrée en cliquant sur
Fermer
, puis sur
Non
.
Saisissez les informations générales suivantes dans les propriétés du chargeur de dimensions Planning :
  • Table source :
     sélectionnez la table source dans la liste déroulante. Les tables source dans la liste correspondent à toutes les tables disponibles dans la zone de stockage temporaire à laquelle vous avez accès.
  • Dimension Planning :
     sélectionnez une dimension parmi toutes les dimensions de la source dans laquelle les éléments devront être chargés. Les dimensions répertoriées proviennent de Modélisation > Gestion du modèle > Dimensions.
  • Créer une valeur de dimension si elle n'existe pas dans Planning :
     cochez cette case pour créer automatiquement de nouvelles valeurs de dimensions dans le système source qui sont introuvables dans Modélisation > Gestion du modèle > Dimensions. Si cette option n'est pas cochée, seules les valeurs de dimensions existantes seront mises à jour et aucune dimension ne sera créée.
    • Si l'option L'import de données crée automatiquement des valeurs de dimension n'est pas activée dans Modélisation > Gestion du modèle > Dimensions pour la dimension que vous chargez, le chargeur vous avertira.
  • Niveau de journalisation :
     sélectionnez le type de détails journalisés lors de l'exécution du chargeur.
    • Erreur
       
      :
       consigne uniquement les erreurs graves.
    • Informations
       
      :
       consigne les informations de base, telles que la date de mise à jour du chargeur.
    • Mode détaillé
       
      :
       fournit des informations détaillées sur toutes les phases et actions. Ce périmètre est principalement utilisé pour le débogage ou l'audit, car il peut générer plus d'informations de journal que nécessaire pour une utilisation normale.

Configurer le mappage des colonnes

Le mappage des colonnes vous permet de mapper des colonnes de la source de données aux valeurs de dimensions disponibles dans Modélisation > Gestion du modèle > Dimensions.
S'il existe plusieurs colonnes à mapper, vous pouvez utiliser le filtre
Afficher
 pour sélectionner :
  • Tout
     : affiche toutes les colonnes Planning.
  • Obligatoire
     : affiche toutes les colonnes Planning obligatoires.
  • Non mappé
     : affiche toutes les colonnes Planning non mappées.
  • Mappé
     : affiche toutes les colonnes Planning mappées.
Vous pouvez utiliser le champ
Rechercher
 pour rechercher des colonnes. Saisissez un nom complet ou partiel pour effectuer des recherches et cliquez sur la loupe. Les colonnes temporaires correspondant à la recherche apparaissent dans les résultats.
Mapper les colonnes
  1. Cliquez sur
    Mappage de colonnes
    .
    L'onglet Mappage de colonnes contient les éléments suivants :
    • Statut :
       indique si une colonne Planning est mappée. Une coche Colonne mappée indique une colonne mappée. Un point d'exclamation Colonne non mappée indique une colonne non mappée.
    • Colonne Planning :
       affiche toutes les colonnes Planning disponibles pour le mappage sur une feuille. La liste des colonnes Planning comprend un ensemble de colonnes Planning obligatoires, suivies d'autres colonnes Planning. Les colonnes Planning obligatoires sont indiquées en caractères gras avec un astérisque et comprennent une colonne Valeur. Les colonnes non obligatoires comprennent le nom abrégé et la description.
    • Colonne source :
       affiche les colonnes de la table temporaire sélectionnée dans les paramètres de la source de données.
  2. Sélectionnez une colonne non mappée et cliquez sur le menu déroulant. Une liste des colonnes que vous pouvez mapper s'affiche dans la liste déroulante. À mesure que vous mappez les colonnes, l'indicateur de statut passe du rouge IntegrationMappingUnmapped.png au vert IntegrationMappingMapped.png.
Lorsque l'option
L'import de données crée automatiquement des valeurs de dimension
 est activée, vous pouvez mapper les attributs par code. Le nom de l'attribut devient automatiquement le code.
Pour consulter un exemple de mappage des valeurs de dimension et de leurs parents à Planning, consultez Exemple : charger des valeurs de dimensions depuis une source de données de type feuille de calcul.
Modifier les noms de valeurs de dimensions Planning lors du chargement
Pour modifier le nom d'une valeur de dimension Planning lors du chargement, procédez comme suit :
  1. Sélectionnez la colonne source qui identifie de manière unique la valeur de dimension dans la source.
  2. Mappez la colonne d'identifiant à l'identifiant de la valeur de dimension.
  3. Mappez le nom au nom de la valeur de dimension.
Annuler le mappage des colonnes
Pour annuler le mappage des colonnes, cliquez sur
Annuler le mappage
 et sélectionnez les éléments suivants :
  • Annuler tous les mappages
     
    :
     annule le mappage de toutes les colonnes.
  • Annuler le mappage de la sélection
     
    :
     annule uniquement le mappage des colonnes sélectionnées.
Lors de l'annulation du mappage d'une colonne, l'icône de statut de mappage devient rouge IntegrationMappingUnmapped.png.
Mapper des attributs associés aux dimensions en liste
Vous pouvez associer des attributs à une dimension en liste en mappant des colonnes depuis l'import d'une source de données.
L'association d'attributs aux dimensions est uniquement possible pour les dimensions en liste. Vous ne pouvez pas associer des attributs à des dimensions hiérarchiques.
Dans
Adaptive Planning
 vous pouvez aller dans
Gestion du modèle
 >
Dimensions
 et cliquer sur une dimension pour afficher ses détails et savoir s'il s'agit d'une dimension de liste.
Dans Paramètres de la source de données, sélectionnez une dimension en liste comme
Dimension Planning
.
Les attributs deviennent disponibles sous forme de colonnes dans Mappage de colonnes, car cette dimension correspond à une dimension en liste.
Les dimensions en liste n'étant pas hiérarchiques, parentId n'est pas une option pour la colonne source.

Télécharger et charger des mappages

Vous pouvez télécharger des mappages, les modifier, puis les charger à nouveau pour permettre aux chargeurs de résoudre rapidement les erreurs de mappage. Chaque chargement se traduit par une action de remplacement intégral. Lors du chargement, une seule feuille de mappages du fichier est traitée. Le traitement des feuilles de mappages supplémentaires s'interrompra et le téléchargement sera annulé.
  1. Cliquez sur
    Télécharger les mappages de membres
     dans le panneau
    Actions
    .
  2. Téléchargez le fichier .XLSX. Vous recevez également un e-mail ou une notification Workday avec un lien de téléchargement vers le fichier de mappages.
  3. Ouvrez le fichier et, dans les feuilles de mappages, recherchez les valeurs de table temporaire à l'origine des erreurs.
    Toutes les cellules marquées (NON VALIDE) dans les colonnes
    Code Planning
     ou
    Nom Planning
     indiquent que ce code n'existe plus dans Workday Adaptive Planning.
  4. Corrigez les erreurs et cliquez sur
    Télécharger les mappages de membres
     pour charger le fichier. La colonne
    Lecture seule
     n'est pas chargée.
  5. Exécutez à nouveau le chargeur.
Ne cliquez pas sur
Supprimer les mappages de membres
 sauf si vous y êtes invité par votre partenaire d'implémentation ou par le support Workday Adaptive Planning.

Créer des règles de gestion

Vous pouvez utiliser des
Règles de gestion
 pour créer des expressions SQL limitant les données temporaires qui sont disponibles pour le chargement. Seuls les enregistrements répondant à vos critères de filtrage seront chargés.
Pour créer un filtre SQL :
  1. Dans l'onglet
    Règles de gestion
    , cliquez sur
    Filtre SQL
    . Cliquez sur
    Modifier
    .
  2. Saisissez une expression SQL. Vous pouvez cliquer sur un élément dans la liste Colonnes disponibles pour inclure cette colonne dans l'expression SQL plutôt que de la saisir.
  3. Cliquez sur
    Appliquer
     pour vérifier votre syntaxe SQL. En cas d'erreurs de syntaxe, un cadre rouge entoure l'expression. Passez votre curseur sur l'éditeur SQL pour afficher les informations concernant l'erreur de syntaxe.
    Pour obtenir de l'aide sur la syntaxe SQL, cliquez sur l'
    aide en ligne
     dans la section Remarques de la boîte de dialogue Modifier le filtre SQL. Vous pouvez également consulter la référence de l'expression SQL.
  4. Corrigez les erreurs de syntaxe et cliquez sur
    Appliquer
    . Seules les lignes temporaires correspondant à l'expression SQL seront importées lorsque vous exécuterez le chargeur.

Prévisualiser la sortie du chargeur

Vous pouvez prévisualiser la sortie du chargeur avant d'effectuer un chargement complet pour vérifier que les mappages sont conformes à vos exigences. Vous pouvez également télécharger sa sortie sous forme de fichier XML pour vérifier manuellement les valeurs de dimensions de votre source de données, par rapport à vos exigences, avant de les charger.
  1. Cliquez sur
    Prévisualisation de la sortie du chargeur
     dans le panneau Actions.
  2. (Facultatif) Saisissez les paramètres de prévisualisation de la sortie du chargeur. Les informations que vous pouvez saisir varient en fonction de la source de données que vous sélectionnez pour ce chargeur de dimensions Planning. La modification des paramètres importe ici de nouvelles données dans les tables et colonnes temporaires.
  3. Cliquez sur
    Prévisualiser la sortie du chargeur
    .
Le chargeur s'exécute en appliquant toutes les transformations et règles de gestion. Une fenêtre contextuelle de statut affiche les étapes que le chargeur a exécutées. Si des valeurs de dimensions doivent être chargées, le chargeur crée un fichier XML et envoie une notification par e-mail avec la sortie du chargeur sous forme de pièce jointe XML zippée.
À l'issue de l'exécution du chargeur, une fenêtre contextuelle supplémentaire vous permet de télécharger la prévisualisation de la sortie du chargeur sous forme de fichier XML zippé. L'affichage de la fenêtre contextuelle de téléchargement peut prendre un certain temps, selon le nombre de valeurs de dimensions et la taille du fichier.
Corriger les erreurs de validation
Lorsque des valeurs de dimensions sont chargées, les données source sont validées pour les erreurs suivantes :
  • La valeur de l'identifiant source pour la valeur de dimension est manquante (vide) dans les données.
  • Les données contiennent des identifiants source en double. Les identifiants source doivent être uniques.
  • Un nom de valeur de dimension est manquant (vide) dans les données.
  • Les données contiennent des noms de valeurs de dimensions en double.
  • ParentId est identique à l'identifiant source dans les données. Dans ce cas, la colonne fait référence à elle-même en tant qu'élément parent.
  • Lors de l'import d'une sous-arborescence, la racine de cette dernière est mappée vers un nœud existant dans Planning. Dans ce cas, l'IDparent ne figure pas dans les données source d'un nouveau nœud à insérer dans Planning.
  • Un nœud existant est déplacé sous un nouveau nœud et l'indicateur Créer est désactivé. Dans ce cas, une valeur de dimension existante est déplacée dans un nouveau nœud lorsqu'il est explicitement indiqué au chargeur de ne pas créer de nouvelles valeurs de dimensions.
  • Les données ont une référence cyclique dans leur hiérarchie. Dans ce cas, ParentId fait référence à son propre enfant en tant que parent.

Exécuter le chargeur

Après avoir enregistré un chargeur de dimensions Planning avec tous les paramètres de configuration requis, le chargeur peut être exécuté manuellement ou comme tâche d'intégration planifiée.
Patientez 15 à 30 minutes entre chaque exécution du chargeur de dimensions Planning pour que :
Adaptive Planning
 a le temps de se synchroniser avec votre import. Les imports plus volumineux nécessitent plus de temps pour se synchroniser. Le temps d'attente dépend de la taille du modèle et d'autres facteurs.
Vous pouvez importer des données directement depuis le système source ou exécuter le chargeur en utilisant les valeurs temporaires déjà importées. Lors de l'exécution du chargeur, sélectionnez le comportement souhaité. Cliquez sur
Ignorer l'import des données
pour utiliser la table temporaire existante pour le chargement. L'option Ignorer l'import des données n'est pas disponible lorsque vous utilisez des feuilles de calcul comme sources de données.
Dans le cadre du processus d'exécution, le chargeur vérifie que les données de la table temporaire ont été correctement mappées. Plusieurs validations sont appliquées pendant le chargement. Toute erreur survenant au cours du chargement indique les points à résoudre afin que l'import s'effectue correctement.
Inclure le chargeur de dimensions Planning dans une tâche d'intégration
Une tâche d'intégration peut contenir un ou plusieurs chargeurs. Une tâche peut également contenir d'autres tâches d'intégration, ainsi que des chargeurs de métriques et des chargeurs de scripts Discovery.
Une bonne pratique consiste à utiliser une tâche d'intégration distincte par chargeur.
Si une tâche contient plusieurs chargeurs, les paramètres de chaque chargeur seront présentés à chaque exécution de la tâche. Si un paramètre commun/partagé est utilisé dans le(s) chargeur(s) d'une tâche, alors la tâche ne lancera le paramètre qu'une seule fois. Vous pouvez choisir de remplacer les invites des paramètres.
Pour les exécutions planifiées de la tâche, les valeurs par défaut des paramètres, stockées lors de la création des chargeurs, sont utilisées.
Messages de dépannage et avertissements
Pour obtenir une explication concernant les messages consignés lors d'un chargement, voir Référence : consigner les messages des chargeurs de dimensions Planning.

Charger des modifications dans une valeur de dimension source

Le chargeur de dimensions Planning peut renommer une valeur de dimension lors du chargement, à condition qu'un mappage ait déjà été établi à la valeur de dimension source.
Le tableau suivant illustre les mappages que le chargeur a déjà établis. La valeur de dimension de la source "États-Unis" est mappée à la colonne Identifiant source "1001".
Valeur de dimension Planning
Colonne Identifiant source
Valeur de dimension source
États-Unis
1001
États-Unis
Canada
1002
Canada
Dans le système source, si "États-Unis" devient "États-Unis d'Amérique", alors le chargeur de dimensions Planning pourra appliquer ce changement lors du chargement, car le chargeur maintient le mappage entre la colonne Identifiant source "1001" et l'identifiant interne Planning pour la valeur de dimension "États-Unis".
Valeur de dimension Planning
Colonne Identifiant source
Valeur de dimension source
États-Unis
1001
États-Unis
Canada
1002
Canada
L'exécution du chargeur va remplacer la valeur de dimension "États-Unis" par "États-Unis d'Amérique" dans Planning.