Passer au contenu principal
Documentation
Documentation
Adaptive Planning
Dernière mise à jour : 2023-06-23
Exemple : charger des valeurs de dimension depuis des sources de données de type feuille de calcul

Exemple : charger des valeurs de dimension depuis des sources de données de type feuille de calcul

Cet exemple illustre le chargement d’une liste de clients SMS à partir d’une source de données de feuille de calcul dans
Adaptive Planning
 à l’aide du Chargeur de dimensions Planning. Il suppose qu'une dimension hiérarchique nommée Customer existe déjà.
L'objectif final ici est d'ajouter plusieurs valeurs de dimension directement sous la dimension hiérarchique Customer, sous la forme d'un ensemble CRM Customers, de sorte que l'arborescence ressemble à ce qui suit :

Customer
|__Customer 1
|__Customer 2
|__CRM Customers
   |__R.G. Barry Corporation
   |__Sierra Bancorp
   |__SkullCandy, Inc.
   ...
|__StoneMore Partners L.P.
|__ScanSource, Inc.
...

Mettre en forme la feuille de calcul CRM Customers

Les feuilles de calcul utilisées pour importer des données dans le chargeur de dimensions Planning nécessitent un formatage précis pour indiquer les valeurs de dimensions parents et les valeurs de dimensions enfants.
Trois colonnes sont obligatoires :
  • Id
     : identifiant unique associé à la valeur de dimension dans le système source.
  • ParentId
     : identifiant du parent de la valeur de dimension dans le système source, le cas échéant.
  • Name
     : nom de la dimension dans le système source qui doit idéalement correspondre à la valeur de dimension Planning, si elle est définie dans Planning pour la première exécution du chargeur.
La colonne Id identifie de manière unique chaque valeur de dimension. La colonne ParentId indique l'identifiant vers lequel pointent les valeurs de dimension, tel que les parents. Pour être chargé à la racine, ParentID doit être nul.
Feuille de calcul de client SMS
Option
Description
1
Colonne Id
2
Colonne ParentId
Si vous avez des noms en double pour certaines valeurs, vous aurez besoin d'une colonne Code supplémentaire dans le fichier XSLX de source de données. Ce code identifie de manière unique les valeurs de dimension lorsque celles-ci possèdent des noms en double.
Notez que l'identifiant de CRM Customers est 3. L'identifiant 3 est référencé dans la colonne ParentId pour marquer toutes les valeurs de dimension qui deviendront ses enfants.
La dimension Customer ne doit pas être nécessairement incluse dans la feuille de calcul, car elle sera sélectionnée dans les paramètres de la source de données du chargeur.

Créer une source de données de type Feuille CRM pour le chargeur de dimensions Planning

À l'aide de la feuille de calcul présentée ci-dessus, créez une source de données de type feuille de calcul nommée Feuille CRM.
Importez le contenu de la feuille pour la source de données afin de renseigner la zone intermédiaire.

Configurer les paramètres du chargeur de dimensions Planning

Une fois la source de données de type feuille de calcul créée et ses données renseignées dans la table intermédiaire, le chargeur peut être configuré.
Paramètres de la source de données
La table source correspond à la Feuille1 de la source de données Feuille CRM. Cet exemple utilise uniquement la source de données Feuille CRM, mais les autres sources de données sont également affichées dans la liste. Les chargeurs de dimensions Planning peuvent accéder à n'importe quelles données intermédiaires, quelle que soit la source de données.
Sélectionnez
Customer
 comme
Dimension Planning
.
Activez
Créer une valeur de dimension si elle n'existe pas dans Planning
.
Mappage de colonnes
En raison du format et des colonnes de la source de données de type feuille de calcul, les mappages de colonnes pour ce chargeur doivent être les suivants :
Colonne Planning
Colonne source
Identifiant du parent
ParentId
Identifiant client
Id
Nom du client
Nom
Cet exemple ne nécessite aucune règle de gestion.
Enregistrez le chargeur en cliquant sur
Enregistrer
 dans le panneau Actions.

Aperçu de la sortie du chargeur

Une fois le chargeur enregistré, cliquez sur
Afficher un aperçu de la sortie du chargeur
 dans le panneau Actions.
Vérifiez que le
Statut de l'aperçu de la sortie du chargeur
 ne présente aucune erreur.

Exécuter le chargeur

Si l’aperçu de la sortie du chargeur est correct, ce chargeur est alors prêt à être chargé. Cliquez sur
Exécuter manuellement
 dans le panneau Actions pour l'exécuter.
Le chargeur est également prêt à être inclus dans une tâche d'intégration planifiée qui pourrait être exécutée automatiquement.

Afficher les valeurs de dimension chargées

La capture d’écran ci-dessous illustre les résultats du chargement des valeurs de la dimension Client. Le volet latéral gauche affiche l'arborescence développée dans
Dimensions
de gestion du modèle
de modélisation
. La valeur de la liste déroulante
C8
 affiche la feuille de calcul formatée pour l’importation. Si la colonne ParentId est laissée en blanc, la dimension Planning que vous choisissez dans la liste déroulante Paramètres de sources de données du chargeur de dimensions Planning devient son parent.
Importation des valeurs de dimension - Mise en forme XLSX
Option
Description
1
Panneau Valeurs de dimension : hiérarchie Customer et CRM Customers
2
Feuille de calcul mise en forme pour l'importation
3
Colonne ParentId
Customer
, en haut de la liste Valeurs de dimension située à gauche, a été sélectionné comme dimension Planning dans le menu déroulant Paramètres de la source de données dans le chargeur.

Redéfinir le parent des valeurs de dimension

Pour redéfinir le parent des valeurs de dimension existantes avec le chargeur, indiquez l’identifiant du nouveau parent dans la colonne ParentId de la valeur de dimension que vous devez déplacer. Exemple : en utilisant le résultat de l’exemple ci-dessus, si vous voulez que les clients CRM deviennent un enfant du client 1 afin que l’arborescence ressemble à : 

Customer
|__Customer 1
   |__CRM Customers
      |__R.G. Barry Corporation
      |__Sierra Bancorp
      |__SkullCandy, Inc.
      ...
|__Customer 2
|__StoneMore Partners L.P.
|__ScanSource, Inc.
...
La feuille de calcul des sources de données ressemblerait à :
Chargeur de dimensions Planning Customers - Redéfinir la parenté des valeurs de dimension
Option
Description
1
Colonne Id
2
Colonne ParentId
L'identifiant de Customer 1 est 1. Il deviendra le parent de CRM Customers, comme indiqué dans la colonne ParentId pour CRM Customers.
Le résultat du chargement de cette feuille de calcul serait :
Chargeur de dimensions Planning Customers - Exemple pour redéfinir le parent des valeurs de dimension
Notez que le client 1 est le parent des clients CRM, comme l’indique la colonne parentId dans la feuille de calcul.

Associer des attributs aux dimensions de liste

Vous pouvez associer des attributs aux dimensions de liste en les mappant sans indiquer d'identifiant parent.
Une
dimension de liste
 est une dimension entièrement non hiérarchique. Elle ne comporte aucune sous-dimension ni hiérarchie des valeurs de dimension, mais seulement une liste linéaire de valeurs.
Une source de données de type feuille de calcul pour la dimension de liste Produit aurait des colonnes pour chacun de ses attributs de dimension (par exemple : Groupe, Couleur et Taille).
Les colonnes pour Groupe, Couleur et Taille contiennent les attributs pour la dimension Produit.
Sélectionnez une dimension de liste dans les
Paramètres de la source de données
 du chargeur.
Les attributs de Produit deviennent disponibles sous forme de colonnes dans le Mappage de colonnes, car cette dimension est une dimension de liste.
Ces colonnes supplémentaires ne seraient pas disponibles pour le mappage de colonnes s'il s'agit d'une dimension hiérarchique.