Zum Inhalt springen

Dateiverzeichnismanipulation im Jitterbit App Builder

In diesem Artikel wird die Arbeit mit der Dateiverzeichnismanipulation in App Builder. Zu den behandelten Themen gehören das Verschieben von Dateien zwischen Binärdateien und einem Dateisystem, das Erstellen von Verzeichnissen innerhalb App Builder, und binden Sie Verzeichnisse in ein Dateisystem-Panel ein.

Voraussetzungen

  • Auf Ihrem Computer muss ein Dateisystem eingerichtet werden. App Builder Server (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

Spalte Obligatorisch (J/N) Datentyp Beschreibung
DataSourceID(*) Ja UUID Die DataSourceID der Dateisystem-Datenquelle
Name(*) Ja String Der Name der Datei, wenn sie im Dateisystem gespeichert ist
Verzeichnis(*) Ja Zeichenfolge Der Dateipfad der im Dateisystem gespeicherten Datei
FullName Nein String Der Name der Datei, wenn sie im Dateisystem gespeichert ist
IsDirectory Nein Boolean Ob die gespeicherte Datei ein Ordner ist oder nicht
Inhalt Nein Binär Die Datei selbst
Erweiterung Nein Zeichenfolge Die Erweiterung der gespeicherten Datei
Erstellt am Nein Datum/Uhrzeit Wann die Datei in das Dateisystem eingefügt wurde
ModifiedOn Nein Datum/Uhrzeit Wann die Datei im Dateisystem aktualisiert wurde
Länge Nein Ganzzahl Länge der Datei in Bytes
FolderIcon Nein Binär Das Symbol des Ordners im Dateisystem

Anweisungen zum Verschieben von Dateien aus dem Binärformat in an App Builder Tabelle zum 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 App Builder
  2. Wenn Sie einen Ordner im Dateisystem erstellen möchten, müssen Sie Regeln in App Builder Gehen Sie dazu wie folgt vor:

    • Erstellen Sie eine XP CRUD-Einfügeregel aus der Hauptdatenbank Ihrer Anwendung, die auf die Dateitabelle Ihres Dateisystems abzielt.
      • Schlüssel der Dateitabelle, die als Ziel verwendet 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 anhand dieser Tabelle erstellen und dieses parametrisierte Feld verwenden, um auf die DataSourceID abzuzielen.
        • NAME(*)- Sie können als Datei-/Ordnernamen einen beliebigen Namen verwenden. Es ist üblich, beim Speichern in einem Dateisystem aus Sicherheitsgründen nicht den tatsächlichen Namen der Datei zu verwenden, sondern einen neuen Namen zu generieren.
        • DIRECTORY(*)- Wenn der Ordner der Ordner auf der höchsten Ebene in Ihrem Dateisystem ist, verwenden Sie als Verzeichnis eine leere Zeichenfolge. Wenn Sie eine Ordnerhierarchie erstellen, ist das Verzeichnis der Dateipfad des Ordners. App Builder nimmt automatisch das erste '\' im Dateipfad an.
      • Zielen Sie das Feld IsDirectory mit einer '1' für alle Ordner an. So geht's App Builder wird wissen, dass ein Ordner im Dateisystem erstellt werden muss, anstatt zu versuchen, 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. Wenn sich der Ordner/die Datei irgendwo anders als auf der obersten Ebene in Ihrem Dateisystem befindet, müssen Sie Seiten einrichten, um zu überprüfen, ob er/sie korrekt eingefügt wurde, oder sich an jemanden mit Zugriff auf das Dateisystem wenden, um zu bestätigen, dass der Ordner erstellt wurde.

Einfügen von Dateien in das Dateisystem

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

    • 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 kreuzen, wenn 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. Wenn Sie dies nicht tun, stellen Sie sicher, dass Sie eine Namenskonvention einrichten, die konsistent und leicht zu merken ist. (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. Es gibt eine SQL-Dokumentation im Internet, die Ihnen hilft, die Erweiterung vom ursprünglichen Dateinamen zu entfernen.)
      • DIRECTORY(*)- Der Pfad, in dem die Datei gespeichert wird. Eine Reihe von Ordnernamen, die durch „\“ getrennt sind.
    • Ein weiteres Feld, das für Dateien anvisiert werden muss, ist Inhalt
      • INHALT- Die Datei selbst. Die Binärdatei, die in der Tabelle gespeichert wird

Verzeichnisse in ein Dateisystemfenster einbinden

  1. Wenn Sie eine Verknüpfung zu einer Seite erstellen, die ein Dateisystem als Panelquelle verwendet, muss eine Bindung übergeben werden, um auf Ihre Dateien zuzugreifen.

    • Sie müssen dem Objekt, von dem aus Sie die Bindung durchführen, die Felder hinzufügen, an die Sie die Bindung durchführen möchten.
      • Die Felder, an die Sie die Bindung durchführen möchten, sind die PKs der Dateitabelle in Ihrem Dateisystem (DataSourceID, Verzeichnis und Name).
    • Wo auch 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 erreichen, wenn Sie dies auf diese Weise tun möchten.

Beispiel einer XP-CRUD-Regel zum Erstellen eines Unterordners

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

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

directoryexample.png

Beispiel einer XP-CRUD-Regel zum Erstellen eines Unterordners