JavaScript Jitterbit und allgemeine Funktionen im Design Studio

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

Wichtig

Für eine verbesserte Leistung empfehlen wir, JavaScript nur zu verwenden, wenn eine Jitterbit-Skript Entsprechung nicht verfügbar ist.

Hinweis

Die maximale Anzahl an Schleifeniterationen, die in Harmony erlaubt sind, beträgt 50.000.
Die maximale Anzahl an Schleifeniterationen in der Jitterbit-Skript-Sprache gilt für jede einzelne Schleife. Um die erlaubte Anzahl an Iterationen pro Schleife in einem Jitterbit-Skript zu erhöhen, siehe Jitterbit.scripting.while.max_iterations in Scripting Jitterbit-Variablen.
Die maximale Anzahl an Schleifeniterationen in JavaScript gilt für das gesamte Skript (Summe aller Schleifen innerhalb eines Skripts). Um die maximale Anzahl an Schleifeniterationen in JavaScript zu erhöhen, siehe Java script loop in JavaScript.

Jitterbit-Funktionen

`Jitterbit.DbExecute`

Deklaration

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: Eine Zeichenfolge, die die Datenquelle im aktuellen Projekt angibt
sql: Der SQL-Befehl, der gegen die Datenbank ausgeführt werden soll
outputVariable: (Zweite Form) Ein Ausgabewert, der den in dem SQL-Befehl zurückgegebenen Feldern zugeordnet ist. Zusätzliche Argumente können nach Bedarf angegeben werden.

Beschreibung

Führt eine SQL-Anweisung auf einer Datenbank aus und gibt die Ergebnisse zurück. Siehe die Jitterbit-Skriptfunktion DBExecute für weitere Details.

[Zurück nach oben]

`Jitterbit.DbLookup`

Deklaration

string Jitterbit.DbLookup(string databaseId, string sql)

Syntax

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

Erforderliche Parameter

databaseId: Eine Zeichenfolge, die die Datenquelle im aktuellen Projekt angibt
sql: Der SQL-Befehl, der gegen die Datenbank ausgeführt werden soll

Beschreibung

Führt eine SQL-Anweisung auf einer Datenbank aus und gibt das erste Feld des ersten Ergebnisses zurück, das den angegebenen Kriterien entspricht. Siehe die Jitterbit-Skriptfunktion DBLookup für weitere Details.

[Zurück nach oben]

`Jitterbit.GetVar`

Deklaration

string Jitterbit.GetVar(string jitterbitVariableName)

Syntax

Jitterbit.GetVar(<jitterbitVariableName>)

Erforderliche Parameter

jitterbitVariableName: Der Name einer Jitterbit-Variablen

Beschreibung

Gibt den Wert einer Jitterbit-Variablen zurück (eine vordefinierte globale Variable, die im Agenten integriert ist und mit jitterbit. beginnt). Die verfügbaren Variablen können im Design Studio eingesehen werden und sind unter Jitterbit-Variablen dokumentiert.

Warnung

Es ist auch möglich, aber nicht empfohlen, die Funktion Jitterbit.GetVar zu verwenden, um den Wert einer benutzerdefinierten globalen Variablen abzurufen.

Die Funktion Jitterbit.GetVar ist so konzipiert, dass sie die Verwendung von Variablen ermöglicht, die Punkte im Variablennamen enthalten. Die Verwendung von Punkten in einem benutzerdefinierten globalen Variablennamen wird jedoch nicht empfohlen. Da der Wert in einen String umgewandelt wird, wenn die Variable gesetzt wird, können diese Funktionen nicht mit komplexen Datentypen wie Arrays, Dictionaries oder JSON-Objekten verwendet werden. Stattdessen wird empfohlen, globale Variablen ohne Punkte zu erstellen und stattdessen Unterstriche anstelle von Punkten zu verwenden und die standardmäßige Dollarzeichen-$-Syntax zu verwenden, wie in Globalen Variablen beschrieben.

Beispiele

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

[Back to top]

`Jitterbit.ReadFile`

Deklaration

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

Syntax

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

Erforderliche Parameter

sourceId: Dateityp-Quelle im aktuellen Projekt

Optionale Parameter

fileFilter: Dateifilter oder Dateiname, um die Quellendefinition zu überschreiben

Beschreibung

Liest den Inhalt einer Datei aus einer Quelle.

Die in diesem Funktionsaufruf verwendete Dateityp-Quelle muss als Quelle im aktuellen Projekt definiert sein.

Siehe die Anweisungen zum Einfügen von Projektelementen.

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 Quelldefinition verwendeten Dateifilter zu überschreiben. Ein Dateiname kann verwendet werden. Alternativ kann eine globale Variable verwendet werden, um den Dateifilter in der Quelldefinition zu überschreiben. Globale Variablen werden in der Quelldefinition als [de_name] referenziert.

Seit der Harmony-Version 8.20 schlägt die Operation nicht fehl, wenn die Funktion ReadFile fehlschlägt. Ein Skript wird abgebrochen, eine Warnung wird zum Betriebsprotokoll hinzugefügt, und die Operation wird fortgesetzt.

Diese Methode kann verwendet werden, um Daten aus einer HTTP-Quelle zu lesen. In diesem Fall werden alle Jitterbit $jitterbit.source.http.* Variablen befüllt.

Beispiele

// Reads the first file retrieved from a source
var fileContents = Jitterbit.ReadFile("<TAG>Sources/Customer CSV FTP</TAG>");

// Use the filename "test.txt" instead of what is defined in the source
var fileContents = Jitterbit.ReadFile("<TAG>Sources/Customer CSV FTP</TAG>", "test.txt");

[Back to top]

`Jitterbit.SetVar`

Deklaration

Jitterbit.SetVar(string jitterbitVariableName, string value)

Syntax

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

Erforderliche Parameter

jitterbitVariableName: Der Name einer Jitterbit-Variable
value: Ein Wert, der der Variable zugewiesen werden soll

Beschreibung

Setzt den Wert einer Jitterbit-Variable (eine vordefinierte globale Variable, die im Agenten integriert ist und mit jitterbit. beginnt). Die verfügbaren Variablen können im Design Studio eingesehen werden und sind unter Jitterbit-Variablen dokumentiert.

Warnung

Es ist auch möglich, aber nicht empfohlen, die Funktion Jitterbit.SetVar zu verwenden, um den Wert einer benutzerdefinierten globalen Variable festzulegen.

Die Funktion Jitterbit.SetVar ist so konzipiert, dass sie die Verwendung von Variablen ermöglicht, die Punkte im Variablennamen enthalten. Es wird jedoch nicht empfohlen, Punkte in einem benutzerdefinierten globalen Variablennamen zu verwenden. Da der Wert in einen String umgewandelt wird, wenn die Variable gesetzt wird, können diese Funktionen nicht mit komplexen Datentypen wie Arrays, Wörterbüchern oder JSON-Objekten verwendet werden. Stattdessen wird empfohlen, globale Variablen ohne Punkte zu erstellen und stattdessen Unterstriche anstelle von Punkten zu verwenden und die standardmäßige Dollarzeichen-$-Syntax zu verwenden, wie in Globalen Variablen beschrieben.

Beispiele

// Setzt eine Jitterbit-Variable
Jitterbit.SetVar("$jitterbit.scripting.db.max_rows", 1000);

[Zurück nach oben]

`Jitterbit.WriteFile`

Deklaration

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

Syntax

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

Erforderliche Parameter

targetId: Dateityp-Ziel im aktuellen Projekt

Optionale Parameter

fileContents: Daten, die in die Datei geschrieben werden sollen
filename: Dateiname, um die Zieldefinition zu überschreiben

Beschreibung

Schreibt die fileContents in das durch targetId angegebene Dateityp-Ziel. Wenn fileContents vom Typ binär ist, werden die binären Daten in die Datei geschrieben. In allen anderen Fällen wird eine Zeichenfolgenrepräsentation der Daten geschrieben. Die Datei wird automatisch von der Funktion geleert und geschlossen.

Das in diesem Funktionsaufruf verwendete Dateityp-Ziel muss als Ziel im aktuellen Projekt definiert sein.

Die verfügbaren Variablen sind im Jitterbit Studio sichtbar und werden unter Jitterbit-Variablen. dokumentiert.

Der dritte Parameter, filename, ist optional und kann verwendet werden, um den im Ziel verwendeten Dateinamen zu überschreiben. Alternativ kann eine globale Variable verwendet werden, um den Dateinamen in der Zieldefinition zu überschreiben. Globale Variablen werden in der Zieldefinition als [de_name] referenziert.

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

Seit der Harmony-Version 8.20 schlägt die Operation nicht fehl, wenn die Funktion WriteFile fehlschlägt. Ein Skript wird abgebrochen, eine Warnung wird zum Betriebsprotokoll hinzugefügt, und die Operation wird fortgesetzt.

Beispiele

//  Writes the value of $contents to the file defined by a target
Jitterbit.WriteFile("<TAG>Targets/FTP Target</TAG>", $contents);

// Use the filename "test.txt" instead of what is defined in the target
Jitterbit.WriteFile("<TAG>Targets/FTP Target</TAG>", $contents, "test.txt");

[Zurück nach oben]

`SetScriptOutput`

Deklaration

void SetScriptOutput(string data)

Syntax

SetScriptOutput(<data>)

Erforderliche Parameter

data: Daten, die vom Skript zurückgegeben werden sollen

Beschreibung

Setzt den Wert, der von einem Skript zurückgegeben wird.

Der Rückgabewert eines Skripts kann als Rückgabewert der Funktion RunScript zugegriffen werden.

Beispiele

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

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

[Zurück nach oben]

`SetScriptResult`

Deklaration

void SetScriptResult(string data)

Syntax

SetScriptResult(<data>)

Erforderliche Parameter

data: Daten, die vom Skript zurückgegeben werden sollen

Beschreibung

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

[Zurück nach oben]

`WriteToOperationLog`

Deklaration

string WriteToOperationLog(string message)

Syntax

WriteToOperationLog(<message>)

Erforderliche Parameter

message: Eine Zeichenfolgen-Nachricht

Beschreibung

Schreibt eine Nachricht in das Betriebsprotokoll.

Beispiele

// Schreibt eine Nachricht in das Betriebsprotokoll
WriteToOperationLog("Das Quellfeld 'Preis' hat einen ungültigen Wert.");

[Back to top]

JavaScript allgemeine Funktionen

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

Allgemeine Eigenschaft	Beschreibung
`Array`	Siehe die JavaScript-Array-Eigenschaften und -Funktionen
`Date`	Siehe die JavaScript-Datumseigenschaften und -funktionen
`decodeURI()`	Dekodiert eine URI
`decodeURIComponent()`	Dekodiert einen URI-Komponenten
`encodeURI()`	Kodiert eine URI
`encodeURIComponent()`	Kodiert einen URI-Komponenten
`eval()`	Bewertet einen String und führt ihn aus, als ob er JavaScript-Code wäre
`isFinite()`	Überprüft, ob ein Wert eine endliche und legale Zahl ist
`isNaN()`	Überprüft, ob ein Wert eine illegale Zahl ist
`JSON.parse()`	Analysiert einen JSON-String und gibt ein JavaScript-Objekt zurück
`JSON.stringify()`	Wandelt ein JavaScript-Objekt in einen JSON-String um
`Math`	Siehe die JavaScript-Mathematikseigenschaften und -funktionen
`Number()`	Wandelt den Wert eines Objekts in eine Zahl um
`parseFloat()`	Analysiert einen String und gibt eine Fließkommazahl zurück
`parseInt()`	Analysiert einen String und gibt eine ganze Zahl zurück
`String`	Siehe die JavaScript-String-Eigenschaften und -funktionen

[Zurück nach oben]