Configurazione degli endpoint e-mail configuring-email-endpoints

Gli endpoint e-mail consentono agli utenti di richiamare un servizio inviando uno o più documenti (come allegati e-mail) a un account e-mail specificato. La posta in arrivo funge da punto di raccolta per gli allegati. Il servizio controlla la casella in entrata ed elabora gli allegati. I risultati della conversione vengono inoltrati all'utente definito nell'endpoint.

Per un endpoint e-mail, gli utenti autorizzati possono richiamare un processo inviando i file all’account appropriato. I risultati verranno restituiti all’utente che ha inviato il messaggio (per impostazione predefinita) o all’utente definito nelle impostazioni dell’endpoint.

Prima di configurare un endpoint e-mail, crea un account e-mail POP3 o IMAP da utilizzare per l’endpoint. Imposta un conto separato per ogni tipo di conversione. Ad esempio, un account può essere configurato per generare documenti PDF standard da allegati di file in arrivo e un altro account può essere configurato per generare documenti PDF protetti.

Tutti gli endpoint e-mail sono configurati con un nome utente e una password autorizzati per la casella in entrata e-mail, necessari quando si richiama il servizio. L’account e-mail è protetto dal sistema del server di posta in cui è configurato.

Se gli utenti inviano documenti con caratteri della lingua dell'Europa occidentale nei nomi dei percorsi di file e conversione, devono utilizzare un'applicazione di posta elettronica che supporti i tipi di codifica richiesti (Latin1 [ISO-8859-1], Western European [Windows] o UTF-8). Per ulteriori informazioni, vedere il documento Installazione e distribuzione di moduli AEM per il server applicazioni.

Prima di configurare un endpoint e-mail, configura il servizio e-mail. (Vedi Configurare le impostazioni predefinite dell'endpoint e-mail.) I parametri di configurazione del servizio e-mail hanno due scopi:

Configurare SSL per un endpoint e-mail configure-ssl-for-an-email-endpoint

È possibile configurare POP3, IMAP o SMTP per utilizzare Secure Sockets Layer (SSL) per un endpoint e-mail.

Configurare le impostazioni predefinite dell’endpoint e-mail configure-default-email-endpoint-settings

È possibile utilizzare la pagina Gestione del servizio per configurare attributi comuni a tutti gli endpoint e-mail e per fornire valori predefiniti per tutti gli endpoint e-mail.

Affinché il flusso di lavoro dei moduli riceva e gestisca i messaggi e-mail in arrivo dagli utenti, è necessario creare un endpoint e-mail per il servizio Completa attività. Questo endpoint di posta elettronica richiede impostazioni aggiuntive, come descritto in Creare un endpoint di posta elettronica per il servizio Attività completo.

Modificare i valori predefiniti per gli endpoint e-mail change-the-default-values-for-email-endpoints

Impostazioni endpoint e-mail predefinito default-email-endpoint-settings

Espressione Cron: Espressione cron utilizzata dal quarzo per pianificare il polling della directory di input.

Intervallo di ripetizione: il numero di volte in cui il polling della directory viene ripetuto. L’intervallo di ripetizione predefinito è in secondi se questo valore non è specificato nella configurazione dell’endpoint. Il valore predefinito è 10. Questo valore non può essere inferiore a 10.

Conteggio ripetizioni: il numero di volte in cui viene eseguito il polling della directory di input. Il conteggio di ripetizioni predefinito da utilizzare se questo valore non è specificato nella configurazione dell’endpoint. Il valore -1 indica l'analisi indefinita della directory. Il valore predefinito è -1.

Ritardo all'avvio del processo: Il valore predefinito, in secondi, per il ritardo prima che il processo inizi la scansione dell'endpoint. Il valore predefinito è 0.

Dimensione batch: il numero di messaggi di posta elettronica elaborati dal ricevitore per scansione per ottenere prestazioni ottimali. Il valore -1 indica tutte le e-mail. Il valore predefinito è 2.

Asincrono: identifica il tipo di chiamata come asincrono o sincrono. I processi transitori e sincroni possono essere richiamati solo in modo sincrono. Il valore predefinito è asincrono.

Pattern di dominio: il modello di nome di dominio utilizzato per filtrare le e-mail in arrivo. Ad esempio, se utilizzi adobe.com, verranno elaborate solo le e-mail da adobe.com; le e-mail da altri domini verranno ignorate.

Pattern file: i pattern di file allegati in ingresso accettati dal provider. Ciò include i file con estensioni specifiche (*.dat, *.xml), nomi specifici (dati) ed espressioni composite nel nome e nell’estensione (.[dD][aA]'porta'). Il valore predefinito è *.*.

Destinatari del processo riuscito: Uno o più indirizzi di posta elettronica utilizzati per inviare e-mail per indicare i processi riusciti. Per impostazione predefinita, un messaggio di processo riuscito viene sempre inviato al mittente del processo iniziale. Sono supportati fino a 100 destinatari. Per disattivare questa impostazione, lasciare vuoto il campo.

Destinatari del processo non riuscito: Uno o più indirizzi di posta elettronica utilizzati per inviare e-mail per indicare i processi non riusciti. Per impostazione predefinita, un messaggio di processo non riuscito viene sempre inviato al mittente che ha inviato il processo iniziale. Sono supportati fino a 100 destinatari. Per disattivare questa impostazione, lasciare vuoto il campo.

Host casella in entrata: Nome host casella in entrata o indirizzo IP per il provider di posta elettronica da analizzare.

Porta posta in arrivo: Numero di porta posta in arrivo per la scansione del provider di posta elettronica. Se il valore è 0, viene utilizzata la porta IMAP o POP3 predefinita.

Protocollo casella in entrata: Protocollo e-mail per l'endpoint e-mail da utilizzare per la scansione della casella in entrata. Le opzioni disponibili sono IMAP o POP3. Il server di posta host della casella in entrata deve supportare questi protocolli.

Timeout casella in entrata: Specifica il tempo di attesa dell'endpoint prima dell'annullamento durante il tentativo di connessione alla casella in entrata. Se una connessione non viene acquisita prima del raggiungimento del valore di timeout, la casella in entrata non verrà sottoposta a polling.

Utente casella in entrata: Il nome utente necessario per accedere all'account di posta elettronica. A seconda del server e della configurazione di e-mail, questo nome può essere solo la parte del nome utente dell’e-mail o l’indirizzo e-mail completo.

Password casella in entrata: la password per l'utente casella in entrata.

SSL POP3/IMAP abilitato: Se selezionata, abilita SSL.

Host SMTP: Il nome host del server di posta elettronica utilizzato dal provider di posta elettronica per inviare risultati e messaggi di errore. Ad esempio, mail.example.com.

Porta SMTP: Porta utilizzata per la connessione al server di posta. Il valore predefinito è 25.

Utente SMTP: l'account utente per il provider di posta elettronica da utilizzare quando invia messaggi di posta elettronica per risultati ed errori.

Password SMTP: la password per l'account SMTP. Alcuni server di posta non richiedono una password SMTP.

Invia da: L'indirizzo di posta elettronica (ad esempio, user@company.com) utilizzato per inviare notifiche e-mail di risultati ed errori. Se non si specifica un valore Invia da, il server di posta elettronica tenta di determinare l'indirizzo di posta elettronica combinando il valore specificato nell'impostazione Utente SMTP con un dominio predefinito configurato sul server di posta elettronica. Se il server di posta elettronica non dispone di un dominio predefinito e non si specifica un valore per Invia da, potrebbero verificarsi degli errori. Per verificare che i messaggi e-mail abbiano l’indirizzo di origine corretto, specifica un valore per l’impostazione Invia da.

SSL SMTP abilitato: Se selezionata, abilita SSL su SMTP.

Includi il corpo dell'e-mail originale come allegato: Per impostazione predefinita, quando si invia un'e-mail al server Forms, il testo originale del messaggio viene incluso nel corpo del messaggio. Per includere il testo come allegato, selezionare questa opzione.

Utilizza l'oggetto originale per le e-mail dei risultati: Per impostazione predefinita, il server Forms utilizza i valori specificati nelle impostazioni Oggetto e-mail riuscito e Oggetto e-mail errore come oggetto per l'invio dei messaggi e-mail dei risultati. Selezionare questa opzione per utilizzare invece la stessa riga dell'oggetto dell'e-mail originale inviata al server.

Oggetto e-mail riuscito: Dopo aver inviato un messaggio e-mail a un endpoint e-mail per avviare o continuare un processo, riceverai un messaggio e-mail di ritorno dal server AEM Forms. Se l’e-mail ha esito positivo, riceverai un’e-mail di successo. Se l’e-mail non riesce, riceverai un’e-mail di errore con l’indicazione del motivo dell’errore. Questa impostazione consente di specificare l’oggetto dei messaggi e-mail di successo inviati per questo endpoint.

Corpo e-mail di successo: Consente di specificare il corpo del testo dei messaggi e-mail di successo inviati per questo endpoint.

Prefisso oggetto e-mail errore: Consente di specificare il testo utilizzato all'inizio della riga dell'oggetto dei messaggi e-mail di errore inviati per questo endpoint.

Oggetto e-mail errore: Consente di specificare l'oggetto dei messaggi e-mail di errore inviati per questo endpoint. Questo testo viene visualizzato dopo il prefisso dell’oggetto e-mail di errore.

Corpo dell'e-mail di errore: Consente di specificare la prima riga nel corpo del testo dei messaggi e-mail di errore inviati per questo endpoint.

Informazioni di riepilogo e-mail: Ogni messaggio di operazione riuscita o di errore include una sezione contenente il testo dell'e-mail originale inviato al server Forms. Questa impostazione specifica il testo visualizzato sopra la sezione.

Convalida Posta in arrivo prima della creazione/aggiornamento dell'endpoint: Quando questa opzione è selezionata, Forms Server verifica se le impostazioni SMTP/POP3 sono corrette prima della creazione dell'endpoint. Quando fai clic su Aggiungi, viene visualizzato un messaggio che indica se l’account della casella in entrata è valido. Se questa opzione non è selezionata, AEM Forms Server crea l’endpoint senza convalidare la casella in entrata.

Codifica set di caratteri: Il formato di codifica da utilizzare per il messaggio di posta elettronica. Il valore predefinito è UTF-8, che verrà utilizzato dalla maggior parte degli utenti al di fuori del Giappone. Gli utenti in un ambiente giapponese possono scegliere ISO2022-JP.

Cartella e-mail inviata non riuscita: Specifica una directory in cui archiviare i risultati se il server di posta SMTP non è operativo.

Impostazioni endpoint e-mail email-endpoint-settings

Utilizza le seguenti impostazioni per configurare un endpoint e-mail.

Nome: Impostazione obbligatoria che identifica l'endpoint. Non includere un carattere < perché tronca il nome visualizzato in Workspace. Se immetti un URL come nome dell’endpoint, accertati che sia conforme alle regole di sintassi specificate in RFC1738.

Descrizione: una descrizione dell'endpoint. Non includere un carattere < perché tronca la descrizione visualizzata in Workspace.

Espressione Cron: Immettere un'espressione cron se l'e-mail deve essere pianificata utilizzando un'espressione cron.

Conteggio ripetizioni: numero di volte che l'endpoint e-mail analizza la cartella o la directory. Il valore -1 indica una scansione indefinita. Il valore predefinito è -1.

Intervallo di ripetizione: la velocità di scansione utilizzata dal destinatario per verificare la posta in arrivo.

Ritardo all'avvio del processo: Tempo di attesa per l'analisi dopo l'avvio del modulo di pianificazione.

Dimensione batch: il numero di messaggi di posta elettronica elaborati dal ricevitore per scansione per ottenere prestazioni ottimali. Il valore -1 indica tutte le e-mail. Il valore predefinito è 2.

Nome utente: Impostazione obbligatoria, ovvero il nome utente utilizzato quando si richiama un servizio di destinazione da un'e-mail. Il valore predefinito è SuperAdmin.

Nome dominio: Impostazione obbligatoria, che rappresenta il dominio dell'utente. Il valore predefinito è DefaultDom.

Pattern dominio: specifica i pattern di dominio delle e-mail in arrivo accettate dal provider. Ad esempio, se utilizzi adobe.com, vengono elaborate solo le e-mail da adobe.com; le e-mail da altri domini vengono ignorate.

Modello file: Specifica i modelli di file allegati in ingresso accettati dal provider. Ciò include i file con estensioni specifiche (*.dat, *.xml), nomi specifici (dati) o espressioni composite nel nome e nell'estensione (*.[dD][aA]'porta').

Destinatari del processo riuscito: un indirizzo e-mail a cui vengono inviati messaggi per indicare i processi riusciti. Per impostazione predefinita, un messaggio di processo riuscito viene sempre inviato al mittente. Se si digita mittente, i risultati e-mail vengono inviati al mittente. Sono supportati fino a 100 destinatari. Specifica destinatari aggiuntivi con indirizzi e-mail, separati da virgole (,).

Per disattivare questa impostazione, lasciare vuota l'impostazione. In alcuni casi, si desidera attivare un processo e non inviare una notifica e-mail del risultato.

Destinatari del processo non riuscito: Un indirizzo e-mail a cui vengono inviati i messaggi per indicare i processi non riusciti. Per impostazione predefinita, un messaggio di processo non riuscito viene sempre inviato al mittente. Se si digita mittente, i risultati e-mail vengono inviati al mittente. Sono supportati fino a 100 destinatari. Specifica destinatari aggiuntivi con indirizzi e-mail, separati da virgole (,).

Per disattivare questa impostazione, lasciare vuota l'impostazione. In alcuni casi, si desidera attivare un processo e non inviare una notifica e-mail del risultato.

Host casella in entrata: Nome host casella in entrata o indirizzo IP per il provider di posta elettronica da analizzare.

Porta Posta in arrivo: Porta utilizzata dal server di posta elettronica. Il valore predefinito per POP3 è 110 e quello per IMAP è 143. Se SSL è abilitato, il valore predefinito per POP3 è 995 e quello per IMAP è 993.

Protocollo casella in entrata: Protocollo e-mail per l'endpoint e-mail da utilizzare per la scansione della casella in entrata. I valori sono IMAP o POP3. Il server di posta host della casella in entrata deve supportare questi protocolli.

Timeout casella in entrata: timeout, in secondi, dell'attesa delle risposte della casella in entrata da parte del provider di posta elettronica.

Utente casella in entrata: il nome utente necessario per accedere all'account di posta elettronica. A seconda del server e della configurazione di e-mail, questo valore può essere solo la parte del nome utente dell’e-mail o l’indirizzo e-mail completo.

Password casella in entrata: la password per l'utente casella in entrata.

SSL POP3/IMAP abilitato: Selezionare questa impostazione per forzare il provider di posta elettronica a utilizzare SSL per la scansione della casella in entrata. Assicurati che il server di posta supporti SSL.

Host SMTP: Il nome host del server di posta elettronica utilizzato dal provider di posta elettronica per inviare risultati e messaggi di errore.

Porta SMTP: Il valore predefinito per la porta SMTP è 25.

Utente SMTP: l'account utente per il provider di posta elettronica da utilizzare quando invia notifiche e-mail di risultati ed errori.

Password SMTP: la password per l'account SMTP. Alcuni server di posta non richiedono una password SMTP.

Invia da: L'indirizzo di posta elettronica (ad esempio, user@company.com) utilizzato per inviare notifiche e-mail di risultati ed errori. Se non si specifica un valore Invia da, il server di posta elettronica tenta di determinare l'indirizzo di posta elettronica combinando il valore specificato nell'impostazione Utente SMTP con un dominio predefinito configurato sul server di posta elettronica. Se il server di posta elettronica non dispone di un dominio predefinito e non si specifica un valore per Invia da, potrebbero verificarsi degli errori. Per verificare che i messaggi e-mail abbiano l’indirizzo di origine corretto, specifica un valore per l’impostazione Invia da.

SSL SMTP abilitato: Selezionare questa impostazione per forzare il provider di posta elettronica a utilizzare SSL per la scansione della casella in entrata. Assicurati che il server di posta supporti SSL.

Cartella e-mail inviata non riuscita: Specifica una directory in cui archiviare i risultati se il server di posta SMTP non è operativo.

asincrono: Quando è impostato su sincrono, tutti i documenti di input vengono elaborati e viene restituita una singola risposta. Quando è impostato su asincrono, viene inviata una risposta per ogni documento elaborato.

Ad esempio, viene creato un endpoint e-mail per un servizio che accetta un singolo documento di Word e restituisce tale documento come file PDF. È possibile inviare un’e-mail alla casella in entrata dell’endpoint contenente più (3) documenti Word. Quando vengono elaborati tutti e tre i documenti, se l’endpoint è configurato come sincrono, viene inviata un’unica e-mail di risposta con tutti e tre i documenti allegati. Se l’endpoint è asincrono, viene inviata un’e-mail di risposta dopo che ogni documento di Word è stato convertito in PDF. Il risultato sono tre e-mail, ciascuna con un singolo allegato PDF.

Il valore predefinito è asincrono.

Includere il corpo dell'e-mail originale come allegato: Per impostazione predefinita, quando si invia un'e-mail al server di Forms, il testo originale del messaggio viene incluso nel corpo del messaggio. Per includere il testo come allegato, selezionare questa opzione.

Utilizza l'oggetto originale per le e-mail dei risultati: Per impostazione predefinita, il server Forms utilizza i valori specificati nelle impostazioni Oggetto e-mail riuscito e Oggetto e-mail errore come oggetto per l'invio dei messaggi e-mail dei risultati. Selezionare questa opzione per utilizzare invece la stessa riga dell'oggetto dell'e-mail originale inviata al server.

Oggetto e-mail riuscito: Dopo aver inviato un messaggio e-mail a un endpoint e-mail per avviare o continuare un processo, riceverai un messaggio e-mail di ritorno dal server AEM Forms. Se l’e-mail ha esito positivo, riceverai un’e-mail di successo. Se l’e-mail non riesce, riceverai un’e-mail di errore con l’indicazione del motivo dell’errore. Questa impostazione consente di specificare l’oggetto dei messaggi e-mail di successo inviati per questo endpoint.

Corpo e-mail di successo: Consente di specificare il corpo del testo dei messaggi e-mail di successo inviati per questo endpoint.

Prefisso oggetto e-mail errore: Consente di specificare il testo utilizzato all'inizio della riga dell'oggetto dei messaggi e-mail di errore inviati per questo endpoint.

Oggetto e-mail errore: Consente di specificare l'oggetto dei messaggi e-mail di errore inviati per questo endpoint. Questo testo viene visualizzato dopo il prefisso dell’oggetto e-mail di errore.

Corpo dell'e-mail di errore: Consente di specificare la prima riga nel corpo del testo dei messaggi e-mail di errore inviati per questo endpoint.

Informazioni di riepilogo e-mail: Ogni messaggio di operazione riuscita o di errore include una sezione contenente il testo dell'e-mail originale inviato al server Forms. Questa impostazione specifica il testo visualizzato sopra la sezione.

Convalida casella in entrata prima di creare/aggiornare l'endpoint: Quando questa opzione è selezionata, Forms Server controlla se le impostazioni SMTP/POP3 sono corrette prima di creare l'endpoint. Quando fai clic su Aggiungi, viene visualizzato un messaggio che indica se l’account della casella in entrata è valido. Se questa opzione non è selezionata, AEM Forms Server crea l’endpoint senza convalidare la casella in entrata.

Nome operazione: Questa impostazione è obbligatoria. Elenco di operazioni che possono essere assegnate all’endpoint e-mail. L'operazione selezionata determina i campi da visualizzare nelle sezioni Mapping parametri di input e Mapping parametri di output.

Mapping parametri di input: utilizzato per configurare l'input necessario per elaborare il servizio e l'operazione. I due tipi di input sono letterali e variabili:

Letterale: L'e-mail utilizza il valore immesso nel campo così come viene visualizzato.

Variabile: è possibile mappare una stringa dall'oggetto, dal corpo, dall'intestazione o dall'indirizzo di posta elettronica del mittente. A tale scopo, utilizzare una delle seguenti parole chiave: %SUBJECT%, %BODY%, %HEADER% o %SENDER%. Se ad esempio si utilizza %SUBJECT%, il contenuto dell'oggetto dell'e-mail verrà utilizzato come parametro di input. Per prelevare gli allegati, immettere un modello di file che l'endpoint e-mail può utilizzare per selezionare i documenti allegati. Se ad esempio si immette *.pdf, verranno selezionati tutti i documenti allegati con estensione pdf. Se si immette *, verrà selezionato qualsiasi documento allegato. L'immissione di example.pdf consente di selezionare qualsiasi documento allegato denominato example.pdf.

Mapping parametri di output: utilizzato per configurare l'output del servizio e dell'operazione. I seguenti caratteri nei valori di mappatura dei parametri di output vengono espansi nel nome file allegato:

%F Rappresenta il nome del file di origine (senza estensione).

%E Rappresenta l'estensione del file di origine.

Qualsiasi occorrenza della barra rovesciata () viene sostituita con %%.

nota ​: se il messaggio di richiesta del servizio include più file allegati, non è possibile utilizzare i parametri %F e %E per la proprietà Output Parameter Mappints dell'endpoint. Se la risposta dei servizi restituisce più allegati, non è possibile specificare lo stesso nome per più allegati. Se non si seguono queste raccomandazioni, il servizio richiamato crea i nomi per i file restituiti e i nomi non sono prevedibili.

Sono disponibili i seguenti valori:

Oggetto singolo: Il provider di posta elettronica non dispone della destinazione della cartella di origine. I risultati vengono restituiti come allegati. Il modello è Result/%F.ps e restituisce Result%%sourcefilename.ps come allegato del nome file.

Elenco: Il modello è Result/%F/ e restituisce Result%%sourcefilename%%file1 come allegato del nome file.

Mappa: Il modello è Result/%F/ e la destinazione di origine è Result%%sourcefilename%%file1 e Result%%sourcefilename%%file2. Se la mappa contiene più oggetti e il modello è Result/%F.ps, gli allegati del file di risposta sono Result%%sourcefilename1.ps (output 1) e Result%%sourcefilename2.ps (output 2).

Creare un endpoint e-mail per il servizio Attività completa create-an-email-endpoint-for-the-complete-task-service

Affinché il flusso di lavoro dei moduli riceva e gestisca i messaggi e-mail in arrivo dagli utenti, è necessario creare un endpoint e-mail per il servizio Completa attività.