Un amministratore può configurare una cartella di rete, nota come cartella controllata, in modo che quando un utente inserisce un file (ad esempio un file PDF) nella cartella esaminata, venga avviata un'operazione preconfigurata e il file venga manipolato. Dopo l'esecuzione dell'operazione specificata, l'operazione salva il file modificato in una cartella di output specificata. Per informazioni dettagliate sull'amministrazione di una cartella esaminata, vedere Guida di amministrazione.
È possibile utilizzare l’interfaccia utente della cartella esaminata per:
Prima di configurare una cartella esaminata, accertatevi di quanto segue:
Per creare una cartella esaminata, effettuate le seguenti operazioni:
Toccate l'icona Adobe Experience Manager nell'angolo superiore sinistro dello schermo.
Toccate Strumenti > Forms > Configura cartella esaminata. Viene visualizzato un elenco di cartelle esaminate già configurate.
Toccate Nuovo. Viene visualizzato un elenco dei campi necessari per creare la cartella esaminata:
Nome: Identifica la cartella esaminata. Utilizzate solo caratteri alfanumerici per il nome.
Percorso: Specifica il percorso della cartella esaminata. In un ambiente cluster, questa impostazione deve puntare a una cartella di rete condivisa accessibile a ogni utente che esegue AEM su nodi diversi di un cluster.
Elabora file utilizzando: Il tipo di processo da avviare. È possibile specificare flusso di lavoro, script o servizio.
Nome servizio/Percorso script/Percorso flusso di lavoro: Il comportamento del campo è basato sul valore specificato per il campo Process Files Using. Potete specificare i seguenti valori:
Se si è selezionato Service per il campo Process Files Using, il valore del campo Service Name(inputProcessorType) deve essere racchiuso tra parentesi. Ad esempio, (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 {
Toccate Avanzate. La scheda avanzata contiene altri campi. La maggior parte di questi campi contiene un valore predefinito.
Filtro Payload Mapper: quando create una cartella esaminata, crea una struttura di cartelle all’interno della cartella esaminata. La struttura delle cartelle contiene le cartelle stage, result, preserve, input e failure. La struttura delle cartelle può fungere da payload di input per il flusso di lavoro e accettare l’output da un flusso di lavoro. Può anche elencare i punti di errore, se presenti. La struttura di un payload è diversa dalla struttura di una cartella controllata. È possibile creare script personalizzati per mappare la struttura di una cartella esaminata al payload. Tale script è denominato filtro di mappatura payload. Sono disponibili due implementazioni di payload mapper out-of-the-box. Se non disponete di un'implementazione personalizzata, utilizzate un'implementazione out-of-the-box:
Modalità di esecuzione: Specificate l'elenco separato da virgole delle modalità di esecuzione consentite per l'esecuzione del flusso di lavoro.
Timeout Dei File In Fase Dopo: Specificate il numero di secondi di attesa prima che un file o una cartella di input già prelevato per l’elaborazione venga trattato come se fosse scaduto e contrassegnato come un errore. Il meccanismo di timeout viene attivato solo quando il valore di questa proprietà è un numero positivo.
Elimina i file in fase di timeout quando vengono ridotti: Se abilitata, il meccanismo Time Out Staged Files Aftermeccanismo è attivato solo quando la limitazione è attivata per la cartella esaminata.
Scansiona cartella di input dopo ogni: specifica l’intervallo di tempo, in secondi, per la scansione della cartella controllata per gli input. A meno che l’impostazione Limita non sia abilitata, l’intervallo di sondaggio deve essere più lungo del tempo necessario per elaborare un processo medio; in caso contrario, il sistema potrebbe sovraccaricarsi. Il valore dell'intervallo deve essere maggiore o uguale a uno.
Escludi pattern file: Specificate un elenco delimitato da punti e virgola (;) di pattern utilizzati da una cartella esaminata per determinare quali file e cartelle analizzare e acquisire. Qualsiasi file o cartella con il pattern specificato non viene sottoposto a scansione per l'elaborazione. Per ulteriori informazioni sui pattern di file, vedere Informazioni sui pattern di file.
Includi pattern file: Specificate un elenco delimitato da punti e virgola (;) di pattern utilizzati dalla cartella esaminata per determinare quali cartelle e file analizzare e acquisire. Ad esempio, se il pattern di file Includi è input*, tutti i file e le cartelle che corrispondono a input* vengono prese. Il valore predefinito è * e indica tutti i file e le cartelle. Per ulteriori informazioni sui pattern di file, vedere Informazioni sui pattern di file.
Tempo di attesa: specificate il tempo, in millisecondi, di attesa prima di eseguire la 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à recuperato dopo che sono passati 59 o più minuti. Il valore predefinito è 0.
Questa impostazione è utile per fare in modo 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 file richiede dieci minuti per il download, impostare il tempo di attesa su 10*60 *1000 millisecondi. Questo intervallo impedisce alla cartella esaminata di eseguire la scansione del file se non ha una durata di dieci minuti.
Elimina risultati precedenti a: specifica il tempo, in numero di giorni, da attendere prima di eliminare i file e le cartelle con un valore maggiore di quello specificato. Questa impostazione è utile per evitare che la cartella dei risultati diventi piena. Un valore pari a -1 giorni indica di non eliminare mai la cartella dei risultati. Il valore predefinito è -1.
Nome cartella risultati: specificate il nome della cartella in cui memorizzare i risultati. Se i risultati non vengono visualizzati in questa cartella, controllare la cartella degli 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 pattern di file:
Nome cartella errore: specificate la cartella in cui vengono salvati i file con errore. Questo percorso è sempre relativo alla cartella esaminata. È possibile utilizzare i pattern di file, come descritto per Cartella risultati.
Mantieni nome cartella: specificate la cartella in cui i file vengono memorizzati dopo la scansione e il prelievo. Il percorso può essere assoluto, relativo o nullo. È possibile utilizzare i pattern di file, come descritto per Cartella risultati. Il valore predefinito è preserve/%Y/%M/%D/.
Dimensione batch: specificare il numero di file o cartelle da acquisire per scansione. impedisce un sovraccarico del sistema; la scansione di troppi file alla volta 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 esaminata, è necessario mantenere l'intervallo di scansione ridotto. Se i file vengono omessi raramente, usate un intervallo di scansione maggiore in modo che gli altri servizi possano usare i thread.
Limita su: quando questa opzione è abilitata, limita il numero di processi di cartelle controllati che AEM i moduli vengono elaborati 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 è impostata su True, i file nella cartella dei risultati e nella cartella preserve vengono sovrascritti. Se è impostata su False, per il nome vengono utilizzati file e cartelle con un suffisso indice numerico. Il valore predefinito è False.
Mantieni file in caso di errore: se è impostata su True, i file di input vengono conservati in caso di errore. Il valore predefinito è true.
Includi file con pattern: specificate un elenco delimitato da punti e virgola (;) di pattern utilizzato dalla cartella esaminata per determinare le cartelle e i file da acquisire e acquisire. Ad esempio, se il pattern di file Includi è input*, tutti i file e le cartelle che corrispondono a input* vengono prese. Per ulteriori informazioni, vedere Guida di amministrazione
Richiama cartella esaminata in modo asincrono: identifica il tipo di chiamata come asincrono o sincrono. Il valore predefinito è asincrono. Asincrona è consigliato per i processi di lunga durata, mentre sincrono è consigliato per i processi transitori o di breve durata.
Abilita cartella esaminata: quando questa opzione è abilitata, la cartella di controllo è abilitata. Il valore predefinito è True.
Oltre a modificare il nome della cartella esaminata, potete modificare tutte le proprietà di una cartella esaminata esistente. Per modificare le proprietà di una cartella esaminata esistente, effettuate le seguenti operazioni: