Creare caricatori cloud personalizzati

Procedura di base

Immettere le impostazioni dell'origine dati.
Definire i parametri.
Scrivere JavaScript utilizzando le API di CCDS in ai Namespace.
Definire le regole aziendali.
Eseguire o pianificare l'esecuzione del caricatore.

Prerequisiti

Verificare di disporre dell'autorizzazione Sviluppatore integrazioni.
Verificare
Adaptive Planning
i dati del piano che si desidera esportare esistono già in una tabella di gestione temporanea.
Creare credenziali OAuth per il sistema esterno o ottenere credenziali che è possibile includere in modo esplicito nel codice JavaScript.
Definire quali parametri è necessario passare al sistema esterno e quali sono i valori predefiniti previsti da tale sistema.
Approfondire le modalità per le comunicazioni scritte con l'endpoint del sistema esterno.

Navigazione

Dal menu di navigazione, accedere a

Integrazione

Progettazione integrazioni

Immettere le impostazioni dell'origine dati

Creare un nuovo caricatore cloud personalizzato

Accedere al Designer dati selezionando
Integrazione > Progettazione integrazioni
.
Nella cartella Caricatori della Libreria componenti, selezionare
Crea nuovo caricatore
.
Selezionare
Caricatore cloud personalizzato
come tipo di caricatore e immettere un nome.
Se l'opzione Caricatore cloud personalizzato non è presente, il caricatore cloud personalizzato non è abilitato per l'istanza in uso oppure non si dispone dell'autorizzazione Sviluppatore integrazioni necessaria per accedere al caricatore.
Selezionare
Crea
.

Selezionare valori per Tabella di origine, Credenziale e Livello registro

Immettere le informazioni del Caricatore cloud personalizzato:
Tabella di origine:
selezionare una tabella di gestione temporanea contenente
Adaptive Planning
dati di pianificazione che si desidera esportare.
Credenziali richieste:
selezionare questa opzione se il sistema esterno richiede OAuth e si desidera che l'utente che seleziona le credenziali OAuth disponga dell'autorizzazione Operatore di integrazione.
Credenziale:
selezionare una credenziale OAuth preesistente.
Livello registro:
selezionare la quantità di dettagli da registrare quando il caricatore è in esecuzione:
Errore
:
registra solo gli errori.
Info
:
registra tutte le informazioni di base, ad esempio quando è stata aggiornata l'origine dati.
Dettagli
:
fornisce informazioni dettagliate su tutte le fasi e le azioni. Viene utilizzato principalmente per il debug o la verifica, perché può aggiungere al registro una quantità di informazioni eccessiva.
Fare clic su
Salva
nel menu delle azioni.

Definire i parametri

Selezionare
Impostazioni designer.
Trascinare gli elementi di impostazione di tipo Con parametri o Statico dal riquadro
Componente impostazioni
a
Impostazioni designer.
I valori delle impostazioni con parametri immessi in questo passaggio diventano valori predefiniti del caricatore, se non viene specificato un valore alternativo nella fase di esecuzione del caricatore.
Le impostazioni statiche immesse in questo passaggio vengono utilizzate ogni volta che viene eseguito il caricatore e non richiedono nessun input nella fase di esecuzione.
Booleano: un valore uno o zero.
Dimensione: una dimensione dall'amministratore della dimensione all'interno
Adaptive Planning
.
Intero: un numero intero non negativo.
Password: una password. Una volta salvato, questo valore non può essere visualizzato.
Intervallo di tempo: un intervallo di tempo compreso tra l'interno
Adaptive Planning
.
Testo: un valore alfanumerico.
Fare doppio clic su una voce parametro per immettere un nome e modificarne il valore.
Trascinare tutti gli elementi necessari a cui fare riferimento in JavaScript.
Salvare il caricatore.
Utilizzare il nome di un parametro in JavaScript per fare riferimento al parametro.

Creare codice JavaScript

Selezionare
Script
.
Selezionare il modello preesistente e modificarlo, oppure selezionare
Nuovo script
per creare uno script personalizzato.
Scrivere il javaScript che si desidera venga eseguito dal caricatore utilizzando le API di CCDS in ai Namespace.
Verificare che lo script includa i seguenti elementi obbligatori:
testConnection
per creare una richiesta https da pubblicare nel sistema esterno
exportData
funzione da cui esportare i dati
Adaptive Planning
. Consultare Funzione di esportazione dei dati (solo caricatore cloud personalizzato) nell'argomento Adaptive Planning Functions.
Creare riferimenti basati sul nome per tutti i parametri creati in Impostazioni designer.
Salvare lo script.

Utilizzare OAuth negli script del caricatore cloud personalizzato

Selezionare
Richiedi autorizzazione
prima di eseguire il caricatore.
Fornire tutti i dettagli di autorizzazione aggiuntivi necessari per l'endpoint del sistema esterno, ad esempio l'ambito.
Selezionare
Test di connessione
per verificare che le credenziali OAuth siano state trasmesse correttamente all'endpoint.
Annotare la data di autorizzazione e l'ID utente in Stato autorizzazione. Le date di scadenza delle autorizzazioni variano da un sistema esterno all'altro. Selezionare Reimposta autorizzazione nel riquadro Azioni per riattivare l'autorizzazione in base alle esigenze.

Definire le regole aziendali

Selezionare la scheda
Regole aziendali
.
Selezionare
Modifica
.
Immettere un'espressione SQL. È possibile fare clic su un elemento in Colonne disponibili per inserire la colonna nell'espressione SQL invece di digitarla.
Selezionare
Applica
per verificare la sintassi. In caso di errore, il bordo intorno all'espressione diventerà di colore rosso. Passare il puntatore del mouse sull'espressione per visualizzare le informazioni sull'errore di sintassi.
Correggere eventuali errori di sintassi e selezionare
Applica
. Verranno caricate solo le righe di gestione temporanea corrispondenti all'espressione SQL.

Includere il caricatore cloud personalizzato in un'attività di integrazione

Script CCL di esempio

Configurare un'origine dati foglio di calcolo.
Creare un nuovo caricatore cloud personalizzato nel riquadro
Caricatori
.
Passare alla scheda
Impostazioni origine dati
e selezionare l'origine dei dati del foglio di calcolo nel campo
Tabella di origine
.
Copiare lo script di esempio seguente nella scheda
Script
.
 // 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);
} 
Selezionare
Salva
nel riquadro
Azioni
.
Per eseguire lo script, selezionare
Esegui manualmente
nel riquadro
Azioni
.