JavaScript Jitterbit und allgemeine Funktionen in Design 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.
Wichtig
Für eine verbesserte Leistung empfehlen wir, JavaScript nur zu verwenden, wenn ein Jitterbit Script Äquivalent ist nicht verfügbar.
Notiz
- Die maximal zulässige Anzahl von Schleifeniterationen in Harmony beträgt 50.000.
- Die maximale Anzahl von Schleifeniterationen in der Jitterbit Script Skriptsprache ist pro einzelne Schleife. Informationen zum Erhöhen der zulässigen Anzahl von Iterationen pro Schleife in einem Jitterbit Script Script finden Sie unter Jitterbit.scripting.while.max_iterations in Skripting von Jitterbit-Variablen.
- Die maximale Anzahl von Schleifeniterationen in JavaScript beträgt pro Script (Aggregat aller Schleifen innerhalb eines Script). Informationen zum Erhöhen der maximalen Anzahl von Schleifeniterationen in JavaScript finden Sie unter Javascript - Schleife in JavaScript.
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: Eine Zeichenfolge Datenbankquelle im aktuellen Projektsql: Der SQL-Befehl, der für die Datenbank ausgeführt werden solloutputVariable: (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 Details.
Jitterbit.DbLookup
Erklärung
string Jitterbit.DbLookup(string databaseId, string sql)
Syntax
Jitterbit.DbLookup(<databaseId>, <sql>)
Erforderliche Parameter
databaseId: Eine Zeichenfolge Datenbankquelle im aktuellen Projektsql: 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 Details.
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 sind im Design Studio zu sehen und unter Jitterbit-Variablen dokumentiert.
Warnung
Es ist auch möglich, aber nicht empfohlen, die Jitterbit.GetVar Funktion zum Abrufen des Werts einer benutzerdefinierten globalen Variable.
Die Jitterbit.GetVar Die Funktion 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 beim Festlegen der Variablen in eine Zeichenfolge konvertiert 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 und das Standard-Dollarzeichen zu verwenden $ Syntax wie in Globale Variablen beschrieben.
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: Dateitypquelle im aktuellen Projekt
Optionale Parameter
fileFilter: Dateifilter oder Dateiname zum Überschreiben der Quelldefinition
Beschreibung
Liest den Inhalt einer Datei aus einer Quelle.
Die in diesem Funktionsaufruf verwendete Dateitypquelle muss im aktuellen Projekt als Quelle 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 wie folgt referenziert: [de_name] in der Quelldefinition.
Ab Harmony Version 8.20, 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>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");
Jitterbit.SetVar
Erklärung
Jitterbit.SetVar(string jitterbitVariableName, string value)
Syntax
Jitterbit.SetVar(<jitterbitVariableName>, <value>)
Erforderliche Parameter
jitterbitVariableName: Der Name einer Jitterbit-Variablevalue: 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 sind im Design Studio zu sehen und unter Jitterbit-Variablen dokumentiert.
Warnung
Es ist auch möglich, aber nicht empfehlenswert, die Jitterbit.SetVar Funktion zum Festlegen des Werts einer benutzerdefinierten globalen Variable.
Die Jitterbit.SetVar Die Funktion 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 beim Festlegen der Variablen in eine Zeichenfolge konvertiert 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 und das Standard-Dollarzeichen zu verwenden $ Syntax wie in Globale Variablen beschrieben.
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: Dateitypziel im aktuellen Projekt
Optionale Parameter
fileContents: In die Datei zu schreibende Datenfilename: Dateiname zum Überschreiben der Zieldefinition
Beschreibung
Schreibt der fileContents zum Dateitypziel, das angegeben ist durch targetId. Wenn fileContents vom Typ binär ist, werden die Binärdaten in die Datei geschrieben. In allen anderen Fällen wird eine String-Darstellung der Daten geschrieben. Die Datei wird von der Funktion automatisch geleert und geschlossen.
Das in diesem Funktionsaufruf verwendete Dateitypziel muss im aktuellen Projekt als Ziel definiert sein.
Die verfügbaren Variablen sind im Jitterbit Studio einsehbar und 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 wie folgt referenziert: [de_name] in der Zieldefinition.
Diese Methode kann auch verwendet werden, um Daten an ein HTTP-Ziel zu schreiben/zu posten. In diesem Fall $jitterbit.target.http.* Variablen werden aufgefüllt.
Ab Harmony Version 8.20, 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>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");
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>Scripts/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 Nachricht in das Operationsprotokoll.
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.
| Gemeinsame Eigenschaft | Beschreibung |
|---|---|
Array | Siehe die JavaScript-Array-Eigenschaften und-Funktionen |
Date | Siehe die JavaScript-Datumseigenschaften und-Funktionen |
decodeURI() | Dekodiert eine URI |
decodeURIComponent() | Dekodiert eine URI-Komponente |
encodeURI() | Kodiert eine URI |
encodeURIComponent() | Kodiert eine URI-Komponente |
eval() | Wertet einen String aus und führt ihn aus, als wäre er JavaScript-Code |
isFinite() | Prüft, ob ein Wert eine endliche und gültige Zahl ist |
isNaN() | Prüft, ob ein Wert eine ungültige Zahl ist |
JSON.parse() | Analysiert eine JSON-Zeichenfolge und gibt ein JavaScript-Objekt zurück |
JSON.stringify() | Wandelt ein JavaScript-Objekt in einen JSON-String um |
Math | Siehe die mathematischen Eigenschaften und Funktionen von JavaScript |
Number() | Wandelt den Wert eines Objekts in eine Zahl um |
parseFloat() | Analysiert einen String und gibt eine Gleitkommazahl zurück |
parseInt() | Analysiert einen String und gibt eine Ganzzahl zurück |
String | Siehe die JavaScript-String-Eigenschaften und-Funktionen |