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
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
- Saisissez les paramètres de la source de données.
- Configurez le mappage des colonnes.
- Créez des règles de gestion.
- Affichez un aperçu de la sortie du chargeur.
- Exécutez ou planifiez le chargeur.
Navigation
À partir du menu de navigation, accédez à 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.
- Cliquez surdans le panneauCréer un nouveau chargeurChargeursde la Bibliothèque de composants.
- SélectionnezChargeur d’associationsPlanningcomme type de chargeur. Entrez un nom pour le chargeur.
- Cliquez sur.Créer
- Saisissez les informations au sujet despropriétés généralesdu chargeur d’associations dans l’ongletParamè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électionnezMettre à jourpour 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électionnezTout remplacerpour 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, lemodeindiquera automatiquementMise à jour.
- Si vous n’utilisez pas Adaptive Planning avec Workday Human Capital Management ou Workday Financials, lemodeindiquera automatiquementTout 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 pour sélectionner :
Planning
à mapper, utilisez le filtre Afficher
- Tout: affiche tous les utilisateurs.
- Obligatoireaffiche 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 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.
Rechercher
- Mapper les colonnes
- Cliquez sur l’onglet. L’onglet Mappage de colonnes affiche les colonnes suivantes :Mappage de colonnes
- Statut: une case à cocher
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. 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.
- 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
.
- 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 dansColonne source. La propriété de niveau dansAdministration>Associationss’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 queRef IDà titre de code d’association dans laColonne 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 lacolonne 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 surAnnuler le mappageet 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
.
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 :
- Dans l’ongletRègles de gestion, cliquez surFiltre SQL. Cliquez sur.Modifier
- Saisissez une expression SQL. Vous pouvez cliquer sur un élément dans la listeColonnes disponiblespour inclure cette colonne dans l’expression SQL plutôt que de l’entrer.
- Cliquez surpour 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.AppliquerPour obtenir de l’aide sur la syntaxe SQL, cliquez sur l’dans la section Notes de la boîte de dialogue Modifier le filtre SQL. Voir Référence : expressions SQL.aide en ligne
- Corrigez les erreurs de syntaxe et cliquez sur. Seules les lignes intermédiaires correspondant à l’expression SQL seront importées lorsque vous exécuterez le chargeur.Appliquer
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.