Passer au contenu principal
Documentation
Documentation
Adaptive Planning
Dernière mise à jour : 2023-06-23
Créer des chargeurs de périmètres Planning

Créer des chargeurs de périmètres 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.
Le chargeur de périmètres Planning vous permet de mapper des métadonnées relatives aux hiérarchies organisationnelles depuis la zone de stockage temporaire vers
Adaptive Planning
Utilisez le chargeur de périmètres Planning pour importer des périmètres en bloc plutôt que de les créer un par un dans l'administration des périmètres. Une fois le chargeur créé, vous pouvez l'exécuter manuellement ou planifier son exécution dans le cadre d'un
Intégration
 tâche.
Regardez la vidéo :
 1 min 36 s

Étapes de base

  • Saisissez les paramètres de la source de données.
  • Configurez le mappage des colonnes.
  • Créez des règles de gestion.
  • Prévisualisez la sortie du chargeur.
  • Exécutez ou planifiez le chargeur.

Conditions préalables

Le chargeur de périmètres Planning nécessite des données temporaires issues de l'import d'une 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

Navigation

Compass.png Dans le menu de navigation, accédez à
Intégration
Concevoir des intégrations
.

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

Les paramètres des sources de données vous permettent de choisir la table source que vous souhaitez utiliser à partir des données temporaires d'intégration et d'indiquer si vous souhaitez créer de nouveaux périmètres automatiquement.
Une bonne pratique consiste à enregistrer fréquemment votre travail 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 sur
Non
.
  1. Cliquez sur
    Créer un nouveau chargeur
     dans la section Chargeurs de la Bibliothèque de composants.
  2. Sélectionnez
    Chargeur de périmètres Planning
     comme type de chargeur. Donnez un nom au chargeur.
  3. Cliquez sur
    Créer.
  4. Saisissez les informations générales de propriétés du chargeur de périmètres Planning :
    • Table source
       : sélectionnez la table source dans la liste déroulante. Les tables sources sur la liste correspondent à toutes les tables disponibles dans la zone de stockage temporaire à laquelle vous accédez.
    • Créer un périmètre si introuvable dans Planning
       : cochez cette case pour créer automatiquement de nouveaux périmètres trouvés dans le système source mais introuvables dans
      modélisation
      gestion du modèle
      Périmètres
       Décochez Mettre à jour uniquement les périmètres existants dans votre modèle.
    • Propager les mises à jour de périmètre applicables aux enfants
       :
      cochez cette case pour
      mettre à jour les périmètres enfants si le changement implique une propriété en cascade. Si cette case n'est pas cochée, seul le périmètre explicitement mis à jour sera modifié.
    • Supprimer les éléments du workflow lors de la désactivation du workflow
       :
      cochez cette case pour supprimer les
      éléments dans le workflow si vous désactivez les workflows. Si cette case n'est pas cochée, les éléments de workflow ne seront pas supprimés lorsque le workflow sera désactivé.
    • Supprimer les montants réels inaccessibles lors de la mise à jour de la disponibilité du périmètre
       : si la date de début ou de fin des montants réels d'un périmètre change de manière à rendre ces derniers inaccessibles, supprimez les données de montants réels qui ne sont pas accessibles.
    • Publier en masse les modifications en attente
      : si Concept : publication en masse Comporte des modifications de workflow en attente, sélectionnez-les pour les publier.
    • Maintenir l'ordre existant dans Planning
       : cochez cette case pour conserver l'ordre de tri des périmètres existant déjà utilisé dans Adaptive Planning.
    • Continuer avec des avertissements
       :cochez cette case pour poursuivre le chargement lorsque des messages d'avertissement s'affichent.
    • Niveau de journalisation
       : sélectionnez le type de détail à capturer lors de l'exécution du chargeur.
      • Désactivé
         : aucune erreur n'est consignée.
      • Erreur
         : consigne uniquement les erreurs graves.
      • Informations
         : consigne les informations de base, telles que la date de mise à jour du chargeur.
      • Mode détaillé
         : informations détaillées concernant toutes les phases et actions. Utilisé principalement pour le débogage ou les audits.

Configurer le mappage des colonnes

Le mappage des colonnes vous permet de mapper des colonnes issues de la source de données aux périmètres disponibles dans
Modélisation
- Périmètres
de gestion du modèle
. Vous pouvez annuler le mappage des colonnes pour ignorer les données temporaires que vous ne souhaitez pas charger. Vous pouvez également annuler le mappage des colonnes une par une après l'exécution du chargeur pour dépanner les colonnes générant des erreurs dans les journaux.
La seule façon d'obtenir une liste des identifiants de périmètres existants consiste à utiliser l'API exportLevels . Le code du périmètre n'apparaît nulle part dans l'IU de l'application. La colonne Identifiant source des périmètres devient le code du périmètre lors du chargement.
S'il existe plusieurs colonnes à mapper, utilisez le filtre
Afficher
 pour sélectionner :
  • Tout
     : affiche toutes les colonnes Planning.
  • Obligatoire
     : affiche toutes les colonnes Planning obligatoires, telles que Identifiant du parent et Périmètre.
  • Non mappé
     : affiche toutes les colonnes Planning non mappées.
  • Mappé
     : affiche toutes les colonnes Planning mappées.
Utilisez
Catégorie
pour sélectionner :
  • Détail du périmètre
     : affiche les colonnes qui se rapportent au détail du périmètre, notamment Nom abrégé, Devise et Dans le workflow. La valeur Dans le workflow doit être une valeur booléenne de 1 pour true ou de 0 pour false.
  • Paramètres d'élimination
     : affiche les colonnes qui se rapportent aux paramètres d'élimination, notamment le périmètre d'élimination et le partenaire commercial d'élimination. Ces valeurs booléennes doivent être de 1 pour true ou de 0 pour false.
  • Paramètres de version
     : affiche les colonnes qui se rapportent aux paramètres de version, notamment le début et la fin des montants réels. Ces valeurs doivent avoir des formats de date, tels que 01/01/2010.
  • Attributs de périmètre
     : affichent relatives aux attributs de périmètre.
  • Dimensions de périmètre
     : affiche les colonnes se rapportant aux dimensions de périmètre.
Vous pouvez utiliser le champ
Rechercher
 pour rechercher des colonnes. Saisissez un nom complet ou partiel pour effectuer des recherches et cliquez sur la loupe. Les colonnes temporaires correspondant à la recherche apparaissent dans les résultats.
Mapper les colonnes
  1. Cliquez sur
    Mappage de colonnes
    .
  2. Sélectionnez une colonne non mappée dans le menu déroulant. Les colonnes disponibles pour le mappage s'affichent dans la liste. À mesure que vous mappez les colonnes, l'indicateur de statut passe d'un point d'exclamation IntegrationMappingUnmapped.png à une coche IntegrationMappingMapped.png.
L'onglet Mappage de colonnes affiche les colonnes suivantes :
  • Statut :
    une coche Colonne mappée indique une colonne mappée. Un point d'exclamation Colonne non mappée indique une colonne non 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 devise.
  • Colonne source :
     affiche les colonnes de la table temporaire sélectionnée dans les paramètres de la source de données.
Lorsque l'option
L'import 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.
Mapper les parents des périmètres
La colonne Identifiant du parent indique l'identifiant du parent d'un périmètre. Pour charger des données au plus haut niveau dans une hiérarchie, la valeur Identifiant du parent dans les données source doit être vide. L'Identifiant du parent doit également être vide si vous souhaitez créer un périmètre enfant sous le périmètre supérieur.
Pour consulter un exemple de mappage des périmètres et leurs parents à Planning, consultez Exemple : charger des périmètres depuis une source de données de type feuille de calcul.
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 change l'icône de statut en point d'exclamation IntegrationMappingUnmapped.png.
Outre l'annulation du mappage pour résoudre les erreurs et ignorer des colonnes, une bonne pratique consiste à utiliser l'annulation du mappage pour faciliter la gestion des modifications. Lorsque de nouvelles colonnes sont introduites dans une source de données, vous pouvez annuler le mappage des colonnes les plus anciennes pour mapper les nouvelles.

Télécharger et charger des mappages

Vous pouvez télécharger des mappages, les modifier, puis les charger à nouveau pour permettre aux chargeurs de résoudre rapidement les erreurs de mappage. Chaque chargement se traduit par une action de remplacement intégral. Lors du chargement, une seule feuille de mappages du fichier est traitée. Le traitement des feuilles de mappages supplémentaires s'interrompra et le téléchargement sera annulé.
  1. Cliquez sur
    Télécharger les mappages de membres
     dans le panneau
    Actions
    .
  2. Téléchargez le fichier .XLSX. Vous recevez également un e-mail ou une notification Workday avec un lien de téléchargement vers le fichier de mappages.
  3. Ouvrez le fichier et, dans les feuilles de mappages, recherchez les valeurs de table temporaire à l'origine des erreurs.
    Toutes les cellules marquées (NON VALIDE) dans les colonnes
    Code Planning
     ou
    Nom Planning
     indiquent que ce code n'existe plus dans Workday Adaptive Planning.
  4. Corrigez les erreurs et cliquez sur
    Télécharger les mappages de membres
     pour charger le fichier. La colonne
    Lecture seule
     n'est pas chargée.
  5. 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 support 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 temporaires disponibles pour le chargement. Seuls les enregistrements répondant à vos critères de filtrage seront chargés.
L'onglet
Règles de gestion
 contient une zone de texte pour saisir du langage SQL.
Pour créer un filtre SQL :
  1. Dans l'onglet
    Règles de gestion
    , cliquez sur
    Filtre SQL
    . Cliquez sur
    Modifier
    .
  2. Saisissez 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 la saisir.
  3. 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 les informations 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. Pour en savoir plus, voir Référence : expressions SQL .
  4. Corrigez les erreurs de syntaxe et cliquez sur
    Appliquer
    . Seules les lignes temporaires correspondant à l'expression SQL seront importées lorsque vous exécuterez le chargeur.

Prévisualiser 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.
Lors de l'exécution de la sortie du chargeur de prévisualisation ou de la charge manuelle, les erreurs des données source sont vérifiées pour validation. Exemples de validations à vérifier si :
  • Un sous-périmètre est créé sans indiquer son périmètre parent.
  • Un attribut de périmètre est assigné à une valeur d'attribut introuvable.
  • La valeur de l'identifiant source pour le périmètre est manquante (vide) dans les données.
  • Les données contiennent des identifiants source ou noms de périmètre en double. Les identifiants source doivent être uniques.
  • ParentId est identique à l'identifiant source dans les données. Dans ce cas, la colonne se réfère à elle-même comme parent.
  • Lors de l'import de sous-périmètres, la racine du sous-périmètre est mappée à un nœud existant dans
    Adaptive Planning
    . L'identifiant parent ne figure pas dans les données source d'un nouveau nœud introduit dans
    Adaptive Planning
    .
  • Un nœud existant est déplacé sous un nouveau nœud et l'indicateur Créer est désactivé. Un périmètre existant est transféré dans un nouveau nœud lorsque le chargeur a été configuré pour ne pas créer de nouveaux périmètres.
  • Les données ont une référence cyclique dans leur hiérarchie. ParentId fait référence à son propre enfant en tant que parent.
  • Un périmètre est défini en tant que partenaire commercial d'élimination et l'un de ses périmètres enfants est configuré en tant que périmètre d'élimination. Un périmètre défini en tant que partenaire commercial d'élimination ne peut pas avoir un périmètre d'élimination comme enfant.
Vous pouvez également télécharger l'aperçu de la sortie sous forme de fichier XML pour vérifier manuellement les périmètres issus de votre source de données par rapport à vos critères avant de les charger.
  1. Cliquez sur
    Prévisualiser 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 périmètres Planning. La modification des paramètres importe ici de nouvelles données dans les tables et colonnes temporaires.
  3. Cliquez sur
    Prévisualiser la sortie du chargeur
    .
Le chargeur fonctionne, y compris toutes les transformations et règles de gestion. Une fenêtre contextuelle de statut affiche les étapes au fur et à mesure de l'exécution du chargeur. Si des périmètres sont disponibles pour être chargés, le chargeur créera un fichier XML et enverra une notification par e-mail avec la sortie sous forme de pièce jointe XML zippée. Si aucun périmètre n'est chargé, le fichier contiendra un message indiquant qu'aucun périmètre n'est chargé.
À l'issue de l'exécution du chargeur, 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 zippé. L'affichage de la fenêtre contextuelle de téléchargement peut prendre un certain temps, selon le nombre de niveaux et la taille du fichier.

Exécuter le chargeur

Après avoir enregistré un chargeur de périmètres Planning avec les paramètres requis, exécutez le chargeur manuellement ou en tant que tâche d'intégration planifiée.
Patientez 15 à 30 minutes entre chaque exécution du chargeur de périmètres Planning pour que :
Adaptive Planning
 a le temps de se synchroniser avec votre import. Les imports plus volumineux nécessitent plus de temps pour se synchroniser. 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 périmètres directement à partir du système source ou exécuter le chargeur à l'aide des valeurs temporaires déjà importées. Lors de l'exécution du chargeur, sélectionnez le comportement souhaité. Cliquez sur
Ignorer l'import des données
 pour utiliser la table temporaire existante pour le chargement. L'option Ignorer l'import des 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 temporaire 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'import s'effectue correctement.
Inclure le chargeur de périmètres Planning dans une tâche d'intégration
Une tâche d'intégration peut avoir un ou plusieurs chargeurs. Une tâche peut contenir d'autres tâches d'intégration, comme les chargeurs de scripts.
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 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 choisir de remplacer les invites des paramètres.
Pour planifier les exécutions de la tâche, utilisez les valeurs par défaut des paramètres des chargeurs.
Messages de dépannage et avertissements
Voir Référence : consigner les messages des chargeurs de périmètres Planning pour obtenir les descriptions des messages consignés lors d'un chargement.