Créer des chargeurs infonuagiques personnalisés

Étapes de base

Saisissez les paramètres de la source de données.
Définissez les paramètres.
Écrivez du code Java à l’aide des API CCDS dans la section Espace de noms ai.
Définissez les règles de gestion.
Exécutez ou planifiez le chargeur.

Conditions préalables

Vérifiez que vous disposez de l’autorisation Développeur d’intégration.
Vérifiez que
Adaptive Planning
Les données de plan que vous souhaitez exporter existent déjà dans une table intermédiaire
Créez un identifiant OAuth pour votre système externe ou obtenez des identifiants que vous pouvez explicitement inclure dans votre JavaScript.
Vous devez savoir quels paramètres transmettre à votre système externe et les valeurs par défaut qu’attend le système externe.
Vous devez savoir comment écrire au point de terminaison du système externe.

Navigation

À partir du menu de navigation, accédez à

Intégrations de conception

d’intégration

Saisir les paramètres de source de données

Créer un nouveau chargeur infonuagique personnalisé

Accédez au concepteur de données en sélectionnant
Intégration > Concevoir des intégrations
.
Dans le dossier Chargeurs de la Bibliothèque de composants, cliquez sur
Créer un nouveau chargeur
.
Sélectionnez
Chargeur infonuagique personnalisé
comme type de chargeur et donnez-lui un nom.
Si vous ne voyez pas l’option Chargeur infonuagique personnalisé, soit elle n’est pas activée pour cette instance, soit vous ne disposez pas de l’autorisation Développeur d’intégration nécessaire pour y accéder.
Sélectionnez
Créer
.

Sélectionner la table source, l’identifiant et le niveau de journalisation

Saisissez les informations du chargeur infonuagique personnalisé :
Table source :
sélectionnez une table intermédiaire contenant
Adaptive Planning
les données Planning que vous souhaitez exporter.
Identifiant obligatoire :
indiquez si le système externe nécessite OAuth et si vous exigez qu’un utilisateur disposant de l’autorisation Opérateur d’intégration sélectionne l’identifiant OAuth approprié.
Identifiant :
sélectionnez un identifiant OAuth préexistant.
Niveau de journalisation :
indiquez le niveau de détail à consigner lors de l’exécution du chargeur :
Erreur
 :
consigne uniquement les erreurs.
Informations
 :
consigne toutes les informations de base. Par exemple, lorsque la source de données a été mise à jour.
Mode détaillé
 :
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 générer plus d’informations de journal que nécessaire pour une utilisation normale.
Cliquez sur
Enregistrer
dans le menu Actions.

Définir des paramètres

Cliquez sur
Paramètres du concepteur.
Faites glisser les éléments de paramètres paramétrables ou statiques du panneau
Composant de paramètres
dans le tableau
Paramètres du concepteur.
Les valeurs des paramètres paramétrables saisies ici deviennent les valeurs par défaut du chargeur si vous n’en fournissez aucune autre lors de l’exécution du chargeur.
Les paramètres statiques que vous saisissez ici sont utilisés à chaque exécution du chargeur et n’exigent aucune entrée au moment de l’exécution.
Booléen : valeur représentée par la valeur 1 ou 0.
Dimension : une dimension de l'administrateur des dimensions dans
Adaptive Planning
.
Entier : un nombre entier non négatif.
Mot de passe : un mot de passe. Cette valeur n’est plus visible une fois enregistrée.
Plage de périodes : une plage de périodes
Adaptive Planning
.
Texte : une valeur alphanumérique.
Cliquez deux fois sur un élément de paramètre pour saisir un nom et modifier sa valeur.
Faites glisser tous les é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 un JavaScript

Sélectionnez
Script
.
Sélectionnez le modèle préexistant et modifiez-le ou sélectionnez
Nouveau script
pour créer votre propre script.
Écrivez le javaScript que vous souhaitez que le chargeur exécute à l’aide des API CCDS dans le Espace de noms ai.
Vérifiez que le script contient les éléments requis suivants :
testConnection
fonction pour créer une demande https à publier dans votre système externe
exportData
fonction pour exporter des données de
Adaptive Planning
. Voir Fonction d’exportation de données (Chargeur infonuagique personnalisé seulement) dans la rubrique Fonctions de Adaptive Planning.
Référencez par nom tous les paramètres que vous avez créés dans les paramètres du concepteur.
Enregistrez le script.

Utiliser OAuth dans les scripts du chargeur infonuagique personnalisé

Sélectionner
Demander une autorisation
avant d’exécuter le chargeur.
Fournir des détails supplémentaires pour l’autorisation, tels que le champ d’application, requis pour le point de terminaison du système externe.
Sélectionner
Tester la connexion
pour vérifier que les identifiants OAuth ont été correctement transmis au point de terminaison.
Noter la date d’autorisation et le code utilisateur dans le statut d’autorisation. Les dates d’expiration des autorisations varient d’un système externe à un autre. Cliquez sur Réinitialiser l’autorisation dans le panneau Actions pour réattribuer une autorisation, le cas échéant.

Définir des règles de gestion

Cliquez sur l’onglet
Règles de gestion
.
Cliquez sur
Modifier
.
Saisissez 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 saisir.
Cliquez sur
Appliquer
pour vérifier votre syntaxe. En cas d’erreurs, un cadre rouge entoure l’expression. Passez la souris sur l’expression pour afficher des informations concernant des erreurs de syntaxe.
Corrigez toute erreur dans votre syntaxe et cliquez sur
Appliquer
. Seules les lignes intermédiaires correspondant à l’expression SQL seront chargées.

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

Exemple de script de chargeur infonuagique personnalisé

Configurez une source de données de type feuille de calcul.
Créez un nouveau chargeur infonuagique personnalisé dans le panneau
Chargeurs
.
Naviguez jusqu’à l’onglet
Paramètres de source de données
et sélectionnez votre source de données de type feuille de calcul dans le champ
Table source
.
Copiez l'exemple de script ci-dessous dans l'onglet
Scripts
.
 // Manually invoke this method via 'Test connection'
function testConnection(context) {
    return true;
}
// Manually invoke this method via 'Run manually'
function exportData(context) {
   //"xxx" is the name of your Amazon S3 bucket. 
    var bucketName = 'xxx';
    //Name of the sample CSV file to which data from your spreadsheet data source is exported
    var key = 'exampleTest.csv';
    //"xxxx" is the access key for your AWS S3 bucket.
    var awsAccessKey = 'xxxx';
    //"xxxx" is the secret key of your AWS S3 bucket. 
    var awsSecretKey = 'xxxx';
    var region = 'us-west-1';
    // Step 1: Get the data
    var reader = context.createTableReader();
    // Step 2: Process and export the data
    var result = "Column,Heading,Names\n";
    var row = null;
    while ((row = reader.readRow()) !== null) {
       // remove meta columns we don't need
       row.length = row.length - 2;
       result += row.join() + '\n';
   }
    ai.awss3.putFile(bucketName, key, result, region, awsAccessKey, awsSecretKey);
} 
Sélectionnez
Enregistrer
dans le panneau
Actions
.
Pour exécuter le script, cliquez sur
Exécuter manuellement
dans le panneau
Actions
.