Passer au contenu principal
Adaptive Insights
Knowledge and Support - Adaptive Insights

Créer un chargeur de dimension de planification

Les demandes du chargeur de dimensions de planification sont limitées à la mise à jour de 10000 valeurs de dimension maximum dans une dimension hiérarchique ou 40000 valeurs de dimension dans une dimension linéaire. Ces limites ne s’appliquent pas à la création de valeurs de dimension dans une demande de chargeur.

Le chargeur de dimension Planification vous permet de mapper des métadonnées relatives aux valeurs de dimension de la zone de stockage au Adaptive Planning. Le principal avantage du chargeur de dimension de planification est qu’il vous permet d’importer des valeurs de dimensions en bloc plutôt que de les créer une par une dans Modélisation > Gestion des modèles > Dimensions. Une fois le chargeur créé, vous pouvez l’exécuter manuellement ou planifier l’exécution dans le cadre d’une Integration tâche.

Planning Dimension Loader
 

Pour créer un chargeur de dimensions de planification, suivez ce flux :

Saisissez les paramètres
de source de données
→︎
Configurer la colonne
Mappage
→︎
Créer des règles
métier
→︎
Prévisualiser le chargeur
de chargeur
→︎
Exécuter ou planifier le
Chargeur

Avant de commencer

Le chargeur de dimensions de planification nécessite des données de stockage à partir d’une importation de Source de données existante. 

Saisissez les Paramètres de source de données

Les paramètres de source de données vous permettent de sélectionner la table source que vous souhaitez utiliser à partir des données de stockage de Integration, sélectionnez la dimension Planification à charger et définissez si des valeurs de dimension doivent être créées automatiquement. 

  1. Accédez à Integration > Concepteur de données.
  2. Cliquez sur Créer chargeur Dans la zone Chargeurs de la Bibliothèque des composants.
  3. Sélectionnez Chargeur de dimensions de planification comme type de chargeur. Saisissez un nom de chargeur.
  4. Cliquez sur Créer.

Meilleure pratique : Enregistrez régulièrement les données créées et modifiez votre chargeur en cliquant sur Enregistrer dans le panneau Actions. Vous pouvez ignorer toute modification non enregistrée en cliquant sur Fermerpuis sur Non.

Saisissez les informations générales de propriétés du chargeur de dimensions de planification :

Planning Dimension Loader - Data Source Settings 

  • 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.
  • Dimension de planification : Sélectionnez une dimension à partir de toutes les dimensions pour la source où les éléments doivent être chargés. Les dimensions listées proviennent de Modélisation > Gestion des modèles > Dimensions.
  • Créez une valeur de dimension si vous n’avez trouvé aucune valeur dans Planification : cochez la case pour créer automatiquement des valeurs de dimension trouvées dans le système source, mais non trouvées dans Modélisation > Gestion des modèles > Dimensions. Si cette option n’est pas cochée, seules les valeurs de dimension existantes sont mises à jour et aucune dimension n’est créée.
    • Si dans la dimension que vous chargez l’option « L’importation de données crée automatiquement des valeurs de dimension » n’est pas activée dans Modélisation > Gestion des modèles> Dimensions, le chargeur vous avertira :
      Planning Dimension Loader - Data import automatically creates dimension values warning
  • Niveau du journal : Sélectionnez le type de détails journalisés lors de l’exécution du chargeur.
    • Erreur : journaliser uniquement les erreurs graves.
    • Infos : Journaliser les informations de base, par exemple lorsque le chargeur a été mis à jour.
    • Verbeux : fournit des informations détaillées sur toutes les phases et actions. Ce niveau est principalement utilisé pour le débogage ou l’audit, car il peut produire plus d’informations de journal que nécessaire, pour une utilisation normale.

Configurer Mappage de colonnes

Le mappage de colonne vous permet de mapper des colonnes de la source de données aux valeurs de dimension disponibles dans Modélisation > Gestion des modèles > Dimensions.

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

  • Tout : affiche toutes les colonnes Planification.
  • Requis : affiche toutes les colonnes requises Planification.
  • Non mappé : affiche toutes les colonnes mappées Planification.
  • Mappé : affiche toutes les colonnes mappées Planification.

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

  1. Cliquez sur Mappage de colonne.

Planning Dimension Loader - Column Mapping

L’onglet Mappage de colonne dispose des colonnes suivantes :

  • Statut : indique si une colonne Planification est mappée. 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 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 les processus de mappage.
  1. Sélectionnez une colonne non mappée et cliquez dans le menu déroulant. Une liste des colonnes que vous pouvez mapper s’affiche dans la liste déroulante. Au fur et à mesure que vous mappez les colonnes, l’indicateur de statut passe du rouge IntegrationMappingUnmapped.png au vert IntegrationMappingMapped.png.

Voir Charger des valeurs de dimension à partir d’une source de données de feuille de calcul pour avoir un exemple de la façon dont les valeurs de dimension et leurs éléments parents sont mappés dans la Planification.

Modifier les noms de valeur de dimension Planification lors du chargement

Pour modifier le nom d’une valeur de dimension Planification lors du chargement :

  1. Sélectionnez la colonne ID source qui identifie de manière unique la valeur de dimension dans la source.
  2. Sélectionnez la colonne de votre source contenant le nom de valeur de dimension dans la colonne Nom complet de la source.

Démapper des colonnes

Pour démapper des 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.

Lors du démappage, la couleur du statut d’une colonne de son icône de mappage passe au rouge IntegrationMappingUnmapped.png.

Mapper des attributs associés aux dimensions Liste

Vous pouvez associer des attributs à une dimension Liste en mappant des colonnes à partir d’une importation de source de données.

L’association d’attributs aux dimensions est uniquement possible pour des dimensions Liste. Vous ne pouvez pas associer des attributs aux dimensions hiérarchiques.

Dans le Adaptive Suite, vous pouvez consulter Gestion des modèles > Dimensions et cliquer sur une dimension pour afficher ses détails, pour définir s’il s’agit d’une dimension Liste.

 Dimension Detail - List Dimension

Dans Paramètres de source de données, sélectionnez une dimension Liste comme dimension de planification.

Planning Dimension Loader - Data Source Setting - List Dimension

Les attributs deviennent disponibles sous forme de colonnes dans Mappage de colonne, car cette dimension correspond à une dimension Liste.

Les dimensions Liste n’étant pas hiérarchiques, l’IdParent n’est pas une option pour la colonne Id Source.

La colonne Nom complet de la source est un champ obligatoire lorsque la colonne Dimension est définie. L’exemple ci-dessous présente une dimension Produit mappée sur "Id" comme colonne Id source et "Nom" comme colonne Nom complet de la source. Le Nom complet de la source est facultatif pour les autres lignes.

Planning Dimension Loader - Map Attributes Associated with List Dimensions

Créer des règles métier

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

Planning Dimension 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 Dimension Loader - BusinessRules - 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, vous pouvez cliquer sur « l’aide en ligne » dans la section­Notes Modifier le filtre SQL. Vous pouvez également consulter la Référence d’expression SQL.

  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 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 dimension à 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 dimensions 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 est exécuté en appliquant toutes les transformations et les règles métier dans le cadre de l’exécution. Une fenêtre contextuelle de statut affiche les étapes exécutées par le chargeur. Si des valeurs de dimension doivent être chargées, le chargeur crée un fichier XML et envoie une notification par courriel avec la sortie du chargeur sous forme de pièce jointe XML zippée.

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 valeurs de dimension et la taille du fichier.

Planning Dimension Loader - Preview Loader Output - XML Download

Preview Loader Output - XML of Metadata

Corriger les erreurs de validation

Lorsque des valeurs de dimension sont chargées, les données source sont validées pour les erreurs suivantes :

  • La valeur Id source pour la valeur de dimension est manquante (vide) dans les données.
  • Les données comportent des Id source en double. Les Id source doivent être uniques.
  • Un nom de valeur de dimension manque (vide) dans les données.
  • Les données comportent des noms de valeur de dimension en double.
  • Un Id parent est identique à l’Id 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’importation d’une sous-arborescence, la racine de cette dernière est mappée sur un nœud existant dans la Planification. Dans ce cas, l’IDParent ne figure pas dans les données source pour un nouveau nœud qui doit être inséré dans la Planification.
  • Un nœud existant est déplacé sous un nouveau nœud et le marquage Créer est désactivé. Dans ce cas, une valeur de dimension existante est déplacée dans un nouveau mode lorsqu’il est explicitement indiqué au chargeur de ne pas créer des valeurs de dimension.
  • Les données ont une référence cyclique dans leur hiérarchie. Dans ce cas, un IdParent fait référence à son propre élément enfant comme élément parent.

Exécuter le chargeur

Une fois qu’un chargeur de dimensions de planification a été enregistré 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 de chargeur de dimensions de planification, de sorte que la synchronisation puisse être effectuée entre Adaptive Suite 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.

Vous pouvez importer des données à 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 dimension de planification dans une tâche d’intégration

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

Meilleure 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 lors de l’exécution de la tâche. Si un paramètre commun/partagé est utilisé dans les chargeurs dans une tâche, la tâche lance 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 , archivées lors de la création des chargeurs , sont utilisées.

Messages et avertissements de dépannage

Pour une explication relative aux messages journalisés lors d’un chargement, voir Messages de journalisation du chargeur de dimensions de planification.