Passer au contenu principal

logoCorrectSize.png

Workday Adaptive Planning Knowledge Center

Créer un chargeur de niveau de planification

Explique comment créer un chargeur de niveau de planification pour importer des niveaux, incluant comment configurer des paramètres de source de données, des mappages de colonne et des règles métiers.

Les chargeurs de métadonnées synchronisent les informations hiérarchiques des systèmes sources dans les hiérarchies de Adaptive Insights. Vos hiérarchies doivent déjà exister dans votre système source avant que vous ne tentiez de synchroniser avec Adaptive Insights.

The Planning Level Loader lets you map metadata about organizational hierarchies from the staging area into Adaptive Insights.Use the planning level loader to import levels in bulk, instead of creating them one at a time in the levels admin. Once you create a loader, you can run it manually or schedule it to run as part of an Integration task.

Watch the video: 1m 36s

Create a Planning Level Loader
 

Étapes de base

  • Saisissez les paramètres de la source de données
  • Configurer le mappage de colonnes
  • Créer des règles métiers
  • Prévisualisation de la sortie du chargeur
  • Exécuter ou programmer le chargeur

Avant de commencer

Le chargeur de niveau de planification nécessite des données de stockage à partir d’une importation de Source de données existante. Notez la source de données que vous souhaitez utiliser.

Autorisations requises : Opérateur d’intégration, Concepteur de données.

Comment y parvenir

Compass.png Aller à nav menu navicon.gif > Intégration >Intégrations de conception

Saisissez les Paramètres de la source de données

Les paramètres de source de données vous permettent de choisir la table source que vous souhaitez utiliser à partir des données de stockage d’intégration, et d’ indiquer si vous souhaitez créer de nouveaux niveaux automatiquement.

Bonne pratique : Enregistrez fréquemment lorsque vous créez et modifiez votre chargeur. Cliquez sur Enregistrer dans le panneau Actions. Pour supprimer tout changement non sauvegardé, cliquez sur Fermer, puis cliquez sur Non.

Planning Level Loader Data Settings 

  1. Cliquez sur Créer nouveau chargeur Dans la zone Chargeurs  de la  Bibliothèque des composants.
  2. Sélectionnez Chargeur de niveau de planification comme type de chargeur. Saisissez un nom de chargeur.
  3. Cliquez sur Créer.
  4. Saisissez les informations générales de propriétés du chargeur de niveau de planification :
  • Table de la source : Sélectionnez la table de la source dans la liste déroulante. Les tables de la source sur la liste correspondent à toutes les tables disponibles dans la zone de stockage à laquelle vous accédez.
  • Créer un niveau si introuvable dans la planification : Cochez cette case pour créer automatiquement de nouveaux niveaux trouvés dans le système source, mais introuvables dans Modélisation > Gestion des modèles > Niveaux. Décochez Mettre à jour uniquement les niveaux existants dans votre modèle.
  • Propager les mises à jour de niveau applicables aux enfants Cochez pour  mettre à jour les niveaux enfants si le changement implique une propriété en cascade. Si cette case n’est pas cochée, seul le niveau mis à jour sera modifié.    
  • Supprimer les éléments du flux de travail lors de la désactivation du flux de travail Cochez pour supprimer les éléments dans le flux de travail si vous désactivez les flux de travail. Si cette option n’est pas cochée, les éléments de flux de travail ne seront pas supprimés lorsque le flux de travail est désactivé. 
  • Supprimer les données réelles inaccessibles lors de la mise à jour de la disponibilité du niveau Si la date de début ou de fin des données réelles  sur  un niveau change pour rendre les données réelles inaccessibles, supprimez les données réelles qui ne sont pas accessibles.
  • Publier les modifications en attente de la Publication des modifications : Si Publication des modifications a des modifications de flux de travail, cochez pour publier les modifications.
  • Niveau du journal : Sélectionnez le type de détails à capturer lors de l’exécution du chargeur.
    • Désactivé : Aucune erreur enregistrée.
    • Erreur : Consigner  uniquement les erreurs graves.
    • Infos : Journaliser les informations de base, par exemple lorsque le chargeur a été mis à jour.
    • Verbeux : Informations détaillées sur toutes les phases et actions. Utilisé principalement pour le débogage ou les audits.

Configurer le  mappage de colonnes

Le mappage de colonne vous permet de mapper les colonnes de la source de données aux niveaux disponibles dans  Modélisation > Gestion des modèles > Niveaux. Vous pouvez dissocier les colonnes pour ignorer les données de stockage que vous ne souhaitez pas charger. Vous pouvez également annuler le mappage des colonnes une à la fois après l'exécution du chargeur pour dépanner les colonnes générant des erreurs dans les journaux.   

Planning Level Loader - Column Mapping

S’il existe plusieurs colonnes à mapper, utilisez le filtre Afficher  pour sélectionner les données :

  • Tout :  affiche toutes les colonnes Planification.
  • Requis: Affiche toutes les colonnes de planification requises, par ex. : ID parent et Niveau.
  • Non mappé :  affiche toutes les colonnes Planification non mappées.
  • Mappé :  affiche toutes les colonnes Planification mappées.

Utilisez Catégorie pour sélectionner.

  • Détails de niveau: Affiche les colonnes qui se rapportent aux détails de niveau, y compris Nom court, Devise et Flux de travail. La valeur Dans le flux de travail doit être une valeur booléenne de 1 pour vrai ou 0 pour faux.
  • Paramètres d’élimination : Affiche les colonnes qui se rapportent aux paramètres d’élimination, y compris le niveau d’élimination et le partenaire commercial d’élimination. Ces valeurs booléennes doivent être 1 pour true ou 0 pour false.
  • Paramètres de version: Affiche les colonnes qui se rapportent aux paramètres de la version, y compris le début des données réelles et la fin des données réelles. Ces valeurs doivent avoir des formats de date tels que 01/01/2010.
  • Attributs de niveau: Affiche les colonnes qui se rapportent aux attributs de niveau.
  • Dimensions de niveau: Affiche les colonnes qui se rapportent aux dimensions de niveau.

Vous pouvez utiliser le champ Rechercher pour rechercher des colonnes. Saisissez un nom complet ou partiel pour effectuer la recherche et cliquez sur la loupe. Toutes les colonnes de stockage correspondant à la recherche s’affichent dans les résultats.

Mapper les colonnes

L’onglet Mappage de colonne dispose des colonnes suivantes :

  • Statut :  Une coche Mapped Column indique une colonne mappée. Un point d’exclamation Unmapped Column indique une colonne non mappée.
  • Colonne Planification : affiche toutes les colonnes Planification disponibles pour le mappage sur une feuille. La liste des colonnes Planification comprend un ensemble de colonnes obligatoires Planification, suivies d’autres colonnes Planification. Les colonnes Planification 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 devise.
  • Colonne Id source : affiche les colonnes dans la table de stockage, sélectionnée dans les paramètres de source de données.
  • Colonne Nom complet source : indique les noms complets pour simplifier le processus de mappage. 
  1. Cliquez sur Mappage de colonne.
  1. Sélectionnez une colonne non mappée dans le menu déroulant. Colonnes disponibles pour l’affichage des mappages dans la liste. Lorsque vous mappez les colonnes, l’indicateur de statut passe d’un point d’exclamation IntegrationMappingUnmapped.png à une coche IntegrationMappingMapped.png
Mapper les parents des niveaux

La colonne ID parent indique l’id du parent d’un niveau. Pour charger au plus haut niveau dans une hiérarchie, la valeur ID parent dans les données source doit être vide. L’ID parent doit également être vide si vous souhaitez créer un niveau enfant sous le niveau supérieur.

Voir  Charger des niveaux  depuis une source de données de feuille de calcul  pour un exemple de la manière dont les niveaux et leurs parents sont mappés à la planification.

Démapper des colonnes

Pour  annuler le mappage   de colonnes, cliquez sur Démapper et sélectionnez :

  • Tout démapper : Démappe toutes les colonnes.
  • Démapper la sélection : Démappe uniquement les colonnes sélectionnées.

L'annulation du mappage d'une colonne modifie l’icône de statut en un point d’exclamation IntegrationMappingUnmapped.png.

Bonne pratique : En plus de démapper pour résoudre les erreurs et d’ignorer les  colonnes, vous pouvez utiliser le démappage pour aider à la gestion des changements. Lorsque de nouvelles colonnes sont introduites dans une source de données, vous pouvez démapper les colonnes les plus anciennes pour mapper les nouvelles colonnes.

Créer des règles professionnelles

Vous pouvez utiliser des règles métiers pour créer des expressions SQL limitant les données de stockage  disponibles pour le chargement. Seuls les enregistrements répondant à vos critères de filtre seront chargés.

L’onglet Règles métiers contient une zone de texte pour entrer SQL :

Planning Level Loader - Business Rules

Pour créer un filtre SQL :

  1. Dans l’onglet Règles métier, sélectionnez Filtre SQL. Cliquez sur Modifier.

Planning Level Loader - Business Rules - SQL Editor

  1. Sélectionnez une expression SQL. Vous pouvez cliquer sur un élément dans la liste de colonnes disponibles pour inclure cette colonne dans l’expression SQL plutôt que de la taper.

  2. Cliquez sur Appliquer pour contrôler la syntaxe SQL. En cas d’erreurs de syntaxe, l’expression est entourée en rouge. Passez votre curseur sur l’éditeur SQL pour afficher les informations d’erreur de syntaxe.

Planning Dimension Loader - SQL Syntax Error

Pour obtenir une aide détaillée sur la syntaxe SQL, cliquez sur « l’aide en ligne  » dans la sec­tion Notes Modifier le filtre SQL. Voir la  Référence : expression SQL  pour en savoir plus.

  1. Corrigez toute erreur de syntaxe et cliquez sur Appliquer. Seules les lignes de stockage correspondant à l’expression SQL seront importées lorsque vous exécutez le chargeur.

Prévisualisation de la sortie du chargeur

Vous pouvez prévisualiser  la sortie du chargeur pour vérifier les mappages et corriger les erreurs de validation avant d’exécuter le chargeur.

Lorsque la sortie du chargeur de prévisualisation  ou la charge manuelle s’exécute, les données sources sont validées pour les erreurs. Exemples de validations  incluant des vérifications si :

  • Un sous-niveau est créé sans indiquer son niveau parent.
  • Un attribut de niveau est attribué à une valeur d’attribut qu’il ne peut pas trouver. 
  • La valeur  Id source pour le niveau est manquante (vide) dans les données.
  • Les données comportent des Id source ou noms de niveau en double. Les Id source doivent être uniques.
  • Un Id parent est identique à l’Id source dans les données. Si oui, la colonne   se réfère à elle-même comme parent.
  • Lors de l’importation des sous-niveaux, la racine du sous-niveau mappe à un nœud existant dans Adaptive Insights. L’ID parent n’est pas dans les données source d’un nouveau nœud  introduit dans Adaptive Insights.
  • Un nœud existant est déplacé sous un nouveau nœud et le marquage Créer un nouveau est désactivé. Un niveau existant passe dans un nouveau nœud lorsque le chargeur a été défini pour ne pas créer de nouveaux niveaux.
  • Les données ont une référence cyclique dans leur hiérarchie. Un IdParent fait référence à son propre élément enfant comme élément parent.
  • Un niveau est défini en tant que partenaire commercial d’élimination et l’un de ses niveaux enfants est défini comme un niveau d’élimination. Un niveau défini comme un partenaire commercial d’élimination ne peut pas avoir un enfant qui est un niveau d’élimination.

Vous pouvez également télécharger l’aperçu de la sortie sous forme de fichier XML pour vérifier manuellement les niveaux à partir 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 niveau de planification. La modification des paramètres importe ici de nouvelles données dans les tables et les colonnes de stockage.

  3. Cliquez sur Prévisualisation de la sortie du chargeur.

Le chargeur fonctionne, y compris toutes les transformations et règles métiers. Une fenêtre contextuelle de statut  affiche les étapes exécutées par le chargeur. Si des niveaux sont disponibles  pour être chargés, le chargeur crée un fichier XML et envoie une notification par courriel avec la sortie sous forme de pièce jointe XML zippée. Si aucun niveau n’est chargé, le fichier contiendra un message indiquant qu’aucun niveau n’est chargé.

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, après exécution correcte du chargeur. L’affichage de la fenêtre contextuelle de téléchargement peut prendre un instant, selon le nombre de niveaux  et la taille du fichier.

Planning Dimension Loader - Preview Loader Output - XML Download

Voici un exemple de fichier XML de sortie  téléchargé décompressé :

Preview Loader Output - XML of Metadata

Exécuter le chargeur

Après avoir enregistré un chargeur de niveau de planification avec les paramètres requis, exécutez le chargeur manuellement ou exécutez-le en tant que tâche d'intégration  planifiée.

Patientez 15 à 30 minutes entre chaque exécution de chargeur de niveau de planification, de sorte que la synchronisation puisse être effectuée entre Adaptive Insights et votre importation. Le temps de synchronisation des importations plus importantes est plus long. Le temps d’attente dépend de la taille du modèle et d’autres facteurs.

Pour exécuter manuellement le chargeur, cliquez sur Exécuter manuellement dans le panneau Actions.

Vous pouvez charger des niveaux  directement à partir du système source ou vous pouvez exécuter le chargeur à l’aide des valeurs de stockage déjà importées. Lorsque le chargeur est exécuté, sélectionnez le comportement souhaité. Sélectionnez Éviter l’importation de données pour utiliser la table de stockage existante pour le chargement. L’option Ignorer l’importation de 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 de stockage ont été correctement mappées. Plusieurs validations sont appliquées au cours du chargement. Toute erreur survenant au cours du chargement indique les points à résoudre afin que l’importation s’effectue correctement.

Inclure le chargeur de niveau de planification dans une tâche d’intégration

Toute  tâche  d’intégration peut avoir un ou plusieurs chargeurs. Une tâche peut également contenir d’ autres tâches d’intégration ainsi que des chargeurs de mesure et des chargeurs par script.

Bonne pratique : Distinguer chaque Tâche d’intégration pour chaque chargeur.

Si une tâche contient plusieurs chargeurs, les paramètres de chaque chargeur sont présentés dans une invite lors de l’exécution de la tâche. Si un paramètre commun ou partagé est utilisé dans les chargeurs pour une même tâche, la tâche demande le paramètre une seule fois. Vous pouvez décider d’ignorer les invites de paramètre. 

Pour des exécutions planifiées de la tâche, les valeurs par défaut des paramètres pour les chargeurs sont utilisées.

Messages et avertissements de dépannage

Voir Messages de journal de chargeur de niveau de planification  pour les descriptions des  messages enregistrés pendant un chargement.