Konfigurera Google Mail (OAuth) för import av e-post

Du kan konfigurera importprocessorn så att den använder Google Mail OAuth för att importera filer som bifogas till inkommande e-post, tillsammans med e-postelement som ämne och brödtext, till Content Capture. Varje importerat e-postmeddelande blir en batch, med e-postelement som bilagor, textdel eller hela e-postmeddelanden som skapas som separata dokument i en batch.

Här beskrivs vad som behöver göras för att konfigurera import av e-post med Google (OAuth):

Hämta omdirigerings-URL:en för att skapa en Google Mail-app

För att kunna konfigurera en Google Mail-app behöver du Content Capture-värdnamnet och uppgifterna om auktoriserings-URL för instansen av Oracle Content Management du vill ansluta till.

Så här hämtar du omdirigerings-URL:en:

  1. Logga in till Oracle Content Management som administratör och gå till Content Capture.
  2. Öppna din procedur och gå till fliken Fånga.

  3. Gå till tabellen Importprocessorjobb och klicka på Lägg till importprocessorjobb för att skapa ett nytt jobb.

  4. På sidan Allmänna inställningar:
    1. Ange ett namn i fältet Import – jobbnamn och ett prefix i fältet Batchprefix. Importerade batchar namnges med detta prefix, följt av ett nummer som ökar för varje ny batch.
    2. Gå till fältet Importkälla och välj E-postkälla.
  5. På sidan Inställningar för importkälla, i sektionen Anslutningsprotokoll, väljer du Google Mail (OAuth).

    En omdirigerings-URL visas. Kopiera den här URL:en, som har formatet https://<hostname>.<domainname>.com:<port>/capture/admin/faces/completeAuthorization. URL:en kan ha eller sakna en port. Utan port skulle URL:en ha följande format: https://<hostname>.<domainname>.com/capture/admin/faces/completeAuthorization

    Obs!:

    Du ska ännu inte skicka de inmatningar du gjort eller navigera bort från den här sidan. Du måste gå tillbaka till den här sidan för att konfigurera Google mail OAuth efter att du har skapat en Google Mail-app och hämtat klient-id och klienthemlighet. Du ska ange dem i fälten för Klient-id och Klienthemlighet.

Konfigurera en Google Mail-app för import av e-post

Så här konfigurerar du en Google Mail-app

  1. Gå till Google API-konsolen i ett annat webbläsarfönster.
  2. På sidan Hantera resurser visas en lista över projekten om du redan har skapat dem i Googles utvecklarkonsol. Gör följande, om du inte redan har gjort det:
    1. Klicka på SKAPA PROJEKT.
    2. Ange ett projektnamn.
    3. För att lättare kunna identifiera projekten i konsolen redigerar du Projekt-id genom att klicka på REDIGERA och ange ett meningsfullt id.
    4. Du måste välja en plats om du har definierat några organisationsresurser eller organisationsmappar. I annat fall accepterar du standardinställningarna och klickar på SKAPA.

      Projektet skapas och du omdirigeras till projektlistan i konsolen.

  3. Klicka på Ikonen för Googles utvecklarnavigering i det övre vänstra hörnet, välj API:er & tjänster och välj Infopanel.

    Obs!:

    Om du inte visar det nyskapade projektets infopanel väljer du projektet i listrutan i det övre vänstra hörnet.
  4. I den vänstra sidlisten klickar du på Bibliotek för att gå till sidan API-bibliotek. Sök sedan efter Gmail API-biblioteket och aktivera det.
  5. I det övre vänstra hörnet klickar du på Ikonen för Googles utvecklarnavigering, väljer API:er & tjänster och sedan OAuth-medgivandeskärm. Välj målanvändare på OAuth-medgivandeskärmen och klicka sedan på SKAPA.
  6. På sidan Redigera appregistrering, på fliken OAuth-medgivandeskärm:
    • I fältet Appnamn anger du produktens namn, t.ex. Gmail App.
    • I listrutan E-postadress för användarsupport väljer du e-postadressen för användarsupport.
    • Rulla ned till sektionen Utvecklarens kontaktinformation och ange din e-postadress i fältet E-postadresser.
    • Klicka på SPARA OCH FORTSÄTT.
  7. På fliken Omfattningar:
    1. Klicka på LÄGG TILL ELLER TA BORT OMFATTNINGAR.
    2. I sektionen Uppdatera valda omfattningar ska du antingen markera kryssrutorna för följande GMail-API-omfattningar eller manuellt ange dessa omfattningar i rutan Lägg till omfattningar manuellt och klicka på LÄGG TILL I TABELL. Klicka sedan på UPPDATERA.
    3. Klicka på SPARA OCH FORTSÄTT.

      Omfattningarna userinfo.email och userinfo.profile visas i sektionen Dina icke-känsliga omfattningar och omfattningen gmail.modify visas i sektionen Dina begränsade omfattningar på fliken Omfattningar.

  8. Gå till fliken Testanvändare och klicka på SPARA OCH FORTSÄTT.
  9. På fliken Översikt kan du granska inställningarna och sedan klicka på TILLBAKA TILL INFOPANELEN.
  10. Under Publiceringsstatus, i sektionen Test, klickar du på PUBLICERA APP och sedan klickar du på BEKRÄFTA i dialogrutan Vidarebefordra till produktion? så publiceras appen.
  11. Klicka på Inloggningsuppgifter i den vänstra sidlisten och gör sedan följande:
    1. På sidan Inloggningsuppgifter klickar du på SKAPA INLOGGNINGSUPPGIFTER och väljer OAuth-klient-id.
    2. I listrutan Applikationstyp väljer du Webbapplikation.
    3. Ge klienten ett namn, t.ex. Gmail OAuth-appklient.
    4. I Auktoriserade omdirigerings-URI:er klickar du på LÄGG TILL URI och klistrar in den omdirigerings-URL du kopierade från Content Capture-proceduren.
    5. I Auktoriserat JavaScript-ursprung klickar du på LÄGG TILL URI och klistrar in omdirigerings-URL:en, men tar bort allting efter domänen eller efter porten om URI:n inkluderar en port.
    6. Klicka på SKAPA.

      Värdena för klient-id och klienthemlighet visas i dialogrutan OAuth-klienten har skapats. Anteckna dessa värden och klicka sedan på OK.

      Nu kan du gå tillbaka till Content Capture i Oracle Content Management och börja där du lämnade. Börja alltså med att ange klient-id och klienthemlighet för att konfigurera Google mail OAuth.

Konfigurera Google Mail OAuth för e-postimport till Capture

Så här konfigurerar du inställningar för importprocessorjobb för e-post från Google Mail OAuth:

  1. Gå tillbaka till Capture-proceduren och börja där du lämnade.
  2. På fliken E-postkonton valde du anslutningsprotokollet Google Mail (OAuth). Ange nu det klient-id och den klienthemlighet som du kopierade vid konfigureringen av Google Mail-appen i fälten Klient-id och Klienthemlighet.

  3. I tabellen E-postkonton att bearbeta klickar du på Lägg till e-postkonto.

  4. Om du vill ge e-postprocessorjobbet åtkomst till e-postkontot anger du e-postadressen och lösenordet till det e-post-id du tänker använda på inloggningssidan till Google Mail.

  5. Bekräfta dina val genom att klicka på Godkänn.

    E-post-id:t visas i tabellen E-postkonton att bearbeta under kolumnen E-postadresser. Statusen ska vara Verifierad.

    Du kan lägga till fler Google Mail-id:n i den här tabellen genom att använda stegen du har följt hittills. Om du vill ta bort ett e-post-id markerar du dess rad i tabellen och klickar sedan på Ta bort e-post-id.

  6. På fliken Meddelandefilter anger du var och hur e-postmeddelanden och/eller bilagor ska sökas.

    1. I fältet Mappar att bearbeta anger du en eller flera mappar som ska sökas i de angivna e-postkontona. Standardvärdet är serverns inkorg. Om du vill ange flera mappar avgränsar du dem med ett ; (semikolon). Om du vill ange undermappar inkluderar du en sökvägsavgränsare som gäller för e-postservern, till exempel ett / (snedstreck), som i mapp/undermapp.

    2. Som standard bearbetar Content Capture alla e-postmeddelanden i den angivna mappen om inte ett meddelandefilter har tillämpats på jobbet. I tabellen Meddelandefilter kan du även välja fältet Aktiv för varje e-postelement som ska sökas och sedan ange tecken som ska sökas i fältet Fältet innehåller.

      Om du till exempel vill söka efter e-postmeddelanden vars ämne eller meddelandetext innehåller ordet betalning väljer du Aktiv för båda sökfälten, inkluderar payment i varje post Fältet innehåller och väljer sökoperatorn Eller.

    3. I fältet Sökoperator väljer du sökoperatorn som du ska använda för de angivna meddelandefiltren: Och (standard) importerar endast om alla sökkriterier matchar, medan Eller importerar om något sökkriterium matchar.

  7. På fliken Bearbetning anger du hur e-postmeddelandena och deras bilagor ska bearbetas. Du kan ange vilken information som ska inkluderas och prioriteten för att tilldela batcharna, baserat på e-postprioriteten.

    1. Under Alternativ för e-postmeddelande anger du om meddelandetextfilen ska importeras. Ange importformatet (text eller EML) och om det ska inkluderas när det inte finns någon bilaga och om hela e-postmeddelandet (inklusive bilagor) ska importeras som en EML-fil.

    2. I fältet Inkludera bilagor som matchar dessa masker anger du bifogade filer baserat på deras filmasker. Du kan ange flera filmasker avgränsade med ett komma eller semikolon. Du kan till exempel inkludera alla PDF-filer (*.pdf).

    3. I fältet Exkludera bilagor som matchar dessa masker anger du bifogade filer som ska exkluderas baserat på deras filmasker. Du kan ange flera filmasker avgränsade med ett komma eller semikolon.

    4. Du kan även välja Efterbearbeta alltid när bilagor inte matchar masker, Inkludera bilagor som matchar dessa masker och Exkludera bilagor som matchar dessa masker. Om det här fältet är aktivt och bilagorna inte matchar de angivna maskerna betraktas e-postimporten som inte utförd och efterbearbetad enligt inställningarna du anger i fältet Vid ej utförd import på fliken Efterbearbetning.

      Obs!:

      Fältet Efterbearbeta alltid när bilagor inte matchar masker är inaktivt när båda fälten Importera meddelandetextfil och Inkludera när inga bilagor finns är aktiva samtidigt.

    5. Under Dokumentsortering anger du ordningen på elementen (till exempel meddelandetext och bilagor) från ett e-postmeddelande som ska sorteras som dokument i importerade batchar.

    6. Under Inkludera i batchanteckning väljer du meddelandeelement (till exempel Mottaget datum/tid, Avsändaradress, Mottagaradress, Ämne och Meddelandetext).

    7. Under Batchprioritet kan du välja att tilldela en prioritet till varje ny batch baserat på dess e-postprioritet (låg, normal eller hög). Ange till exempel 8 i fältet Hög om du vill tilldela e-postmeddelanden med hög prioritet till en batchprioritet på 8 i Content Capture. E-postmeddelanden som inte tilldelas en prioritet får normal prioritet.

  8. På fliken Efterbearbetning anger du vad som händer med e-postmeddelanden när en import har eller inte har utförts. Du kan ta bort meddelanden, flytta dem till en angiven mapp inom e-postkontot eller, om importen inte utfördes, hindra meddelanden från att tas bort. Om jobbet till exempel körs regelbundet kan du hindra e-postmeddelanden som har importerats från att importeras igen genom att flytta dem till en angiven mapp.

  9. Slutför övriga sidor för importprocessorjobb enligt beskrivningen i Lägga till eller redigera ett importprocessorjobb.

Nu kan du testa e-postimportjobbet. Importprocessorn kontrollerar om det finns meddelanden i de konfigurerade e-postkontona och söker efter matchande e-postmeddelanden i mappar. Om matchande e-postmeddelanden hittas skapar importprocessorn en Content Capture-batch och ett dokument för varje dokument som importeras från e-postmeddelandet. Importprocessorn kan även fylla i metadatafält med e-postmetadata och ta bort importerade meddelanden eller flytta dem till en mapp.

Content Capture hämtar med jämna mellanrum e-postmeddelanden från e-postkontot som du konfigurerade på fliken E-postkonton. Om du däremot vill aktivera en e-postimport vid ett visst tillfälle väljer du ett e-postimportjobb i tabellen Importprocessorjobb och klickar på ikonen Kontrollera e-post. Den här ikonen är inaktiv om ditt e-postimportjobb är offline.