Aangepaste cloudlaadprogramma's maken

Basisstappen

Voer gegevensbroninstellingen in.
Definieer parameters.
JavaScript schrijven met behulp van de CCDS-API's in de: ai Namespace.
Definieer bedrijfsregels.
Voer de lader uit of plan deze.

Prerequisites

Controleer of u over de machtiging Integratieontwikkelaar beschikt.
Controleren of
Adaptive Planning
plangegevens die u wilt exporteren, staan al in een faseringstabel.
Maak een OAuth-referentie voor uw externe systeem of verkrijg referenties die u expliciet in uw JavaScript kunt opnemen.
Weet welke parameters u aan uw externe systeem moet doorgeven en welke standaardinstellingen het externe systeem verwacht.
Begrijp hoe u naar het eindpunt van het externe systeem moet schrijven.

Navigatie

From the nav menu, go to

Integration

Design Integrations

Gegevensbroninstellingen invoeren

Een nieuw aangepast cloudlaadprogramma maken

Open de Gegevensontwerper door naar
Integratie > Integratieontwerpen
te gaan.
Selecteer
Nieuwe lader maken
in de map Laders van de componentenbibliotheek.
Selecteer
Aangepast cloudlaadprogramma
als ladertype en voer een naam in.
Als Aangepast cloudlaadprogramma niet als optie wordt weergegeven, is deze optie niet ingeschakeld voor deze instance of beschikt u niet over de benodigde machtigingen voor integratieontwikkelaars om toegang te krijgen.
Selecteer
Maken
.

Selecteer de brontabel, de referenties en het logboekniveau

Voer de informatie van het aangepaste cloudlaadprogramma in:
Brontabel:
selecteer een faseringstabel met:
Adaptive Planning
planningsgegevens die u wilt exporteren.
Referentie vereist:
selecteer of het externe systeem OAuth vereist en of u een gebruiker met de machtiging Integratiegebruiker nodig hebt om de juiste OAuth-referentie te selecteren.
Referentie:
selecteer een bestaande OAuth-referentie.
Logboekniveau:
selecteer hoeveel details u wilt registreren wanneer de lader wordt uitgevoerd:
Fout
:
alleen fouten worden geregistreerd.
Info
:
registreert alle basisgegevens, zoals wanneer de gegevensbron is bijgewerkt.
Uitgebreid
:
biedt zeer gedetailleerde informatie over alle fasen en acties. Wordt voornamelijk gebruikt voor het opsporen van fouten of audits, omdat het meer logboekinformatie kan opleveren dan praktisch is voor normaal gebruik.
Klik op
Opslaan
in het actiemenu.

Parameters definiëren

Selecteer
Ontwerper-instellingen.
Sleep geparametriseerde of statische instellingsitems uit het deelvenster
Instellingencomponent
naar
Ontwerper-instellingen.
De hier ingevoerde waarden voor parameterinstellingen worden standaardwaarden voor de lader als u tijdens de uitvoering van de lader geen andere waarden opgeeft.
Statische instellingen die u hier invoert, worden elke keer dat de lader wordt uitgevoerd gebruikt en hoeven tijdens runtime niet te worden ingevoerd.
Boole-waarde: een waarde die wordt weergegeven als één of nul.
Dimensie: een dimensie uit de dimensiebeheerder in
Adaptive Planning
.
Integer: een niet-negatief geheel getal.
Wachtwoord: een wachtwoord. Deze waarde kan niet worden weergegeven nadat deze is opgeslagen.
Periodebereik: een periodebereik van binnen
Adaptive Planning
.
Tekst: een alfanumerieke waarde.
Dubbelklik op een parameteritem om een naam in te voeren en de waarde te wijzigen.
Sleep zoveel items naar binnen als u nodig hebt voor uw verwijzing in uw JavaScript.
Sla de lader op.
Gebruik de naam van een parameter in uw JavaScript om ernaar te verwijzen.

JavaScript schrijven

Selecteer
Script
.
Selecteer de bestaande sjabloon en wijzig deze of selecteer
Nieuw script
om uw eigen script te maken.
Schrijf het JavaScript dat u door de lader wilt laten uitvoeren met behulp van de CCDS-API's in de: ai Namespace.
Controleer of het script de volgende vereiste functies bevat:
testConnection
functie om een https-aanvraag te maken om naar uw externe systeem te posten
exportData
functie om gegevens uit te exporteren
Adaptive Planning
. Zie Gegevensfunctie exporteren (alleen aangepast cloudlaadprogramma) in het onderwerp Adaptive Planning Functions.
Verwijs met naam naar alle parameters die u in de Ontwerper-instellingen hebt gemaakt.
Sla het script op.

OAuth gebruiken in aangepaste cloudlaadprogrammascripts

Selecteer
Autorisatie aanvragen
voordat u de lader uitvoert.
Geef eventuele aanvullende autorisatiedetails op, zoals het bereik, die nodig zijn voor het externe systeemeindpunt.
Selecteer
Verbinding testen
om te controleren of de OAuth-referenties zijn doorgegeven aan het eindpunt.
Noteer de autorisatiedatum en gebruikers-ID in de autorisatiestatus. De vervaldatums van de autorisatie verschillen per extern systeem. Selecteer Autorisatie opnieuw instellen in het deelvenster Acties om zo nodig opnieuw te autoriseren.

Bedrijfsregels definiëren

Selecteer het tabblad
Bedrijfsregels
.
Selecteer
Bewerken
.
Voer een SQL-expressie in. U kunt op een item in de lijst Beschikbare kolommen klikken om die kolom in de SQL-expressie te plaatsen in plaats van deze te typen.
Selecteer
Toepassen
om uw syntaxis te controleren. Bij fouten wordt de rand rond de uitdrukking rood. Plaats de muisaanwijzer op de expressie om informatie over syntaxisfouten weer te geven.
Corrigeer eventuele fouten in uw syntaxis en selecteer
Toepassen
. Alleen faseringsrijen die overeenkomen met de SQL-expressie worden geladen.

Het aangepast cloudlaadprogramma opnemen in een integratietaak

Voorbeeld van CCL-script

Stel een spreadsheetgegevensbron in.
Maak een nieuw aangepast cloudlaadprogramma aan in het deelvenster
Laders
.
Navigeer naar het tabblad
Gegevensbroninstellingen
en selecteer de gegevensbron van uw spreadsheet in het veld
Brontabel
.
Kopieer het onderstaande voorbeeldscript naar het tabblad
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);
} 
Selecteer
Opslaan
in het deelvenster
Acties
.
Selecteer
Handmatig uitvoeren
in het deelvenster
Acties
om het script uit te voeren.