Configurare Google Mail (OAuth) pentru import e-mail

Puteţi configura setările jobului procesor de import pentru a utiliza Google Mail cu protocol OAuth, pentru a importa în Content Capture fişiere ataşate la mesajele de e-mail primite, împreună cu elemente ale mesajului precum subiectul şi corpul mesajului. Fiecare mesaj de e-mail importat devine un set, cu elemente de e-mail precum ataşamentele, corpul mesajului sau întregul mesaj de e-mail, create ca documente separate în cadrul setului.

Obţinerea URL-ului de redirecţionare pentru crearea unei aplicaţii Google Mail

Pentru a putea configura o aplicaţie Google Mail, aveţi nevoie de numele gazdei Content Capture şi de detaliile URL-ului de autorizare a instanţei Oracle Content Management la care doriţi să vă conectaţi.

Pentru a obţine adresa URL de redirecţionare:

  1. Conectaţi-vă la Oracle Content Management, ca administrator iar acum treceţi la capturarea conţinutului
  2. Deschideţi procedura şi accesaţi fila Captare.
  3. În tabelul Joburi procesor de import, faceţi clic pe Adăugaţi jobul procesor de import pentru a crea un nou job.

  4. În pagina Setări generale:
    1. Introduceţi un nume în câmpul Nume job import şi un prefix în câmpul Prefix set. Seturile importate sunt denumite utilizând acest prefix, urmat de un număr care se incrementează cu fiecare set nou.
    2. În câmpul Sursă de import, asiguraţi-vă că selectaţi Sursă e-mail.
  5. În pagina Setări sursă import, în secţiunea Protocol conexiune selectaţi Google Mail (OAuth).

    Se afişează o adresă URL de redirecţionare. Copiaţi acest URL al cărui format este https://<hostname>.<domainname>.com:<port>/capture/admin/faces/completeAuthorization. Adresa dvs. URL poate avea sau nu un port. Fără un port, adresa URL ar trebui să fie în acest format: https://<hostname>.<domainname>.com/capture/admin/faces/completeAuthorization

    Notă:

    Nu trimiteţi încă intrările şi nici nu navigaţi dincolo de această pagină. Este necesar să reveniţi la această pagină şi să configuraţi Google Mail OAuth, după ce aţi creat o aplicaţie Google Mail şi aţi obţinut ID-ul de client şi secretul pentru client. Le veţi introduce în câmpurile ID client şi Secret client.

Configurarea unei aplicaţii Google Mail pt. importul de e-mailuri

Pt. a configura o aplicaţie Google Mail:

  1. Accesaţi Google APIs console într-o altă fereastră a browserului.
  2. În pagina Manage resources, veţi vedea o listă a proiectelor dvs. dacă le-aţi creat deja în Google Developers Console. Dacă nu aţi făcut deja acest lucru, efectuaţi următoarele:
    1. Faceţi clic pe CREATE PROJECT.
    2. Introduceţi un Project name.
    3. Pentru a vă ajuta să vă identificaţi cu uşurinţă proiectul în consolă, editaţi Project ID făcând clic pe EDIT şi introducând un ID relevant.
    4. Este necesar să selectaţi o locaţie, dacă aţi definit resurse sau foldere organizaţionale. Dacă nu, acceptaţi valoarea prestabilită şi faceţi clic pe CREATE.

      Proiectul dvs. va fi creat şi veţi fi redirecţionat către lista dvs. de proiecte din consolă.

  3. În colţul de sus din stânga, faceţi clic pe Pictograma de navigare pentru dezvoltatorul Google, selectaţi APIs & Services şi apoi selectaţi Dashboard.

    Notă:

    Dacă nu vizualizaţi dasboardul cu proiectul creat recent, selectaţi proiectul dvs. în lista derulantă din colţul de sus din stânga.
  4. În bara laterală din partea stângă, faceţi clic pe Library pentru a accesa pagina API Library. Apoi căutaţi biblioteca Gmail API şi activaţi-o.
  5. În colţul de sus din stânga, faceţi clic pe Pictograma de navigare pentru dezvoltatorul Google, selectaţi APIs & Services şi apoi OAuth consent screen. Alegeţi utilizatorii vizaţi din ecranul OAuth consent screen, apoi faceţi clic pe CREATE.
  6. Pe pagina Edit app registration, din fila OAuth consent screen:
    • În câmpul App name introduceţi numele produsului dvs., de exemplu, Aplicaţie Gmail.
    • În lista derulantă User support email, selectaţi adresa de e-mail prin care veţi primi solicitări de suport de la utilizatori.
    • Derulaţi în jos la secţiunea Developer contact information şi în câmpul Email addresses introduceţi adresa dvs. de e-mail.
    • Faceţi clic pe SAVE AND CONTINUE.
  7. Pe fila Scopes:
    1. Faceţi clic pe ADD OR REMOVE SCOPES.
    2. În secţiunea Update selected scopes, fie selectaţi casetele de validare pentru următoarele domenii GMail API, fie introduceți manual aceste domenii în caseta Manually add scopes şi faceţi clic pe ADD TO TABLE. Apoi faceţi clic pe UPDATE.
    3. Faceţi clic pe SAVE AND CONTINUE.

      Domeniile userinfo.email şi userinfo.profile sunt afişate în secţiunea Your non-sensitive scopes, iar domeniul gmail.modify este afişat în secţiunea Your restricted scopes din fila Scopes.

  8. În fila Test users, faceţi clic pe SAVE AND CONTINUE.
  9. Pe fila Summary vă puteţi examina setările şi apoi faceţi clic pe BACK TO DASHBOARD.
  10. Sub Publishing Status, în secţiunea Testing faceţi clic pe PUBLISH APP şi apoi în dialogul Push to production? faceţi clic pe CONFIRM pentru a publica aplicaţia.
  11. În bara laterală din stânga, faceţi clic pe Credentials şi apoi efectuaţi următoarele:
    1. În pagina Credentials, faceţi clic pe CREATE CREDENTIALS şi apoi selectaţi OAuth client ID.
    2. În lista derulantă Application type selectaţi Web application.
    3. Denumiţi clientul, de exemplu, Client aplicaţie OAuth Gmail.
    4. În Authorized redirect URIs, faceţi clic pe ADD URI şi lipiţi URL-ul de redirecţionare pe care l-aţi copiat din procedura Content Capture pe care o aveţi.
    5. În Authorized JavaScript origins, faceţi clic pe ADD URI şi lipiţi URL-ul de redirecţionare, dar eliminaţi tot ce există după domeniu sau după port, dacă URI-ul dvs. include un port.
    6. Faceţi clic pe CREATE.

      Valorile pentru ID client şi Secret client pe care le aveţi sunt afişate în dialogul OAuth client created. Notaţi undeva aceste valori şi apoi faceţi clic pe OK.

      Acum reveniţi la captură conţinut din Oracle Content Management şi începeţi de unde aţi rămas. Adică, începeţi prin introducerea valorilor pentru ID client şi Secret client pentru a putea să configuraţi Google Mail OAuth.

Configurarea Google Mail OAuth pentru import de e-mail în Capture

Pentru a configura setările jobului procesor de import de e-mail din Google Mail cu protocol OAuth:

  1. Reveniţi la procedura Capture şi începeţi de unde aţi rămas.
  2. Pe fila Conturi de e-mail, aţi selectat protocolul de conexiune Google Mail (OAuth). Acum, introduceţi ID-ul clientului şi secretul pe care le-aţi copiat la momentul când aţi făcut configurarea aplicaţiei Google Mail pe care o aveţi, în câmpurile ID client şi Secret client.
  3. În tabelul Conturi de e-mail de procesat, faceţi clic pe Adăugaţi un cont de e-mail.

  4. Pentru a furniza jobului procesor de e-mail un acces la contul de e-mail, pe pagina de autentificare la Google Mail, introduceţi adresa de e-mail şi parola ID-lui de e-mail pe care îl veţi utiliza.

  5. Confirmaţi-vă opţiunile, făcând clic pe Permitere.

    ID-ul de e-mail este afişat în tabelul Conturi de e-mail de procesat în coloana Adrese de e-mail. Starea sa ar trebui să fie Verificat.

    Puteţi adăuga mai multe ID-uri Google Mail în acest tabel, utilizând paşii pe care i-aţi urmat până acum. Pentru a şterge un ID de e-mail, selectaţi rândul acestuia în tabel şi apoi faceţi clic pe Ştergere ID de e-mail.

  6. Pe fila Filtre pt. mesaje, specificaţi unde şi cum să se caute mesajele de e-mail şi/sau ataşamentele

    1. În câmpul Foldere de procesat, introduceţi unul sau mai multe foldere de căutat în conturile de e-mail specificate. Valoarea prestabilită este cutia Inbox a serverului. Pentru a specifica mai multe foldere, separaţi-le cu un caracter ; (punct şi virgulă). Pentru a specifica subfoldere, includeţi un delimitator de cale aplicabil pentru serverul de e-mail, cum ar fi o bară oblică la dreapta / (forward slash), ca în folder/subfolder.

    2. În mod prestabilit, Content Capture procesează toate e-mailurile din folderul specificat, cu excepţia cazului în care jobului respectiv i se aplică un filtru de mesaje. Opţional, în tabelul Filtre pt. mesaje selectaţi câmpul Activat pentru fiecare element de e-mail de căutat, apoi introduceţi caracterele de găsit în câmpul Câmpul conţine.

      De exemplu, pentru a căuta e-mailuri al căror subiect sau corp al mesajului conţine cuvântul plată, ar trebui să selectaţi Activat pentru ambele câmpuri de căutare, să includeţi plată în fiecare intrare Câmpul conţine şi să selectaţi operatorul de căutare Sau.

    3. În câmpul Operator de căutare, selectaţi operatorul de căutare care va fi utilizat pentru filtrele de mesaje specificate: Şi (prestabilit) care face importul numai dacă toate criteriile de căutare corespund, în timp ce Sau face importul dacă oricare dintre criteriile de căutare corespund.

  7. Pe fila Procesare, specificaţi modul de procesare a mesajelor de e-mail şi a ataşamentelor acestora. Puteţi specifica informaţiile care trebuie incluse şi prioritatea pe care trebuie să o asignaţi seturilor, în funcţie de prioritatea e-mailului.

    1. La Opţiuni mesaj de e-mail, specificaţi dacă trebuie importat fişierul cu corpul mesajului. Specificaţi formatul de import al acestuia (text sau EML) şi dacă acesta ar trebui să fie inclus atunci când nu există ataşamente şi dacă întregul mesaj de e-mail (inclusiv ataşamentele) ar trebui să fie importat ca un fişier EML.

    2. În câmpul Includere ataşamente care corespund acestor măşti, specificaţi fişierele din ataşament în funcţie de măştilor lor de fişiere. Puteţi introduce mai multe măşti de fişiere, separate prin virgulă sau punct şi virgulă. De exemplu, puteţi include toate fişierele PDF (*.pdf).

    3. În câmpul Excludere ataşamente care corespund acestor măşti, specificaţi fişierele din ataşament care trebuie excluse în funcţie de măştilor lor de fişiere. Puteţi introduce mai multe măşti de fişiere, separate prin virgulă sau punct şi virgulă.

    4. Opţional, selectaţi Se post-procesează întotdeauna când ataşamentele nu corespund măştilor, Includere ataşamente care corespund acestor măşti şi Excludere ataşamente care corespund acestor măşti. Dacă acest câmp este activat şi atașamentele nu corespund măştilor specificate, atunci importul e-mailului este considerat nereuşit şi este post-procesat în conformitate cu setările pe care le specificaţi sub câmpul La importul eşuat din fila Postprocesare.

      Notă:

      Câmpul Se post-procesează întotdeauna când ataşamentele nu corespund măştilor este dezactivat, atunci când ambele câmpuri Import fişier corp mesaj şi Includere când nu există ataşamente sunt activate în acelaşi timp.
    5. La Ordonare documente, specificaţi ordinea în care elementele (de exemplu, corpul mesajului şi ataşamentele) dintr-un mesaj de e-mail trebuie să fie ordonate ca documente în seturile importate.

    6. Sub Includere în notă set, selectaţi elementele mesajului (cum ar fi Dată/Oră primire, Adresă expeditor, Adresă destinatar, Subiect şi Corp mesaj).

    7. La Prioritate set, asignaţi opţional o prioritate fiecărui set nou, pe baza priorităţii mesajelor sale de e-mail (scăzută, normală sau ridicată). De exemplu, introduceţi 8 în câmpul Ridicată pentru a asigna e-mailurilor cu prioritate ridicată, o prioritate de 8 pentru set în Content Capture. E-mailurile la care nu s-a asignat nicio prioritate sunt considerate cu prioritate normală.

  8. Pe fila Postprocesare, specificaţi ce se întâmplă cu mesajele de e-mail după ce importul a reuşit sau a eşuat. Puteţi şterge mesaje, le puteţi muta într-un folder specificat din contul de e-mail sau, în cazul unui import nereuşit, puteţi împiedica ştergerea mesajelor. De exemplu, dacă jobul este executat în mod regulat, este posibil să împiedicaţi importul din nou al e-mailurilor importate cu succes, mutându-le într-un folder specificat.

  9. Completaţi alte pagini ale jobului procesor de import, conform descrierii din Adăugarea sau editarea unui job procesor de import.

Acum puteţi testa jobul de import e-mail. Procesorul de import verifică mesajele conturilor de e-mail configurate şi caută foldere pentru e-mailurile corespunzătoare. Dacă se găsesc e-mailuri corespunzătoare, procesorul de import creează un set pentru Content Capture şi un document pentru fiecare document importat din mesajul de e-mail. Opţional, procesorul de import populează câmpurile de metadate cu metadate din e-mail şi şterge mesajele importate cu succes sau le mută într-un folder.

Periodic, Content Capture preia e-mailurile din contul de e-mail pe care îl configuraţi pe fila Conturi de e-mail. Totuşi, dacă doriţi să declanşaţi un import de e-mail la un anumit moment, selectaţi un job de import e-mail în tabelul Joburi procesor de import şi faceţi clic pe pictograma Verificare e-mail. Această pictogramă este dezactivată, dacă jobul dvs. de import e-mail este offline.