Zum Inhalt springen

Skripting von Jitterbit-Variablen in Studio

Einführung

Diese Seite behandelt Jitterbit-Variablen, die für das Skripting verfügbar sind. Jede dieser Variablen ist eine Einstellungsvariable, die Sie schreiben (Einstellungen).

Einstellungen

jitterbit.script.string.utf8size

Datentyp

Boolean

Standardwert

true

Beschreibung

Steuert, ob die StringLength Funktion UTF-8-Zeichen oder Bytes zählt.

  • true: (Standard.) Zählt UTF-8-Zeichen. Dies ist das korrekte Verhalten für mehrbyteige Zeichen.
  • false: Zählt Bytes. Dies ist das veraltete Verhalten, das mit mehrbyteigen UTF-8-Zeichen unerwartete Ergebnisse liefern kann.

Diese Variable wird mit Agenten der Version 12.7 und höher unterstützt.

jitterbit.scripting.aes.default

Datentyp

Boolean

Standardwert

false

Beschreibung

Auf true setzen, um die AESEncryption und AESDecryption Funktionen zu unterstützen, die mit OpenSSL 3 AES kompatibel sind. Diese Variable wird unterstützt, wenn Agenten der Version 11.42 oder höher verwendet werden.

Hinweis

Alternativ sind die Funktionen AESEncryptionEx und AESDecryptionEx standardmäßig OpenSSL 3 AES-kompatibel und werden von dieser Variable nicht beeinflusst.

jitterbit.scripting.db.auto_commit

Datentyp

Boolean

Standardwert

true

Beschreibung

Auf false setzen, um DbExecute- und DbLookup-Anweisungen in einer Transaktion auszuführen. Auto-Commit ist standardmäßig aktiviert.

jitterbit.scripting.db.character_encoding

Datentyp

String

Beschreibung

Gibt die Zeichencodierung an, die von den Datenbankfunktionen CallStoredProcedure und DBLookup verwendet wird, wenn über ODBC verbunden.

Wenn keine Codierung angegeben ist, wird Latin-1 (ISO-8859-1) angenommen. Für unterstützte Codierungen siehe Unterstützte Zeichencodierungen.

jitterbit.scripting.db.max_rows

Datentyp

Integer

Standardwert

10000

Beschreibung

Maximale Anzahl von Zeilen, die mit der Funktion DBExecute abgerufen werden sollen.

jitterbit.scripting.db.multibyte.enable

Datentyp

Boolean

Beschreibung

Auf true setzen, um mehrbyteige Zeichen zu unterstützen, wenn der Datenbank-Connector mit einem ODBC-Treiber verwendet wird. Diese Variable ist bei JDBC-Treibern nicht erforderlich. Diese Variable wird mit Agenten der Version 12.6 und höher unterstützt.

jitterbit.scripting.db.rows_affected

Datentyp

Integer

Beschreibung

Die Anzahl der von den Funktionen DBExecute oder DBLookup betroffenen Zeilen.

jitterbit.scripting.db.search.rowset

Datentyp

Boolean

Standardwert

false

Beschreibung

Wenn ein JDBC-Treiber verwendet wird, um eine Verbindung zu einer Datenbank herzustellen, setzen Sie diesen Wert auf true, um vor der DBExecute Funktion sicherzustellen, dass alle Aufrufe einer gespeicherten Prozedur, die mehrere Ergebnisse zurückgibt, das erste nicht leere Datensatzset zurückgeben, anstatt ein leeres Set zurückzugeben.

jitterbit.scripting.db.transaction

Datentyp

Boolean

Standardwert

false

Beschreibung

Setzen Sie diesen Wert auf true, wenn die Funktionen DBExecute und DBLookup in einer Transaktion ausgeführt werden sollen.

jitterbit.scripting.hex.enable_null_support

Datentyp

Boolean

Standardwert

false

Beschreibung

Setzen Sie diesen Wert auf true, um vor den Funktionen HexToString oder StringToHex die Unterstützung für die Konvertierung von null hex-Werten (00) zu aktivieren. Diese Variable wird unterstützt, wenn Agent-Versionen 11.37 oder höher verwendet werden.

jitterbit.scripting.hex.enable_unicode_support

Datentyp

Boolean

Standardwert

false

Beschreibung

Setzen Sie diesen Wert auf true, um vor den Funktionen HexToString oder StringToHex zwischen Zeichenfolgenwerten und deren UTF-16 hexadezimalen Darstellungen zu konvertieren. Diese Variable wird unterstützt, wenn Agent-Versionen 10.71 / 11.9 oder höher verwendet werden.

jitterbit.scripting.ldap.include_dn_in_results

Datentyp

Boolean

Beschreibung

Wenn gesetzt, enthalten die im XML-Format ausgegebenen LdapSearch-Ergebnisse das DN-Attribut für jeden Eintrag.

Hinweis

Diese Variable wird unabhängig vom LDAP-Connector gesetzt und verwendet.

jitterbit.scripting.ldap.max_search_results

Datentyp

Integer

Beschreibung

Die maximale Anzahl von Einträgen, die LdapSearch zurückgeben sollte.

Hinweis

Diese Variable wird unabhängig vom LDAP-Connector gesetzt und verwendet.

jitterbit.scripting.ldap.return_null_if_no_results

Datentyp

Boolean

Standardwert

false

Beschreibung

Wenn eine LDAP-Abfrage keine Ergebnisse zurückgibt, wird ein NULL-Datenelement zurückgegeben. Der Standardwert ist, ein leeres Array-Datenelement zurückzugeben. Dies dient nur der Rückwärtskompatibilität.

Hinweis

Diese Variable wird unabhängig vom LDAP-Connector gesetzt und verwendet.

jitterbit.scripting.ldap.scope

Datentyp

Integer

Beschreibung

Der Geltungsbereich, den LdapSearch verwenden sollte. Diese Optionen sind gültig:

  • 0 – Nur den Basiseintrag durchsuchen.
  • 1 – Alle Einträge auf der ersten Ebene unterhalb des Basiseintrags durchsuchen, ohne den Basiseintrag einzuschließen.
  • 2 – Den Basiseintrag und alle Einträge im Baum unterhalb des Basiseintrags durchsuchen.

Hinweis

Diese Variable wird unabhängig vom LDAP-Connector gesetzt und verwendet.

Datentyp

Integer

Beschreibung

Verwenden Sie die paginierte Suche, wenn Sie LDAP-Verzeichnisse durchsuchen. Diese Option ist nützlich, um große Ergebnismengen abzurufen.

Diese Variable wird nur auf Windows-basierten privaten Agenten unterstützt und wird nicht auf Linux-basierten privaten Agenten oder den Cloud-Agentengruppen unterstützt. Um diese Einschränkung zu umgehen, schlagen wir eine der folgenden Alternativen vor:

  • Verwenden Sie einen LDAP-Benutzer, der nicht durch das vom LDAP-Server auferlegte Suchgrößenlimit eingeschränkt ist, z. B. einen Administrationsbenutzer.
  • Passen Sie die Einstellung für das Suchgrößenlimit auf dem LDAP-Server selbst an.
  • Verwenden Sie anstelle dieser Variable den LDAP-Connector, dessen Sucheintragsaktivität Paging sowohl auf Windows- als auch auf Linux-Agenten unterstützt.

Hinweis

Diese Variable wird unabhängig vom LDAP-Connector gesetzt und verwendet.

jitterbit.scripting.nesting.max

Datentyp

Ganzzahl

Standardwert

10

Beschreibung

Maximale Verschachtelungstiefe für RunScript/RunOperation-Aufrufe. Wenn die Verschachtelungstiefe überschritten wird, schlägt die Operation fehl. Wenn Ihre Anwendung eine tiefere Verschachtelung benötigt, erhöhen Sie diese Zahl.

jitterbit.scripting.while.max_iterations

Datentyp

Ganzzahl

Standardwert

50000

Beschreibung

Die maximale Anzahl von Ausführungen des Körpers einer While-Schleife. Wenn Sie diese Zahl auf weniger als 1 setzen, wird auf den Standardwert von 50.000 Iterationen zurückgesetzt.

Hinweis

Diese Einstellung gilt nur für Jitterbit Script. Für JavaScript siehe Schleifeniterationen unter JavaScript.