Impostare Google Mail (OAuth) per l'importazione di posta elettronica

È possibile configurare il processore di importazione per l'uso di Google Mail OAuth per importare in Content Capture i file allegati ai messaggi di posta elettronica in entrata insieme agli elementi dei messaggi di posta elettronica, ad esempio l'oggetto e il testo del corpo. Ogni messaggio di posta elettronica importato diventa un batch, con gli elementi di posta elettronica, quali gli allegati, il corpo del messaggio o l'intero messaggio di posta elettronica, creati come documenti distinti all'interno del batch.

Di seguito vengono indicate le operazioni da effettuare per impostare l'importazione di posta elettronica Google (con il protocollo OAuth).

Ottenere l'URL di reindirizzamento per creare un'applicazione Google Mail

Per poter configurare un'applicazione Google Mail, sono necessari il nome host di Content Capture e i dettagli dell'URL di autorizzazione dell'istanza di Oracle Content Management a cui si desidera connettersi.

Per ottenere l'URL di reindirizzamento, effettuare le operazioni riportate di seguito.

Collegarsi a Oracle Content Management come amministratore e passare a Content Capture.
Aprire la procedura e andare alla scheda Acquisisci.
Nella tabella Job processore di importazione fare clic su per creare un nuovo job.
Effettuare le operazioni riportate di seguito nella pagina Impostazioni generali.
1. Immettere un nome nel campo Nome job di importazione e un prefisso nel campo Prefisso batch. I batch importati vengono denominati utilizzando il prefisso specificato, seguito da un numero che aumenta per ogni nuovo batch.
2. Assicurarsi che l'impostazione del campo Origine importazione sia Origine posta elettronica.
Nella sezione Protocollo di connessione della pagina Impostazioni origine importazione selezionare Google Mail (OAuth).
Viene visualizzato un URL di reindirizzamento. Copiare questo URL, che ha il formato seguente: https://<nome host>.<nome dominio>.com:<porta>/capture/admin/faces/completeAuthorization. L'URL può contenere o meno una porta. Senza la porta, il formato dell'URL sarebbe il seguente: https://<nome host>.<nome dominio>.com/capture/admin/faces/completeAuthorization

Nota:
Non sottomettere ancora alcun input né uscire da questa pagina. È necessario tornare a questa pagina per configurare Google Mail OAuth dopo aver creato un'applicazione Google Mail e ottenuto l'ID client e il segreto client. I valori ottenuti dovranno essere immessi nei campi ID client e Segreto client.

Configurare un'applicazione Google Mail per l'importazione di posta elettronica

Per configurare un'applicazione Google Mail, effettuare le operazioni riportate di seguito.

Accedere alla console API Google in un'altra finestra del browser.
Nella pagina Manage resources, se sono stati già creati progetti nella console per sviluppatori Google, verrà visualizzata la lista dei progetti creati. Se non lo si è già fatto, effettuare le operazioni riportate di seguito.
1. Fare clic su CREATE PROJECT.
2. Immettere un nome per Project name.
3. Per facilitare l'identificazione del progetto nella console, modificare l'ID progetto facendo clic su EDIT, quindi immettere un ID significativo.
4. Se sono state definite delle risorse o delle cartelle organizzative, è necessario selezionare una posizione. In caso contrario, accettare l'impostazione predefinita e fare clic su CREATE.
  Il progetto verrà creato e si verrà reindirizzati alla lista dei progetti nella console.
Nell'angolo superiore sinistro fare clic su , selezionare APIs & Services, quindi selezionare Dashboard.

Nota:
Se il dashboard dei progetti creati di recente non è visibile, selezionare il progetto dall'elenco a discesa nell'angolo superiore sinistro.
Nella barra laterale sinistra fare clic su Library per accedere alla pagina API Library. Cercare la libreria Gmail API e abilitarla.
Nell'angolo superiore sinistro fare clic su , selezionare APIs & Services, quindi selezionare OAuth consent screen. Scegliere gli utenti di destinazione nella schermata di consenso OAuth, quindi fare clic su CREATE.
Nella scheda OAuth consent screen della pagina Edit app registration, effettuare le operazioni riportate di seguito.
- Nel campo App name immettere il nome del prodotto, ad esempio Gmail App.
- Nell'elenco a discesa User support email selezionare l'indirizzo di posta elettronica per il supporto utenti.
- Scorrere alla sezione Developer contact information e immettere il proprio indirizzo di posta elettronica nel campo Email addresses.
- Fare clic su SAVE AND CONTINUE.
Nella scheda Scopes effettuare le operazioni riportate di seguito.
1. Fare clic su ADD OR REMOVE SCOPES.
2. Nella sezione Update selected scopes selezionare le caselle di controllo per gli ambiti GMail API seguenti oppure immettere manualmente questi scopi nella casella Manually add scopes e fare clic su ADD TO TABLE. Fare clic su UPDATE.
3. Fare clic su SAVE AND CONTINUE.
  Gli ambiti userinfo.email e userinfo.profile sono visualizzati nella sezione Your non-sensitive scopes e l'ambito gmail.modify _è visualizzato nella sezione Your restricted scopes della scheda Scopes.
Nella scheda Test users fare clic su SAVE AND CONTINUE.
Nella scheda Summary è possibile rivedere le impostazioni; al termine, fare clic su BACK TO DASHBOARD.
Sotto Publishing Status, nella sezione Testing, fare clic su PUBLISH APP, quindi fare clic su CONFIRM nella finestra di dialogo Push to production? per pubblicare l'applicazione.
Nella barra laterale sinistra fare clic su Credentials ed effettuare le operazioni riportate di seguito.
1. Nella pagina Credentials fare clic su CREATE CREDENTIALS e selezionare OAuth client ID.
2. Nell'elenco a discesa Application type selezionare Web application.
3. Assegnare un nome al client, ad esempio Gmail OAuth App Client.
4. In Authorized redirect URIs fare clic su ADD URI e incollare l'URL di reindirizzamento copiato dalla procedura Content Capture.
5. In Authorized JavaScript origins fare clic su ADD URI e incollare l'URL di reindirizzamento, ma rimuovere tutto ciò che segue il nome del dominio oppure il numero di porta se l'URI include una porta.
6. Fare clic su CREATE.
  I valori ID client e Segreto client sono visualizzati nella finestra di dialogo OAuth client created. Prendere nota di questi valori e fare clic su OK.
  
  Tornare a Content Capture in Oracle Content Management e iniziare da dove si era lasciato. In altre parole, iniziare con l'immissione dell'ID e del segreto client per configurare Google Mail OAuth.

Configurare Google Mail OAuth per l'importazione di posta elettronica Capture

Per configurare le impostazioni del job processore di posta elettronica Google Mail OAuth, effettuare le operazioni riportate di seguito.

Tornare alla procedura di acquisizione e iniziare da dove si era lasciato.
Nella scheda Account di posta elettronica è stato selezionato il protocollo di connessione Google Mail (OAuth). Ora immettere l'ID e il segreto client copiati durante la configurazione dell'applicazione Google Mail nei campi ID client e Segreto client.
Nella tabella Account di posta elettronica da elaborare fare clic su .
Per concedere al job processore di posta elettronica l'accesso all'account di posta elettronica, nella pagina di collegamento di Google Mail immettere l'indirizzo di posta elettronica e la password dell'ID di posta elettronica che si prevede di utilizzare.
Confermare le scelte facendo clic su Consenti.

L'ID di posta elettronica è visualizzato nella tabella Account di posta elettronica da elaborare nella colonna Indirizzi di posta elettronica. Lo stato dell'identificativo deve essere Verificato.

È possibile aggiungere altri ID di Google Mail nella tabella utilizzando la procedura seguita finora. Per eliminare un ID di posta elettronica, selezionarne la riga nella tabella e fare clic su .
Nella scheda Filtri messaggio specificare dove e secondo quali modalità cercare i messaggi di posta elettronica e/o gli allegati.
1. Nel campo Cartelle da elaborare immettere una o più cartelle da cercare negli account di posta elettronica specificati. Il valore predefinito è la cartella della posta in entrata del server. Per specificare più cartelle, separarle con un punto e virgola (;). Per specificare le sottocartelle, includere un delimitatore di percorso valido per il server di posta, ad esempio una barra (/), come in cartella/sottocartella.
2. Per impostazione predefinita, Content Capture elabora tutti i messaggi di posta elettronica nella cartella specificata, a meno che non sia stato applicato un filtro messaggio al Job. Facoltativamente, nella tabella Filtri messaggio selezionare il campo Abilitato per ogni elemento di posta elettronica da cercare, quindi immettere i caratteri da trovare nel campo Il campo contiene.
  
  Ad esempio, per cercare i messaggi di posta elettronica il cui oggetto o corpo contiene la parola pagamento, selezionare Abilitato per entrambi i campi di ricerca, includere pagamento in ogni voce Il campo contiene, quindi selezionare l'operatore di ricerca Or.
3. Nel campo Operatore di ricerca selezionare l'operatore di ricerca da usare per i filtri messaggio specificati: And (impostazione predefinita) esegue l'importazione solo se corrispondono tutti i criteri di ricerca, mentre Or esegue l'importazione se corrisponde uno qualsiasi dei criteri di ricerca.
Nella scheda Elaborazione specificare le modalità di elaborazione dei messaggi di posta elettronica e dei relativi allegati. È possibile specificare le informazioni da includere e la priorità da assegnare ai batch, in base alla priorità di posta elettronica.
1. In Opzioni messaggio di posta elettronica specificare se è necessario importare il file del corpo del messaggio. Specificare il formato di importazione (testo o EML) e se il file deve essere incluso quando non è presente alcun allegato nonché se l'intero messaggio di posta elettronica (inclusi gli allegati) deve essere importato come file EML.
2. Nel campo Includi allegati corrispondenti a queste maschere specificare i file degli allegati da includere in base alle relative maschere. È possibile immettere più maschere file separate da un virgola a da un punto e virgola. Ad esempio, è possibile includere tutti i file PDF (*.pdf).
3. Nel campo Escludi allegati corrispondenti a queste maschere specificare i file degli allegati da escludere in base alle relative maschere. È possibile immettere più maschere file separate da un virgola a da un punto e virgola.
4. Facoltativamente, selezionare Esegui sempre post-elaborazione se gli allegati non corrispondono alle maschere, Includi allegati corrispondenti a queste maschere ed Escludi allegati corrispondenti a queste maschere. Se questo campo è abilitato e gli allegati non corrispondono alle maschere specificate, l'importazione dei messaggi di posta elettronica viene considerata come non riuscita e viene eseguita la post-elaborazione in base alle impostazioni specificate nel campo In caso di importazione non riuscita della scheda Post-elaborazione.
  
  Nota:
  Il campo Esegui sempre post-elaborazione se gli allegati non corrispondono alle maschere è disabilitato se entrambi i campi Importa file corpo messaggio e Includi se non esiste alcun allegato sono abilitati.
5. In Ordinamento documento specificare il criterio in base al quale gli elementi (ad esempio, il corpo del messaggio e gli allegati) di un messaggio di posta elettronica devono essere ordinati come documenti nei batch importati.
6. In Includi in nota batch selezionare gli elementi del messaggio (ad esempio Data/ora ricezione, Indirizzo del mittente, Indirizzo di destinazione, Oggetto e Corpo messaggio).
7. In Priorità batch assegnare facoltativamente una priorità a ogni nuovo batch in base alla relativa priorità di posta elettronica (Bassa, Normale o Alta). Ad esempio, immettere 8 nel campo Alta per assegnare ai messaggi di posta elettronica con priorità Alta la priorità batch 8 in Content Capture. I messaggi di posta elettronica ai quali non è stata assegnata una priorità specifica vengono elaborati con la priorità Normale.
Nella scheda Post-elaborazione specificare in che modo vengono elaborati i messaggi di posta elettronica a seconda dell'esito, riuscita o non riuscita, dell'importazione. È possibile eliminare i messaggi, spostarli in una cartella specifica all'interno dell'account di posta elettronica oppure, in caso di importazione non riuscita, impedire l'eliminazione dei messaggi. Ad esempio, se il job viene eseguito periodicamente, è possibile evitare che i messaggi di posta elettronica importati correttamente vengano importati di nuovo spostandoli in una cartella specificata.
Completare le altre pagine del job processore di importazione come descritto in Aggiungere o modificare un job processore di importazione.

Ora è possibile seguire i test del job di importazione di posta elettronica. Il processore di importazione controlla gli account di posta elettronica configurati per verificare la presenza di messaggi ed effettua una ricerca nelle cartelle per individuare i messaggi di posta elettronica corrispondenti. Se trova messaggi di posta elettronica corrispondenti, il processore di importazione crea un batch di Content Capture e un documento per ogni documento importato dal messaggio di posta elettronica. Facoltativamente, il processore di importazione inserisce i metadati di posta elettronica nel campi dei metadati ed elimina o sposta in un'altra cartella i messaggi con importazione riuscita.

Content Capture recupera periodicamente i messaggi di posta elettronica dall'account di posta elettronica configurato nella scheda Account di posta elettronica. Se tuttavia si desidera attivare l'importazione di posta elettronica a una certa ora, selezionare un job di importazione di posta elettronica nella tabella Job processore di importazione e fare clic sull'icona . Questa icona è disabilitata se il job di importazione di posta elettronica non è in linea.