Erstellen oder konfigurieren Sie einen überwachten Ordner create-or-configure-a-watched-folder
Admins können einen Netzwerkordner konfigurieren, der als überwachter Ordner bezeichnet wird, sodass ein vorkonfigurierter Vorgang zur Verarbeitung einer Datei gestartet wird, wenn eine Benutzerin oder ein Benutzer eine Datei (z. B. eine PDF-Datei) in diesem überwachten Ordner ablegt. Nachdem der angegebene Vorgang ausgeführt wurde, speichert der Vorgang die geänderte Datei in einem angegebenen Ausgabeordner. Ausführliche Informationen zum Verwalten eines überwachten Ordners finden Sie in der Administration-Hilfe.
Sie können die Benutzeroberfläche des überwachten Ordners für folgende Vorgänge verwenden:
- Erstellen eines überwachten Ordners
- Ändern von Eigenschaften eines vorhandenen überwachten Ordners
- Löschen eines überwachten Ordners
Erstellen eines überwachten Ordners create-a-watched-folder
Bevor Sie einen überwachten Ordner konfigurieren, stellen Sie Folgendes sicher:
- „Überwachte Ordner“ ist eine erweiterte Funktion von AEM Forms. Dafür wird ein funktionierendes Add-On-Paket für AEM Forms benötigt. Stellen Sie sicher, dass das entsprechende Add-On-Paket für AEM Forms installiert und konfiguriert ist.
- Sie können den überwachten Ordner in einem freigegebenen oder lokalen Speicher erstellen. Sorgen Sie dafür, dass AEM Forms-Benutzende, die den überwachten Ordner ausführen dürfen, über Lese- und Schreibberechtigungen für den überwachten Ordner verfügen.
- Sie können einen Dienst, einen Workflow oder ein Skript verwenden, um einen Prozess mithilfe überwachter Ordner zu automatisieren. Stellen Sie sicher, dass der entsprechende Service oder Workflow oder ein Skript erstellt wurde und ausgeführt werden kann. Weitere Informationen zur Erstellung von Services, Workflows und Skripts finden Sie unter Verschiedene Methoden zur Verarbeitung von Dateien.
- Ein überwachter Ordner besitzt verschiedene Eigenschaften, siehe Eigenschaften überwachter Ordner.
Führen Sie die folgenden Schritte aus, um einen überwachten Ordner zu erstellen:
-
Wählen Sie das Adobe Experience Manager-Symbol in der oberen linken Ecke des Bildschirms aus.
-
Wählen Sie Werkzeuge > Formulare > Überwachten Ordner konfigurieren. Es wird eine Liste der bereits konfigurierten überwachten Ordner angezeigt.
-
Wählen Sie Neu aus. Eine Liste mit den Feldern, die erforderlich sind, um den überwachten Ordner zu erstellen, wird angezeigt:
-
Name: Gibt den überwachten Ordner an. Verwenden Sie nur alphanumerische Zeichen für den Namen.
-
Pfad: Gibt den Speicherort des überwachten Ordners an. In einer Cluster-Umgebung muss diese Einstellung auf einen freigegebenen Netzwerkordner zeigen, auf den alle Benutzenden, die AEM auf anderen Knoten des Clusters ausführen, zugreifen können.
-
Prozessdateien, die Folgendes verwenden: Den Typ des zu startenden Prozesses. Zur Auswahl stehen Workflow, Skript oder Dienst.
-
Dienstname/Skript-Pfad/Workflow-Pfad: Das Verhalten des Feldes basiert auf dem Wert, der für das Feld Prozessdateien, die Folgendes verwenden definiert wird. Sie können die folgenden Werte festlegen:
- Für einen Workflow geben Sie das Workflow-Modell an, das ausgeführt werden soll. Zum Beispiel: /etc/workflow/models/<workflow_name>/jcr:content/model
- Für ein Skript geben Sie den JCR-Pfad des auszuführenden Skripts an. Zum Beispiel: /etc/watchfolder/test/testScript.ecma
- Für einen Dienst geben Sie den Filter an, der zum Suchen nach einem OSGi-Dienst verwendet werden soll. Der Dienst ist als Implementierung der com.adobe.aemfd.watchfolder.service.api.ContentProcessor-Schnittstelle registriert. Beispiel: Der folgende Code ist eine benutzerdefinierte Implementierung der ContentProcessor-Schnittstelle mit der benutzerdefinierten Eigenschaft „foo=bar“.
note note NOTE Wenn Sie Dienst für das Feld Prozessdateien, die Folgendes verwenden gewählt haben, muss der Wert des Feldes „Dienstname“ (inputProcessorType) in Klammern gesetzt werden. Hier ein Beispiel: (foo=bar). code language-java @Component(metatype = true, immediate = true, label = "WF Test Service", description = "WF Test Service") @Service(value = {OutputWriter.class, ContentProcessor.class}) @Property(name = "foo", value = "bar") public class OutputWriter implements ContentProcessor {
- Ausgabedateimuster: Geben Sie eine durch Semikolon (;) getrennte Liste von Mustern an, die von einem überwachten Ordner verwendet werden, um den Namen und den Speicherort der Ausgabedateien und Ordner zu bestimmen. Informationen zu Dateimustern finden Sie unter Grundlegendes zu Dateimustern.
-
-
Wählen Sie Erweitert aus. Die Registerkarte „Erweitert“ enthält weitere Felder. Die meisten dieser Felder enthalten einen Standardwert.
-
Payload Mapper-Filter: Wenn Sie einen überwachten Ordner erstellen, wird eine Ordnerstruktur innerhalb des überwachten Ordners erstellt. Die Ordnerstruktur enthält Ordner für Phasen, Ergebnisse, Aufbewahrung, Eingabe und Fehler. Die Ordnerstruktur kann als Eingabe-Payload für den Workflow dienen und die Ausgabe von einem Workflow akzeptieren. Sie kann gegebenenfalls auch Fehlerquellen auflisten. Die Struktur der Nutzdaten unterscheidet sich von der Struktur eines überwachten Ordners anders. Sie können benutzerdefinierte Skripte schreiben, um der Payload die Struktur eines überwachten Ordners zuzuordnen. Ein solches Skript wird als Payload Mapper-Filter bezeichnet. Zwei standardmäßige Payload-Mapper-Implementierungen sind verfügbar. Wenn Sie keine benutzerdefinierte Implementierunghaben, verwenden Sie eine Standard-Implementierung:
- Standard-Mapper: Verwenden Sie den Standard-Payload-Mapper, um den Eingabe- und Ausgabe-Inhalt der überwachten Ordner in separaten Eingabe- und Ausgabeordnern in der Payload zu belassen.
- Einfacher dateibasierter Payload-Mapper: Verwenden Sie den einfachen dateibasierten Payload-Mapper, um Eingabe- und Ausgabe-Inhalte direkt im Nutzdatenordner zu beizubehalten. Es wird keine zusätzliche Hierarchie erstellt, wie z. B. ein Standard-Mapper.
-
Ausführungsmodus: Geben Sie die kommagetrennte Liste der zulässigen Ausführungsmodi für die Ausführung des Workflows an.
-
Zeitüberschreitung für Stage-Dateien nach: Geben Sie die Anzahl Sekunden an, nach denen für eine Eingabedatei/einen Ordner, der bereits zur Verarbeitung abgerufen wurde, eine Zeitüberschreitung eintritt und ein Fehler gemeldet wird. Die Zeitüberschreitungsfunktion wird nur aktiviert, wenn der Wert für diese Eigenschaft eine positive Zahl ist.
-
Stage-Dateien mit Zeitüberschreitung bei Einschränkung löschen: Wenn diese Option aktiviert ist, wird der Mechanismus Zeitüberschreitung für Stage-Dateien nach nur bei aktivierten Einschränkungen für den überwachten Ordner aktiviert.
-
Überprüfen des Eingabeordners alle: Geben Sie das Intervall in Sekunden an, innerhalb dessen der überwachte Ordner auf Eingaben überprüft wird. Außer wenn die Einstellung „Einschränken“ aktiviert ist, muss das Abfrageintervall länger sein als die Verarbeitungsdauer für einen durchschnittlichen Auftrag. Anderenfalls könnte es zu einer Überlastung des Systems kommen. Der Wert für das Intervall muss größer als oder gleich eins sein.
-
Muster für auszuschließende Dateien: Geben Sie eine durch Semikolons (;) getrennte Liste von Mustern an, die von einem überwachten Ordner verwendet werden, um festzulegen, welche Dateien und Ordner überprüft und aufgenommen werden sollen. Alle Dateien oder Ordner, die diesem angegebenen Muster entsprechen, werden nicht für die Verarbeitung überprüft. Informationen zu Dateimustern finden Sie unter Grundlegendes zu Dateimustern.
-
Muster für einzuschließende Dateien: Geben Sie eine durch Semikolon (;) getrennte Liste von Mustern an, die vom überwachten Ordner verwendet wird, um zu ermitteln, welche Ordner und Dateien überprüft und aufgenommen werden sollen. Wenn als Muster für einzuschließende Dateien beispielsweise „input*“ eingegeben wird, werden alle Dateien und Ordner aufgenommen, die „input*“ im Namen enthalten. Der Standardwert ist &ast, der alle Dateien und Ordner bedeutet. Weitere Informationen zu Dateimustern finden Sie unter Grundlegendes zu Dateimustern.
-
Wartezeit: Geben Sie die Zeit in Millisekunden an, die gewartet wird, bevor ein Ordner oder eine Datei nach der Erstellung überprüft wird. Wenn die Wartezeit beispielsweise 3.600.000 Millisekunden (eine Stunde) beträgt und die Datei vor einer Minute erstellt wurde, wird diese Datei frühestens in 59 Minuten abgerufen. Der Standardwert ist 0.
Diese Einstellung ist nützlich, um sicherzustellen, dass der gesamte Inhalt einer Datei oder eines Ordners in den Eingabeordner kopiert wurde. Wenn Sie beispielsweise eine große Datei verarbeiten müssen und das Herunterladen der Datei 10 Minuten dauert, legen Sie die Wartezeit auf 10 x 60 x 1000 Millisekunden fest. Dieses Intervall verhindert, dass der überwachte Ordner die Datei bereits überprüft, wenn sie noch keine 10 Minuten alt ist.
-
Ergebnisse löschen, die älter sind als: Geben Sie die Anzahl der Tage an, nach denen die Dateien und Ordner gelöscht werden, die älter als der angegebene Wert sind. Diese Einstellung ist nützlich, um sicherzustellen, dass der Ergebnisordner nicht voll wird. Ein Wert von „-1“ Tagen bedeutet, dass der Ergebnisordner nie gelöscht wird. Der Standardwert ist -1.
-
Ergebnis-Ordnername: Geben Sie den Namen des Ordners ein, um die Ergebnisse zu speichern. Wenn die Ergebnisse nicht in diesem Ordner angezeigt werden, überprüfen Sie den Fehlerordner. Schreibgeschützte Dateien werden nicht verarbeitet und im Fehlerordner gespeichert. Sie können einen absoluten oder relativen Pfad mit den folgenden Dateimustern verwenden:
- %F = Dateinamenspräfix
- %E = Dateinamenerweiterung
- %Y = Jahr (vollständig)
- %y = Jahr (letzte zwei Stellen)
- %M = Monat
- %D = Tag des Monats
- %d = Tag des Jahres
- %H = Stunde (24-Stunden-Format)
- %h = Stunde (12-Stunden-Format)
- %m = Minute
- %s = Sekunde
- %l = Millisekunde
- %R = Zufallszahl (zwischen 0 und 9)
- %P = Prozess- oder Vorgangs-ID
- Wenn es beispielsweise der 17. Juli 2009, 20 Uhr, ist und Sie „C:/Test/WF0/failure/%Y/%M/%D/%H/“ angeben, ist der Ergebnisordner „C:/Test/WF0/failure/2009/07/17/20“.
- Wenn der Pfad nicht absolut, sondern relativ ist, wird der Ordner innerhalb des überwachten Ordners erstellt. Der Standardwert ist „result/%Y/%M/%D/“, d. h. der Ergebnisordner im überwachten Ordner. Informationen zu Dateimustern finden Sie unter Grundlegendes zu Dateimustern.
-
Fehler-Ordnername: Geben Sie den Ordner an, in dem die Dateien gespeichert sind. Dieser Speicherort ist stets relativ zum überwachten Ordner. Sie können Dateimuster verwenden, wie für den Ergebnisordner beschrieben.
-
„Bewahren“-Ordnername: Der Speicherort, an dem Dateien nach erfolgreicher Überprüfung und Aufnahme gespeichert werden. Dies kann ein absoluter, relativer oder leerer Ordnerpfad sein. Sie können Dateimuster wie für den Ergebnisordner beschrieben verwenden. Der Standardwert ist „preserve/%Y/%M/%D/“.
-
Stapelgröße: Die Anzahl der Dateien oder Ordner, die pro Überprüfung aufgenommen werden. Mit dieser Einstellung können Sie eine Überlastung des Systems verhindern, da das gleichzeitige Überprüfen zu vieler Dateien zu einem Absturz führen kann. Der Standardwert ist 2.
Wenn das Überprüfungsintervall kurz ist, wird der Eingabeordner häufig von den Threads überprüft. Falls häufig Dateien im überwachten Ordner abgelegt werden, sollten Sie ein kurzes Überprüfungsintervall wählen. Wenn Dateien nicht häufig abgelegt werden, sollten Sie ein größeres Überprüfungsintervall einrichten, damit die anderen Dienste die Threads verwenden können.
-
Throttle On: Wenn diese Option aktiviert ist, wird die Anzahl der Aufträge für den überwachten Ordner begrenzt, die AEM Forms zu jeder Zeit verarbeiten kann. Der Wert für die Stapelgröße bestimmt die maximale Anzahl an Aufträgen. Weitere Informationen finden Sie unter Einschränken.
-
Vorhandene Dateien mit ähnlichem Namen überschreiben Bei Festlegung auf „True“ werden Dateien im Ergebnisordner und im Aufbewahrungsordner überschrieben. Bei Festlegung auf „False“ wird an die Namen von Dateien und Ordnern ein numerisches Indexsuffix angehängt. Der Standardwert ist „False“.
-
Dateien bei Fehler beibehalten: Bei Festlegung auf „True“ bleiben Eingabedateien im Falle eines Fehlers erhalten. Der Standardwert lautet true.
-
Dateien mit Muster einbeziehen: Geben Sie eine durch Semikolon (;) getrennte Liste von Mustern an, die vom überwachten Ordner verwendet wird, um zu ermitteln, welche Ordner und Dateien überprüft und aufgenommen werden sollen. Wenn für „Muster für einzuschließende Dateien“ beispielsweise „input“ festgelegt wird, werden alle Dateien und Ordner aufgenommen, die „input“ im Namen enthalten. Weitere Informationen finden Sie in der Administration-Hilfe.
-
Überwachten Ordner asynchron aufrufen: Gibt den Aufruftyp als „asynchron“ oder „synchron“ an. Der Standardwert ist „asynchron“. „Asynchron“ wird für langlebige Prozesse empfohlen, „synchron“ für transiente und kurzlebige Prozesse.
-
Überwachten Ordner aktivieren: Wenn diese Option aktiviert ist, wird der überwachte Ordner aktiviert. Der Standardwert ist „True“.
-
Ändern von Eigenschaften eines vorhandenen überwachten Ordners modify-properties-of-an-existing-watched-folder
Zusätzlich zum Namen des überwachten Ordners können Sie alle Eigenschaften eines vorhandenen überwachten Ordners ändern. Führen Sie die folgenden Schritte aus, um die Eigenschaften eines vorhandenen überwachten Ordners zu ändern:
- Wählen Sie das Symbol Adobe Experience Manager in der oberen linken Ecke des Bildschirms aus.
- Wählen Sie Werkzeuge > Formulare > Überwachten Ordner konfigurieren. Es wird eine Liste der bereits konfigurierten überwachten Ordner angezeigt.
- Wählen Sie auf der linken Seite des Bildschirms des überwachten Ordners den überwachten Ordner und dann Bearbeiten. Eine Liste mit den Feldern, die erforderlich sind, um den überwachten Ordner zu erstellen, wird angezeigt. Die Felder, die auf der Registerkarte Grundeinstellungen aufgeführt sind, sind Pflichtfelder. Die Registerkarte „Erweitert“ enthält weitere Felder. Die meisten dieser Felder enthalten einen Standardwert. Sie können diese Eigenschaften entsprechend Ihren Anforderungen ändern.
- Wenn Sie die Eigenschaften geändert haben, wählen Sie Aktualisieren aus. Die geänderten Eigenschaften werden gespeichert.