Passer au contenu principal
Documentation
Documentation
Adaptive Planning
Dernière mise à jour : 2023-06-23
Créer des chargeurs d'associations Planning

Créer des chargeurs d'associations Planning

Le chargeur d'associations Planning vous permet de mapper des métadonnées relatives aux associations de dimensions utilisateur et de périmètres de la zone de stockage temporaire à
Adaptive Planning
. Les associations permettent de connecter les périmètres et les dimensions personnalisées aux utilisateurs. La responsabilité de périmètre est un type d'association d'utilisateurs qui les connecte aux périmètres. À la différence des associations de périmètres classiques, la responsabilité de périmètre offre aussi d'autres privilèges. Voir.
Une fois le chargeur créé, vous pouvez l'exécuter manuellement ou planifier son exécution dans le cadre d'une tâche d'intégration. Voir Créer des tâches d'intégration.

Conditions préalables

  • Le chargeur d'associations Planning requiert des données temporaires issues de l'import d'une Source de donnéesexistante.
  • Autorisations requises : Modèle, Opérateur d'intégration, Concepteur de données

Étapes de base

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

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 de la source 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 les associations à charger.
  1. Cliquez sur
    Créer un nouveau chargeur
    dans la section
    Chargeurs
     de la Bibliothèque de composants.
  2. Sélectionnez
    Chargeur d'associations
    Planning
     comme type de chargeur. Donnez un nom au chargeur.
  3. Cliquez sur
    Créer
    .
  4. Saisissez les informations
    propriétés générales
     du chargeur d'associations dans l'onglet
    Paramètres de la source de données
     :
    • 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.
    • Profil de mappage :
       vous pouvez relier à un profil de mappage dans le cadre du processus de création d'un chargeur. Sélectionnez le profil de mappage dans la liste déroulante. Les profils de mappage dans la liste sont ceux auxquels vous avez accès. Consultez la section Profil de mappage du Chargeur de données Planning. Ce profil de mappage, ainsi que tout mappage chargé dans le cadre des chargeurs de métadonnées, mappent les périmètres et dimensions Planning. Voir Créer des chargeurs de données Planning. Exemple : si le chargeur d'associations a "999999" comme valeur de colonne du périmètre (ou pour Workday, un identifiant Workday), alors le profil de mappage détermine le périmètre Planning auquel il fait référence.
    • Périmètre ou dimension
       : sélectionnez le périmètre pour la responsabilité de périmètre ou l'association de périmètre. Sélectionnez une dimension pour charger des associations de dimensions.
    • Attribut :
       (facultatif) sélectionnez un attribut Adaptive Planning pour le périmètre ou la dimension. Vous pouvez ainsi mapper et charger des associations d'attributs de périmètre ou de dimension.
    • Mode
       : sélectionnez
      Mettre à jour
       pour modifier des associations ou des affectations de responsabilités dans un sous-ensemble de périmètres. Cette mise à jour concerne le périmètre, pas l'utilisateur. Pour mettre à jour le périmètre, tous les utilisateurs associés à ce périmètre doivent se trouver dans les données utiles. Sélectionnez
      Tout remplacer
       pour supprimer tous les utilisateurs des associations figurant dans les données utiles et remplacez-les.
      • Si vous utilisez Adaptive Planning avec Workday Human Capital Management ou Workday Financials, le
        Mode
         indiquera automatiquement
        Mise à jour
        .
      • Si vous n'utilisez pas Adaptive Planning avec Workday Human Capital Management ou Workday Financials, le
        Mode
         indiquera automatiquement
        Remplacer tout
        .
    • Continuer avec des avertissements
       : cochez cette case pour poursuivre l'exécution du chargeur avec des avertissements. Si vous ne cochez pas cette case, le chargeur s'arrêtera dès qu'un avertissement s'affichera. En revanche, si vous cochez cette case, le chargeur ignorera les dimensions ou périmètres non mappés et créera un avertissement dans les journaux, tout en permettant au chargeur de poursuivre le traitement.
    • 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 de colonnes vous permet de mapper des colonnes issues de la source de données aux associations disponibles dans
Modélisation > Gestion du modèle > Périmètres
 ou
Modélisation > Gestion du modèle > Dimensions
. Vous devez mapper
Utilisateur
 et
Colonnes Planning
.
Si vous êtes un client Workday exécutant une synchronisation utilisateur dans cet environnement, la colonne Utilisateur devra mapper à la colonne source qui contient des identifiants Workday. Si vous n'avez pas exécuté une synchronisation utilisateur ou que vous n'êtes pas un client Workday, la colonne Utilisateur devra être mappée à la colonne source qui contient des noms d'utilisateur et ou des e-mails.
S'il existe plusieurs
colonnes Planning
 à mapper, utilisez le filtre
Afficher
pour sélectionner :
  • Tout
     : affiche tous les utilisateurs.
  • Obligatoire
     :
    affiche toutes les colonnes Planning obligatoires, par exemple Utilisateur et Périmètre.
  • N'est plus mappé
     :
    affiche toutes les colonnes Planning dont le mappage a été annulé.
  • Mappé
     :
    affiche toutes les colonnes Planning mappées.
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 l'onglet
    Mappage de colonnes
    . 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. Les colonnes Planning obligatoires sont indiquées en caractères gras avec un astérisque.
    • Colonne source
       : affiche les colonnes de la table temporaire sélectionnée dans les paramètres de la source de données.
  2. Sélectionnez une colonne non mappée et cliquez sur le menu déroulant. Une liste des colonnes que vous pouvez mapper s'affiche dans la liste déroulante. À mesure que vous mappez les colonnes, l'indicateur de statut passe du rouge IntegrationMappingUnmapped.png au vert IntegrationMappingMapped.png.
Mappage des colonnes pour la responsabilité de périmètre
Si vous voulez charger uniquement la responsabilité de périmètre, ne mappez pas un identifiant pour le code d'association du périmètre dans la
Colonne source
. La responsabilité de périmètre dans
Administration
 >
Associations
 s'obtient en laissant le code de l'association vide.
Mappage des colonnes pour l'association de périmètres et de dimensions
Si vous voulez charger uniquement les associations de périmètres et de dimensions, ne mappez pas un identifiant, tel que
Ref ID
 pour le code d'association de la
Colonne source
.
Vous ne pouvez pas charger une responsabilité de périmètre et une association de périmètres dans un chargeur unique. Créez un chargeur pour une responsabilité de périmètre et un chargeur distinct pour une association de périmètres.
Mappage des colonnes pour l'association d'attributs
Si vous souhaitez charger des attributs de périmètre ou de dimension avec des associations, mappez-les dans la
colonne source
. Les attributs apparaissent en bas des mappages, sous Nom de l'association.
Annuler le mappage des colonnes
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.
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.

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. 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 avant d'effectuer un chargement complet pour vérifier que les mappages sont conformes à vos exigences. Vous pouvez également télécharger la sortie sous forme de fichier XML pour vérifier manuellement les associations de responsabilités de périmètres issues de votre source de données par rapport à vos critères avant de les charger.
Cliquez sur
Prévisualiser la sortie du chargeur
 dans le panneau Actions.
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 d'association utilisateur doivent être chargées, le chargeur créera un fichier XML et enverra une notification par e-mail 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 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 valeurs d'association et la taille du fichier.
Corriger les erreurs de validation
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 :
  • La valeur de l'identifiant source pour l'utilisateur ou la valeur de dimension et de périmètre est manquante (vide) dans les données.
  • L'identifiant source n'est pas mappé.

Exécuter le chargeur

Après avoir enregistré un chargeur de dimensions Planning 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 du chargeur d'associations 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.
Vous pouvez importer des données directement depuis le système source ou exécuter le chargeur en utilisant les 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 d'association Planning dans une tâche d'intégration
Une 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 de métriques et des chargeurs de scripts 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 seront présentés à chaque exécution de la tâche. Si un paramètre commun/partagé est utilisé dans le(s) chargeur(s) d'une tâche, alors la tâche ne lancera 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.