Nastavenie služby Google Mail (OAuth) pre import e-mailov

Procesor importu môžete nakonfigurovať tak, aby pomocou služby Google Mail (OAuth) importoval do aplikácie Content Capture súbory priložené k prijatým e-mailovým správam spolu s prvkami e-mailových správ, ako je napríklad predmet a text tela. Každá importovaná e-mailová správa sa stane dávkou a z jej prvkov, ako sú napríklad prílohy, telo správy alebo celá e-mailová správa, sa v rámci dávky vytvoria samostatne dokumenty.

Na nastavenie importu e-mailov prostredníctvom služby Google Mail (OAuth) je potrebné vykonať tieto úlohy:

Získanie adresy URL presmerovania na vytvorenie aplikácie Google Mail

Aby ste mohli nakonfigurovať aplikáciu Google Mail, potrebujete názov hostiteľa Content Capture a detaily adresy URL autorizácie inštancie služby Oracle Content Management, ku ktorej sa chcete pripojiť.

Ako získať adresu URL presmerovania:

  1. Prihláste sa do služby Oracle Content Management ako administrátor a prejdite do aplikácie Content Capture.
  2. Otvorte procedúru a prejdite na kartu Digitalizovať.

  3. Na karte Úlohy procesora importu kliknite na ikonu Pridať úlohu procesora importu na vytvorenie novej úlohy.

  4. Na stránke Všeobecné nastavenia:
    1. Zadajte názov do poľa Názov úlohy importu a prefix do poľa Prefix dávky. Názvy importovaných dávok obsahujú tento prefix, po ktorom nasleduje číslo rastúce v prírastkoch s každou novou dávkou.
    2. V poli Zdroj importu je potrebné vybrať položku Zdroj e-mailu.
  5. Na stránke Nastavenia zdroja importu v sekcii Protokol pripojenia vyberte položku Google Mail (OAuth).

    Zobrazí sa adresa URL presmerovania. Skopírujte túto adresu URL, ktorá má formát https://<hostname>.<domainname>.com:<port>/capture/admin/faces/completeAuthorization. Adresa URL môže mať port, ale nemusí. Formát adresy URL bez portu je: https://<hostname>.<domainname>.com/capture/admin/faces/completeAuthorization

    Poznámka:

    Vstupy zatiaľ neodosielajte alebo z tejto stránky odíďte. Po vytvorení aplikácie Google Mail a získaní údajov ID klienta a Utajený kľúč klienta sa vráťte na túto stránku a nakonfigurujte autorizáciu OAuth služby Google Mail. Získané údaje zadáte do polí ID klienta a Utajený kľúč klienta.

Konfigurácia aplikácie Google Mail pre import e-mailov

Ako nakonfigurovať aplikáciu Google Mail:

  1. V ďalšom okne prehľadávača prejdite do konzoly rozhraní Google API.
  2. Na stránke Manage Resources (Spravovať prostriedky) uvidíte zoznam projektov, ak ste ich predtým vytvorili v konzole pre vývojárov spoločnosti Google. Ak ste tak ešte neurobili, vykonajte nasledujúce kroky:
    1. Kliknite na položku CREATE PROJECT (VYTVORIŤ PROJEKT).
    2. Zadajte názov do poľa Project name (Názov projektu).
    3. Kvôli ľahšej identifikácii projektu v konzole kliknite na tlačidlo EDIT (UPRAVIŤ) a v poli Project ID (ID projektu) zadajte ľahko zapamätateľné ID.
    4. Ak ste definovali prostriedky alebo priečinky organizácie, bude potrebné vybrať ich umiestnenie. Ak nie, prijmite predvolené hodnoty a kliknite na tlačidlo CREATE (VYTVORIŤ).

      Vytvorí sa projekt a vy budete presmerovaný do zoznamu projektov v konzole.

  3. V ľavom hornom rohu kliknite na ikonu Ikona navigácie pre vývojárov spoločnosti Google, vyberte položku APIs & Services (API a služby) a potom položku Dashboard (Panel).

    Poznámka:

    Ak nie je zobrazený panel naposledy vytvoreného projektu, projekt vyberte z rozbaľovacieho zoznamu v ľavom hornom rohu.
  4. Na ľavom bočnom paneli kliknite na položku Library (Knižnica) a prejdite na stránku API Library (Knižnica rozhraní API). Potom vyhľadajte knižnicu Gmail API a aktivujte ju.
  5. V ľavom hornom rohu kliknite na ikonu Ikona navigácie pre vývojárov spoločnosti Google, vyberte položku APIs & Services (API a služby) a potom položku OAuth consent screen (Obrazovka súhlasu s autorizáciou OAuth). Na obrazovke súhlasu s autorizáciou OAuth kliknite na tlačidlo CREATE (VYTVORIŤ).
  6. Na stránke úprav registrácie aplikácie na karte OAuth consent screen (Obrazovka súhlasu s autorizáciou OAuth):
    • V poli App name (Názov aplikácie) zadajte názov produktu, napríklad Gmail App.
    • V rozbaľovacom zozname User support email (E-mail na podporu používateľov) vyberte svoju e-mailovú adresu pre používateľskú podporu.
    • Prejdite nadol do sekcie Developer contact information (Kontaktné údaje vývojára) a v poli Email addresses (E-mailové adresy) zadajte svoju e-mailovú adresu.
    • Kliknite na tlačidlo SAVE AND CONTINUE (ULOŽIŤ A POKRAČOVAŤ).
  7. Na karte Scopes (Rozsahy):
    1. Kliknite na položku ADD OR REMOVE SCOPES (PRIDAŤ ALEBO ODSTRÁNIŤ ROZSAHY).
    2. V sekcii Update selected scopes (Aktualizovať vybrané rozsahy) buď začiarknite políčka pre nasledujúce rozsahy pre GMail API, alebo tieto rozsahy zadajte manuálne v poli Manually add scopes (Pridať rozsahy manuálne) a kliknite na tlačidlo ADD TO TABLE (PRIDAŤ DO TABUĽKY). Potom kliknite na tlačidlo UPDATE (AKTUALIZOVAŤ).
    3. Kliknite na tlačidlo SAVE AND CONTINUE (ULOŽIŤ A POKRAČOVAŤ).

      Rozsahy userinfo.email a userinfo.profile sú zobrazené v sekcii Your non-sensitive scopes (Necitlivé rozsahy) a rozsah gmail.modify je zobrazený v sekcii Your restricted scopes (Obmedzené rozsahy) na karte Scopes (Rozsahy).

  8. Na karte Test users (Testovať používateľov) kliknite na tlačidlo SAVE AND CONTINUE (ULOŽIŤ A POKRAČOVAŤ).
  9. Na karte Summary (Súhrn) môžete skontrolovať nastavenia a potom kliknúť na tlačidlo BACK TO DASHBOARD (SPÄŤ NA PANEL).
  10. V časti Publishing Status (Stav publikovania) v sekcii Testing (Testovanie) kliknite na položku PUBLISH APP (PUBLIKOVAŤ APLIKÁCIU) a potom v dialógovom okne Push to production? (Odoslať do produkcie?) aplikáciu publikujte kliknutím na tlačidlo CONFIRM (POTVRDIŤ).
  11. Na ľavom bočnom paneli kliknite na položku Credentials (Doklady) a vykonajte nasledujúce kroky:
    1. Na stránke Credentials (Doklady) kliknite na položku CREATE CREDENTIALS(VYTVORIŤ DOKLADY) a potom vyberte položku OAuth client ID (ID klienta OAuth).
    2. V rozbaľovacom zozname Application type (Typ aplikácie) vyberte položku Web application (Webová aplikácia).
    3. Zadajte názov klienta, napríklad Gmail OAuth App Client (Klient aplikácie Gmail OAuth).
    4. V časti Authorized redirect URIs (Autorizované URI presmerovania) kliknite na položku ADD URI (PRIDAŤ URI) a prilepte adresu URL presmerovania, ktorú ste skopírovali z procedúry Content Capture.
    5. V sekcii Authorized JavaScript origins (Autorizované pôvody JavaScript) kliknite na položku ADD URI (PRIDAŤ URI) a prilepte adresu URL presmerovania, ale odstráňte všetko za doménou alebo za portom, ak URI obsahuje port.
    6. Kliknite na tlačidlo CREATE (VYTVORIŤ).

      Hodnoty Client ID (ID klienta) a Client Secret (Utajený kľúč klienta) sú zobrazené v dialógovom okne OAuth client created (Klient OAuth vytvorený). Tieto hodnoty si poznačte a kliknite na tlačidlo OK.

      Teraz sa vráťte do aplikácie Content Capture v službe Oracle Content Management a pokračujte tam, kde ste skončili. To znamená, začnite zadaním hodnôt ID klienta a Utajený kľúč klienta a nakonfigurujte autorizáciu OAuth služby Google Mail.

Konfigurácia autorizácie OAuth služby Google Mail na import e-mailov v aplikácii Capture

Ako konfigurovať nastavenia úlohy procesora importu e-mailov s autorizáciou OAuth služby Google Mail:

  1. Prejdite späť na procedúru digitalizácie a začnite tam, kde ste skončili.
  2. Na karte E-mailové kontá ste vybrali protokol pripojenia Google Mail (OAuth). Teraz zadajte ID a utajený kľúč klienta, ktoré ste skopírovali počas konfigurácie vašej aplikácie Google Mail, do polí ID klienta a Utajený kľúč klienta.

  3. V tabuľke E-mailové kontá na spracovanie kliknite na ikonu Pridať e-mailové konto.

  4. Ak chcete úlohe procesora e-mailov udeliť prístup k e-mailovému kontu, na prihlasovacej stránke služby Google Mail zadajte e-mailovú adresu a heslo pre ID e-mailu, ktorý chcete použiť.

  5. Potvrďte kliknutím na tlačidlo Povoliť.

    ID e-mailu sa zobrazí v tabuľke E-mailové kontá na spracovanie v stĺpci E-mailové adresy. Jeho stav by mal byť Overené.

    Pomocou krokov, podľa ktorých ste postupovali doteraz, môžete do tejto tabuľky pridať ďalšie ID e-mailu služby Google Mail. Ak chcete odstrániť ID e-mailu, vyberte jeho riadok v tabuľke a kliknite na ikonu Odstránenie ID e-mailu.

  6. Na karte Filtre správ zadajte, kde a ako hľadať e-mailové správy alebo prílohy.

    1. V poli Priečinky na spracovanie zadajte aspoň jeden priečinok, ktorý sa má hľadať v zadaných e-mailových kontách. Predvolená hodnota je v doručenej pošte servera. Ak chcete zadať viacero priečinkov, oddeľte ich bodkočiarkou (;). Ak chcete zadať podpriečinky, vložte oddeľovač cesty platný pre daný poštový server, napríklad lomku (/). Príklad: priečinok/podpriečinok.

    2. Content Capture predvolene spracúva všetky e-maily v zadanom priečinku, ak nie je v úlohe použitý filter správ. Voliteľne môžete v tabuľke Filtre správ začiarknuť pole Aktivované pre každý prvok e-mailu, ktorý sa má vyhľadávať, a potom zadajte hľadané znaky do poľa Pole obsahuje.

      Ak by ste napríklad chceli hľadať e-maily, ktoré v predmete alebo tele správy obsahujú slovo platba, pre obe polia vyhľadávania by ste zadali Aktivované, do oboch vstupov Pole obsahuje by ste zadali slovo platba a vybrali by ste operátor vyhľadávania Alebo.

    3. V poli Operátor vyhľadávania vyberte operátor vyhľadávania, ktorý sa má použiť pre zadané filtre správ A (predvolený) importuje, len ak sú splnené všetky kritériá vyhľadávania. Operátor Alebo importuje, ak existuje zhoda aspoň s jedným kritériom vyhľadávania.

  7. Na karte Spracovanie zadajte, ako sa majú spracúvať e-mailové správy a ich prílohy. Môžete zadať, ktoré informácie sa majú zahrnúť, a prioritu, ktorá sa má priradiť dávkam na základe priority e-mailov.

    1. V sekcii Voľby e-mailovej správy zadajte, či sa má importovať súbor tela správy. Zadajte formát importu (text alebo EML) a to, či má byť zahrnutá do importu, ak nie sú prítomné žiadne prílohy, ako aj to, či sa má importovať celá e-mailová správa (vrátane príloh) ako súbor EML.

    2. V poli Zahrnúť prílohy zodpovedajúce týmto maskám zadajte súbory príloh na základe masiek súboru. Môžete zadať viacero masiek súboru oddelených čiarkou alebo bodkočiarkou. Môžete napríklad zahrnúť všetky súbory PDF (*.pdf).

    3. V poli Vylúčiť prílohy zodpovedajúce týmto maskám zadajte súbory príloh, ktoré budú vylúčené na základe masiek súboru. Môžete zadať viacero masiek súboru oddelených čiarkou alebo bodkočiarkou.

    4. Voliteľne vyberte voľby Vždy vykonať ďalšie spracovanie, keď prílohy nezodpovedajú maskám, Zahrnúť prílohy zodpovedajúce týmto maskám a Vylúčiť prílohy zodpovedajúce týmto maskám. Ak je toto pole aktivované a prílohy nezodpovedajú zadaným maskám, potom sa import e-mailov považuje za neúspešný a ďalej sa spracuje v súlade s nastaveniami, ktoré zadáte v poli Po neúspešnom importe na karte Ďalšie spracovanie.

      Poznámka:

      Pole Vždy vykonať ďalšie spracovanie, keď prílohy nezodpovedajú maskám je deaktivované, keď sú súčasne aktivované polia Importovať súbor tela správy a Zahrnúť, keď neexistujú žiadne prílohy.

    5. V sekcii Zoradenie dokumentov zadajte poradie, v ktorom sa prvky e-mailovej správy (napríklad telo správy a prílohy) majú zoradiť ako dokumenty v importovaných dávkach.

    6. V poli Zahrnúť poznámku k dávke vyberte prvky správy (napríklad Dátum/čas prijatia, Adresa odosielateľa, Adresa príjemcu, Predmet a Telo správy).

    7. V sekcii Priorita dávky voliteľne priraďte prioritu každej novej dávke na základe priority e-mailu (nízka, normálna, vysoká). Zadajte napríklad hodnotu 8 v poli Vysoká, čím e-mailom s vysokou prioritou priradíte prioritu dávky 8 v aplikácii Content Capture. E-maily bez priradenej priority sa považujú za e-maily s normálnou prioritou.

  8. Na karte Ďalšie spracovanie zadajte, čo sa stane s e-mailovými správami po úspešnom alebo neúspešnom importe. Správy môžete odstrániť, presunúť ich do určeného priečinka v rámci e-mailového konta alebo môžete v prípade zlyhania importu zabrániť odstráneniu správ. Ak napríklad úloha prebehne štandardne, môžete zabrániť opätovnému importu úspešne importovaných e-mailov tým, že ich presuniete do určeného priečinka.

  9. Dokončite nastavenia na ostatných stránkach úlohy procesora importu tak, ako je uvedené v časti Pridanie alebo úprava úlohy procesora importu.

Úlohu importu e-mailov teraz môžete otestovať. Procesor importu skontroluje správy v konfigurovaných e-mailových kontách a v priečinkoch vyhľadá zodpovedajúce e-maily. Ak nájde e-maily spĺňajúce kritériá, procesor importu vytvorí dávku a dokument v aplikácii Content Capture pre každý dokument, ktorý sa importuje z e-mailovej správy. Voliteľne procesor importu vyplní polia metadát metadátami e-mailov a odstráni úspešne importované správy alebo ich presunie do priečinka.

Content Capture pravidelne vyvoláva e-maily z e-mailového konta, ktoré ste nakonfigurovali na karte E-mailové kontá. Ak však chcete spustiť import e-mailov v určitom čase, vyberte úlohu importu e-mailov v tabuľke Úlohy procesora importu a kliknite na ikonu Skontrolovať e-mail. Táto ikona je deaktivovaná, ak je úloha importu e-mailov offline.