JavaScript Jitterbit und allgemeine Funktionen in Integration Studio

Jitterbit-JavaScripts können zusätzlich zu den Standard-JavaScript-Funktionen, die Teil von ECMA-262 v5.1 sind, auf Folgendes zugreifen: - diese Jitterbit-spezifischen Funktionen. Da ECMA-262 v5.1 eine ältere Version von JavaScript ist als das, was üblicherweise in Browsern und anderen JavaScript-Engines verfügbar ist, haben wir Tabellen der allgemeinen und standardmäßigen JavaScript-Funktionen beigefügt, die in Jitterbit-JavaScripts verfügbar sind.

Jitterbit-Funktionen

Jitterbit.DbExecute

Erklärung

array Jitterbit.DbExecute(string databaseId, string sql)

int Jitterbit.DbExecute(string databaseId, string sql, string outputVariable,...)

Syntax

Jitterbit.DbExecute(<databaseId>, <sql>)

Jitterbit.DbExecute(<databaseId>, <sql>, <outputVariable>,...])

Erforderliche Parameter

• databaseId: Ein String-Referenzpfad zu einer Datenbankverbindung im aktuellen Projekt
• sql: Der SQL-Befehl, der für die Datenbank ausgeführt werden soll
• outputVariable: (Zweite Form) Ein Ausgabeparameter, der mit den im SQL-Befehl zurückgegebenen Feldern abgeglichen wird. Bei Bedarf können zusätzliche Argumente angegeben werden.

Beschreibung

Führt eine SQL-Anweisung für eine Datenbank aus und gibt die Ergebnisse zurück. Siehe das Jitterbit Script DBExecute -Funktion für weitere Einzelheiten.

Die in diesem Funktionsaufruf verwendete Datenbank muss im aktuellen Projekt als Datenbankverbindung definiert sein. Weitere Informationen finden Sie in den Anweisungen zum Einfügen von Endpoints unter Endpoints in JavaScript.

Jitterbit.DbLookup

Erklärung

string Jitterbit.DbLookup(string databaseId, string sql)

Syntax

Jitterbit.DbLookup(<databaseId>, <sql>)

Erforderliche Parameter

• databaseId: Ein String-Referenzpfad zu einer Datenbankverbindung im aktuellen Projekt
• sql: Der SQL-Befehl, der für die Datenbank ausgeführt werden soll

Beschreibung

Führt eine SQL-Anweisung für eine Datenbank aus und gibt das erste Feld des ersten Ergebnisses zurück, das den angegebenen Kriterien entspricht. Siehe das Jitterbit Script DBLookup -Funktion für weitere Einzelheiten.

Die in diesem Funktionsaufruf verwendete Datenbank muss im aktuellen Projekt als Datenbankverbindung definiert sein. Weitere Informationen finden Sie in den Anweisungen zum Einfügen von Endpoints unter Endpoints in JavaScript.

Jitterbit.GetVar

Erklärung

string Jitterbit.GetVar(string jitterbitVariableName)

Syntax

Jitterbit.GetVar(<jitterbitVariableName>)

Erforderliche Parameter

• jitterbitVariableName: Der Name einer Jitterbit-Variable

Beschreibung

Gibt den Wert einer Jitterbit-Variable zurück (eine vordefinierte globale Variable, die in den Agenten integriert ist und mit jitterbit.). Die verfügbaren Variablen finden Sie in Integration Studio und sind unter Jitterbit-Variablen dokumentiert.

Beispiele

// Retrieves the value of the Jitterbit variable "jitterbit.api.request"
var request = Jitterbit.GetVar("$jitterbit.api.request");

Jitterbit.ReadFile

Erklärung

string Jitterbit.ReadFile(string sourceId[, string fileFilter])

Syntax

Jitterbit.ReadFile(<sourceId>[, <fileFilter>])

Erforderliche Parameter

• sourceId: Ein String-Referenzpfad zu einer Aktivität, die mit einem Dateityp-Endpoint im aktuellen Projekt verknüpft ist

Optionale Parameter

• fileFilter: Dateifilter oder Dateiname zum Überschreiben der Aktivitätskonfiguration

Beschreibung

Liest den Inhalt einer Datei aus einer Quelle.

Die in diesem Funktionsaufruf verwendete Quelle muss als Aktivität definiert sein, die mit einem Dateityp-Endpoint im aktuellen Projekt verknüpft ist. Dazu gehören konfigurierte Aktivitäten für Dateifreigabe, FTP, HTTP, lokalen Speicher und temporären Speicher. Weitere Informationen finden Sie in den Anweisungen zum Einfügen von Endpoints unter Endpoints in JavaScript.

Die Methode gibt den Inhalt der Datei zurück, auf die die Quelle verweist. Wenn der Quellfilter mehr als eine Datei auswählt, wird die erste verwendet. Es wird empfohlen, eine Quelle anzugeben, die eine einzelne Datei eindeutig identifiziert.

Der Parameter fileFilter ist optional und kann verwendet werden, um den in der Aktivitätskonfiguration verwendeten Dateifilter zu überschreiben. Es kann ein Dateiname verwendet werden. Alternativ kann eine globale Variable verwendet werden, um den Dateifilter in der Aktivitätskonfiguration zu überschreiben. Globale Variablen werden wie folgt referenziert: [de_name] in der Aktivitätskonfiguration.

Wenn die ReadFile Funktion fehlschlägt, schlägt der Operation nicht fehl. Ein Script wird abgebrochen, dem Operation wird eine Warnung hinzugefügt und der Operation wird fortgesetzt.

Mit dieser Methode können Daten aus einer HTTP-Quelle gelesen werden. In diesem Fall werden alle Jitterbit $jitterbit.source.http.* Variablen werden ausgefüllt.

Beispiele

// Reads the first file retrieved from a source
var fileContents = Jitterbit.ReadFile("<TAG>activity:ftp/FTP Endpoint/ftp_read/FTP Files</TAG>");

// Use the filename "test.txt" instead of what is defined in the source
var fileContents = Jitterbit.ReadFile("<TAG>activity:ftp/FTP Endpoint/ftp_read/FTP Files</TAG>", "test.txt");

Jitterbit.SetVar

Erklärung

Jitterbit.SetVar(string jitterbitVariableName, string value)

Syntax

Jitterbit.SetVar(<jitterbitVariableName>, <value>)

Erforderliche Parameter

• jitterbitVariableName: Der Name einer Jitterbit-Variable
• value: Ein der Variable zuzuweisender Wert

Beschreibung

Legt den Wert einer Jitterbit-Variable fest (eine vordefinierte globale Variable, die in den Agenten integriert ist und mit jitterbit.). Die verfügbaren Variablen finden Sie in Integration Studio und sind unter Jitterbit-Variablen dokumentiert.

Beispiele

// Sets a Jitterbit variable
Jitterbit.SetVar("$jitterbit.scripting.db.max_rows", 1000);

Jitterbit.WriteFile

Erklärung

void Jitterbit.WriteFile(string targetId, type fileContents[, string filename])

Syntax

Jitterbit.WriteFile(<targetId>, <fileContents>[, <filename>])

Erforderliche Parameter

• targetId: Ein String-Referenzpfad zu einer Aktivität, die mit einem Dateityp-Endpoint im aktuellen Projekt verknüpft ist

Optionale Parameter

• fileContents: In die Datei zu schreibende Daten
• filename: Dateiname zum Überschreiben der Aktivitätskonfiguration

Beschreibung

Schreibt der fileContents zum Ziel, das durch targetId. Wenn fileContents vom Typ „binär“ ist, werden die Binärdaten in die Datei geschrieben. In allen anderen Fällen wird eine Zeichenfolgendarstellung der Daten geschrieben. Die Datei wird von der Funktion automatisch geleert und geschlossen.

Das in diesem Funktionsaufruf verwendete Ziel muss als Aktivität definiert sein, die mit einem Dateityp-Endpoint im aktuellen Projekt verknüpft ist. Dazu gehören konfigurierte Aktivitäten für Dateifreigabe, FTP, HTTP, lokalen Speicher und temporären Speicher. Weitere Informationen finden Sie in den Anweisungen zum Einfügen von Endpoints unter Endpoints in JavaScript.

Der dritte Parameter, filename ist optional und kann verwendet werden, um den in der Aktivitätskonfiguration verwendeten Dateinamen zu überschreiben. Alternativ kann eine globale Variable verwendet werden, um den Dateinamen in der Aktivitätskonfiguration zu überschreiben. Globale Variablen werden wie folgt referenziert: [de_name] in der Aktivitätskonfiguration.

Diese Methode kann auch verwendet werden, um Daten an ein HTTP-Ziel zu schreiben/zu posten. In diesem Fall $jitterbit.target.http.* Variablen werden ausgefüllt.

Wenn die WriteFile() Funktion fehlschlägt, schlägt der Operation nicht fehl. Ein Script wird abgebrochen, dem Operation wird eine Warnung hinzugefügt und der Operation wird fortgesetzt.

Beispiele

//  Writes the value of $contents to the file defined by a target
Jitterbit.WriteFile("<TAG>activity:ftp/FTP Endpoint/ftp_write/FTP Files</TAG>", $contents);

// Use the filename "test.txt" instead of what is defined in the target
Jitterbit.WriteFile("<TAG>activity:ftp/FTP Endpoint/ftp_write/FTP Files</TAG>", $contents, "test.txt");

SetScriptOutput

Erklärung

void SetScriptOutput(string data)

Syntax

SetScriptOutput(<data>)

Erforderliche Parameter

• data: Vom Script zurückzugebende Daten

Beschreibung

Legt den von einem Script zurückgegebenen Wert fest.

Der Rückgabewert eines Script kann abgerufen werden als Rückgabewert des RunScript Funktion.

Beispiele

// In the calling Jitterbit Script script:
$result = RunScript("<TAG>script:CalculateSomething</TAG>", value_to_be_calculated);

// In the Jitterbit JavaScript script "CalculateSomething":
var calculated_value = ...;
...
SetScriptOutput(calculated_value);

SetScriptResult

Erklärung

void SetScriptResult(string data)

Syntax

SetScriptResult(<data>)

Erforderliche Parameter

• data: Vom Script zurückzugebende Daten

Beschreibung

Ein Alias für die SetScriptOutput Funktion. Siehe SetScriptOutput für Details.

WriteToOperationLog

Erklärung

string WriteToOperationLog(string message)

Syntax

WriteToOperationLog(<message>)

Erforderliche Parameter

• message: Eine String-Nachricht

Beschreibung

Schreibt eine Meldung in das Operation.

Beispiele

// Writes a message to the operation log
WriteToOperationLog("The source field 'Price' has an invalid value.");

Allgemeine JavaScript-Funktionen

Diese allgemeinen JavaScript-Funktionen - Teil von ECMA-262 v5.1 - werden in Jitterbit-JavaScripts unterstützt.