Créer un chargeur cloud personnalisé

Dernière mise à jour
Enregistrer en tant que PDF

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 Administration > Rôles et autorisations avant de tenter de créer un chargeur Cloud personnalisé.

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

Regardez la vidéo :3 m 16 s

Étapes de base

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

Before You Begin

Vérifiez que vous avez l’autorisation de rôle Développeur en intégration.
Vérifiez que les données de plan Adaptive Planning 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.

How You Get There

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é

Ouvrez le concepteur de données en accédant à >Intégration Intégrations de conception.
Dans le dossier Chargeurs de la bibliothèque de composants sélectionnez Créer un nouveau chargeur.
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.
Sélectionnez Créer.

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

Saisissez les informations du chargeur cloud personnalisé :

Table source : Sélectionnez une table de stockage contenant les données de planification Adaptive Planning 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.

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 Planning vers votre système externe. Les paramètres peuvent inclure des URL de connexion, des noms d’utilisateur, mots de passe, dimensions de Adaptive Planning 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.

Sélectionnez Paramètres du concepteur.
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 Planning.
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 Planning.
Texte : Une valeur alphanumérique.

Double-cliquez sur un élément dans le canevas pour donner un nom au paramètre et le modifier.
Faites glisser autant d’éléments que vous devez référencer dans votre Javascript.
Enregistrez le chargeur.
Utilisez le nom d’un paramètre dans votre Javascript pour le référencer.

Écrire le Javascript

Sélectionnez Script.
Sélectionnez le modèle préexistant et modifiez-le ou sélectionnez Nouveau script pour créer votre propre modèle.
Écrivez le Javascript que vous souhaitez que le chargeur exécute en utilisant l’API de script CCDS.
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 Planning.

Faites référence à tous les paramètres que vous avez créés dans les Paramètres de concepteur par leur nom.
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 :

Sélectionner Demander une autorisation avant d’exécuter le chargeur.
Fournir des informations supplémentaires sur l’autorisation, telles que la portée, nécessaires pour le point terminal du système externe.
Sélectionner Tester la connexion pour vérifier que les informations d’identification OAuth ont été transmises avec succès au point terminal.
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.

Sélectionnez l’onglet Règles métiers .
Sélectionnez Modifier.
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.
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.
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.