Creare o configurare una cartella controllata create-or-configure-a-watched-folder

Seleziona l'icona Adobe Experience Manager nell'angolo superiore sinistro dello schermo.

Seleziona Strumenti > Forms > Configura cartella controllata. Viene visualizzato un elenco delle cartelle già configurate.

Seleziona Nuovo. Viene visualizzato un elenco dei campi necessari per creare la cartella controllata:

• Nome: identifica la cartella controllata. Utilizza solo caratteri alfanumerici per il nome.

• Percorso: specifica il percorso della cartella controllata. In un ambiente cluster, questa impostazione deve puntare a una cartella di rete condivisa accessibile a tutti gli utenti che eseguono AEM su nodi diversi di un cluster.

• Elabora file tramite: tipo di processo da avviare. Puoi specificare flusso di lavoro, script o servizio.

• Nome servizio/Percorso script/Percorso flusso di lavoro: il comportamento del campo si basa sul valore specificato per il campo File di processo che utilizzano. È possibile specificare i seguenti valori:

  • Per Flusso di lavoro, specifica il modello di flusso di lavoro da eseguire. Ad esempio, /etc/workflow/models/<nome_flusso di lavoro>/jcr:content/model
  • Per Script, specifica il percorso JCR dello script da eseguire. Ad esempio, /etc/watchfolder/test/testScript.ecma
  • Per Servizio, specifica il filtro utilizzato per individuare un servizio OSGi. Il servizio è registrato come implementazione dell’interfaccia com.adobe.aemfd.watchfolder.service.api.ContentProcessor. Ad esempio, il codice seguente è un’implementazione personalizzata dell’interfaccia ContentProcessor con una proprietà personalizzata (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 {

• Pattern file di output: specificare un elenco delimitato da punti e virgola (;) dei pattern utilizzati da una cartella controllata per determinare il nome e il percorso dei file e delle cartelle di output. Per ulteriori informazioni sui modelli di file, vedere Informazioni sui modelli di file.

Seleziona Avanzate. La scheda avanzata contiene altri campi. La maggior parte di questi campi contiene un valore predefinito.

• Filtro mappatore payload: Quando si crea una cartella controllata, viene creata una struttura di cartelle all'interno della cartella controllata. La struttura di cartelle include cartelle di staging, risultato, conservazione, input e errore. La struttura di cartelle può fungere da payload di input per il flusso di lavoro e accettare l’output da un flusso di lavoro. Può anche elencare eventuali punti di errore. La struttura di un payload è diversa da quella di una cartella controllata. Puoi scrivere script personalizzati per mappare la struttura di una cartella controllata al payload. Tale script è denominato filtro di mappatura payload. Sono disponibili due implementazioni predefinite per la mappatura del payload. Se non disponi di un'implementazione personalizzata, utilizza un'implementazione preconfigurata:

  • Mapper predefinito: Utilizza il mapper del payload predefinito per mantenere i contenuti di input e output delle cartelle controllate in cartelle di input e output separate nel payload.
  • Mappatore payload semplice basato su file: Utilizzare il mapper payload semplice basato su file per mantenere i contenuti di input e output direttamente nella cartella del payload. Non crea alcuna gerarchia aggiuntiva, come l’mappatore predefinito.

• Modalità di esecuzione: specificare l'elenco separato da virgole delle modalità di esecuzione consentite per l'esecuzione del flusso di lavoro.

• Timeout file di staging dopo: specificare il numero di secondi di attesa prima che un file o una cartella di input già raccolti per l'elaborazione venga considerato come scaduto e contrassegnato come errore. Il meccanismo di timeout si attiva solo quando il valore di questa proprietà è un numero positivo.

• Elimina file di staging con timeout con limitazione: se attivato, il meccanismo Esegui timeout file di staging dopo viene attivato solo quando la limitazione è attivata per la cartella controllata.

• Scansiona cartella di input ogni: Specificare l'intervallo di tempo, in secondi, per la ricerca di input nella cartella controllata. Se l'impostazione Limitazione non è abilitata, l'intervallo di polling deve essere più lungo del tempo necessario per elaborare un processo medio. In caso contrario, il sistema potrebbe sovraccaricare. Il valore dell'intervallo deve essere maggiore o uguale a uno.

• Escludi pattern file: specificare un elenco delimitato da punti e virgola (;) di pattern utilizzati da una cartella controllata per determinare quali file e cartelle analizzare e raccogliere. Qualsiasi file o cartella con il modello specificato non viene analizzato per l'elaborazione. Per ulteriori informazioni sui modelli di file, vedere Informazioni sui modelli di file.

• Includi pattern file: specificare un elenco delimitato da punti e virgola (;) di pattern utilizzati dalla cartella controllata per determinare quali cartelle e file analizzare e raccogliere. Ad esempio, se il modello di file di inclusione è input*, vengono selezionati tutti i file e le cartelle che corrispondono a input*. Il valore predefinito è * e indica tutti i file e le cartelle. Per ulteriori informazioni sui modelli di file, vedere Informazioni sui modelli di file.

• Tempo di attesa: Specificare il tempo, in millisecondi, di attesa prima della scansione di una cartella o di un file dopo la creazione. Ad esempio, se il tempo di attesa è di 3.600.000 millisecondi (un’ora) e il file è stato creato un minuto fa, questo file verrà acquisito dopo 59 o più minuti. Il valore predefinito è 0.

  Questa impostazione è utile per garantire che tutto il contenuto del file o della cartella venga copiato nella cartella di input. Ad esempio, se si dispone di un file di grandi dimensioni da elaborare e il download richiede dieci minuti, impostare il tempo di attesa su 10*60 *1000 millisecondi. Questo intervallo impedisce alla cartella controllata di eseguire la scansione del file se non ha dieci minuti.

• Elimina risultati precedenti a: Specificare il tempo, in numero di giorni, di attesa prima dell'eliminazione dei file e delle cartelle precedenti al valore specificato. Questa impostazione è utile per garantire che la cartella dei risultati non sia piena. Un valore pari a -1 giorni indica di non eliminare mai la cartella dei risultati. Il valore predefinito è -1.

• Nome cartella risultati: Specificare il nome della cartella in cui archiviare i risultati. Se i risultati non vengono visualizzati in questa cartella, selezionare la cartella con errori. I file di sola lettura non vengono elaborati e vengono salvati nella cartella degli errori. È possibile utilizzare un percorso assoluto o relativo con i seguenti modelli di file:

  • %F = prefisso nome file
  • %E = estensione del nome file
  • %Y = anno (completo)
  • %y = anno (ultime due cifre)
  • %M = mese
  • %D = giorno del mese
  • %d = giorno dell'anno
  • %H = ora (24 ore)
  • %h = ora (12 ore)
  • %m = minuto
  • %s = secondo
  • %l = millisecondi
  • %R = numero casuale (tra 0 e 9)
  • %P = ID processo o processo
  • Ad esempio, se sono le 20:00 del 17 luglio 2009 e si specifica C:/Test/WF0/failure/%Y/%M/%D/%H/, la cartella dei risultati sarà C:/Test/WF0/failure/2009/07/17/20.
  • Se il percorso non è assoluto ma relativo, la cartella viene creata all’interno della cartella controllata. Il valore predefinito è result/%Y/%M/%D/, ovvero la cartella Result all'interno della cartella controllata. Per ulteriori informazioni sui modelli di file, vedere Informazioni sui modelli di file.

• Nome cartella errore: Specificare la cartella in cui vengono salvati i file non riusciti. Questo percorso è sempre relativo alla cartella controllata. È possibile utilizzare i modelli di file, come descritto per Cartella risultati.

• Mantieni nome cartella: Specificare la cartella in cui sono archiviati i file dopo l'analisi e il prelievo completati. Il percorso può essere una directory assoluta, relativa o null. È possibile utilizzare i modelli di file, come descritto per Cartella risultati. Il valore predefinito è preserve/%Y/%M/%D/.

• Dimensione batch: Specificare il numero di file o cartelle da prelevare per analisi. Impedisce un sovraccarico sul sistema; la scansione di troppi file contemporaneamente può causare un arresto anomalo. Il valore predefinito è 2.

  Se l'intervallo di scansione è ridotto, i thread eseguono spesso la scansione della cartella di input. Se i file vengono rilasciati frequentemente nella cartella controllata, è necessario mantenere l'intervallo di scansione ridotto. Se i file vengono eliminati raramente, utilizzare un intervallo di scansione più ampio in modo che gli altri servizi possano utilizzare i thread.

• Limitazione attivata: Quando questa opzione è abilitata, limita il numero di processi delle cartelle controllate che l'AEM elabora in un dato momento. Il valore Dimensione batch determina il numero massimo di processi. Per ulteriori informazioni, vedere limitazione

• Sovrascrivi file esistenti con nome simile: se è impostato su True, i file presenti nella cartella dei risultati e nella cartella di conservazione vengono sovrascritti. Se è impostato su False, vengono utilizzati file e cartelle con un suffisso di indice numerico per il nome. Il valore predefinito è False.

• Mantieni file in caso di errore: Se è impostato su True, i file di input vengono conservati in caso di errore. Il valore predefinito è true.

• Includi file con pattern: Specificare un elenco delimitato da punti e virgola (;) dei pattern utilizzati dalla cartella controllata per determinare quali cartelle e file analizzare e raccogliere. Ad esempio, se viene immesso il Pattern di inclusione file, vengono selezionati tutti i file e le cartelle che corrispondono all'input. Per ulteriori informazioni, vedere Guida per l'amministrazione

• Richiama cartella controllata in modo asincrono: identifica il tipo di chiamata come asincrona o sincrona. Il valore predefinito è asincrono. L'asincronia è consigliata per i processi di lunga durata, mentre la sincronia è consigliata per i processi transitori o di breve durata.

• Abilita cartella controllata: Quando questa opzione è abilitata, la cartella di controllo è abilitata. Il valore predefinito è True.