X4 Produktdokumentation

File System Adapter anlegen, einfügen und konfigurieren

Im ersten Schritt fügen Sie einen sogenannten Adapter in Ihren Prozess ein, um eine Beispieldatei zu importieren. Mit Adaptern können Sie Anwendungen und Daten in beliebige Business Processes integrieren. Weitere Informationen zu den X4 BPMS Standard-Adaptern und ihren Funktionen finden Sie unter X4 BPMS Standard-Adapter.

Für dieses Beispiel benötigen Sie den Adapter File System. Dieser Adapter speichert, liest, löscht, kopiert, verschiebt, listet Dateien und Ordner oder fügt Dateien einer Zieldatei an, die sich im Dateisystem des X4 Servers oder auf verbundenen Windows- oder Samba-Netzlaufwerken befinden. Weitere Informationen zum File System Adapter finden Sie auf der Seite File System.

Nachdem Sie den Adapter angelegt und eingefügt haben, können Sie mit der Konfiguration des Adapters beginnen. Außerdem empfehlen wir, dass Sie ihren Technical Process mit Beschreibungen versehen, die die einzelnen Prozessschritte erläutern. So bleiben die einzelnen Prozessschritte transparent und können auch von beispielweise neue Kollegen schnell nachvollzogen werden.

◀️

Vorheriger Schritt: Technical Process anlegen (.wrf)

Voraussetzungen:

Sie haben die vorzubereitende XML-Beispieldatei angelegt und lokal gespeichert. Weitere Informationen finden Sie unter Beispiel: ESB Project.

Adapter anlegen

  1. Rechtsklicken Sie auf den Technical ProcessImportInvoices in der Sicht Projects und wählen Sie New > Adapter….
    Das Dialogfenster File Creation Wizard wird geöffnet.

  2. Geben Sie im Suchfeld den Wert File System ein und wählen Sie den File System Adapter.
    Bei Bedarf können Sie den Namen des Adapters im Feld File name anpassen.

    image-20241016-110357.png
  3. Klicken Sie auf Finish.
    ✅ Der Adapter wird im ESB Project angelegt und öffnet sich automatisch im Editor. Die weitere Konfiguration des eingefügten Adapters erfolgt im nächsten Schritt.

  4. Wechseln Sie zurück zum Technical Process ImportInvoices.wrf.

Adapter einfügen

  1. Ziehen Sie das Element image-20241016-105227.png Adapter von der Sicht Palette neben das Element image-20241009-135007.png Start in den Editor.

  2. Doppelklicken Sie auf das Element image-20241016-105227.png Adapter.
    Das Dialogfenster Choose Adapter File wird geöffnet.

  3. Wählen Sie den zuvor im Technical Process angelegten Adapter.

  4. Klicken Sie auf OK.

  5. Klicken Sie auf die rechte untere image-20241015-085229.png Ecke des Elements image-20241009-135007.png Start, halten Sie die Maustaste gedrückt und ziehen Sie eine Verbindung zum Element image-20241017-092541.png File_System_Adapter.

    image-20241016-114006.png

Adapter konfigurieren

  1. Klicken Sie auf den image-20241017-092541.png File System Adapter im Editor.

  2. Wählen Sie den Wert Read File aus der Dropdown-Liste Operation in der Sicht Properties.
    Der Adapter liest nun Daten aus der im Parameter path festgelegten Datei.

  3. Doppelklicken Sie auf den image-20241017-092541.png File System Adapter im Editor.
    Der Adapter wird auf einer neuen Registerkarte geöffnet.

  4. Tragen Sie den Pfad zur vorzubereitenden XML-Beispieldatei sampleInvoice.xml in das Feld des Parameters path ein.

    image-20241016-122540.png
  5. Klicken Sie auf image-20241009-130249.png Speichern.

  6. Wechseln Sie zurück zum Technical Process ImportInvoices.wrf.

Beschreibung hinzufügen

  1. Ziehen Sie das Element image-20241016-124820.png Textbox von der Sicht Palette unter das Element image-20241016-122247.png File System Adapter in den Editor.

  2. Doppelklicken Sie auf das Element image-20241016-124820.png Textbox.
    Der Text Editor wird geöffnet.

  3. Geben Sie den gewünschten Beschreibungstext ein, z. B.: “This step imports/reads a sample invoice file from the local hard drive. You can set the folder + filename in the adapter.”

  4. Klicken Sie auf OK.

  5. Passen Sie bei Bedarf die Größe und Position der Textbox an.

    image-20241016-125136.png
▶️