Konfigurowanie Google Mail (OAuth) do importu e-maili

Procesor importu można skonfigurować do używania protokołu Google Mail OAuth do importu (do Content Capture) plików załączonych do przychodzących e-maili, wraz elementami wiadomości, takimi jak teksty tematu i treści. Każda zaimportowana wiadomość e-mail staje się partią, z elementami wiadomości (takimi jak załączniki, treść wiadomości lub cała wiadomość) utworzonymi w partii jako osobne dokumenty.

Aby skonfigurować import e-maili z Google OAuth, należy wykonać następujące zadania:

Uzyskanie adresu URL przekierowania w celu utworzenia aplikacji Google Mail

Do skonfigurowania aplikacji Google Mail są potrzebne nazwa hosta Content Capture oraz szczegóły adresu URL autoryzacji używanej instancji Oracle Content Management, z którą ma zostać nawiązane połączenie.

Aby uzyskać URL przekierowania, należy:

Zalogować się do Oracle Content Management jako administrator, a następnie przejść do usługi Content Capture.
Otworzyć procedurę, po czym przejść do karty Capture.
Aby utworzyć nowe zlecenie, kliknąć w tabeli Zlecenia dla procesora importu na ikonie .
Na stronie "Ustawienia ogólne":
1. W polu Nazwa zlecenia importu wprowadzić nazwę, a w polu Prefiks partii podać prefiks. Importowane partie są nazywane przy użyciu tego prefiksu, po którym następuje numer, który zwiększa się z każdą nową partią.
2. Upewnić się, że w polu Źródło importu jest wybrane Źródło e-maili.
Na stronie "Ustawienia źródła importu" wybrać w sekcji Protokół połączenia opcję Google Mail (OAuth).
Zostaje wyświetlony URL przekierowania. Skopiować ten URL, którego format ma następującą postać: https://<nazwa_hosta>.<nazwa_domeny>.com:<port>/capture/admin/faces/completeAuthorization. URL może zawierać port (nie musi). URL bez portu URL ma następujący format: https://<nazwa_hosta>.<nazwa_domeny>.com/capture/admin/faces/completeAuthorization

Uwaga:
Nie należy jeszcze przesyłać danych wejściowych ani opuszczać tej strony. Trzeba do niej wrócić w celu skonfigurowania protokołu OAuth poczty Google po utworzeniu aplikacji Google Mail i uzyskaniu ID klienta oraz tajnego klucza klienta. Wartości te trzeba będzie wprowadzić w polach "ID klienta" i "Tajny klucz klienta".

Konfigurowanie aplikacji Google Mail do importu e-maili

Aby skonfigurować aplikację Google Mail, należy:

Przejść w innym oknie przeglądarki do konsoli Google API.
Na stronie Zarządzaj zasobami będzie wyświetlana lista projektów, o ile takie zostały utworzone w konsoli dewelopera Google. Jeśli jeszcze nie został utworzony żaden projekt:
1. Nacisnąć przycisk UTWÓRZ PROJEKT.
2. W polu Nazwa projektu wpisać nazwę projektu.
3. Aby ułatwić sobie rozpoznawanie projektu w konsoli, edytować ID projektu. W tym celu nacisnąć przycisk EDYTUJ, po czym wprowadzić zrozumiały ID.
4. Jeśli zostały zdefiniowane zasoby lub foldery organizacyjne, trzeba wybrać lokalizację. W przeciwnym razie zaakceptować ustawienie domyślne, po czym nacisnąć przycisk UTWÓRZ.
  Projekt zostanie utworzony, po czym nastąpi przekierowanie do listy projektów w konsoli.
Kliknąć na ikonie znajdującej się w lewym górnym rogu, po czym wybrać opcję Interfejsy API i usługi, a następnie Panel.

Uwaga:
Jeśli nie jest wyświetlany panel (pulpit informacyjny) ostatnio utworzonego projektu, wybrać projekt z rozwijanej listy znajdującej się w lewym górnym rogu.
Na lewym pasku bocznym kliknąć na pozycji Biblioteka, aby przejść na stronę Biblioteka API. Odszukać bibliotekę Gmail API i włączyć ją.
Kliknąć na ikonie znajdującej się w lewym górnym rogu, po czym wybrać opcję Interfejsy API i usługi, a następnie Ekran akceptacji OAuth. Na ekranie akceptacji OAuth wybrać użytkowników docelowych, po czym nacisnąć przycisk UTWÓRZ.
Na stronie "Edytowanie rejestracji aplikacji", na karcie Ekran akceptacji OAuth:
- W polu Nazwa aplikacji wpisać nazwę swojego produktu, na przykład "Gmail App".
- Z rozwijanej listy Adres e-mail dla użytkowników potrzebujących pomocy wybrać swój adres e-mail.
- Przejść w dół do sekcji Dane kontaktowe dewelopera, po czym wpisać w polu Adresy e-mail swój adres e-mail.
- Nacisnąć przycisk ZAPISZ I KONTYNUUJ.
Na karcie Zakresy:
1. Nacisnąć przycisk DODAJ LUB USUŃ ZAKRESY.
2. W sekcji Aktualizuj wybrane zakresy zaznaczyć pola wyboru zakresów Gmail API albo ręcznie wprowadzić zakresy w polu Ręczne dodawanie zakresów, po czym nacisnąć przycisk DODAJ DO TABELI. Nacisnąć przycisk ZAKTUALIZUJ.
3. Nacisnąć przycisk ZAPISZ I KONTYNUUJ.
  Na karcie Zakresy zostaje w sekcji Twoje zakresy niewrażliwe wyświetlony zakres userinfo.email i zakres userinfo.profile, a w sekcji Twoje zakresy wrażliwe — zakres gmail.modify.
Na karcie Użytkownicy testowi nacisnąć przycisk ZAPISZ I KONTYNUUJ.
Na karcie Podsumowanie sprawdzić wprowadzone ustawienia, po czym nacisnąć przycisk POWRÓT DO PANELU.
W obszarze Stan publikacji, w sekcji Testuję nacisnąć przycisk OPUBLIKUJ APLIKACJĘ, po czym w oknie dialogowym Przenieść do środowiska produkcyjnego? nacisnąć przycisk POTWIERDŹ, aby tę aplikację opublikować.
W lewym pasku bocznym kliknąć na pozycji Dane logowania, po czym:
1. Na stronie Dane logowania nacisnąć przycisk UTWÓRZ DANE LOGOWANIA, po czym wybrać Identyfikator klienta OAuth.
2. Z rozwijanej listy Typ aplikacji wybrać opcję Aplikacja internetowa.
3. Nadać nazwę klientowi, na przykład Gmail OAuth App Client.
4. W sekcji Autoryzowane identyfikatory URI przekierowania nacisnąć przycisk DODAJ URI, po czym wkleić URL przekierowania skopiowany z procedury Content Capture.
5. W sekcji Autoryzowane źródła JavaScriptu nacisnąć przycisk DODAJ URI, po czym wkleić URL przekierowania i usunąć wszystko, co występuje po domenie lub po porcie (jeśli URI zawiera port).
6. Nacisnąć przycisk UTWÓRZ.
  W oknie dialogowym Klient OAuth został utworzony zostają wyświetlone wartości "Twój identyfikator klienta" i "Twój tajny klucz klienta". Wartości te należy zanotować, po czym nacisnąć przycisk OK.
  
  Teraz można wrócić do usługi Content Capture w Oracle Content Management i zacząć od miejsca wyjścia. Inaczej mówiąc, wprowadzić ID klienta i tajny klucz klienta w celu skonfigurowania protokołu OAuth poczty Google.

Konfigurowanie Google Mail OAuth do importu e-maili do Content Capture

Aby skonfigurować ustawienia Google Mail OAuth zlecenia dla procesora importu e-maili, należy:

Powrócić do procedury Capture, po czym przejść do miejsca wyjścia z niej.
Na karcie Konta e-mailowe wybrano protokół połączenia Google Mail (OAuth). Teraz należy wprowadzić ID i tajny klucz klienta, skopiowane z pól ID klienta i Tajny klucz klienta w trakcie konfigurowania aplikacji Google Mail.
W tabeli Konta e-mailowe do przetworzenia kliknąć na ikonie .
Aby zleceniu dla procesora importu zapewnić dostęp do konta e-mailowego, na stronie logowania do Google Mail, wprowadzić adres i hasło dla identyfikatora, który będzie używany.
Potwierdzić swój wybór, naciskając przycisk Zezwalaj.

Identyfikator poczty elektronicznej jest wyświetlany w tabeli Konta e-mailowe do przetworzenia, w kolumnie Adresy e-mail. Powinien mieć status Zweryfikowano.

Powtarzając powyższe czynności, można dodać do tej tabeli dalsze identyfikatory Google Mail. Aby usunąć ID poczty elektronicznej, należy wybrać w tabeli jego wiersz, po czym kliknąć na ikonie .
Na karcie Filtry wiadomości określić, gdzie i jak mają być szukane wiadomości i/lub załączniki.
1. W polu Foldery do przetworzenia wprowadzić foldery, które mają być przeszukiwane na określonych kontach e-mailowych. Wartością domyślną jest skrzynka odbiorcza serwera. Określając więcej niż jeden folder, należy rozdzielić je średnikiem (;). Określając podfoldery, należy użyć separatora segmentów ścieżki właściwego dla serwera poczty, na przykład ukośnika (/), jak w zapisie "folder/podfolder".
2. Domyślnie Content Capture przetwarza wszystkie e-maile z określonego folderu, chyba że do zlecenia został zastosowany filtr wiadomości. Opcjonalnie można dla każdego szukanego elementu e-maila wybrać w tabeli Filtry wiadomości pole Włączone, po czym wprowadzić w polu Pole zawiera odpowiednie znaki.
  
  Na przykład, aby były wyszukiwane e-maile, w których temacie lub treści występuje wyraz płatność, należałoby dla obu pól wyszukiwania wybrać opcję Włączone, wpisać tekst płatność w obu polach Pole zawiera oraz wybrać operator wyszukiwania Lub.
3. W polu Operator wyszukiwania wybrać operator, który ma być używany dla określonych filtrów wiadomości: przy operatorze I (operator domyślny) muszą być spełnione wszystkie kryteria wyszukiwania, a przy operatorze Lub — którekolwiek.
Na karcie Przetwarzanie określić, w jaki sposób mają być przetwarzane wiadomości i załączniki do nich. Można określić, które informacje mają być uwzględniane, oraz priorytet przypisywany do partii na podstawie priorytetu e-maila.
1. W polu Opcje wiadomości e-mail określić, czy ma być importowany plik treści wiadomości. Należy określić format importu (tekstowy lub EML) oraz, czy treść ma być uwzględniana, jeśli nie ma załączników do wiadomości, a także, czy ma być importowana cała wiadomość wraz z załącznikami.
2. W polu Uwzględniaj załączniki zgodne z tymi maskami określić maski uwzględnianych plików załączników. Można podać więcej niż jedną maskę, rozdzielając je przecinkiem lub średnikiem. Na przykład można zlecić uwzględnianie wszystkich plików PDF (*.pdf).
3. W polu Wykluczaj załączniki zgodne z tymi maskami określić maski wykluczanych plików załączników. Można podać więcej niż jedną maskę, rozdzielając je przecinkiem lub średnikiem.
4. Opcjonalnie: Wybrać opcje Zawsze wykonuj przetwarzanie końcowe, gdy załączniki nie są zgodne z maską/maskami, Uwzględniaj załączniki zgodne z tymi maskami oraz Wykluczaj załączniki zgodne z tymi maskami. Jeśli to pole zostanie włączone i załączniki nie będą zgodne z określonymi maskami, proces importu e-maili zostanie uznany za niepomyślny i dalsze przetwarzanie będzie się odbywać zgodnie z ustawieniami określonymi w polu Po niepowodzeniu importu na karcie Przetwarzanie końcowe.
  
  Uwaga:
  Pole Zawsze wykonuj przetwarzanie końcowe, gdy załączniki nie są zgodne z maską/maskami jest wyłączone, gdy jednocześnie są włączone pola Importuj plik treści wiadomości oraz Dołącz, gdy nie istnieje żaden załącznik.
5. W polu Porządkowanie dokumentów określić kolejność, w jakiej elementy (na przykład treść wiadomości i załączniki) wiadomości e-mail mają być ustawiane jako dokumenty w importowanych partiach.
6. W polu Uwzględnij w uwadze dot. partii wybrać elementy wiadomości (takie jak Data/godzina otrzymania, Adres nadawcy, Adres odbiorcy, Temat i Treść wiadomości).
7. W polu Priorytet partii opcjonalnie wybrać przypisywanie priorytetu do każdej nowej partii na podstawie priorytetu e-maila (niski, zwykły lub wysoki). Na przykład można w polu Wysoki wpisać wartość 8, aby e-mailom o wysokim priorytecie przypisywać w Content Capture priorytet "8" partii. E-maile niemające przypisanego priorytetu są traktowane jako e-maile o priorytecie zwykłym.
Na karcie Przetwarzanie końcowe określić, co ma się dziać z wiadomościami e-mail po powodzeniu lub niepowodzeniu importu. Wiadomości można usuwać, przenosić do określonego folderu na koncie e-mailowym lub — w przypadku niepowodzenia importu — chronić przed usunięciem. Na przykład, jeśli zlecenie jest uruchamiane okresowo, można zapobiec ponownemu importowaniu pomyślnie zaimportowanych wiadomości, przenosząc je do określonego folderu.
Wypełnić inne strony zlecenia dla procesora importu zgodnie z opisem Dodawanie lub edytowanie zlecenia dla procesora importu.

Teraz można przetestować zlecenie importu e-maili. Procesor importu sprawdza, czy na skonfigurowanych kontach znajdują się wiadomości i wyszukuje w folderach zgodne e-maile. Jeśli zostaną znalezione zgodne e-maile, procesor importu tworzy partię Content Capture oraz osobne dokumenty dla każdego z dokumentów importowanych z wiadomości e-mail. Opcjonalnie procesor importu wypełnia pola metadanych metadanymi e-maila oraz usuwa pomyślnie zaimportowane wiadomości lub przenosi je do określonego folderu.

Okresowo Content Capture pobiera e-maile z konta e-mailowego, skonfigurowanego na karcie Konta e-mailowe. Chcąc samodzielnie uaktywnić import e-maili, należy wybrać w tabeli Zlecenia dla procesora importu zlecenie importu e-maili, po czym kliknąć na ikonie . Ikona ta jest wyłączana, jeśli zlecenie importu e-maili jest ustawione jako "offline".