Konfigurer Google Mail (OAuth) for e-postimport

Du kan konfigurere importbehandleren til å bruke OAuth for Google Mail til å importere filer som er lagt ved innkommende e-postmeldinger, sammen med andre elementer i e-postmeldingen, for eksempel emne og meldingstekst, til Content Capture. Hver enkelt e-postmelding som importeres, blir en bunke, og e-postelementer som vedlegg, meldingstekst eller hele e-postmeldingen blir opprettet som separate dokumenter i bunken.

Hent omdirigerings-URL-en for å opprette en Google Mail-app

For at du skal kunne konfigurere en Google Mail-app, trenger du vertsnavnet for Content Capture og detaljene om URL-adressen for autorisasjon for Oracle Content Management-forekomsten du vil koble til.

Slik henter du URL-adressen for omdirigering:

  1. Logg på Oracle Content Management som administrator, og gå til Content Capture.
  2. Åpne prosedyren, og gå til fanen Registrer.
  3. I tabellen Importbehandlingsjobber klikker du på Legg til importbehandlerjobb slik at du oppretter en ny jobb.

  4. På siden Generelle innstillinger:
    1. Angi et navn i feltet Navn på importjobb og et prefiks i feltet Bunkeprefiks. Importerte bunker gis et navn som inneholder dette prefikset, fulgt av et tall som økes for hver ny bunke.
    2. Sørg for å velge E-postkilde i feltet Importkilde.
  5. I delen Tilkoblingsprotokoll på siden Innstillinger for importkilde velger du Google Mail (OAuth).

    Det vises en URL-adresse for omdirigering. Kopier denne URL-adressen, som har formatet https://<hostname>.<domainname>.com:<port>/capture/admin/faces/completeAuthorization. URL-adressen kan eventuelt ha en port. Uten en port vil URL-adressen ha dette formatet: https://<hostname>.<domainname>.com/capture/admin/faces/completeAuthorization

    Merknad:

    Ikke send inndataene eller naviger bort fra denne siden ennå. Du må gå tilbake til denne siden for å konfigurere OAuth for Google Mail når du har opprettet en Google Mail-app og hentet klient-ID-en og klienthemmeligheten. Disse angir du i feltene Klient-ID og Klienthemmelighet.

Konfigurer en Google Mail-app for e-postimport

Slik konfigurerer du en Google Mail-app:

  1. Gå til Google APIs Console i et annet nettleservindu.
  2. På siden Manage resources (Administrer ressurser) kan du se en liste over prosjektene dine hvis du allerede har opprettet dem i Google Developers Console. Gjør følgende hvis du ikke allerede har gjort det:
    1. Klikk på CREATE PROJECT (Opprett prosjekt).
    2. Angi et Project name (Prosjektnavn).
    3. For at du enkelt skal kunne identifisere prosjektet i konsollen, redigerer du Project ID (Prosjekt-ID) ved å klikke på EDIT (Rediger) og angir en beskrivende ID.
    4. Du må velge en plassering hvis du har angitt noen organisasjonsressurser eller -mapper. Hvis ikke, godtar du standardinnstillingen og klikker på CREATE (Opprett).

      Prosjektet opprettes, og du blir omdirigert til prosjektlisten din i konsollen.

  3. Klikk på navigeringsikonet for Google Developers øverst til venstre, og velg APIs & Services (API-er og tjenester), og velg deretter Dashboard (Instrumentpanel).

    Merknad:

    Hvis ikke instrumentpanelet for det nylig opprettede prosjektet vises, velger du prosjektet fra rullegardinlisten øverst til venstre.
  4. Klikk på Library (Bibliotek) for å gå til siden API Library (API-bibliotek). Søk deretter etter biblioteket Gmail API (API for Gmail), og aktiver det.
  5. Klikk på navigeringsikonet for Google Developers øverst til venstre, og velg APIs & Services (API-er og tjenester), og velg deretter OAuth consent screen (Skjermbilde for OAuth-samtykke). Velg målbrukerne i skjermbildet for OAuth-samtykke, og klikk deretter på CREATE (Opprett).
  6. Gjør følgende på siden Edit app registration (Rediger appregistrering) i fanen OAuth consent screen (Skjermbilde for OAuth-samtykke):
    • Skriv inn produktnavnet, for eksempel Gmail-app, i feltet App name (Appnavn).
    • Velg e-postadressen for brukerstøtte fra rullegardinlisten User support email (E-post for brukerstøtte)
    • Rull ned til delen Developer contact information (Kontaktopplysninger for utvikler), og angi e-postadressen din i feltet Email addresses (E-postadresser).
    • Klikk på SAVE AND CONTINUE (Lagre og fortsett).
  7. Gjør følgende i fanen Scopes (Omfang):
    1. Klikk på ADD OR REMOVE SCOPES (Legg til eller fjern omfang).
    2. I delen Update selected scopes (Oppdater valgte omfang) merker du enten av for følgende GMail-API-omfang, eller angir disse omfangene manuelt i boksen Manually add scopes (Legg til omfang manuelt), og klikker deretter på ADD TO TABLE (Legg til i tabell). Klikk deretter på UPDATE (Oppdater).
    3. Klikk på SAVE AND CONTINUE (Lagre og fortsett).

      Omfangene userinfo.email og userinfo.profile vises i delen Your non-sensitive scopes (Ikke-sensitive omfang), og omfanget gmail.modify vises i delen Your restricted scopes (Begrensede omfang) i fanen Scopes (Omfang).

  8. I fanen Test users (Testbrukere) klikker du på SAVE AND CONTINUE (Lagre og fortsett).
  9. Du kan se gjennom innstillingene i fanen Summary (Sammendrag), og deretter klikker du på BACK TO DASHBOARD (Tilbake til instrumentpanelet).
  10. I delen Testing under Publishing Status (Publiseringsstatus) klikker du på PUBLISH APP (Publiser app). Deretter klikker du på CONFIRM (Bekreft) i dialogboksen Push to production? (Dytt til produksjon?) når du vil publisere appen.
  11. Klikk på Credentials (Påloggingsinformasjon) i den venstre sidestolpen, og gjør deretter følgende:
    1. Klikk på CREATE CREDENTIALS (Opprett påloggingsinformasjon) på siden Credentials (Påloggingsinformasjon), og velg deretter OAuth client ID (OAuth-klient-ID).
    2. Velg Web application (Web-applikasjon) fra rullegardinlisten Application type (Applikasjonstype).
    3. Gi klienten et navn, for eksempel Klient for OAuth-app for Gmail.
    4. Klikk på ADD URI (Legg til URI) i Authorized redirect URIs (Godkjente URI-er for omdirigering), og lim inn URL-adressen for omdirigering som du kopierte fra Content Capture-prosedyren.
    5. Klikk på ADD URI (Legg til URI) i Authorized JavaScript origins (Godkjente JavaScript-opprinnelser), og lim inn URL-adressen for omdirigering, men fjern alt etter domenet, eller etter porten hvis URI-adressen omfatter en port.
    6. Klikk på CREATE (Opprett).

      Verdiene for klient-ID og klienthemmelighet vises i dialogboksen OAuth client created (OAuth-klient opprettet). Noter disse verdiene, og klikk på OK.

      Gå nå tilbake til Content Capture i Oracle Content Management, og fortsett der du slapp. Det vil si at du begynner med å angi klient-ID-en og -hemmeligheten for å konfigurere OAuth for Google Mail.

Konfigurere Google Mail OAuth for Capture-e-postimport

Slik konfigurerer du innstillinger for importbehandlerjobber for Google Mail OAuth-e-post:

  1. Gå tilbake til Capture-prosedyren, og begynn der du sluttet sist.
  2. I fanen E-postkonti velger du tilkoblingsprotokollen Google Mail (OAuth). Deretter angir du klient-ID-en og hemmeligheten du kopierte i prosessen med å konfigurere Google Mail-appen, i feltene Klient-ID og Klienthemmelighet.
  3. I tabellen E-postkonti som skal behandles klikker du på Legg til e-postkonto.

  4. Hvis du vil gi e-postbehandlerjobben tilgang til e-postkontoen, går du til påloggingssiden for Google Mail og angir e-postadressen og passordet for e-post-ID-en du skal bruke.

  5. Bekreft valgene ved å klikke på Tillat.

    E-post-ID-en vises i tabellen E-postkonti som skal behandles under kolonnen E-postadresser. Statusen skal være Bekreftet.

    Du kan legge til flere Google Mail-ID-er i denne tabellen ved å følge trinnene du har fulgt hittil. Hvis du vil slette en e-post-ID, velger du den tilhørende raden i tabellen og klikker på Slett e-post-ID.

  6. I fanen Meldingsfiltre angir du hvor og hvordan du vil søke etter e-postmeldinger og/eller -vedlegg.

    1. I feltet Mapper som skal behandles angir du én eller flere mapper du vil søke i, i de angitte e-postkontiene. Standardverdien er tjenerens innboks. Hvis du vil angi flere mapper, skiller du dem med ; (semikolon). Hvis du vil angi undermapper, må du ta med et baneskilletegn som er gyldig på e-posttjeneren, for eksempel / (skråstrek), som i mappe/undermappe.

    2. Som standard behandler Content Capture all e-post i den angitte mappen, med mindre det er brukt et meldingsfilter for jobben. I tabellen Meldingsfiltre er det også mulig å velge feltet Aktivert for hvert e-postelement det skal søkes i, og deretter angi tegnene som skal bli funnet, i feltet Felt inneholder.

      Hvis du for eksempel vil søke etter e-poster der emnet eller meldingsteksten inneholder ordet payment, velger du Aktivert for begge søkefeltene, tar med payment i hver Felt inneholder-post og velger deretter søkeoperatorenEller.

    3. I feltet Søkeoperator velger du søkeoperatoren du vil bruke for de angitte meldingsfiltrene: Og (standard) importerer bare hvis alle søkekriteriene samsvarer, mens Eller importerer hvis et hvilket som helst søkekriterium samsvarer.

  7. I fanen Behandler angir du hvordan du vil behandle e-postmeldingene og de tilhørende vedleggene. Du kan angi hvilke opplysninger som skal inkluderes, og prioriteten som skal tilordnes til bunkene, basert på e-postprioriteten.

    1. Under Valg for e-postmelding angir du om meldingstekstfilen skal importeres. Angi importformatet (tekst eller EML) og om det skal inkluderes når det ikke finnes noen vedlegg, og om hele e-postmeldingen (inkludert vedlegg) skal importeres som en EML-fil.

    2. I feltet Inkluder vedlegg som samsvarer med denne masken / disse maskene angir du vedleggsfiler basert på de tilhørende filmaskene. Du kan angi flere filmasker atskilt med komma eller semikolon. Du kan for eksempel inkludere alle PDF-filer (*.PDF).

    3. I feltet Utelat vedlegg som samsvarer med denne masken / disse maskene angir du vedleggsfiler som skal utelates, basert på de tilhørende filmaskene. Du kan angi flere filmasker atskilt med komma eller semikolon.

    4. Du kan også velge Etterbehandle alltid når vedlegg ikke samsvarer med masken(e), Inkluder vedlegg som samsvarer med denne masken / disse maskene og Utelat vedlegg som samsvarer med denne masken / disse maskene. Hvis dette feltet er aktivert og vedleggene ikke samsvarer med masken(e) som er angitt, blir e-postimporten betraktet som mislykket og etterbehandlet i henhold til innstillingene du angir under feltet Ved mislykket import i fanen Etterbehandling.

      Merknad:

      Feltet Etterbehandle alltid når vedlegg ikke samsvarer med masken(e) er deaktivert når både feltet Importer meldingstekstfil og feltet Inkluder når det ikke finnes vedlegg er aktivert sammen.
    5. Under Dokumentsortering angir du sorteringsrekkefølgen for elementene (for eksempel meldingsteksten og vedleggene) fra en e-postmelding som skal sorteres som dokumenter i importerte bunker.

    6. Under Inkluder i bunkenotat velger du meldingselementer (som Dato/klokkeslett for mottak, Fra-adresse, Til-adresse, Emne og Meldingstekst).

    7. Under Bunkeprioritet kan du tilordne en prioritet til hver ny bunke, basert på e-postprioriteten (lav, normal eller høy). Du kan for eksempel angi 8 i feltet Høy hvis du vil tilordne en bunkeprioritet på 8 til e-poster med høy prioritet i Content Capture. E-poster som ikke er tilordnet noen prioritet, anses for å ha normal prioritet.

  8. I fanen Etterbehandling angir du hva som skjer med e-postmeldingene etter vellykket eller mislykket import. Du kan slette meldinger, flytte dem til en angitt mappe i e-postkontoen, eller i tilfelle importen mislykkes, hindre at meldinger blir slettet. Hvis jobben kjøres jevnlig, kan du for eksempel hindre at importerte e-poster blir importert på nytt, ved å flytte dem til en angitt mappe.

  9. Fullfør andre sider for importbehandlerjobber slik det er beskrevet i Legge til eller redigere en importbehandlerjobb.

Nå kan du teste importjobben for e-poster. Importbehandleren kontrollerer om de konfigurerte e-postkontiene inneholder meldinger, og søker i mapper etter samsvarende e-poster. Hvis det blir funnet samsvarende e-poster, oppretter importbehandleren en Content Capture-bunke og et dokument for hvert dokument som blir importert fra e-postmeldingen. Importbehandleren kan også fylle ut metadatafelt med e-postmetadata, og den kan slette importerte meldinger eller flytte dem til en mappe.

Content Capture henter jevnlig e-poster fra e-postkontoen du har konfigurert i fanen E-postkonti. Hvis du imidlertid ønsker å utløse en e-postimport på et bestemt klokkeslett, velger du en e-postimportjobb i tabellen Importbehandlingsjobber og klikker på ikonet Kontroller e-post. Dette ikonet er deaktivert hvis e-postimportjobben er frakoblet.