Créer des chargeurs Cloud personnalisés

Étapes de base

Saisissez les paramètres de la source de données.
Définir des paramètres
Écrivez en langage JavaScript à l'aide des API SDCP dans Espace de nom 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 de Développeur en intégration.
Vérifie que
Adaptive Planning
Les données de plan que vous souhaitez exporter existent déjà dans une table temporaire.
Créez des identifiants OAuth pour votre système externe ou obtenez des identifiants que vous pouvez explicitement inclure dans votre Javascript.
Demandez les paramètres que vous devez transmettre à votre système externe et les valeurs par défaut qu'attend le système externe.
en Déterminez la méthode à utiliser pour écrire au point de terminaison du système externe.

Navigation

Dans le menu de navigation, accédez à

Intégration

Concevoir des intégrations

.

Saisir les paramètres de la source de données

Créer un nouveau chargeur Cloud 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
.
Cliquez sur
Chargeur Cloud personnalisé
comme type de chargeur et donnez-lui un nom.
Si vous ne voyez pas l'option Chargeur Cloud personnalisé, soit elle n'est pas activée pour cette instance, soit vous ne disposez pas de l'autorisation Développeur en 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 Cloud personnalisé :
Table source :
sélectionnez une table temporaire contenant
Adaptive Planning
Les données Planning que vous souhaitez exporter.
Exiger un identifiant :
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étrage configurés ou statiques du panneau
Composant de paramètres
dans
Paramètres du concepteur.
Les valeurs des paramètres configurés 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'exige aucune entrée au moment de l'exécution.
Boolean : valeur représentée par la valeur 1 ou 0.
Dimension : dimension de l'administrateur de dimensions dans
Adaptive Planning
.
Integer : nombre entier non négatif.
Password : mot de passe. Cette valeur ne peut pas être affichée une fois enregistrée.
Period range : plage de périodes dans
Adaptive Planning
.
Text : valeur alphanumérique.
Cliquez deux fois sur un élément de paramètre pour saisir un nom et modifier sa valeur.
Faites glisser un maximum d'éléments à 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 en 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 le chargeur doit exécuter en utilisant les API SDCP dans les Espace de nom ai.
Vérifiez que le script contient les éléments requis :
testConnection
fonction pour créer une requête https à publier sur votre système externe.
exportData
fonction pour exporter les données depuis
Adaptive Planning
. Voir Export Data Function (Custom Cloud Loader Only) dans la rubrique Fonctions 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 Cloud personnalisé

Sélectionner
Demander une autorisation
avant d'exécuter le chargeur.
Fournir des informations supplémentaires sur l'autorisation, telles que le champ d'application, nécessaires 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 temporaires correspondant à l'expression SQL seront chargées.

Inclure le chargeur Cloud personnalisé dans une tâche d'intégration

Exemple de script CCP

Configurez une source de données de type feuille de calcul.
Créez un nouveau chargeur Cloud personnalisé dans le panneau
Chargeurs
.
Cliquez sur l'onglet
Paramètres de la 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);
} 
Cliquez sur
Enregistrer
dans le panneau
Actions
.
Pour exécuter le script, cliquez sur
Exécuter manuellement
dans le panneau
Actions
.