Passer au contenu principal

logoCorrectSize.png

Workday Adaptive Planning Knowledge Center

Créer un chargeur d’attributs de planification

Explique comment créer un chargeur d’attributs de planification pour importer des attributs, 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 Attribute Loader lets you map metadata about attributes from the staging area into Adaptive Insights. Use the attribute loader to import attributes in bulk from an external system and synchronize them, instead of creating attributes one at a time in the attributes 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 32s

Create a Planning Attribute 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 d’attributs 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 : Modèle, Opérateur d’intégration, Concepteur de données, Modèle

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, et d’ indiquer si vous souhaitez créer de nouveaux attributs 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. Sélectionnez  Créer un nouveau chargeur  dans la section Chargeurs  de  la Bibliothèque de composants.
  2. Sélectionnez Chargeur d’attributs de planification comme type de chargeur. Saisissez un nom de chargeur.
  3. Sélectionnez Créer.
  4. Saisissez les informations générales de propriétés  du chargeur d’attributs :
  • Table de la source : Sélectionnez la table de la source dans la liste déroulante. La liste contient  toutes les tables disponibles dans la zone de stockage auxquelles vous pouvez accéder.
  • Attribut de planification : Sélectionnez l’attribut dans Adaptive Insights à charger.
  • Créez une valeur d’attribut si elle est introuvable dans la planification : Sélectionnez pour créer automatiquement de nouvelles valeurs d’attribut trouvées dans le système source, mais pas dans Modélisation > Gestion des modèles > Attributs. Désélectionner cette option met à jour uniquement les valeurs d’attribut existantes dans votre modèle.
  • Publier les modifications en attente de la Publication des modifications : Si Publication des modifications a des modifications de flux de travail en attente, sélectionnez cette option 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 colonnes vous permet de mapper les colonnes de la source de données aux propriétés d’attribut disponibles dans  Modélisation > Gestion des modèles > Attributs. Vous pouvez démapper 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, telles que ID parent et Attribut.
  • Non mappé :  affiche toutes les colonnes Planification non mappées.
  • Mappé :  affiche toutes les colonnes Planification mappées.

Utilisez Catégorie pour sélectionner. 

  • Tous :   affiche toutes les colonnes. Les attributs n’utilisent pas les catégories.

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 Description.
  • 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 attributs

La colonne ID parent indique l’id du parent d’une valeur d’attribut. Pour charger l’attribut le plus élevé 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 des valeurs d’attribut enfant   sous le niveau supérieur.

Voir  Charger des attributs depuis une source de données de feuille de calcul  pour un exemple de la manière dont les attributs 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 :

  • Une valeur d’attribut est créée sans indiquer son attribut parent.
  • Un attribut est attribué à une valeur d’attribut qu’il ne peut pas trouver. 
  • La valeur  Id source pour la valeur d’attribut est manquante (vide) dans les données.
  • Les données comportent des Id source ou noms d’attribut 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.
  • Un nœud existant est déplacé sous un nouveau nœud et le marquage Créer un nouveau est désactivé. Un attribut existant passe dans un nouveau nœud lorsque le chargeur a été défini pour ne pas créer de nouvelles valeurs d’attribut.
  • 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.

Vous pouvez également télécharger l’aperçu de la sortie sous forme de fichier XML pour vérifier manuellement les attributs à 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 d’attributs 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 attributs 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 attribut n’est chargé, le fichier zip contient un message indiquant qu’aucun attribut 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 d’attributs 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 d’attribut 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 d’attributs 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 les attributs 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 d’attributs de planification dans une tâche d’intégration

Toute integration tâche  peut avoir un ou plusieurs chargeurs. Une tâche peut également contenir  d’autres tâches d’intégration ainsi que des Dashboards 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.

  • Cet article vous a été utile ?