Dateinamen-Schlüsselwörter in Jitterbit Integration Studio

Einführung

Dateinamen-Schlüsselwörter werden verwendet, um eindeutige Dateinamen für konfigurierbare Felder zu generieren, die Dateinamen als Eingabe verwenden. Dazu gehören bestimmte Felder, die beim Konfigurieren von Endpoints mit Konnektoren verfügbar sind. Dateinamen-Schlüsselwörter sind einer der Typen globaler Datenelemente, die in Harmony verfügbar sind. Die anderen Typen globaler Datenelemente - Projektvariablen, globale Variablen und Jitterbit-Variablen - sind auch global im gesamten Projekt verfügbar. Sie werden unterschiedlich festgelegt, wie in Projektvariablen beschrieben, Globale Variablen und Jitterbit-Variablen, bzw. Da alle globalen Datenelemente jedoch denselben Namespace verwenden, müssen ihre Namen im Vergleich zu allen anderen globalen Datenelementen eindeutig sein.

Verfügbare Schlüsselwörter

Die in der folgenden Tabelle aufgeführten Schlüsselwörter können in bestimmten Feldern in Endpoint verwendet werden. Bei den Schlüsselwörtern wird nicht zwischen Groß- und Kleinschreibung unterschieden. Beispiel: [time] ist gleichbedeutend mit [TIME] Und [Time].

Verwenden Sie Dateinamen-Schlüsselwörter in Konfigurationsbildschirmen

Während der Konfiguration von Endpoints mithilfe von Konnektoren, können Sie Dateinamen-Schlüsselwort-Ersetzungen in bestimmten Feldern verwenden, die ein Variablensymbol haben. Dateinamen-Schlüsselwörter können in Feldern zusammen mit anderen Eingaben verwendet werden, einschließlich mit anderen Schlüsselwörtern oder Variablen. Diese Abschnitte werden unten behandelt:

• Felder, in denen Schlüsselwörter verwendet werden können
• Wählen Sie ein Dateinamen-Schlüsselwort aus
• Formate zwischen Pille und Text umschalten
• Dateinamen-Schlüsselwort entfernen

Felder, in denen Schlüsselwörter verwendet werden können

Schlüsselwortersetzungen sind für die Verwendung in konfigurierbaren Feldern vorgesehen, die Dateinamen als Eingabe verwenden. Dies schließt bestimmte Felder ein, die während der Endpoint der unten aufgeführten Konnektoren verfügbar sind.

Aktivitäten lesen

• Optionale Einstellungen: Nach der Verarbeitung > Datei umbenennen (Dateifreigabe, FTP, Temporärer Speicher und Lokaler Speicher Lese-Aktivitäten)

• Optionale Einstellungen: Triggerdatei > Absoluter Dateipfad (Dateifreigabe, FTP, Temporärer Speicher und Lokaler Speicher Aktivitäten lesen)

• Optionale Einstellungen: Erfolgs-/Fehlerordner > Erfolgsordner im absoluten Pfad und Fehlerordner im absoluten Pfad (FTP und Lokaler Speicher Lese-Aktivitäten)

Aktivitäten schreiben

• Dateiname(n) (Dateifreigabe, FTP, Temporärer Speicher und Lokaler Speicher Schreib-Aktivitäten)

• Optionale Einstellungen: Komprimierung > Dateiname(n) im Archiv (Dateifreigabe, FTP, Temporärer Speicher und Lokaler Speicher Schreib-Aktivitäten)

• Optionale Einstellungen: Erfolgs-/Fehlerordner > Erfolgsordner im absoluten Pfad und Fehlerordner im absoluten Pfad (FTP und Lokaler Speicher Schreib-Aktivitäten)

Wählen Sie ein Dateinamenschlüsselwort aus

Um auf Dateinamen-Schlüsselwörter zuzugreifen, können Sie entweder auf das Variablensymbol klicken oder geben Sie eine öffnende eckige Klammer ein [ um eine Liste mit Schlüsselwörtern und Variablen anzuzeigen.

Innerhalb der Liste wird das Schlüsselwort oder der Variablentyp durch das Symbol neben seinem Namen angezeigt:

• für Dateinamenschlüsselwort
• für globale Variable
• für Projektvariable
• für Jitterbit-Variable

Bewegen Sie den Mauszeiger in der Liste über den Schlüsselwortnamen, um eine Vorschau der Informationen dazu anzuzeigen:

Der Wert, der im Informations-Popup angezeigt wird, ist für ein Dateinamen-Schlüsselwort immer leer. Ein Standardwert für ein Dateinamen-Schlüsselwort kann in einem Konfigurationsfeld nicht definiert werden.

Wählen Sie ein Schlüsselwort aus, das dem Feld an der Position Ihres Cursors, irgendwo in der Zeichenfolge, hinzugefügt werden soll. Die Variable wird in einem Pillenformat ähnlich dem unten gezeigten angezeigt:

Um Informationen zum Schlüsselwort zu überprüfen, bewegen Sie den Mauszeiger über das Schlüsselwort-Pill:

Umschalten der Formate zwischen Pille und Text

Um das Standardformat der Keyword-Pille in das Textformat zu ändern, klicken Sie auf das Symbol zum Reduzieren :

Dadurch wird die Anzeige des Pillenformats in ein Textformat umgeschaltet, wobei der Variablenname in eckige Klammern eingeschlossen ist [ ]:

Um von einem Textformat zurück zum Pillenformat zu wechseln, ändern Sie den Fokus vom Feld weg, indem Sie beispielsweise in ein anderes konfigurierbares Feld klicken. Die Feldeingabe kehrt automatisch zum standardmäßigen Pillenformat zurück.

Entfernen eines Dateinamenschlüsselworts

Um ein Dateinamen-Schlüsselwort zu entfernen, klicken Sie auf das Entfernen-Symbol :

Einschränkungen und Problemumgehungen

Bei der Verwendung von Dateinamen-Schlüsselwörtern in den Feldern Triggerdatei oder Erfolgs-/Fehlerordner besteht eine Einschränkung darin, dass die Schlüsselwörter bei Verwendung der Triggerdatei bzw. beim Erstellen der Erfolgs- bzw. Fehlerdatei nicht aufgelöst werden.

Nehmen wir beispielsweise an, Sie haben eine Quelldatei mit dem Namen customers.csv und das aktuelle Datum ist der 2. Oktober 2019.

Sie können versuchen, eine Schlüsselwortkombination wie diese zu verwenden, um den Zieldateinamen festzulegen:

[file]_[date].csv

customers_2019-10-02.csv-_2019-10-02_02-02-54-525

Da jedoch Dateinamen-Schlüsselwörter nicht aufgelöst werden, sieht das tatsächliche Ergebnis stattdessen ungefähr so aus, einschließlich der noch in Klammern stehenden, nicht aufgelösten Schlüsselwörter:

[file]_[date].csv_2019-10-02_02-02-54-525

Eine Problemumgehung besteht darin, für den Zieldateinamen eine globale Variable anstelle von Dateinamenschlüsselwörtern zu verwenden:

1. Erstellen Sie eine globale Variable in einer einem Zielknoten hinzugefügten Bedingung der Transformation und legen Sie diese globale Variable fest, um den Quelldateinamen anzugeben.

   In diesem Beispiel wurde ein Dateiname erstellt, der den Quelldateinamen und die aktuelle Uhrzeit in UTC verwendet:

   <trans>
   If(SourceInstanceCount() == 1,
     $filename_target = $jitterbit.source.filename + "_";
     $filename_target += Replace(GetUTCFormattedDateTime(Now(), "UTC", false), ":", "-");
   );
   true;
   </trans>
   

2. Verwenden Sie die globale Variable (im Beispiel genannt filename_target) als Zieldateiname im Feld Erfolgs-/Fehlerordner.

   Die globale Variable wird für die Erfolgs- bzw. Fehlerdatei korrekt aufgelöst.