Passer au contenu principal
Adaptive Planning
Créer des chargeurs d’associations Planning

Créer des chargeurs d’associations Planning

Le chargeur d'associations Planning vous permet de mapper les métadonnées sur les associations de dimensions et de niveaux des utilisateurs de la zone intermédiaire
Adaptive Planning
. Les associations permettent de connecter les niveaux et les dimensions personnalisées aux utilisateurs. La propriété de niveau est un type d’association d’utilisateurs qui les connecte aux niveaux. À la différence des associations de niveaux classiques, la propriété de niveau 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 Planning Planning requiert des données intermédiaires à partir d'une importation 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. Affichez un aperçu de la sortie du chargeur.
  5. Exécutez ou planifiez le chargeur.

Navigation

Compas.png À partir du menu de navigation, accédez à
Intégrations de conception
d’intégration

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 intermédiaires d’intégration et d’indiquer les associations à charger.
  1. Cliquez sur
    Créer un nouveau chargeur
    dans le panneau
    Chargeurs
    de la Bibliothèque de composants.
  2. Sélectionnez
    Chargeur d’associations
    Planning
    comme type de chargeur. Entrez un nom pour le chargeur.
  3. Cliquez sur
    Créer
    .
  4. Saisissez les informations au sujet des
    propriétés générales
    du chargeur d’associations dans l’onglet
    Paramètres de source de données
     :
    • 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 de stockage intermédiaire à laquelle vous accédez.
    • Profil de mappage :
      vous pouvez lier 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, mappe les niveaux 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 niveau (ou pour Workday, un identifiant Workday), le profil de mappage détermine le niveau Planning auquel il fait référence.
    • Niveau ou dimension
       : sélectionnez le niveau pour la propriété de niveau ou l’association de niveau. Sélectionnez une dimension pour charger des associations de dimensions.
    • Attribut :
      (facultatif) sélectionnez un attribut Adaptive Planning pour le niveau ou la dimension. Cela vous permet de mapper et de charger des associations pour des attributs de niveau ou de dimension.
    • Mode
       : sélectionnez
      Mettre à jour
      pour modifier des associations ou des affectations de propriétés dans un sous-ensemble de niveaux. Cette mise à jour concerne le niveau, pas l’utilisateur. Pour mettre à jour le niveau, tous les utilisateurs associés à ce niveau 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
        Tout remplacer
        .
    • Continuer avec des avertissements
       : cochez cette case pour poursuivre l’exécution du chargeur même en présence d’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 niveaux 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 > Niveaux
ou
Modélisation > Gestion du modèle > Dimensions
. Vous devez mapper les colonnes
Utilisateur
et
Planning
.
Si vous êtes un client de Workday exécutant une synchronisation utilisateur dans cet environnement, la colonne Utilisateur doit être mappée à la colonne source qui contient les 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 ou des courriels.
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 Niveau.
  • 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 une recherche, puis cliquez sur la loupe. Les colonnes intermédiaires correspondant à la recherche figurent 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 case à cocher Colonne mappée indique une colonne mappée. Une colonne non mappée avec un point d’exclamation indique qu’une colonne n’est pas mappée.
    • Colonne Planning
       : affiche toutes les colonnes Planning disponibles pour le mappage. Les colonnes Planning obligatoires sont indiquées en caractères gras et comportent un astérisque.
    • Colonne source
       : affiche les colonnes de la table intermédiaire sélectionnée dans Paramètres de source de données.
  2. 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 IntegrationMappingUnmapped.png au vert IntegrationMappingMapping.png.
Mappage des colonnes relativement à la propriété de niveau
Si vous voulez charger uniquement la propriété de niveau, ne mappez pas un identifiant de code d’association pour le niveau dans
Colonne source
. La propriété de niveau dans
Administration
 >
Associations
s’obtient en laissant le code de l’association vide.
Mappage des colonnes pour l’association de niveaux et de dimensions
Si vous voulez charger uniquement les associations de niveaux et de dimensions, ne mappez pas d’identifiant, tel que
Ref ID
à titre de code d’association dans la
Colonne source
.
Vous ne pouvez pas charger une propriété de niveau et une association de niveaux dans un chargeur unique. Créez un chargeur pour une propriété de niveau et un chargeur distinct pour une association de niveaux.
Colonnes de mappage pour l'association d'attributs
Si vous voulez charger des attributs de niveau ou de dimension avec des associations, mappez-les dans la
colonne Source
. Les attributs apparaissent en bas des mappages, sous le nom de l’association.
Annuler le mappage des colonnes
Vous pouvez annuler le mappage des colonnes pour ignorer les données intermédiaires que vous ne souhaitez pas charger. Vous pouvez également annuler le mappage des colonnes une par une après l’exécution du chargeur afin de déterminer les colonnes qui génèrent 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 remplace l'icône de statut par un 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 intermédiaires 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 l’entrer.
  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 Notes 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 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 un 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 la sortie sous forme de fichier XML pour vérifier manuellement les associations de propriétés de niveaux issues de votre source de données par rapport à vos critères, et ce, avant de les charger.
Cliquez sur
Afficher un aperçu de la sortie du chargeur
dans le panneau Actions.
Le chargeur s’exécute en appliquant toutes les transformations et règles de gestion qui font partie de l’exécution. 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é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 compressé. 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 d’aperçu ou du chargement manuel, les données source sont validées pour détecter les erreurs. Par exemple, les validations incluent les vérifications suivantes :
  • La valeur de l’identifiant source de l’utilisateur ou la valeur de dimension et de niveau 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.
Prévoyez 15 à 30 minutes entre chaque exécution du chargeur d'associations Planning afin que
Adaptive Planning
a du temps à synchroniser avec votre importation. La synchronisation des importations plus volumineuses nécessite plus de temps. 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 d’associations 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 Discovery et des chargeurs à base 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 seront 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 au moment de la création des chargeurs, sont utilisées.