Google Mail (OAuth) instellen voor het importeren van e-mail

U kunt de importprocessor configureren voor het gebruik van Google Mail OAuth om bestanden die zijn bijgevoegd bij inkomende e-mailberichten en elementen in e-mailberichten, zoals onderwerp en hoofdtekst, te importeren in Content Capture. Elk geïmporteerd e-mailbericht wordt een batch. De e-mailelementen zoals bijlagen, hoofdtekst of het volledige e-mailbericht worden gemaakt als afzonderlijke documenten in de batch.

Raadpleeg de volgende onderwerpen om Google (OAuth) in te stellen voor het importeren van e-mail:

De omleidings-URL verkrijgen voor het maken van een Google Mail-app

Als u een ​​Google Mail-app wilt configureren, hebt u de Content Capture hostnaam en de details van de autorisatie-URL van de Oracle Content Management instance nodig waarmee u verbinding wilt maken.

Ga als volgt te werk om de omleidings-URL te verkrijgen:

  1. Meld u als beheerder aan bij Oracle Content Management en ga naar Content Capture.
  2. Open uw procedure en ga naar het tabblad Vastleggen.

  3. Klik in de tabel Importprocessortaken op Importprocessortaak toevoegen om een nieuwe taak te maken.

  4. Op de pagina 'Algemene instellingen':
    1. Geef een naam op in het veld Taaknaam importeren en een voorvoegsel in het veld Batchvoorvoegsel. Geïmporteerde batches krijgen een naam met dit voorvoegsel, gevolgd door een getal dat bij elke nieuwe batch wordt verhoogd.
    2. Zorg ervoor dat u in het veld Importbron de waarde E-mailbron selecteert.
  5. Selecteer op de pagina 'Instellingen importbron' in de sectie Verbindingsprotocol de optie Google Mail (OAuth).

    Er wordt een omleidings-URL weergegeven. Kopieer deze URL met de indeling https://<hostnaam>.<domeinnaam>.com:<port>/capture/admin/faces/completeAuthorization. Uw URL kan ook een poort bevatten. Zonder poort heeft de URL de volgende indeling: https://<hostnaam>.<domeinnaam>.com/capture/admin/faces/completeAuthorization

    Opmerking:

    Wacht met het versturen van uw invoer of het sluiten van de pagina. U moet terugkeren naar deze pagina om Google Mail OAuth te configureren, nadat u een Google Mail-app hebt gemaakt en de client-ID en het clientgeheim hebt verkregen. Geef deze op in de velden 'Client-ID' en 'Clientgeheim'.

Een Google Mail-app configureren voor het importeren van e-mail

Ga als volgt te werk om een Google Mail-app te configureren:

  1. Ga in een ander browservenster naar de console voor Google-API's.
  2. Als u al projecten hebt gemaakt in de Google Developers Console ziet u op de pagina Manage resources een lijst met uw projecten. Als u dit nog niet hebt gedaan, moet u het volgende doen:
    1. Klik op CREATE PROJECT.
    2. Voer een projectnaam in.
    3. Bewerk de project-ID door op EDIT te klikken en een betekenisvolle ID in te voeren, zodat u uw project eenvoudig in de console kunt identificeren.
    4. Selecteer een locatie als u organisatorische resources of mappen hebt gedefinieerd. Als dit niet het geval is, accepteert u de standaardwaarde en klikt u op CREATE.

      Het project wordt gemaakt en u wordt omgeleid naar uw projectlijst in de console.

  3. Klik in de linkerbovenhoek op het Google Developer-navigatiepictogram en selecteer achtereenvolgens APIs & Services en Dashboard.

    Opmerking:

    Als het dashboard van het recent gemaakte project niet zichtbaar is, selecteert u uw project in de dropdownlijst in de linkerbovenhoek.
  4. Klik op de linkerzijbalk op Library om naar de pagina API Library te gaan. Zoek vervolgens naar de bibliotheek Gmail API en activeer deze.
  5. Klik in de linkerbovenhoek op het Google Developer-navigatiepictogram en selecteer achtereenvolgens APIs & Services en OAuth consent screen. Kies uw doelgebruikers in het OAuth-toestemmingsscherm en klik vervolgens op CREATE.
  6. Op het tabblad OAuth consent screen van de pagina 'Edit app registration':
    • Voer in het veld App name uw productnaam in, bijvoorbeeld 'Gmail App'.
    • Selecteer in de dropdownlijst User support email uw e-mailadres voor gebruikersondersteuning.
    • Schuif omlaag naar de sectie Developer contact information en voer in het veld Email addresses uw e-mailadres in.
    • Klik op SAVE AND CONTINUE.
  7. Op het tabblad Scopes:
    1. Klik op ADD OR REMOVE SCOPES.
    2. Schakel in de sectie Update selected scopes selectievakjes in voor de volgende GMAIL API-bereikwaarden of voer deze bereikwaarden in het vak Manually add scopes handmatig in en klik op ADD TO TABLE. Klik vervolgens op UPDATE.
    3. Klik op SAVE AND CONTINUE.

      De bereikwaarden userinfo.email en userinfo.profile worden weergegeven in de sectie Your non-sensitive scopes en het bereik gmail.modify wordt weergegeven in de sectie Your restricted scopes op het tabblad Scopes.

  8. Klik op het tabblad Test users op SAVE AND CONTINUE.
  9. Op het tabblad Summary kunt u uw instellingen bekijken en vervolgens op BACK TO DASHBOARD klikken.
  10. Klik in de sectie Testing onder Publishing Status op PUBLISH APP en klik vervolgens in het dialoogvenster Push to production? op CONFIRM om de publicatie te publiceren.
  11. Klik in de linkerzijbalk op Credentials en doe vervolgens het volgende:
    1. Klik op de pagina Credentials op CREATE CREDENTIALS en selecteer vervolgens OAuth client ID.
    2. Selecteer in de dropdownlijst Application type de optie Web application.
    3. Geef de client een naam, bijvoorbeeld Gmail OAuth App-client.
    4. Klik in Authorized redirect URIs op ADD URI en plak de omleidings-URL die u uit uw Content Capture procedure hebt gekopieerd.
    5. Klik in Authorized JavaScript origins op ADD URI en plak de omleidings-URL maar verwijder alles na het domein of na de poort als uw URI een poort bevat.
    6. Klik op CREATE.

      De waarden van uw client-ID en clientgeheim worden weergegeven in het dialoogvenster OAuth client created. Noteer deze waarden en klik vervolgens op OK.

      Ga nu terug naar Content Capture in Oracle Content Management en ga verder vanaf het punt waar u bent gebleven. Begin dus met het invoeren van de client-ID en het clientgeheim om Google Mail OAuth te configureren.

Google Mail (OAuth) configureren voor het importeren van e-mail uit Capture

Ga als volgt te werk om de instellingen van de importprocessortaak voor Google Mail (OAuth) te configureren:

  1. Ga terug naar uw Capture procedure en ga verder vanaf het punt waar u bent gebleven.
  2. Op het tabblad E-mailaccounts hebt u het verbindingsprotocol Google Mail (OAuth) geselecteerd. Voer nu in de velden Client-ID en Clientgeheim de client-ID en het geheim in die u hebt gekopieerd bij het configureren van uw Google Mail-app.

  3. Klik in de tabel Te verwerken e-mailaccounts op E-mailaccount toevoegen.

  4. Als u de e-mailprocessortaak toegang wilt verlenen tot het e-mailaccount, moet u op de aanmeldingspagina van Google Mail het e-mailadres en wachtwoord invoeren van de e-mail-ID die u gaat gebruiken.

  5. Bevestig uw keuzes door op Toestaan te klikken.

    De e-mail-ID wordt weergegeven in de tabel Te verwerken e-mailaccounts, in de kolom E-mailadressen. De status hiervan moet Geverifieerd zijn.

    U kunt meer Google Mail-ID's aan deze tabel voegen. Gebruik hiervoor de eerder gevolgde stappen. Als u een e-mail-ID wilt verwijderen, selecteert u de betreffende rij in de tabel en klikt u vervolgens op E-mail-ID verwijderen.

  6. Geef op het tabblad Berichtenfilters op waar en op welke manier er moet worden gezocht naar e-mailberichten en/of bijlagen.

    1. Geef in het veld Te verwerken mappen een of meerdere mappen binnen de opgegeven e-mailaccounts op waarin u wilt zoeken. De standaardwaarde is de inbox van de server. Als u meerdere mappen wilt selecteren, moet u deze scheiden door middel van een puntkomma (;). Als u submappen wilt opgeven, gebruikt u een padscheidingsteken dat geschikt is voor de mailserver, zoals een / (slash) in map/submap.

    2. Standaard wordt in Content Capture alle e-mail in de opgegeven mappen verwerkt, tenzij er een berichtenfilter is toegepast op de taak. Indien gewenst kunt u in de tabel Berichtenfilters het veld Geactiveerd selecteren voor alle e-mailelementen waarin u wilt zoeken. Vervolgens voert u in het veld Veld bevat tekens in waarnaar u wilt zoeken.

      Bijvoorbeeld: als u wilt zoeken naar e-mails met het woord betaling in de onderwerpregel of in de hoofdtekst van de e-mail, selecteert u Geactiveerd bij beide zoekvelden, voert u betaling in bij beide items Veld bevat en selecteert u de zoekoperator Of.

    3. Selecteer in het veld Zoekoperator de zoekoperator die u voor de opgegeven berichtenfilters wilt gebruiken: bij de standaardoptie En wordt er alleen geïmporteerd als alle zoekcriteria overeenkomen, terwijl er bij Of wordt geïmporteerd als een van de zoekcriteria overeenkomt.

  7. Geef op het tabblad Verwerking op hoe de e-mailberichten en de bijbehorende bijlagen moeten worden verwerkt. U kunt op basis van de e-mailprioriteit opgeven welke informatie er moet worden opgenomen en welke prioriteit de batches moeten krijgen.

    1. Geef onder Opties voor e-mailbericht op of het bestand met berichthoofdtekst moet worden geïmporteerd. Geef het importformaat (tekst of EML) op, geef op of het bestand moet worden opgenomen als er geen bijlagen zijn en geef op of het gehele e-mailbericht (inclusief bijlagen) als een EML-bestand moet worden geïmporteerd.

    2. Geef in het veld Bijlagen opnemen die overeenkomen met deze maskers bijlagebestanden op basis van hun bestandsmaskers op. U kunt meerdere bestandsmaskers opgeven, gescheiden door een komma of een puntkomma. U kunt bijvoorbeeld alle PDF-bestanden (*.pdf) opnemen.

    3. Geef in het veld Bijlagen uitsluiten die overeenkomen met deze maskers bijlagebestanden op die op basis van hun bestandsmaskers moeten worden uitgesloten. U kunt meerdere bestandsmaskers opgeven, gescheiden door een komma of een puntkomma.

    4. Selecteer desgewenst Altijd naverwerken als bijlagen niet overeenkomen met masker(s), Bijlagen opnemen die overeenkomen met deze maskers en Bijlagen uitsluiten die overeenkomen met deze maskers. Als dit veld is geactiveerd en de bijlagen komen niet overeen met de opgegeven maskers, wordt de e-mailimport als mislukt beschouwd en naverwerkt volgens de door u opgegeven instellingen in het veld Bij mislukte import in het tabblad Naverwerking.

      Opmerking:

      Het veld Altijd naverwerken als bijlagen niet overeenkomen met masker(s) wordt uitgeschakeld als de velden Bestand met berichthoofdtekst importeren en Opnemen als er geen bijlagen zijn beide worden ingeschakeld.

    5. Geef bij Documentvolgorde de volgorde op waarin de elementen van een e-mailbericht (bijvoorbeeld hoofdbericht van tekst en bijlagen) moeten worden geplaatst als documenten in geïmporteerde batches.

    6. Selecteer berichtelementen bij Opnemen in batchnotitie (zoals Ontvangstdatum/-tijd, Adres afzender, Adres ontvanger, Onderwerp en Hoofdtekst van bericht).

    7. Bij Batchprioriteit kunt u desgewenst een prioriteit aan elke nieuwe batch toewijzen op basis van de e-mailprioriteit (laag, normaal of hoog). U kunt bijvoorbeeld '8' invoeren in het veld Hoog om in Content Capture een batchprioriteit van 8 toe te wijzen aan e-mails met hoge prioriteit. E-mails zonder prioriteit worden beschouwd als hebbende een normale prioriteit.

  8. Geef op de pagina Naverwerking aan wat er met e-mailberichten moet gebeuren na een geslaagde of mislukte importbewerking. U kunt berichten verwijderen, berichten verplaatsen naar een opgegeven map binnen de e-mailaccount of, bij van een mislukte importbewerking, voorkomen dat berichten worden verwijderd. U kunt bijvoorbeeld, als de taak regelmatig wordt uitgevoerd, voorkomen dat succesvol geïmporteerde e-mails opnieuw worden geïmporteerd door deze naar een opgegeven map te verplaatsen.

  9. Overige pagina's van de importprocessortaak voltooien zoals beschreven in Importprocessortaken toevoegen of bewerken.

U kunt nu de e-mailimporttaak testen. De importprocessor controleert de geconfigureerde e-mailaccounts op berichten en zoekt in mappen naar overeenkomende e-mails. Als er overeenkomende e-mails zijn gevonden, maakt de importprocessor een Content Capture batch en een document voor elk document dat vanuit het e-mailbericht wordt geïmporteerd. Desgewenst vult de importprocessor metagegevensvelden met metagegevens van e-mails en worden succesvol geïmporteerde berichten verwijderd of naar een map verplaatst.

E-mailberichten worden periodiek in Content Capture opgehaald uit de e-mailaccount die u hebt geconfigureerd op het tabblad E-mailaccounts. Als u echter op een bepaald tijdstip een e-mailimport wilt triggeren, selecteert u een e-mailimporttaak in de tabel Importprocessortaken en klikt u op het pictogram E-mail controleren. Dit pictogram wordt uitgeschakeld als u e-mailimporttaak offline is.