Créer des chargeurs de dimensions Planning

Adaptive 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 les métadonnées sur les valeurs de dimension de la zone intermédiaire dans

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 que vous avez créé un chargeur, 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, suivez la procédure suivante :

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

Configurer le mappage des colonnes

Créer des règles de gestion

Afficher un aperçu de la sortie du chargeur

Exécuter ou planifier le chargeur

Avant de commencer

Le chargeur de dimensions Planning requiert des données intermédiaires provenant d'une importation d'une source de donnéesexistante.

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

Les paramètres de la source de données vous permettent de sélectionner la table source que vous souhaitez utiliser dans les données intermédiaires, de sélectionner la dimension Planning à charger et d’indiquer si de nouvelles valeurs de dimensions doivent être créées automatiquement ou pas.

Accédez à Intégration > Designer Integrations
.

Cliquez sur Créer un nouveau chargeur
dans la zone Chargeurs de la Bibliothèque de composants.

Sélectionnez Chargeur de dimensions Planning
comme type de chargeur. Donnez un nom au chargeur.

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
.

Entrez l’information générale suivante dans les propriétés du chargeur de dimensions Planning :

Table source :
sélectionnez la table source dans la liste déroulante. Les tables sources dans la liste correspondent à toutes les tables disponibles dans la zone intermédiaire à 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’importation 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 l’information de base, telle que la date de mise à jour du chargeur.

Mode détaillé
:
fournit de l’information détaillée sur toutes les phases et actions. Ce niveau est principalement utilisé pour le débogage ou l’audit, car il peut générer plus d’information 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. Entrez un nom complet ou partiel à rechercher, puis cliquez sur la loupe. Les colonnes intermédiaires correspondant à la recherche figurent dans les résultats.

Mapper les colonnes: 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 cochée indique une colonne mappée. Une un point d’exclamation indique qu’une colonne n’est pas 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 intermédiaire sélectionnée dans les paramètres de la source de données.
Sélectionnez une colonne non mappée et cliquez sur le menu déroulant. La 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 au vert .

Lorsque l’option
L’importation 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.

Voir Exemple : charger les valeurs de dimension à partir des sources de données de feuille de calcul pour voir comment les valeurs de dimension et leurs parents sont mappés à Planning.

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 :
Sélectionnez la colonne source qui désigne de manière unique la valeur de dimension dans la source.
Mappez la colonne d’identifiant à l’identifiant de la valeur de dimension.
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.

L'annulation du mappage d'une colonne fait passer son statut de mappage à une icône rouge .
Mapper des attributs associés aux dimensions de liste: Vous pouvez associer des attributs à une dimension de liste en mappant des colonnes depuis l’importation d’une source de données.

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

À moins de
Adaptive Planning
vous pouvez aller à la tâche Gestion du modèle
> Dimensions
et cliquer sur une dimension pour en afficher le détail afin de déterminer s’il s’agit d’une dimension de liste.

Dans Paramètres de la source de données, sélectionnez une dimension de liste comme Dimension Planning
.

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

Les dimensions de liste n’étant pas hiérarchiques, parentId n’est pas une option pour la colonne Source.

Télécharger et téléverser des mappages

Vous pouvez télécharger des mappages, les modifier, puis les téléverser à nouveau pour permettre aux chargeurs de résoudre rapidement les erreurs de mappage. Chaque téléversement se traduit par une action de remplacement intégral. Lors du téléversement, une seule feuille de mappages du fichier est traitée. Le traitement des feuilles de mappages supplémentaires s’interrompra, et le téléversement sera annulé.

Cliquez sur

Télécharger les mappages de membres

dans le panneau

Actions

Téléchargez le fichier .XLSX. Vous recevrez également un courriel ou une notification Workday avec un lien de téléchargement vers le fichier de mappages.

Ouvrez le fichier et, dans les feuilles de mappages, recherchez les valeurs de table intermédiaire à l’origine des erreurs.

Toutes les cellules marquées (NON VALIDE) dans les colonnes

Code Planning

Nom Planning

indiquent que ce code n’existe plus dans Workday Adaptive Planning.

Corrigez les erreurs et cliquez sur

Téléverser les mappages de membres

pour charger le fichier. La colonne

Lecture seule

n’est pas téléversée.

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 Service de soutien 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 intermédiaires 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 :

Dans l’onglet Règles de gestion
, sélectionnez Filtre SQL
. Cliquez sur Modifier
.

Entrez 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 l’entrer.

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 l’information 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.

Corrigez les erreurs de syntaxe et cliquez sur Appliquer
. Seules les lignes intermédiaires correspondant à l’expression SQL seront importées lorsque vous exécuterez le chargeur.

Afficher un aperçu de la sortie du chargeur

Vous pouvez afficher l’aperçu de 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.

Cliquez sur Afficher un aperçu de la sortie du chargeur
dans le panneau Actions.

(Facultatif) Entrez les paramètres d’aperçu de la sortie du chargeur. L’information que vous pouvez entrer varie 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 intermédiaires.

Cliquez sur Afficher un aperçu de 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 courriel 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 l’aperçu 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 sources 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 sources en double. Les identifiants sources 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’importation d’une sous-arborescence, la racine de cette dernière est mappée vers un nœud existant dans Planning. Dans ce cas, parentId ne figure pas dans les données sources 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 obligatoires, le chargeur peut être exécuté manuellement ou comme tâche d’intégration planifiée.

Prévoyez 15 à 30 minutes entre chaque exécution du chargeur de dimensions Planning afin que

Adaptive Planning

a du temps à synchroniser avec votre importation. Les importations plus volumineuses 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 intermédiaires déjà importées. Lors de l’exécution du chargeur, sélectionnez le comportement souhaité. Cliquez sur Ignorer l’importation des données
pour utiliser la table intermédiaire existante pour le chargement. L’option Ignorer l’importation des données n’est pas disponible lorsque vous utilisez des tableurs comme sources de données.

Dans le cadre du processus d’exécution, le chargeur vérifie que les données de la table intermédiaire 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’importation s’effectue correctement.

Inclure le chargeur de dimensions Planning dans une tâche d’intégration: Toute 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 d’indicateurs et des chargeurs à base de script 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 sont présentés à chaque exécution de la tâche. Si un paramètre commun/partagé est utilisé dans les chargeurs d’une tâche, la tâche ne lance 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 et avertissements de dépannage: Pour obtenir une explication des messages consignés pendant un chargement, voir Référence : consigner les messages des chargeurs de dimensions Planning.

Changements lors du chargement 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 pour 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 « USA » est mappée à la colonne Identifiant source « 1001 ».

Valeur de dimension Planning	Colonne Identifiant source	Valeur de dimension source
USA	1001	USA
Canada	1002	Canada

Dans le système source, si « USA » devient « États-Unis », alors le chargeur de dimensions Planning pourra appliquer ce changement lors du chargement, car le chargeur conserve le mappage entre la colonne Identifiant source « 1001 » et l’identifiant interne Planning pour la valeur de dimension « USA ».

Valeur de dimension Planning	Colonne Identifiant source	Valeur de dimension source
USA	1001	États-Unis
Canada	1002	Canada

L’exécution du chargeur va remplacer la valeur de dimension « USA » par « États-Unis » dans Planning.

Mettre à jour en masse des noms ou des codes

Voir Niveau suivant : utilisation de l’intégration Adaptive pour mettre à jour en masse des noms/codes de dimension personnalisés (rubrique en anglais).