Zum Inhalt springen

Ziel-Jitterbit-Variablen im Design Studio

Einführung

Diese Seite behandelt Jitterbit-Variablen, die für Aktivitäten als Ziele verfügbar sind, organisiert nach Informationsvariablen, die Sie lesen (Informational), und Einstellungsvariablen, die Sie schreiben (Settings).

Informationsvariablen

jitterbit.target.file_count

Datentyp

Ganzzahl

Beschreibung

Nachdem alle Eingabedateien transformiert wurden, wird diese Variable auf die Anzahl der Ziel-Dateien gesetzt, die übertragen werden.

jitterbit.target.ftp.return_code

Datentyp

Ganzzahl

Beschreibung

Der Antwortstatuscode, der von einem FTP-Ziel zurückgegeben wird, wenn es in einer Operation oder der WriteFile()-Skriptfunktion verwendet wird. Wenn kein Statuscode zurückgegeben wird, ist der gemeldete Wert -1.

jitterbit.target.http.status_code

Datentyp

Ganzzahl

Beschreibung

Der Antwortstatuscode, der von einem HTTP-Ziel zurückgegeben wird, wenn es in einer Operation oder der WriteFile()-Skriptfunktion verwendet wird. Wenn kein Statuscode zurückgegeben wird, ist der gemeldete Wert -1.

Einstellungen

jitterbit.target.chunk_node_name

Datentyp

String

Beschreibung

Wenn Chunking (Aufteilen einer Datei) aktiviert ist, ist ein Knoten der wiederholende Datensatz (oder Schleifenknoten), an dem es möglich ist, die Datei zu teilen.

Zum Beispiel könnten in einer XML-Datei die benannten Ebenen (wiederholende Datensätze) Wurzel, Organisation, Abteilung und Mitarbeiter sein. Sie könnten wählen, die Datei nach Abteilung oder nach Mitarbeiter zu chunkieren (aufzuteilen).

Es ist auch möglich, den Knoten in Betriebsoptionen festzulegen.

jitterbit.target.chunk_size

Datentyp

Integer

Beschreibung

Zwei mögliche Fälle, in denen jitterbit.target.chunk_size = 2000:

  • Fall 1: Das Chunking der Quelle ist deaktiviert, es wird ein Ziel-Chunking mit der Größe = 2000 durchgeführt.
  • Fall 2: Das Chunking der Quelle ist aktiviert, es wird zuerst das Ziel kombiniert und dann das kombinierte Ziel auf die Größe = 2000 gechunked.

jitterbit.target.chunking_uncombined

Datentyp

Boolean

Beschreibung

Wenn auf true gesetzt und das Chunking der Quelle aktiviert ist, werden die Ziel-Chunk-Dateien nicht kombiniert. Dies ermöglicht eine Ziel-Datei pro Datensatz.

jitterbit.target.db.character_encoding

Datentyp

String

Beschreibung

Geben Sie die Zeichencodierung für ODBC-Zieldatenbank-Zeichen-/Textspalten an. Wenn keine Codierung angegeben ist, wird Latin-1 (ISO-8859-1) angenommen. Für unterstützte Codierungen siehe Unterstützte Zeichencodierungen.

jitterbit.target.db.commit_chunks

Datentyp

Boolean

Beschreibung

Wenn auf true gesetzt und Chunking für eine Operation mit einer Datenbankquelle aktiviert ist, wird jeder Chunk in die Datenbank übernommen, sobald er erstellt wird. Diese Einstellung kann die Transformation schneller machen, da Chunks parallel übernommen werden können.

jitterbit.target.db.include_null_in_sql_statement

Datentyp

Boolean

Standardwert

false

Beschreibung

Wenn auf true gesetzt, enthalten INCLUDE- und UPDATE-Anweisungen, die von Jitterbit für Datenbankziele generiert werden, explizite Nullwerte für Spalten, die nullfähig sind und eine Zuordnung mit einem Null-Ergebnis haben.

jitterbit.target.db.no_data_action

Datentyp

String

Beschreibung

Option, was zu tun ist, wenn ein leeres Datenbankziel erstellt wird. Diese Werte sind gültig:

  • OK
  • Warnung
  • Fehler

Der Standardwert (für den Fall, dass diese Variable nicht gesetzt ist) kann in jitterbit.conf mit der Option im Abschnitt [ErrorHandling] namens NoTargetDataGenerated geändert werden. Wenn dort ebenfalls nichts angegeben ist, ist der Standard, eine Warnung auszugeben.

jitterbit.target.db.pre_target_sql

Datentyp

String

Standardwert

""

Beschreibung

Führen Sie diese SQL-Anweisung aus, bevor Sie mit dem Befüllen der Ziel-Datenbanktabelle(n) beginnen. Der Standardwert ist ein leerer String.

jitterbit.target.db.schema_name_delimiter

Datentyp

String

Standardwert

.

Beschreibung

Der Standardwert ist ein einzelner Punkt (.). Zeichen, das von der Ziel-Datenbank verwendet wird, um den Schemanamen vom Tabellennamen zu trennen, z. B. Schema.Tab. Fast alle Datenbanken verwenden einen Punkt als Trennzeichen.

jitterbit.target.db.transaction

Datentyp

Boolean

Standardwert

true

Beschreibung

Setzen Sie auf false, wenn Sie keine Datenbankänderungen in einer Transaktion vornehmen möchten. Der Standardwert ist, alle Datenbankänderungen in einer Transaktion zu committen.

jitterbit.target.db.use_new_postgress_sequence

Datentyp

Boolean

Beschreibung

Setzen Sie auf true vor einer Datenbankaktivität, um Sequenzen zu unterstützen, wenn Sie über JDBC mit einer PostgreSQL-Datenbank interagieren. Diese Variable wird unterstützt, wenn Agent-Versionen 11.28 oder höher verwendet werden.

jitterbit.target.file_share.create_directories

Datentyp

Boolean

Standardwert

false

Beschreibung

Setzen Sie es auf true, wenn die Zielverzeichnisse für die Dateifreigabe überprüft und erstellt werden sollen. Wenn das Verzeichnis bekanntlich existiert, verwenden Sie diese Option nicht.

jitterbit.target.ftp.encode_url

Datentyp

Boolean

Standardwert

false

Beschreibung

Setzen Sie es in einem Transformationsskript auf true, um URL-Codierung zu verwenden, wenn ein Ziel-Datei- oder Ordnername Sonderzeichen wie #, % oder @ enthält. Zum Beispiel sftp://reposit.mysite.com/storage/file#1.xml.

Siehe jitterbit.source.ftp.encode_url für die Quellversion dieser Variablen.

jitterbit.target.ftp.transfer_timeout

Datentyp

Integer

Beschreibung

Legen Sie das Übertragungszeitlimit in Sekunden für FTP-Zielübertragungen fest. Das Standardübertragungszeitlimit für FTP beträgt eine Stunde (3.600 Sekunden). Setzen Sie es auf null, um es zu deaktivieren.

jitterbit.target.http.form_data

Datentyp

Boolean

Beschreibung

Wenn auf true gesetzt, wird jede Ziel-Datei unter Verwendung des RFC 1687 Formular-Uploads hochgeladen.

jitterbit.target.http.form_data.ContentType

Datentyp

String

Beschreibung

Wenn der RFC 1687 Formular-Upload verwendet wird, wird hier der Content-Type der Datei festgelegt.

jitterbit.target.http.form_data.filename

Datentyp

String

Beschreibung

Wenn der RFC 1687 Formular-Upload verwendet wird, wird hier der Name der hochgeladenen Datei festgelegt.

jitterbit.target.http.form_data.name

Datentyp

String

Beschreibung

Wenn der RFC 1687 Formular-Upload verwendet wird, wird hier der Name des Formulars festgelegt.

jitterbit.target.http.max_redirs

Datentyp

Ganzzahl

Standardwert

0

Beschreibung

Maximale Anzahl von Weiterleitungen, die beim Verwenden eines HTTP-Ziels befolgt werden sollen. Setzen Sie diese Variable auf eine negative Zahl, um beliebig viele Weiterleitungen zu folgen. Der Standardwert ist 0 (null); es werden keine Weiterleitungen befolgt.

jitterbit.target.http.remove_trailing_linebreaks

Datentyp

Boolean

Beschreibung

Wenn auf true gesetzt, werden nachfolgende Zeilenumbrüche entfernt, bevor die Zieldaten gesendet werden.

jitterbit.target.http.response.header.<HeaderName>

(wird im Skripteditor als jitterbit.target.http.response.header.* angezeigt)

Datentyp

String

Beschreibung

Wird beim Verarbeiten eines gehosteten Webdienst-Posts oder eines HTTP-Endpunkts gesetzt. HTTP-Antwortheader sind nicht sichtbar, nur die Nutzlast. Wenn durch den Namen eines HTTP-Headers für <HeaderName> ersetzt, enthält diese Variable den entsprechenden Wert.

Zum Beispiel würde die Variable Get("jitterbit.target.http.response.header.Proxy-Authenticate") den Wert des Proxy-Authenticate-Antwortheaders enthalten.

Hinweis

Wenn der Headername einen Bindestrich enthält, müssen Sie die Variable entweder mit den Funktionen Set oder Get referenzieren.

jitterbit.target.http.ssl_cert_id

Datentyp

String

Beschreibung

Eine Kennung für einen Konfigurationseintrag in jitterbit.conf für das SSL-Zertifikat, das für HTTP-Ziele verwendet werden soll. Siehe auch Anpassungen > Client-Zertifikate und Zertifikate zum Keystore für private Agenten hinzufügen.

jitterbit.target.http.transfer_timeout

Datentyp

Ganzzahl

Beschreibung

Setzen Sie den Übertragungszeitüberschreitung in Sekunden für HTTP-Zielübertragungen. Der Standardwert für die Übertragungszeitüberschreitung für HTTP beträgt eine Stunde (3.600 Sekunden). Setzen Sie ihn auf null, um ihn zu deaktivieren.

jitterbit.target.json.array_to_object

Datentyp

Boolean

Beschreibung

Wenn auf true gesetzt, wird bei einer Transformation mit einer JSON-Ziel-Datenstruktur in einem Vorgang mit aktivierter Chunking die Zieldatei im JSON-Format anstelle von XML vorliegen.

jitterbit.target.sftp.ssh_key_id und jitterbit.source.sftp.ssh_key_id

Datentyp

String

Standardwert

""

Beschreibung

Zur Konfiguration mehrerer SSH-Schlüssel. Standardmäßig sind diese beide leer, was bedeutet, dass die Konfiguration im Abschnitt [SSH] der jitterbit.conf-Konfiguration für alle SFTP-Quellen und -Ziele ohne definiertes Passwort verwendet wird:

[SSH]
PublicKeyFile='Z:/ssh/rsa2048.pub'
PrivateKeyFile='Z:/ssh/rsa2048'
PrivateKeyPassphrase=secret

Hinweis

Beim Bearbeiten der Konfigurationsdatei beachten, dass eine Zeile, die mit einem führenden # auskommentiert ist, nicht leer gelassen werden darf, da die nächste Zeile als Kommentar gelesen wird, auch wenn sie nicht mit # beginnt.

Wenn einer dieser Variablen auf einen String (wie "RSA") gesetzt ist, werden diese Konfigurationsoptionen für eine Quelle oder ein Ziel verwendet (je nachdem, welche Variable definiert ist):

PublicKeyFileRSA='Z:/ssh/id_rsa.pub'
PrivateKeyFileRSA='Z:/ssh/id_rsa'
PrivateKeyPassphraseRSA=verysecret

Dies ermöglicht die Auswahl unterschiedlicher Schlüsselsätze bei der Verwendung der öffentlichen/privaten SSH-Schlüssel-Authentifizierung für verschiedene SFTP-Quellen und -Ziele.

jitterbit.target.text.character_encoding

Datentyp

String

Beschreibung

Geben Sie die Zeichencodierung für Ziel-Textdokumente an. Wenn keine Codierung angegeben ist, wird Latin-1 (ISO-8859-1) angenommen. Für unterstützte Codierungen siehe Unterstützte Zeichencodierungen.

jitterbit.target.wave.json

Datentyp

String

Beschreibung

Wird verwendet, um die JSON-Daten in einer Salesforce Einstein (Wave) JSON-Metadatei zu überschreiben. Siehe Überschreiben von JSON-Metadaten in Salesforce Einstein Analytics.

jitterbit.target.xml.exclude_empty_data

Datentyp

Boolean

Standardwert

false

Beschreibung

Wenn eine Zuordnung zu einem Zielknoten zu einem leeren Wert führt, setzen Sie diese Variable auf true, um den Knoten im Ziel-XML auszuschließen. Der Standardwert (false) ist, den Knoten mit einem leeren Wert im Ziel-XML einzuschließen. Diese Variable wird empfohlen, wenn der Zielknoten einen booleschen Wert hat, anstelle von jitterbit.target.xml.include_empty_xml.

Damit ein true-Wert von jitterbit.target.xml.exclude_empty_data wirksam wird, muss jitterbit.target.xml.include_null_xml auf false gesetzt werden und jitterbit.target.xml.include_empty_xml muss ebenfalls false sein (seine Standardeinstellung).

jitterbit.target.xml.include_empty_xml

Datentyp

Boolean

Standardwert

false

Beschreibung

Wenn eine Zuordnung zu einem Zielknoten zu einem leeren Wert führt, setzen Sie diese Variable auf true, um den Knoten im Ziel-XML einzuschließen. Der Standardwert (false) ist, den Knoten mit einem leeren Wert aus dem Ziel-XML auszuschließen. Diese Variable hat keinen Einfluss auf Zielknoten, die einen booleschen Wert haben (siehe stattdessen jitterbit.target.xml.exclude_empty_data).

jitterbit.target.xml.include_nil_attribute

Datentyp

Boolean

Standardwert

false

Beschreibung

Setzen Sie diesen Wert auf true, um upstream einer Transformation mit JSON-Ausgabe null-Werte und leere Strings im Ziel-XML einzuschließen, die dem Eingang entsprechen. Diese Variable wird unterstützt, wenn Agent-Versionen 11.37 oder höher verwendet werden.

Hinweis

Wenn dieser Wert upstream der IfNull oder IsNull Funktionen auf true gesetzt ist, werden die Funktionen einen leeren String als einen nicht-null Wert bewerten, wenn Agent-Versionen 11.43 oder höher verwendet werden.

jitterbit.target.xml.include_null_xml

Datentyp

Boolean

Standardwert

true

Beschreibung

Wenn eine Zuordnung zu einem Zielknoten zu einem null-Wert oder einem leeren Wert führt, ist der Standardwert dieser Variable (true), den Knoten im Ziel-XML einzuschließen, ihn jedoch als nil zu kennzeichnen. Setzen Sie diese Variable auf false, um den Knoten mit einem null-Wert aus dem Ziel-XML zu entfernen.

jitterbit.target.xml.nsprefix

Datentyp

String

Standardwert

"NS"

Beschreibung

Der Standard-XML-Namensraum-Präfix ist "NS". Wenn Ihr XML einen anderen Namensraum-Präfix benötigt, kann diese Variable verwendet werden, um den Standard-Namensraum-Präfix mit Ihrem vorhandenen Namensraum-Präfix-Namen zu überschreiben.

Zum Beispiel könnte Ihre XML-Zielausgabe mit dem Standard-XML-Namensraum so aussehen:

<ns:Body xmlns:ns="http://www.marketo.com/mktows/">
<ns:successGetMultipleLeads>
<result>

Wenn Sie diese globale Variable auf einen anderen Präfix setzen, zum Beispiel $jitterbit.target.xml.nsprefix="tp", würde sich die Ausgabe in diesem Beispiel wie folgt ändern:

<tp:Body xmlns:tp="http://www.marketo.com/mktows/">
<tp:successGetMultipleLeads>
<result>

jitterbit.target.xml.num_for_bool

Datentyp

Boolean

Standardwert

true

Beschreibung

Wenn auf true gesetzt, werden XML-Boolean-Zielwerte mit "0" oder "1" für false bzw. true dargestellt. Dies ist der Standardwert, daher muss dieser Parameter auf false gesetzt werden, um die String-Werte "true"/"false" zu erhalten.

jitterbit.target.xml.preserve.namespace.prefix

Datentyp

Boolean

Standardwert

false

Beschreibung

Standardmäßig (false) wenden XML-Transformationen generische Namensraum-Präfixe (ns, ns1, ns2 usw.) auf die Zielausgabe an, unabhängig von den in der Quell-XML verwendeten Präfixen. Setzen Sie diese Variable auf true, um die im Quell-XML definierten Namensraum-Präfixe bei einer Transformation mit XML-Ausgabe beizubehalten. Dies ist nützlich, wenn ein Zielendpunkt die Beibehaltung der ursprünglichen Präfixe erfordert. Diese Variable wird unterstützt, wenn Agent-Versionen 12.8 oder höher verwendet werden.

Im Gegensatz zu jitterbit.target.xml.nsprefix, die nur das einzelne Standardpräfix mit einem von Ihnen angegebenen Wert überschreibt, behält diese Variable jedes Namensraum-Präfix aus der Quelle bei.

Ein Beispiel: Eine Quell-XML kann ein Präfix wie ns2 definieren:

<ns2:C1FACompletionFieldWork xmlns:ns2="http://oracle.com/C1FACompletionFieldWork.xsd">

Mit dem Standardwert (false) verwendet die Zielausgabe ein generisches Präfix:

<ns:C1FACompletionFieldWork xmlns:ns="http://oracle.com/C1FACompletionFieldWork.xsd">

Wenn Sie $jitterbit.target.xml.preserve.namespace.prefix=true setzen, bleibt das Quellpräfix in der Zielausgabe erhalten:

<ns2:C1FACompletionFieldWork xmlns:ns2="http://oracle.com/C1FACompletionFieldWork.xsd">

jitterbit.target.xml.prettify

Datentyp

Boolean

Standardwert

true

Beschreibung

Wenn auf true gesetzt, werden XML-Ziele mit Zeilenumbrüchen und Tabulator-Einrückungen geschrieben. Dies ist leichter zu lesen, aber die resultierende Datei wird größer sein.