Datei lesen |
Die Aktion Datei lesen sucht einen vorgegebenen Dateityp in einem bestimmten Ordner, liest die in dieser Datei enthaltenen Daten und speichert sie in einer Variable.
Auf den folgenden Registerkarten können Sie die Eigenschaften für die Aktion Datei lesen konfigurieren.
Quelle
Speicherort: Gibt das Dateisystem oder den Speicherort an, in dem der Quellordner vorliegt. Dateisysteme oder Speicherorte können auch ein Pfad relativ zu dem Ordner sein, der die Integrationsdatei, einen temporären Speicherordner, lokale Dateisysteme, Netzwerkfreigaben, Librarian oder einen unterstützten Cloud-Speicherort enthält. Weitere Informationen über unterstützte Cloud-Speicherorte finden sie auf der Administration Console
Dateiname: Gibt die Datei an, deren Daten die Aktion liest. Sie können den Speicherort des Ordners und den Dateinamen eingeben oder auf Durchsuchen klicken, um zur gewünschten Datei zu navigieren und diese auszuwählen. (Wenn Speicherort auf Relativ zur Integration oder Temporärer Speicher eingestellt ist, ist die Option Durchsuchen nicht verfügbar). Alternativ können Sie eine Variable hinzufügen, um die gewünschte Datei anzugeben, oder ein Sonderzeichen zum eingegebenen Wert hinzufügen.
Letzte veröffentlichte Version: Gibt an, dass die Aktion die zuletzt veröffentlichte Version der angegebenen Librarian-Datei verwendet. Diese Option wird nur wirksam, wenn die Librarian-Datei einem Workflow zugewiesen ist. Verfügbar, wenn Speicherort auf Librarian gesetzt ist.
|
Wenn Sie geklickt haben, um die Option Warten auf Eingang der Datei unter Dateierkennung (siehe unten) auszuwählen, ändert sich die Option Dateiname in die Option Zu scannender Ordner. |
Zu scannender Ordner: Legt den Ordner fest, in dem die Aktion nach der Datei suchen soll. Sie können den Speicherort des Ordners eingeben oder auf Durchsuchen klicken, um zum gewünschten Ordner zu navigieren und diesen auszuwählen. (Wenn Speicherort auf Relativ zur Integration oder Temporärer Speicher eingestellt ist, ist die Option Durchsuchen nicht verfügbar). Alternativ können Sie eine Variable hinzufügen, die den zu durchsuchenden Ordner angibt, oder ein Sonderzeichen zum eingegebenen Wert hinzufügen. Verfügbar, wenn Sie das Kontrollkästchen Warten auf Eingang der Datei unter Dateierkennung klicken.
Letzte veröffentlichte Version: Gibt an, dass die Aktion die zuletzt veröffentlichte Version der angegebenen Librarian-Datei verwendet. Diese Option wird nur wirksam, wenn die Librarian-Datei einem Workflow zugewiesen ist. Verfügbar, wenn Speicherort auf Librarian gesetzt ist.
Untergeordnete Ordner scannen: Gibt an, dass die Aktion auch alle Unterordner des Ordners überwacht, der durch die Eigenschaft Zu scannender Ordner angegeben ist.
Dateicodierung: Gibt die Methode an, mit der die aktuell gelesene Datei codiert wird.
Format der Dateiinhalte: Gibt den Typ des Dateiinhalts an. Die Aktion verarbeitet den Inhalt der Datei diesem Format entsprechend.
Daten sind in einer SOAP-Nachricht enthalten: Gibt an, dass die Aktion nach Daten sucht, die in einer SOAP-Nachricht enthalten sind.
Zeitüberschreitung gesperrter Datei: Legt fest, wie lange versucht wird, die Datei zu öffnen, die anfangs durch eine andere Anwendung gesperrt war.
Dateierkennung
Warten auf Eingang der Datei: Gibt an, dass die Aktion auf das Eintreffen der Datei wartet, wenn sie nicht bereits im Ordner vorhanden ist.
|
Die Optionen zur Dateierkennung sind nur verfügbar, wenn Sie das Kontrollkästchen Warten auf Eingang der Datei angeklickt haben. |
Quelle
Scanverfahren: Legt die Methode fest, mit der die Aktion den Scan-Ordner auf das Eintreffen der angegebenen Datei überwacht.
Benachrichtigung und Abfrage: Legt fest, dass die Aktion sowohl den Scan-Ordner fortlaufend überwacht als auch den Ordner in bestimmten Zeitabständen scannt. Diese Option ist hilfreich, wenn Sie Bedenken bezüglich der Zuverlässigkeit Ihres Dateisystems haben. Wenn ein Ereignis beim kontinuierlichen Scan nicht erkannt wird, würde mit dem Abfrage-Scan die Erkennung sichergestellt. Wenn Sie diese Option wählen, können Sie das Abfrage-Intervall in Millisekunden, Sekunden, Minuten oder Stunden festlegen.
Nur Benachrichtigungen: Legt fest, dass die Aktion den Scan-Ordner fortlaufend überwacht.
Nur Abfrage: Legt fest, dass die Aktion den Scan-Ordner in bestimmten Zeitabständen scannt. Wenn Sie diese Option wählen, können Sie das Abfrage-Intervall in Millisekunden, Sekunden, Minuten oder Stunden festlegen.
Abfrageintervall: Gibt an, wie oft die Aktion nach der Datei sucht. Verfügbar, wenn Benachrichtigung und Abfrage oder Nur Abfrage für das Scanverfahren ausgewählt ist.
Dateimuster: Gibt den Filter an, den die Aktion zur Erkennung der Datei verwendet, auf die die Aktion ausgeführt werden soll. Dieser Filter kann Platzhalterzeichen (z. B. ? und *) oder reguläre Ausdrücke (z. B. (?i)^.*\.csv$) enthalten. Klicken Sie auf , um eine Liste der unterstützten Modifizierer von regulären Ausdrücken und Platzhaltern aufzurufen. Klicken Sie auf einen Modifizierer, um diesen hinzuzufügen. Sie können auch eine Variable hinzufügen, die das Dateimuster angibt, oder ein Sonderzeichen zum eingegebenen Wert hinzufügen.
Regulären Ausdruck verwenden: Legt fest, dass die Aktion reguläre Ausdrücke nutzt, um das Dateimuster zu erkennen. Wenn Sie diese Option auswählen, können Sie der vorherigen Eigenschaft Modifizierer von regulären Ausdrücken hinzufügen, um mehr Kontrolle über die Suchkriterien zu haben.
Erkennungsoptionen
Erkennungsereignisse: Gibt wie folgt die Art des Ereignisses an, das die Aktion überwacht:
Datei erstellt: Gibt an, dass die Aktion überwacht, ob eine Datei erstellt wird. Wenn Speicherort auf Librarian gesetzt ist und Letzte veröffentlichte Version ausgewählt ist, wird dieses Ereignis erst erkannt, nachdem die erstellte Datei den Status „veröffentlicht“ erhält oder mit dem Status „veröffentlicht“ erstellt wurde.
Datei geändert: Gibt an, dass die Aktion überwacht, ob eine Datei geändert wird. Wenn Speicherort auf Librarian gesetzt ist und Letzte veröffentlichte Version ausgewählt ist, wird dieses Ereignis nur erkannt, wenn die geänderte Datei sich im Status „veröffentlicht“ befindet.
Workflowstatus geändert zu: Gibt an, dass die Aktion überwacht, ob der Workflow einer Datei in den angegebenen Status wechselt. Geben Sie den gewünschten Workflowstatus in das Feld ein (Groß- und Kleinschreibung beachten). Wenn Letzte veröffentlichte Version ausgewählt ist, wird dieses Ereignis nur erkannt, wenn der angegebene Zielstatus ein veröffentlichter Status ist. Verfügbar, wenn Speicherort auf Librarian gesetzt ist.
Minimale Dateigröße: Legt die minimale Größe einer Datei fest, damit sie vom einer Aktion noch als Quelldatei akzeptiert wird.
Maximale Dateigröße: Legt die maximale Größe einer Datei fest, damit sie von einer Aktion noch als Quelldatei akzeptiert wird.
Datei - ungenutzte Zeit: Legt die maximale Zeit einer Datei fest, während der sie sich in einem Ordner im Ruhezustand befindet kann, damit Sie von einer Aktion noch als Quelldatei akzeptiert wird. Das maximale Alter kann in Millisekunden, Sekunden, Minuten oder Stunden angegeben werden und wird mit der „LastModifiedTime“ (Zeit der letzten Änderung) verglichen.
Sortierreihenfolge für mehrere Dateien
Legt die Reihenfolge fest, in der die Aktion die Dateien im angegebenen Ordner verarbeitet, wenn mehrere Dateien dem angegebenen Dateimuster entsprechen. Wenn auf der Eigenschaftsseite keine Sortierreihenfolge vorgegeben ist, wird standardmäßig nach Erstellungszeit (in aufsteigender Reihenfolge) und dann nach dem Dateinamen (in aufsteigender Reihenfolge) sortiert. Sie können bis zu vier Sortierkriterien angeben.
Reihenfolge: Zeigt die Reihenfolge an, in der die Sortierkriterien auf die übereinstimmenden Dateien im angegebenen Ordner angewendet werden.
Feld sortieren: Gibt das Kriterium an, das auf die übereinstimmenden Dateien angewendet wird.
Richtung: Legt fest, ob das Sortierfeld-Kriterium in aufsteigender oder absteigender Reihenfolge auf die übereinstimmenden Dateien angewendet wird.
Sortierkriterien hinzufügen: Legt zusätzliche Sortierkriterien fest.
Ausgabe
Dateiinhalt als Variable speichern: Legt die Variable fest, in die der Inhalt der Datei gespeichert werden soll. Geben Sie die Variable in das Eingabefeld ein. Alternativ können Sie eine Variable hinzufügen.
Aktion
Name: Gibt den Namen der Aktion an. Sie können den Standardnamen ersetzen, indem Sie einen neuen Namen in das Feld eintragen.
Beschreibung: Gibt eine Beschreibung für die Aktion an.
Aktion ausführen: Legt fest, wie oft die Aktion ausgeführt werden soll.
Immer: Legt fest, dass der Integrationsdienst die Aktion bei jeder Durchführung der Integration ausführt.
Nie: Legt fest, dass der Integrationsdienst die Aktion bei der Durchführung der Integration nicht ausführt.
Bedingt, auf Variable basierend: Legt fest, dass der Integrationsdienst die Aktion nur dann ausführt, wenn eine ausgewählte Variable eine bestimmte Bedingung erfüllt. Nutzen Sie diese Option in Situationen, in denen nur eine Bedingung vorhanden ist, die bestimmt, ob die Aktion durchgeführt wird. Nachdem Sie diese Option ausgewählt haben, können Sie die bedingte Anweisung im Eingabefeld erstellen.
Variable: Gibt die Variable an, die für die bedingte Anweisung verwendet werden soll. Geben Sie die Variable in das Eingabefeld ein. Klicken Sie , um eine Liste der zuletzt verwendeten Variablen anzuzeigen, oder klicken Sie auf Weitere Variablen, um das Dialogfeld Variable einfügen zu öffnen.
[Relationale Operatoren]: Gibt den relationalen Operator zur Verwendung für die bedingte Anweisung an. Klicken Sie auf den bestehenden Operator, um eine Liste zusätzlicher Operatoren zu öffnen, und wählen Sie den gewünschten aus. Weitere Informationen finden Sie unter Relationale Operatoren. Welche Operatoren in der Liste verfügbar sind, hängt davon ab, ob Sie für die Option Typ den Eintrag Text oder Dezimal auswählen.
Wert: Gibt den oder die Werte zur Verwendung für die bedingte Anweisung an. Um einen Wert hinzuzufügen, klicken Sie auf und auf <Wert eingeben>. Geben Sie den gewünschten Wert ein und drücken Sie dann
Enter
. Um einen Wert zu löschen, klicken Sie mit der sekundären Maustaste darauf und klicken Sie dann auf Löschen. Bei manchen Operatoren wie Is blank (ist leer) und Is not blank (ist nicht leer) muss kein Wert angegeben werden. In diesen Fällen ist das Feld Wert nicht verfügbar.
Typ: Legt fest, ob die bedingte Anweisung einen Text oder einen Dezimalwert auswertet.
Bedingt, auf Ausdruck basierend: Legt die Bedingungen fest, unter denen der Integrationsdienst die Aktion ausführt. Nutzen Sie diese Option in Situationen, wo mehrere bedingte Anweisungen benötigt werden. Wenn Sie diese Option wählen, können Sie den bedingten Ausdruck im Eingabefeld erstellen, indem Sie die gewünschten bedingten Anweisungen eingeben. Ein bedingter Ausdruck wird auf der Registerkarte Strukturansicht erstellt und bearbeitet. Klicken Sie auf die Registerkarte Textansicht, um eine schreibgeschützte Textansicht des bedingten Ausdrucks aufzurufen.
Steuerelemente im Eingabefeld (Registerkarte „Strukturansicht“)
[Bedingter Verbinder]: Gibt den bedingten Verbinder für die bedingten Anweisungen innerhalb der Gruppe an. Der bedingte Verbinder Und ist voreingestellt.
Klicken Sie auf den bestehenden bedingten Verbinder, um ein Menü aufzurufen, in dem Sie Ihren bedingten Ausdruck mit einem der folgenden Verfahren konfigurieren können:
Und, Oder, NichtUnd, NichtOder: Klicken Sie auf den bedingten Verbinder in der Liste, den Sie für die bedingten Anweisungen verwenden möchten. Weitere Informationen über die unterstützten bedingten Verbinder finden Sie unter Bedingte Verbinder.
Bedingung hinzufügen: Klicken Sie hierauf, um eine weitere bedingte Anweisung zur aktuellen Gruppe hinzuzufügen.
Gruppe hinzufügen: Klicken Sie hierauf, um eine Untergruppe mit bedingten Anweisungen zur aktuellen Gruppe hinzuzufügen.
Gruppe entfernen: Klicken Sie hier, um die Untergruppe zu löschen. Verfügbar, wenn Sie das Menü aus einer Untergruppe heraus öffnen.
Alles entfernen: Klicken Sie hierauf, um alle bedingten Anweisungen (einschließlich der Untergruppen) zu löschen. Verfügbar, wenn Sie das Menü von der obersten Gruppe aus öffnen.
: Fügt zu der Gruppe, die dem jeweiligen Verbinder zugeordnet ist, eine bedingte Anweisung hinzu. Dieses Symbol wird rechts von den einzelnen bedingten Verbindern in Ihrem Ausdruck angezeigt.
: Löscht die bedingte Anweisung. Dieses Symbol wird rechts von einer bestehenden bedingten Anweisung angezeigt, wenn Sie auf die Anweisung zeigen.
Variable: Gibt die Variable an, die für die bedingte Anweisung verwendet werden soll. Geben Sie die Variable in das Eingabefeld ein. Klicken Sie , um eine Liste der zuletzt verwendeten Variablen anzuzeigen, oder klicken Sie auf Weitere Variablen, um das Dialogfeld Variable einfügen zu öffnen.
[Relationale Operatoren]: Gibt den relationalen Operator zur Verwendung für die bedingte Anweisung an. Klicken Sie auf den bestehenden Operator, um eine Liste zusätzlicher Operatoren zu öffnen, und wählen Sie den gewünschten aus. Weitere Informationen finden Sie unter Relationale Operatoren. Welche Operatoren in der Liste verfügbar sind, hängt davon ab, ob Sie für die Option Typ den Eintrag Text oder Dezimal auswählen.
Wert: Gibt den oder die Werte zur Verwendung für die bedingte Anweisung an. Um einen Wert hinzuzufügen, klicken Sie auf und auf <Wert eingeben>. Geben Sie den gewünschten Wert ein und drücken Sie dann
Enter
. Um einen Wert zu löschen, klicken Sie mit der sekundären Maustaste darauf und klicken Sie dann auf Löschen. Bei manchen Operatoren wie Is blank (ist leer) und Is not blank (ist nicht leer) muss kein Wert angegeben werden. In diesen Fällen ist das Feld Wert nicht verfügbar.
Typ: Legt fest, ob die bedingte Anweisung einen Text oder einen Dezimalwert auswertet.
Anmeldeeinstellungen
Von übergeordneter Aktion übernehmen: Gibt an, dass die Aktion die auf der Eigenschaftsseite Aktionen angegebenen Anmeldeeinstellungen übernimmt. Wenn es sich bei der Aktion andererseits um eine Aktion „Gruppieren“ handelt, übernimmt sie die Anmeldeeinstellungen auf der Eigenschaftenregisterkarte der direkt übergeordneten Aktion Gruppieren.
Benutzeranmeldedaten angeben: Gibt an, dass die Aktion unter werden Verwendung der angegebenen Anmeldeeinstellungen ausgeführt wird.
Fehlerverarbeitung und Diagnose
Fehler ignorieren und mit der Ausführung von Aktionen fortfahren: Gibt an, dass bei einem Fehlschlagen der Aktion die übrigen Aktionen weiter ausgeführt werden. Wenn diese Option nicht ausgewählt wurde und die Aktion fehlschlägt, hängt das resultierende Verhalten von den folgenden Faktoren ab:
Die Aktion ist Bestandteil einer Aktion vom Typ „Gruppieren“
Wenn Sie Der Reihe nach für die Eigenschaft Aktionen ausführen auf der Registerkarte Ausführung der Aktion Gruppieren angegeben haben, werden keine weiteren Aktionen im Rahmen der Aktion „Gruppieren“ ausgeführt. Außerhalb dieser Aktion „Gruppieren“ sind keine Aktionen betroffen.
Wenn Sie Parallel für die Eigenschaft Aktionen ausführen auf der Registerkarte Ausführung der Aktion Gruppieren angegeben haben, werden die Fehler ignoriert und weitere Aktionen werden im Rahmen der Aktion „Gruppieren“ ausgeführt. Außerhalb dieser Aktion „Gruppieren“ sind keine Aktionen betroffen.
Die Aktion ist nicht Bestandteil einer Aktion vom Typ „Gruppieren“
Wenn Sie Der Reihe nach für die Eigenschaft Aktionen ausführen auf der Registerkarte Ausführung der Aktion Gruppieren angegeben haben, werden keine weiteren Aktionen im Rahmen der Integration ausgeführt.
Wenn Sie Parallel für die Eigenschaft Aktionen ausführen auf der Registerkarte Ausführen der Aktion Aktionen angegeben haben, werden die Fehler ignoriert und weitere Aktionen werden im Rahmen der Integration ausgeführt.
Bei Fehlschlag erneut versuchen: Legt fest, dass bei einem Fehlschlagen der Aktion der Integrationsdienst versucht, diese erneut auszuführen.
Maximale erneute Versuche: Legt die maximale Anzahl der Versuche durch den Integrationsdienst fest, die Aktion erneut auszuführen. Verfügbar, wenn die Option Bei Fehlschlag erneut versuchen ausgewählt wurde.
Intervall für erneute Versuche: Legt die Zeitdauer fest, während der der Integrationsdienst nach dem Fehlschlagen der Aktion wartet, bevor er versucht, die Aktion erneut auszuführen. Verfügbar, wenn die Option Bei Fehlschlag erneut versuchen ausgewählt wurde.