Dateiverzeichnismanipulation im Jitterbit App Builder

Dieser Artikel befasst sich mit der Dateiverzeichnisbearbeitung im App Builder. Zu den behandelten Themen gehören das Verschieben von Dateien zwischen Binärdateien und einem Dateisystem, das Erstellen von Verzeichnissen im App Builder und das Einbinden von Verzeichnissen in ein Dateisystem-Panel.

Voraussetzungen

• Auf Ihrem App Builder-Server muss ein Dateisystem eingerichtet werden (lokal, S3 oder Netzwerk).
  • Es wird empfohlen, die DataSourceID des Dateisystems in der Parametertabelle für die Anwendung zu speichern, aus der Sie Dateien übertragen möchten
• Die Datenbank, aus der Sie Ihre Dateien übertragen, muss mit Ihrem Dateisystem verknüpft sein

Spalten in einer Dateisystem-Dateitabelle

Anweisungen zum Verschieben von Binärdateien in einer App Builder Tabelle in ein Dateisystem

Ordner

1. Wenn Sie bereits einen Ordner im Dateisystem haben, in dem Sie die Dateien speichern möchten, müssen Sie keine Ordner über den App Builder einrichten

2. Wenn Sie einen Ordner im Dateisystem erstellen möchten, müssen Sie dazu im App Builder Regeln einrichten:

   • Erstellen Sie eine XP CRUD-Einfügeregel aus der Hauptdatenbank Ihrer Anwendung, die auf die Dateitabelle Ihres Dateisystems abzielt
     • Schlüssel der Dateitabelle, die angesprochen werden müssen, sind DataSourceID (Ihres Dateisystems), Name (Name der Datei) und Directory (Dateipfad).
       • DATASOURCEID(*)- Wenn Sie die DataSourceID Ihres Dateisystems in Ihrer Parametertabelle gespeichert haben, können Sie die Regel auf Grundlage dieser Tabelle erstellen und dieses parametrisierte Feld verwenden, um auf die DataSourceID abzuzielen.
       • NAME(*)- Sie können den Datei-/Ordnernamen beliebig verwenden. Aus Sicherheitsgründen wird beim Speichern in einem Dateisystem üblicherweise nicht der tatsächliche Name der Datei verwendet, sondern ein neuer Name generiert.
       • DIRECTORY(*)- Wenn der Ordner der Ordner auf der höchsten Ebene in Ihrem Dateisystem ist, verwenden Sie eine leere Zeichenfolge als Verzeichnis. Wenn Sie eine Ordnerhierarchie erstellen, ist das Verzeichnis der Dateipfad des Ordners. App Builder übernimmt automatisch das erste „\“ im Dateipfad.
     • Setzen Sie für alle Ordner das Feld IsDirectory mit einer „1“. So erkennt App Builder, dass ein Ordner im Dateisystem erstellt werden muss, anstatt ihn als Datei einzufügen.
     • Registrieren Sie die Einfügeregel als Aktion für ein Ereignis und lösen Sie dieses Ereignis aus. Wenn Sie einen Ordner der obersten Ebene in Ihrem Dateisystem erstellt haben, sollte dieser in der Dateitabelle Ihres Dateisystems angezeigt werden. Befindet sich der Ordner/die Datei nicht auf der obersten Ebene Ihres Dateisystems, müssen Sie Seiten einrichten, um die korrekte Einfügung zu überprüfen, oder sich an jemanden mit Zugriff auf das Dateisystem wenden, um die Erstellung des Ordners zu bestätigen.

Einfügen von Dateien in das Dateisystem

1. Erstellen Sie eine XP CRUD-Einfügeregel aus der Datenquelle und der Tabelle, aus der Sie die Dateien verschieben. Diese Regel zielt auf die Dateitabelle Ihres Dateisystems ab.

   • Die Schlüssel für die Datei sind dieselben wie für den Ordner.
     • DATASOURCEID(*) - Die DataSourceID des Dateisystems. Sie können den Wert entweder fest codieren oder in der Parametertabelle streichen, falls Sie ihn gespeichert haben.
     • NAME(*) - Es ist üblich, nicht den ursprünglichen Namen der Datei in Ihrem Dateisystem zu verwenden. Sie können dies jedoch tun. Falls nicht, achten Sie auf eine einheitliche und leicht zu merkende Namenskonvention. (Hinweis: Wenn Sie diese Datei in einem eingebetteten Steuerelement in der Vorschau anzeigen möchten, müssen Sie die Dateierweiterung an das Ende des Namens anhängen. Eine Online-SQL-Dokumentation hilft Ihnen dabei, die Erweiterung vom ursprünglichen Dateinamen zu entfernen.)
     • DIRECTORY(*)- Der Pfad, in dem die Datei gespeichert wird. Eine Reihe von Ordnernamen, getrennt durch '\'.
   • Ein weiteres Feld, das für Dateien verwendet werden muss, ist „Inhalt“.
     • INHALT - Die Datei selbst. Die Binärdatei, die in der Tabelle gespeichert wird.

Verzeichnisse in ein Dateisystem-Panel einbinden

1. Wenn Sie auf eine Seite verlinken, die ein Dateisystem als Panelquelle verwendet, muss eine Bindung für den Zugriff auf Ihre Dateien übergeben werden.

   • Fügen Sie dem Objekt, von dem aus Sie die Bindung herstellen, die Felder hinzu, an die Sie die Bindung herstellen möchten.
     • Die Felder, an die Sie die Bindung herstellen möchten, sind die PKs der Dateitabelle in Ihrem Dateisystem (DataSourceID, Verzeichnis und Name).
   • Wo immer Sie Ihren Link zur Seite „Dateisystem“ einrichten, müssen Sie die Felder, die Sie gerade Ihrem Objekt hinzugefügt haben, als Linkkriterien festlegen. Sie können dies auch zwischen Panels tun, wenn Sie dies wünschen.

Beispiel einer XP-CRUD-Regel zum Erstellen eines Unterordners

Hier ist ein Beispiel für eine XP CRUD-Regel, die App Builder anweist, einen Unterordner mit dem Namen PaymentImport aus dem App BuilderData Ordner auf dem C: Laufwerk. In diesem Beispiel wird davon ausgegangen, dass der Datenquellenpfad C:/App BuilderData.

Regelkonfiguration:

• Zweck: XP CRUD
• Aktion: Cram
• Quelldatenquelle: Datenquelle, aus der die Regel stammt. Beispiel: InvoicePortal
• Zieldatenquelle: Datenquelle, auf die die Regel abzielt. Beispiel: Laufwerk C
• Zielebene: Logikebene
• Ziel: Benannte Tabelle, auf die die Regel abzielt. Beispiel: Datei

In der Regel definierte Spalten:

• DataSourceID: 'b24b8338-5c91-4e92-8481-8605944a558d'
• Verzeichnis: *
• Name: 'PaymentImport'
• IsDirectory: 1

Beispiel einer XP-CRUD-Regel zum Erstellen eines Unterordners