Google Mail (OAuth) -määritys sähköpostin tuontia varten

Voit konfiguroida tuonnin käsittelyohjelman käyttämään Google Mail -sovelluksessa OAuth-todennusta, kun se saapuviin sähköpostiviesteihin liitetyt tiedostot sekä sähköpostiviestin elementit, kuten aiheen ja tekstiosan, Content Capture -sovellukseen. Jokaisesta tuodusta sähköpostiviestistä tulee erä, ja sähköpostin elementit (kuten liitteet, viestin tekstiosa tai koko sähköpostiviesti) luodaan erän erillisiksi asiakirjoiksi.

Tässä on lueteltu toimenpiteet, joita tarvitaan Google (OAuth) -sähköpostin tuonnissa:

Uudelleenohjauksen URL-osoitteen haku Google Mail -sovelluksen luontia varten

Tarvitset Google Mail -sovelluksen konfigurointia varten Content Capture -sovelluksen pääkoneen nimen ja yhdistettävän Oracle Content Management -instanssin valtuutuksen URL-osoitteen tiedot.

Uudelleenohjauksen URL-osoitteen haku:

  1. Kirjaudu sisään Oracle Content Management -palveluun järjestelmänvalvojana ja siirry Content Capture -sovellukseen.
  2. Avaa proseduuri ja siirry Capture-välilehteen.

  3. Luo uusi työ valitsemalla Tuonnin käsittelyohjelman työt -taulukossa Lisää tuonnin käsittelyohjelman työ.

  4. Yleiset-asetukset sivulla:
    1. Syötä nimi Tuontityön nimi -kenttään ja etuliite Erän etuliite -kenttään. Tuodut erät nimetään käyttämällä tätä etuliitettä, jonka perässä on numero, joka suurenee jokaisen uuden erän myötä.
    2. Varmista Tuontilähde-kentässä, että olet valinnut Sähköpostilähde-vaihtoehdon.
  5. Valitse Tuontilähteen asetukset -sivun Yhteyskäytäntö-osassa Google Mail (OAuth).

    Uudelleenohjauksen URL-osoite tulee näkyviin. Kopioi tämä URL-osoite, jonka muoto on https://<hostname>.<domainname>.com:<port>/capture/admin/faces/completeAuthorization. URL-osoitteella voi ehkä olla portti. Ilman porttia URL-osoite on tässä muodossa: https://<hostname>.<domainname>.com/capture/admin/faces/completeAuthorization

    Huomautus::

    Älä lähetä vielä syöttämiäsi tietoja tai siirry pois tältä sivulta. Sinun on palattava tälle sivulle suorittamaan tehtävä konfiguroida Google Mail OAuth -sovelluksen, kun olet luonut Google Mail -sovelluksen ja saanut työaseman tunnuksen ja työaseman salaisen avaimen. Syötä ne Työaseman tunnus- ja Työaseman salainen avain -kenttiin.

Google Mail -sovelluksen konfigurointi sähköpostin tuontia varten

Google Mail -sovelluksen konfigurointi:

  1. Siirry Google API -liittymien konsoliin toista selainikkunaa käyttäen.
  2. Manage resources -sivulla on näkyvissä lista projekteista, jos olet jo luonut niitä Google Developers Consolessa. Jos et ole vielä tehnyt niin, suorita seuraavat toimenpiteet:
    1. Valitse CREATE PROJECT.
    2. Anna nimi projektille.
    3. Jotta voisit helposti tunnistaa oman projektisi konsolissa, muokkaa Project ID -kenttää valitsemalla EDIT ja antamalla kuvaava tunnus.
    4. Sinun on valittava sijainti, jos olet määrittänyt organisaation resursseja tai kansioita. Jos et ole, hyväksy oletusarvo ja valitse CREATE.

      Projektisi luodaan, ja sinut ohjataan takaisin konsolissa olevaan projektilistaan.

  3. Valitse vasemmassa yläkulmassa Google Developers -palvelun navigointikuvake ja sitten APIs & Services ja Dashboard.

    Huomautus::

    Jos et ole katselemassa äskettäin luodun projektin koontinäyttöä, valitse projekti vasemman yläkulman avattavasta listasta.
  4. Siirry API Library -sivulle valitsemalla vasemmasta sivupalkista Library. Hae Gmail API -kirjasto ja ota se käyttöön.
  5. Valitse vasemmassa yläkulmassa Google Developers -palvelun navigointikuvake ja sitten APIs & Services ja OAuth consent screen. Valitse kohdekäyttäjät OAuth-suostumusnäytössä ja valitse CREATE.
  6. Sovelluksen rekisteröinnin muokkaussivun OAuth consent screen -välilehdessä:
    • Syötä App name -kenttään tuotteesi nimi, kuten Gmail App.
    • Valitse avattavassa User support email -listassa sähköpostiosoitteesi käyttäjätukea varten.
    • Selaa Developer contact information -osaan ja syötä sähköpostiosoitteesi Email addresses -kenttään.
    • Valitse SAVE AND CONTINUE.
  7. Scopes-välilehdessä:
    1. Valitse ADD OR REMOVE SCOPES.
    2. Valitse Update selected scopes -osassa seuraavien GMail API -laajuuksien valintaruudut tai syötä kyseiset laajuudet manuaalisesti Manually add scopes -ruutuun ja valitse ADD TO TABLE. Valitse sitten UPDATE.
    3. Valitse SAVE AND CONTINUE.

      userinfo.email- ja userinfo.profile-laajuudet näkyvät Your non-sensitive scopes -osassa, ja gmail.modify-laajuus näkyy Scopes-välilehden Your restricted scopes-osassa.

  8. Valitse Test users-välilehdessä SAVE AND CONTINUE.
  9. Summary-välilehdessä voit tarkistaa tekemäsi asetukset. Valitse sen jälkeen BACK TO DASHBOARD.
  10. Valitse Testing-osan Publishing Status -kohdassa PUBLISH APP. Julkaise sovellus valitsemalla CONFIRM Push to production? -valintaikkunassa.
  11. Valitse vasemmasta sivupalkista Credentials ja suorita sitten seuraavat toimenpiteet:
    1. Valitse Credentials-sivulla CREATE CREDENTIALS ja sitten OAuth client ID.
    2. Valitse avattavassa Application type -listassa Web application.
    3. Anna työasemalle nimi, kuten Gmail OAuth App Client.
    4. Valitse Authorized redirect URIs -kohdassa ADD URI ja liitä Content Capture -proseduurista kopioimasi uudelleenohjauksen URL-osoite.
    5. Valitse Authorized JavaScript origins -kohdassa ADD URI ja liitä uudelleenohjauksen URL-osoite, mutta poista siitä kaikki toimialueen jälkeiset osat (tai portin jälkeiset osat, jos URI-tunnukseen sisältyy portti).
    6. Valitse CREATE.

      Työaseman tunnus ja työaseman salainen avain näkyvät OAuth client created -valintaikkunassa. Merkitse kyseiset arvot muistiin ja valitse OK.

      Siirry takaisin Oracle Content Management -palvelun Content Capture -sovellukseen ja jatka siitä, mihin jäit. Aloita syöttämällä työaseman tunnus ja salainen avain, jotta voit konfiguroida Google Mail OAuth -sovelluksen.

Google Mail -sovelluksen OAuth-todennuksen konfigurointi Capture-sähköpostin tuontia varten

Google Mail -sovelluksen OAuth-todennuksen konfigurointi sähköpostin tuonnin käsittelyohjelman työn asetuksia varten:

  1. Palaa Capture-proseduuriin ja jatka siitä, mihin jäit.
  2. Valitsit Sähköpostitilit -välilehdessä Google Mail (OAuth) -yhteyskäytännön. Syötä nyt työaseman tunnus ja salainen avain, jotka kopioit Google Mail -sovelluksen konfiguroinnin yhteydessä Työaseman tunnus- ja Salainen avain -kenttiin.

  3. Valitse Käsiteltävät sähköpostitilit -taulukossa Lisää sähköpostitili.

  4. Jos haluat antaa sähköpostin käsittelyohjelman työlle pääsyn sähköpostitilille, syötä Google Mail -sovelluksen sisäänkirjaussivulla käyttämäsi sähköpostitunnuksen sähköpostiosoite ja salasana.

  5. Vahvista tekemäsi valinnat napsauttamalla Salli-painiketta.

    Sähköpostitunnus näkyy Käsiteltävät sähköpostitilit -taulukossa Sähköpostiosoitteet-sarakkeen alla. Tilan on oltava Tarkistettu.

    Voit lisätä muita Google Mail -tunnuksia tähän taulukkoon noudattamalla edellä mainittuja vaiheita. Voit poistaa sähköpostitunnuksen valitsemalla sen rivin taulukossa ja napsauttamalla sitten Poista sähköpostitunnus-kuvaketta.

  6. Määritä Viestisuodattimet-välilehdessä, missä ja miten sähköpostiviestejä ja/tai liitteitä voi hakea.

    1. Syötä Käsiteltävät kansiot -kenttään vähintään yksi määritetyistä sähköpostitileistä haettava kansio. Oletusarvo on palvelimen saapuneiden kansio. Jos määrität useita kansioita, erota ne puolipisteellä (;). Jos haluat määrittää alikansioita, liitä mukaan sähköpostipalvelimelle sopiva erotin, kuten vinoviiva (/), esimerkiksi näin: kansio/alikansio.

    2. Content Capture käsittelee oletusarvoisesti kaikki sähköpostit määritetyssä kansiossa, jollei työssä käytetä viestisuodatinta. Voit myös valita Viestisuodattimet-taulukossa Käytössä-kentän kaikkien haettavien sähköpostin elementtien osalta ja syöttää sitten haettavia merkkejä Kenttä sisältää -kenttään.

      Jos esimerkiksi haluaisit hakea sähköpostiviestejä, joiden aihe tai tekstiosa sisältää sanan payment, valitsisit Käytössä kummankin hakukentän osalta, lisäisit payment-osan jokaiseen Kenttä sisältää -merkintään ja valitsisit TAI-hakuoperaattorin.

    3. Valitse Hakuoperaattorit-kentässä määritetyissä viestisuodattimissa käytettävä hakuoperaattori: JA (oletusarvo) suorittaa tuonnin vain, jos kaikki hakuehdot täyttyvät. TAI puolestaan suorittaa tuonnin, jos mikä tahansa hakuehto täyttyy.

  7. Määritä Käsittely-välilehdessä, kuinka sähköpostiviestit ja niiden liitteet käsitellään. Voit määrittää mukaan otettavat tiedot sekä erille määritettävän prioriteetin sähköpostin prioriteetin perusteella.

    1. Määritä Sähköpostiviestin valinnat -kohdassa, pitääkö viestin tekstiosan tiedosto tuoda. Määritä tiedoston tuontimuoto (teksti tai EML) ja pitääkö tiedosto ottaa mukaan, jos liitteitä ei ole ja, pitääkö koko sähköpostiviesti (liitteineen) tuoda EML-tiedostona.

    2. Määritä Lisää kaikki näitä peitteitä vastaavat liitteet -kenttään liitetiedostot niiden tiedostopeitteiden perusteella. Voit syöttää useita tiedostopeitteitä pilkulla tai puolipisteellä eroteltuina. Voit esimerkiksi ottaa mukaan kaikki PDF-tiedostot (*.pdf).

    3. Määritä Jätä pois kaikki näitä peitteitä vastaavat liitteet -kenttään poisjätettävät liitetiedostot niiden tiedostopeitteiden perusteella. Voit syöttää useita tiedostopeitteitä pilkulla tai puolipisteellä eroteltuina.

    4. Voit myös valita vaihtoehdot Jälkikäsittely aina, kun liitteet eivät vastaa peitteitä, Lisää kaikki näitä peitteitä vastaavat liitteet ja Jätä pois kaikki näitä peitteitä vastaavat liitteet. Jos tämä kenttä on käytössä, eivätkä liitteet vastaa määritettyjä peitteitä, sähköpostin tuontia pidetään epäonnistuneena, ja se jälkikäsitellään Jälkikäsittely-välilehden Epäonnistuneen tuonnin yhteydessä -kentässä määritettyjen asetusten mukaan.

      Huomautus::

      Jälkikäsittely aina, kun liitteet eivät vastaa peitteitä -kenttä on poissa käytöstä, kun sekä Tuo viestin tekstiosan tiedosto- että Lisää, kun liitteitä ei ole -kenttä ovat käytössä.

    5. Määritä Asiakirjajärjestys-kohdassa, missä järjestyksessä sähköpostiviestin elementit (kuten viestin tekstiosa ja liitteet) järjestetään asiakirjoiksi tuoduissa erissä.

    6. Valitse Lisää erän huomautukseen -kohdassa viestin elementit (kuten Vastaanottopäivämäärä ja -aika, Lähettäjän osoite, Vastaanottajan osoite, Aihe ja Viestin tekstiosa).

    7. Erän prioriteetti -kohdassa voit halutessasi määrittää prioriteetin kaikille uusille erille erän sähköpostin prioriteetin perusteella (matala, normaali tai korkea). Syöttämällä esimerkiksi arvon 8 Korkea-kenttään voit määrittää korkean prioriteetin sähköposteille erän prioriteetin 8 Content Capture -sovelluksessa. Sähköposteja, joille ei ole määritetty prioriteettia, pidetään normaalin prioriteetin sähköposteina.

  8. Määritä Jälkikäsittely-välilehdessä, mitä sähköpostiviesteille tapahtuu onnistuneen tai epäonnistuneen tuonnin jälkeen. Voit poistaa viestejä, siirtää niitä tiettyyn kansioon sähköpostitilissä tai - jos tuonti epäonnistuu - estää viestien poistamisen. Jos esimerkiksi työ ajetaan säännöllisesti, voit estää onnistuneesti tuotujen sähköpostiviestien uudelleentuonnin siirtämällä ne määritettyyn kansioon.

  9. Täytä muut tuonnin käsittelyohjelman sivut kohdassa Tuonnin käsittelyohjelman työn lisäys tai muokkaus kuvatulla tavalla.

Nyt voit testata sähköpostin tuontityön. Tuonnin käsittelyohjelma tarkistaa, onko konfiguroiduissa sähköpostitileissä viestejä, ja hakee vastaavia sähköposteja kansioista. Jos vastaavia sähköposteja löytyy, tuonnin käsittelyohjelma luo Content Capture -erän ja asiakirjan kullekin sähköpostiviestistä tuotavalle asiakirjalle. Tuonnin käsittelyohjelma voi tarvittaessa täyttää metatietokenttiä sähköpostien metatiedoilla ja poistaa onnistuneesti tuotuja viestejä tai siirtää niitä kansioon.

Content Capture hakee säännöllisesti sähköpostit Sähköpostitilit-välilehdessä konfiguroidusta sähköpostitilistä. Jos kuitenkin haluat käynnistää sähköpostin tuonnin tiettyyn aikaan, valitse sähköpostien tuontityö Tuonnin käsittelyohjelman työt -taulukossa ja napsauta Tarkista sähköposti-kuvaketta. Kuvake on poissa käytöstä, jos sähköpostin tuontityö on offline-tilassa.