Passer au contenu principal

logoCorrectSize.png

Workday Adaptive Planning Knowledge Center

Créer un chargeur cloud personnalisé

Il est nécessaire de disposer d’une connaissance approfondie de la programmation Javascript et d’une expérience pour créer un chargeur cloud personnalisé. Vous ne devez pas commencer à créer un chargeur cloud personnalisé si vous n’avez pas accès à un programmeur Javascript expérimenté. Vous devez également recevoir l’autorisation de Développeur en intégration dans Adaptive Insights  Administration > Rôles et autorisations avant de tenter de créer un chargeur cloud personnalisé.

Un chargeur cloud personnalisé  vous permet d’exporter Adaptive Insights des données de planification directement vers des systèmes cloud tiers.

Regardez la vidéo : 3 min 16 s

Custom Cloud Loader
 

Étapes de base

  1. Saisissez les paramètres de source de données.
  2. Définissez les paramètres.
  3. Écrire le Javascript à l’aide de l’API CCDS.
  4. Définissez les règles métiers.
  5. Exécutez ou programmez le chargeur.

Avant de commencer

  • Vérifiez que vous avez l’autorisation de rôle Développeur en intégration.
  • Vérifiez que les données de plan Adaptive Insights que vous souhaitez exporter existent  déjà dans une table de stockage.
  • Créez des informations d’identification OAuth pour votre système externe ou obtenez des informations d’identification que vous pouvez explicitement inclure dans votre Javascript.
  • Ayez connaissance des paramètres que vous devez transmettre à votre système externe et quelles sont les valeurs par défaut attendues par le système externe.
  • Comprendre comment écrire sur le point terminal du système externe.

Comment y parvenir

Compass.png Aller à nav menu navicon.gif > Intégration >Intégrations de conception

Saisissez les Paramètres de la source de données

Les paramètres de source de données vous permettent de choisir la table source que vous souhaitez utiliser dans les données de stockage de votre instance, de déterminer les informations d’identification à utiliser et le niveau de détail du journal à enregistrer lors d’une exécution du chargeur.

Créer un nouveau chargeur cloud personnalisé

  1. Ouvrez le concepteur de données en accédant à >Intégration Intégrations de conception.
  2. Dans le dossier Chargeurs de la bibliothèque de composants  sélectionnez Créer un nouveau chargeur.
  3. Sélectionnez Chargeur cloud personnalisé comme type de chargeur et saisissez un nom. Si vous ne voyez pas l’option Chargeur cloud personnalisé, soit elle n’est pas activée pour cette instance, soit vous n’avez pas l’autorisation de rôle Développeur en intégration nécessaire pour y accéder.
  4. Sélectionnez Créer.

Sélectionnez la table source, les informations d’identification et le niveau de journal

  1. Saisissez les informations du chargeur cloud personnalisé :
  • Table source :  Sélectionnez une table de stockage contenant les données de planification Adaptive Insights que vous souhaitez exporter.
  • Requiert des informations d’identification : Sélectionnez si le système externe nécessite OAuth et si vous exigez qu’un utilisateur disposant d’une autorisation de rôle d’opérateur d’intégration sélectionne les informations d’identification OAuth appropriées.
  • Informations d’identification : Sélectionnez des informations d’identification OAuth  préexistantes. 
  • Niveau du journal : Sélectionnez  combien de détails journaliser lorsque le chargeur fonctionne :
    • Erreur : Ne consigne que les erreurs.
    • Informations :  Consigne toutes les informations de base, par exemple lorsque la source de données a été mise à jour.
    • Verbeux :  fournit des informations très détaillées sur toutes les phases et actions. Principalement utilisé pour le débogage ou l’audit, car il peut produire plus d’informations de journal que nécessaire, pour une utilisation normale.
  1. Cliquez sur Enregistrer dans le menu Actions.

Définir les paramètres

Définissez les paramètres que votre Javascript exige pour exporter les données Adaptive Insights vers votre système externe. Les paramètres peuvent inclure des URL de connexion, des noms d’utilisateur, mots de passe, dimensions de Adaptive Insights et d’autres informations. Les paramètres paramétrisés vous permettent de modifier leurs valeurs au moment de l’exécution. Les paramètres statiques persistent dans les exécutions du chargeur.

  1. Sélectionnez Paramètres du concepteur.
  2. Faites glisser les éléments de paramétrage paramétrisé ou  statique du panneau Composant de paramètres  dans le canevas sous Paramètres de concepteur. 
    • Les valeurs  de paramètre paramétrisé saisies ici deviennent les valeurs par défaut du chargeur si vous n’en fournissez  au moment de l’exécution du chargeur.
    • Les paramètres statiques que vous saisissez ici sont utilisés à chaque fois que le chargeur s’exécute et n’exige pas d’entrée au moment de l’exécution.
  • Booléen : Une valeur représentée sous forme de un ou zéro.
  • Dimension : Une  dimension de l’admin des dimension dans Adaptive Insights.
  • Entier : Un nombre entier non négatif.
  • Mot de passe : Un mot de passe. Cette valeur ne peut pas être affichée une fois qu’elle est enregistrée.
  • Période : Une période dans Adaptive Insights.
  • Texte : Une valeur alphanumérique.
  1. Double-cliquez sur un élément dans le canevas pour donner un nom au paramètre et le modifier.
  2. Faites glisser autant d’éléments que vous devez référencer dans votre Javascript.
  3. Enregistrez le chargeur.
  4. Utilisez le nom d’un paramètre dans votre Javascript pour le référencer.

Écrire le Javascript

  1. Sélectionnez Script.
  2. Sélectionnez le modèle préexistant et modifiez-le ou sélectionnez Nouveau script pour créer votre propre modèle.
  3. Écrivez le Javascript que vous souhaitez que le chargeur exécute en utilisant   l’API de script  CCDS.
  4. Vérifiez que le script comprend les éléments requis :
  • La fonction testConnection  pour créer une requête https à publier sur votre système externe
  • La fonction exportData pour exporter des données de Adaptive Insights.
  1. Faites référence à tous les paramètres que vous avez créés dans les Paramètres de concepteur par leur nom.
  2. Enregistrez le script.

Vous pouvez formater et embellir un script dans l’éditeur en utilisant le raccourci clavier Ctrl+B. Recherchez et remplacez les lancements avec Ctrl+H.

Vous pouvez séparer un long script en plusieurs fichiers pour faciliter la maintenance. Par exemple, vous pouvez contenir toute votre logique testConnection logique dans un script  appelé testconnectionscript. Un deuxième script, appelé exportdatascript, peut contenir toute la logique exportData logique. Lorsque la même fonction est déclarée dans plusieurs scripts, celle provenant du script le plus récemment ajouté est utilisée.

Utiliser OAuth dans les scripts de chargeur cloud personnalisé

Lorsque vous sélectionnez Exiger des informations d’identification pour un chargeur cloud personnalisé, votre script doit contenir ai.https.authorizedRequest.

Voir Authentification avec OAuth  pour savoir comment créer des informations d’identification  OAuth.

Les personnes qui exécutent un chargeur cloud personnalisé qui font référence à un identifiant doivent :

  1. Sélectionner Demander une autorisation avant d’exécuter le chargeur.
  2. Fournir des informations supplémentaires sur l’autorisation, telles que la portée,  nécessaires pour le point terminal  du système externe.
  3. Sélectionner Tester la connexion pour vérifier que les informations d’identification  OAuth ont été transmises avec succès au point terminal.
  4. Noter la date d’autorisation et l’ID utilisateur dans le statut d’autorisation. Les dates d’expiration d’autorisation varient d’un système externe à l’autre. Sélectionnez Réinitialiser l’autorisation dans le panneau Actions pour réautoriser le cas échéant.

Définissez les règles professionnelles.

Vous pouvez utiliser les Règles métiers pour créer des expressions SQL qui limitent les données de stockage exportées vers le système externe. Seuls les enregistrements répondant à vos critères de filtre seront chargés.

L’onglet Règles métiers contient une zone de texte pour entrer du SQL.

  1. Sélectionnez l’onglet Règles métiers .
  2. Sélectionnez Modifier.
  3. Entrer une expression SQL Vous pouvez cliquer sur un élément dans Colonnes disponibles pour inclure cette colonne dans l’expression SQL plutôt que de la taper.
  4. Sélectionnez Appliquer pour vérifier votre syntaxe. En cas d’erreurs, l’expression est entourée en rouge. Survolez avec votre curseur l’expression pour voir les informations d’erreur de syntaxe.
  5. Corrigez les erreurs dans votre syntaxe et sélectionnez Appliquer. Seules les lignes de stockage correspondant à l’expression SQL seront chargées.

Inclure le chargeur cloud personnalisé dans une tâche d’intégration

Les chargeurs cloud personnalisés  doivent être exécutés comme tâches d’intégration. Toute Integration tâche peut contenir un ou plusieurs chargeurs. Une tâche peut également contenir d’autres tâches d’intégration et chargeurs.

Bonne pratique : Distinguer chaque Tâche d’intégration pour chaque chargeur.

Si une tâche contient plusieurs chargeurs, les paramètres de chaque chargeur sont présentés lors de l’exécution de la tâche. Si un paramètre commun/partagé est utilisé dans les chargeurs dans une tâche, la tâche lance le paramètre une seule fois. Vous pouvez décider d’ignorer les invites de paramètre. 

Pour des exécutions planifiées de la tâche, les valeurs par défaut des paramètres , archivées lors de la création des chargeurs , sont utilisées.

  • Cet article vous a été utile ?