Konfigurere Google Mail (OAuth) til e-mailimport

Du kan konfigurere importprocessoren til at bruge Google Mail OAuth til at importere filer, der er vedhæftet i indgående e-mailmeddelelser, samt e-mailelementer som emne og brødtekst, i Content Capture. Hver importeret e-mailmeddelelse bliver en batch med e-mailelementer, for eksempel vedhæftninger, brødtekst eller hele e-mailmeddelelsen, oprettet som separate dokumenter i batchen.

Du konfigurerer Google-e-mailimport (OAuth) på følgende måde:

Hente omdirigerings-URL til oprettelse af en Google Mail-app

For at kunne konfigurere en Google Mail-app skal du bruge oplysninger om Content Capture-værtsnavnet og autorisations-URL til den Oracle Content Management-instans, du vil oprette forbindelse til.

Sådan anskaffer du omdirigerings-URL:

  1. Log på Oracle Content Management som en administrator, og gå til Content Capture.
  2. Åbn din procedure, og gå til fanen Opsaml.

  3. Klik på Tilføj importprocessorjob i tabellen Importprocessorjob for at oprette et nyt job.

  4. På siden Generelle indstillinger:
    1. Indtast et navn i feltet Importjobnavn og et præfiks i feltet Batchpræfiks. Importerede batches navngives med dette præfiks efterfulgt af et tal, der øges ved hver ny batch.
    2. I feltet Importkilde skal du sørge for, at E-mailkilde er valgt.
  5. Vælg Google Mail (OAuth) i sektionen Forbindelsesprotokol på siden Importkildeindstillinger.

    En omdirigerings-URL vises. Kopier denne URL, hvis format er https://<hostname>.<domainname>.com:<port>/capture/admin/faces/completeAuthorization. Din URL har måske eller måske ikke en port. Uden en port vil URL'en have dette format: https://<hostname>.<domainname>.com/capture/admin/faces/completeAuthorization

    Bemærk:

    Du må ikke afsende dine inputs eller navigere væk fra denne side endnu. Du skal vende tilbage til denne side for at konfigurere Google-mail-OAuth, når du har oprettet en Google Mail-app og anskaffet klient-ID og klienthemmelighed. Du skal indtaste dem i felterne Klient-ID og Klienthemmelighed.

Konfigurere en Google Mail-app til e-mailimport

Sådan konfigurerer du en Google Mail-app:

  1. Gå til Google API-konsol i et andet browservindue.
  2. På siden Manage resources kan du se en liste over dine projekter, hvis du allerede har oprettet dem i Google Developers-konsollen. Hvis du ikke allerede har gjort det, skal du gøre følgende:
    1. Klik på CREATE PROJECT.
    2. Indtast et Project name.
    3. Rediger Project ID ved at klikke på EDIT og indtaste et sigende ID for let at kunne identificere dit projekt i konsollen.
    4. Du skal vælge en lokation, hvis du har defineret nogen organisatoriske ressourcer eller mapper. Hvis ikke, skal du acceptere standarden og klikke på CREATE.

      Dit projekt oprettes, og du bliver omdirigeret til din projektliste i konsollen.

  3. Klik i øverste venstre hjørne på Google Developer-navigationsikon, vælg APIs & Services, og vælg derefter Dashboard.

    Bemærk:

    Hvis du ikke ser på det senest oprettede projekts dashboard, skal du vælge dit projekt på rullelisten i øverste venstre hjørne.
  4. Klik på Library i venstre sidepanel for at gå til siden API Library. Søg efter biblioteket Gmail API, og aktiver det.
  5. Klik i øverste venstre hjørne på Google Developer-navigationsikon, vælg APIs & Services, og vælg derefter OAuth consent screen. Vælg dine målbrugere på skærmen til OAuth-samtykke, og klik derefter på CREATE.
  6. Gør følgende på siden Edit app registration på fanen OAuth consent screen:
    • I feltet App name skal du indtaste dit produktnavn, for eksempel Gmail App.
    • På rullelisten User support email skal du vælge e-mailadressen til brugersupport.
    • Rul ned til sektionen Developer contact information, og indtast din e-mailadresse i feltet Email addresses.
    • Klik på SAVE AND CONTINUE.
  7. Gør følgende på fanen Scopes:
    1. Klik på ADD OR REMOVE SCOPES.
    2. I sektionen Update selected scopes skal du enten markere afkrydsningsfelterne for følgende GMail API-omfang eller manuelt indtaste disse omfang i feltet Manually add scopes og klikke på ADD TO TABLE. Klik derefter på UPDATE.
    3. Klik på SAVE AND CONTINUE.

      Omfangene userinfo.email og userinfo.profile vises i sektionen Your non-sensitive scopes, og omfanget gmail.modify vises i sektionen Your restricted scopes på fanen Scopes.

  8. Klik på SAVE AND CONTINUE på fanen Test users.
  9. På fanen Summary kan du gennemgå dine indstillinger og derefter klikke på BACK TO DASHBOARD.
  10. Klik på PUBLISH APP under Publishing Status i sektionen Testing, og klik derefter på CONFIRM i dialogboksen Push to production? for at publicere appen.
  11. Klik på Credentials i venstre sidepanel, og gør derefter følgende:
    1. Klik på CREATE CREDENTIALS på siden Credentials, og vælg derefter OAuth client ID.
    2. Vælg Web application på rullelisten Application type.
    3. Navngiv klienten, for eksempel Gmail OAuth App Client.
    4. Klik på ADD URI i Authorized redirect URIs, og indsæt den omdirigerings-URL, som du kopierede fra din Content Capture-procedure.
    5. Klik på ADD URI i Authorized JavaScript origins, og indsæt omdirigerings-URL'en, men fjern alt efter domænet eller efter porten, hvis din URI inkluderer en port.
    6. Klik på CREATE.

      Dine værdier af klient-ID og klienthemmelighed vises i dialogboksen OAuth client created. Noter dig disse værdier, og klik derefter på OK.

      Nu kan du gå tilbage til Content Capture i Oracle Content Management og fortsætte det sted, som du var kommet til. Så du skal starte med at indtaste klientens ID og hemmelighed for at konfigurere Google-mail-OAuth.

Konfigurere Google Mail OAuth til Capture-e-mailimport

Sådan konfigurerer du indstillinger for e-mailimportprocessorjob for Google Mail OAuth:

  1. Gå tilbage til din Capture-procedure for at begynde det sted, som du var kommet til.
  2. Under fanen E-mailkonti har du valgt Google Mail (OAuth) som forbindelsesprotokol. Nu skal du indtaste det klient-ID og den hemmelighed, som du har kopieret under konfigurering af din Google Mail-app, i felterne Klient-ID og Klienthemmelighed.

  3. Klik på Tilføj e-mailkonto i tabellen E-mailkonti, der skal behandles.

  4. Hvis du vil give e-mailprocessorjobbet adgang til e-mailkontoen, skal du indtaste e-mailadressen og adgangskoden for det e-mail-ID, som du vil bruge.

  5. Bekræft dine valg ved at klikke på Tillad.

    E-mail-ID'et vises i tabellen E-mailkonti, der skal behandles under kolonnen E-mailadresser. Dets status skal være Verificeret.

    Du kan tilføje flere Google Mail-ID'er i denne tabel ved hjælp af de foregående trin. Du sletter et e-mail-ID ved at vælge dets række i tabellen og derefter klikke på Slette e-mail-ID.

  6. Angiv, hvor og hvordan du vil søge efter e-mailmeddelelser og/eller vedhæftninger, på fanen Meddelelsesfiltre.

    1. Indtast en eller flere mapper, som du vil søge i for de angivne e-mailkonti, i feltet Mapper, der skal behandles. Standardværdien er serverens indbakke. Hvis du angiver flere mapper, skal du adskille dem med et ; (semikolon). Du angiver undermapper ved at inkludere en stiafgrænser, der kan bruges til mailserveren, for eksempel en / (skråstreg), som i mappe/undermappe.

    2. Content Capture behandler som standard alle e-mails i den angivne mappe, medmindre der anvendes et meddelelsesfilter på jobbet. Du kan eventuelt vælge feltet Aktiveret i tabellen Meddelelsesfiltre for hvert e-mailelement, der skal søges efter, og derefter indtaste de tegn, der skal søges efter, i feltet Felt indeholder.

      Hvis du for eksempel vil søge efter e-mails, hvis emne eller brødtekst indeholder ordet payment, skal du vælge Aktiveret for begge søgefelter, inkludere payment i hver indtastning i Felt indeholder og vælge søgeoperatoren Eller.

    3. Vælg den søgeoperator, der skal bruges til de angivne meddelelsesfiltre, i feltet Søgeoperatorer: Og (standard) importerer kun, hvis alle søgekriterier matcher, mens Eller importerer, hvis et af søgekriterierne matcher.

  7. Angiv, hvordan e-mailmeddelelser og deres vedhæftninger skal behandles, på fanen Behandling. Du kan angive, hvilke oplysninger der skal inkluderes, og hvilken prioritet batches skal have tildelt, på basis af e-mailprioriteten.

    1. Angiv, om filen med meddelelsens brødtekst skal importeres, under Valg for e-mailmeddelelser. Angiv dens importformat (tekst eller EML), og om den skal inkluderes, når der ikke er nogen vedhæftninger, samt om hele e-mailmeddelelsen (herunder vedhæftninger) skal importeres som en EML-fil.

    2. Angiv vedhæftningsfiler på basis af deres filmasker i feltet Medtag vedhæftninger, der matcher denne/disse maske(r). Du kan indtaste flere filmasker adskilt af komma eller semikolon. Du kan for eksempel inkludere alle PDF-filer (*.pdf).

    3. Angiv vedhæftningsfiler, der skal udelades på basis af deres filmasker, i feltet Udelad vedhæftninger, der matcher denne/disse maske(r). Du kan indtaste flere filmasker adskilt af komma eller semikolon.

    4. Vælg eventuelt Efterbehandl altid, når vedhæftninger ikke matcher maske(r), Medtag vedhæftninger, der matcher denne/disse maske(r) og Udelad vedhæftninger, der matcher denne/disse maske(r). Hvis dette felt er aktiveret, og vedhæftningerne ikke matcher den eller de angivne masker, anses e-mailimporten for at være fejlet, og den efterbehandles i henhold til de indstillinger, som du angiver under feltet Ved fejlet import på fanen Efterbehandling.

      Bemærk:

      Feltet Efterbehandl altid, når vedhæftninger ikke matcher maske(r), er deaktiveret, når både feltet Importer meddelelsestekstfil og Medtag, når der ikke er nogen vedhæftninger er aktiveret.

    5. Angiv den rækkefølge, elementerne (for eksempel meddelelsens brødtekst og vedhæftninger) fra en e-mailmeddelelse skal vises i som dokumenter i importerede batches, under Dokumentsortering.

    6. Vælg meddelelseselementer (for eksempel Modtaget dato/kl., Fra-adresse, Til-adresse, Emne og Meddelelsestekst) under Medtag i batchnote.

    7. Du kan eventuelt tildele en prioritet til hver ny batch på basis af dens e-mailprioritet (lav, normal eller høj) under Batchprioritet. Indtast f.eks. 8 i feltet Høj for at tildele e-mails med høj prioritet en batchprioritet på 8 i Content Capture. E-mails, der ikke har fået tildelt en prioritet, behandles, som om de har prioriteten Normal.

  8. Angiv, hvad der skal ske med e-mailmeddelelser efter udført eller fejlet import, på fanen Efterbehandling. Du kan slette meddelelser, flytte dem til en angivet mappe i e-mailkontoen eller, i tilfælde af fejlet import, forhindre, at meddelelserne slettes. Hvis jobbet for eksempel køres regelmæssigt, kan du forhindre, at importerede e-mails importeres igen, ved at flytte dem til en angivet mappe.

  9. Udfyld andre sider for importprocessorjob som beskrevet i Tilføje eller redigere et importprocessorjob.

Du kan nu teste e-mailimportjobbet. Importprocessoren kontrollerer, om der er meddelelser i de konfigurerede e-mailkonti, og søger efter matchende e-mails i mapperne. Hvis der findes matchende e-mails, opretter importprocessoren en Content Capture-batch og et dokument for hvert af de dokumenter, der importeres fra e-mailmeddelelsen. Importprocessoren kan også udfylde metadatafelter med e-mailmetadata og slette importerede meddelelser eller flytte dem til en mappe.

Content Capture henter regelmæssigt e-mails fra den e-mailkonto, du konfigurerer på fanen E-mailkonti. Hvis du vil udløse en e-mailimport på et bestemt tidspunkt, skal du imidlertid vælge et e-mailimportjob i tabellen Importprocessorjob og klikke på ikonet Tjek e-mail. Dette ikon er deaktiveret, hvis e-mailimportjobbet er offline.