Erstellen oder konfigurieren Sie einen überwachten Ordner create-or-configure-a-watched-folder

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“.

@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“.