Open Thema mit Navigation

The Read File action directs the Integration Service to look in a specified folder for a defined file type, read the data that is contained in that file, and then save the data to a variable.

You can configure the following properties for the Read File action:

Aktion

• Name: Gibt den Namen der Aktion an. Bei Bedarf können Sie den Standardnamen ersetzen, indem Sie einen neuen Namen in das Feld eintragen.

• Beschreibung: Ermöglicht das Speichern einer Beschreibung für die Aktion.

• Aktion ausführen: Hier können Sie angeben, wie häufig die Aktion ausgeführt werden soll.

  • Immer: Legt fest, dass der Integrationsdienst die Aktion bei jeder Durchführung der Integration ausführen wird.

  • Nie: Legt fest, dass der Integrationsdienst die Aktion bei der Durchführung der Integration nicht ausführen wird.

  • 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 oder nicht. Nachdem Sie diese Option aktiviert haben, können Sie die bedingte Anweisung im vorgesehenen Eingabefeld erstellen.

    Bedienelemente im Eingabefeld

    • Variable: Geben Sie die Variable ein, die für die bedingte Anweisung verwendet werden soll. Alternativ können Sie eine Variable zum Wert der bedingten Anweisung hinzufügen.

    • [Relationaler Operator]: 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 ausgewählt haben.

    • Wert: Gibt den oder die Werte zur Verwendung für die bedingte Anweisung an. Bei manchen Operatoren wie Is null (Ist null) und Is not null (Ist ungleich null) 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, abhängig von Ausdruck: 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. Nachdem Sie diese Option aktiviert haben, können Sie den bedingten Ausdruck im vorgesehenen Eingabefeld erstellen, indem Sie die gewünschten bedingten Anweisungen angeben. 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.

    Bedienelemente im Eingabefeld (Registerkarte „Strukturansicht“)

    • [Bedingter Verbinder]: Gibt den bedingten Verbinder für die bedingten Anweisungen innerhalb der Gruppe an. Der bedingte Verbinder And (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:

      • Einen anderen bedingten Verbinder auswählen: Die Menüoptionen beinhalten eine Liste mit bedingten Verbindern. Geben Sie den bedingten Verbinder ein, der für die bedingten Anweisungen verwendet werden soll. For more information about the supported conditional joiners, see Conditional Joiners.

      • 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: Steht im Menü zur Verfügung, wenn das Menü aus einer Untergruppe geöffnet wurde. Klicken Sie hierauf, um die Untergruppe zu löschen.

      • Alle löschen: Steht im Menü zur Verfügung, wenn das Menü aus der obersten Gruppe geöffnet wurde. Klicken Sie hierauf, um alle bedingten Anweisungen (einschließlich der Untergruppen) zu löschen.

    • : Dieses Symbol wird unmittelbar rechts von den einzelnen bedingten Verbindern im Ausdruck angezeigt. Klicken Sie hierauf, um eine bedingte Anweisung zur Gruppe hinzuzufügen, die dem jeweiligen Verbinder zugeordnet ist.

    • : Dieses Symbol ist sichtbar, wenn Sie den Cursor auf eine vorhandene bedingte Anweisung richten. Click to delete the conditional statement.

    • Variable: Geben Sie die Variable ein, die für die bedingte Anweisung verwendet werden soll. Alternativ können Sie eine Variable für die bedingte Anweisung hinzufügen.

    • [Relationaler Operator]: 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 ausgewählt haben.

    • Wert: Gibt den oder die Werte zur Verwendung für die bedingte Anweisung an. Bei manchen Operatoren wie Is null (Ist null) und Is not null (Ist ungleich null) muss kein Wert angegeben werden. In diesen Fällen ist das Feld Wert verborgen.

    • Typ: Legt fest, ob die bedingte Anweisung einen Text oder einen Dezimalwert auswertet.

Quelle

• Position: Gibt das Dateisystem an, in dem der Quellenordner vorliegt. Die Dateisysteme oder Speicherorte können lokale Dateisysteme oder Netzwerkfreigaben, Librarian oder einen unterstützten Cloud-Speicherort umfassen. For more information about supported cloud storage locations, see Administration Console's Cloud Storage Page.

• Dateiname: Specifies the file that the Integration Service will read from. 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. Alternativ können Sie eine Variable hinzufügen, um die gewünschte Datei anzugeben, oder ein Sonderzeichen zum eingegebenen Wert hinzufügen.

If you have clicked to select the Wait for file to arrive check box under File Detection (as follows), the File Name option changes to the Folder to Scan option.

• Zu scannender Ordner: Legt den Ordner fest, in dem der Integrationsdienst 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. Alternativ können Sie eine Variable hinzufügen, die den zu durchsuchenden Ordner angibt, oder ein Sonderzeichen zum eingegebenen Wert hinzufügen.

• Dateicodierung: Gibt die Methode an, mit der die aktuell gelesene Datei codiert wird.

• Format des Dateiinhalts: Specifies the data contents type. The Integration Service processes the contents of the file according to this format.

• Daten sind in einer SOAP-Nachricht enthalten: Wenn diese Option aktiviert ist, erwartet der Integrationsdienst, dass die Daten in einer SOAP-Nachricht enthalten sind.

• Zeitüberschreitung bei gesperrter Datei: Legt fest, wie lange versucht wird, die Datei zu öffnen, die anfangs durch eine andere Anwendung gesperrt war.

Dateierkennung

• Auf das Eintreffen der Datei warten: When this option is selected, the Integration Service waits for the file to arrive if it does not already exist in the folder.

File detection options are available only when you have clicked to select the Wait for file to arrive check box.





• Erkennungsoptionen

  • Scanverfahren: Legt die Methode fest, mit der der Integrationsdienst den Scan-Ordner auf das Eintreffen der angegebenen Datei überwachen wird.

    • Benachrichtigung und Abfrage: Legt fest, dass der Integrationsdienst sowohl den Scan-Ordner fortlaufend überwacht als auch den Ordner in bestimmten Zeitabständen scannt. Diese Option kann hilfreich sein, wenn Sie Bedenken wegen 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 diese Option gewählt wird, können Sie das Abfrage-Intervall in Millisekunden, Sekunden, Minuten oder Stunden festlegen.

    • Nur Benachrichtigungen: Legt fest, dass der Integrationsdienst den Scan-Ordner fortlaufend überwacht.

    • Nur Abfrage: Legt fest, dass der Integrationsdienst den Scan-Ordner in bestimmten Zeitabständen scannt. Wenn diese Option gewählt wird, können Sie das Abfrage-Intervall in Millisekunden, Sekunden, Minuten oder Stunden festlegen.

  • Abfrage-Intervall: Gibt an, wie häufig der Integrationsdienst nach der Datei sucht. Verfügbar, wenn Benachrichtigung und Abfrage oder Nur Abfrage als Scanverfahren ausgewählt ist.

  • Dateimuster: Legt den Filter für Dateien fest, nach denen gesucht werden soll. Die Standardeinstellung ist *.dat. Geben Sie bei Bedarf eine andere Dateierweiterung ein. Alternativ können Sie eine Variable hinzufügen, die das Dateimuster angibt, oder ein Sonderzeichen zum eingegebenen Wert hinzufügen.

    • Regulären Ausdruck verwenden: Specifies that the Integration Service will use regular expressions to identify the file pattern. Once this option is enabled, you can add regular expression modifiers to the previous property for more control over the search criteria.

  • Minimale Dateigröße: Legt die minimale Größe einer Datei fest, damit sie vom Integrationsdienst noch als Quelldatei akzeptiert wird.

  • Maximale Dateigröße: Legt die maximale Größe einer Datei fest, damit sie vom Integrationsdienst noch als Quelldatei akzeptiert wird.

  • File Idle Time: Specifies the maximum time a file can be idle in the specified folder for the Integration Service to still accept it as the source file. 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 der Integrationsdienst die Dateien im angegebenen Ordner verarbeiten wird, wenn mehrere Dateien dem angegebenen Dateimuster entsprechen. Wenn auf der Eigenschaftsseite keine Sortierreihenfolge vorgegeben ist, wird standardmäßig nach Erstellungszeit (aufsteigende Reihenfolge) und dann nach dem Dateinamen (aufsteigende Reihenfolge) sortiert. Sie können null bis 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: Hier können Sie weitere Sortierkriterien hinzufügen.

Ausgabe

• Dateiinhalt in Variable speichern: Legt die Variable fest, in die der Inhalt der Datei gespeichert werden soll. Enter the variable in the input box. Alternativ können Sie eine Variable hinzufügen.

Testen von „Datei lesen“

• Test: Führt die Aktion aus. Im Fenster Nachricht werden Informationen über den Erfolg oder Fehlschlag der Aktion angezeigt.

  Durch Klick auf die Schaltfläche Testen wird nur die Aktion, nicht aber die Integration ausgeführt. Aus diesem Grund wird die Aktion ohne Daten aus der Integration durchgeführt, die Sie möglicherweise für ihre Verwendung konfiguriert haben. For information on testing your integration, refer to Using the Test Pane.

Anmeldeeinstellungen

• Von übergeordneter Aktion übernehmen: Wenn diese Option aktiviert ist, übernimmt die Aktion die auf der Eigenschaftsseite Aktionen angegebenen Anmeldeeinstellungen. Wenn es sich bei der Aktion andererseits um eine Aktion Gruppieren handelt, übernimmt sie die Anmeldeeinstellungen auf der Eigenschaftsseite der direkt übergeordneten Aktion Gruppieren.

• Benutzeranmeldedaten angeben: Wenn diese Option aktiviert ist, wird die Aktion unter Verwendung der angegebenen Anmeldeeinstellungen ausgeführt.

Fehlerverarbeitung und Diagnose

• Fehler ignorieren und mit der Ausführung von Aktionen fortfahren: Mit dieser Option wird festgelegt, dass bei einem Fehlschlagen der Aktion die übrigen Aktionen weiter ausgeführt werden.

  Wenn diese Eigenschaft nicht aktiviert ist und die Aktion fehlschlägt, hängt das resultierende Verhalten von den folgenden Szenarien ab: Wenn Sie Der Reihe nach für die Eigenschaft Aktionen ausführen auf der hierarchischen Eigenschaftsseite Aktionen oder Gruppe der ausgewählten Aktion festgelegt haben, werden keine weiteren Aktionen innerhalb der Gruppe ausgeführt. Wenn Sie Parallel für die Eigenschaft Aktionen ausführen auf der hierarchischen Eigenschaftsseite Aktionen oder Gruppe der Aktion festgelegt haben, wirkt sich dies nicht auf die Aktionen innerhalb der Gruppe aus. Die Fehler werden ignoriert, und keine weiteren Aktionen innerhalb der Gruppe werden ausgeführt. Wenn sich die ausgewählte Aktion innerhalb der Aktion Gruppieren befindet, sind keine Aktionen außerhalb der Aktion „Gruppieren“ betroffen.

• Bei Fehlschlag erneut versuchen: Mit dieser Option wird festgelegt, dass bei einem Fehlschlagen der Aktion der Integrationsdienst versuchen wird, 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 Bei Fehlschlag erneut versuchen aktiviert ist.

• Intervall für erneute Versuche: Legt die Zeit fest, wie lange der Integrationsdienst warten wird, nachdem die Aktion fehlgeschlagen ist, bevor versucht wird, die Aktion erneut auszuführen. Verfügbar, wenn Bei Fehlschlag erneut versuchen aktiviert ist.