Настройка Google Mail (OAuth) для импорта электронной почты

Обработчик импорта можно настроить на использование Google Mail OAuth для импорта в приложение Content Capture файлов, прикрепленных к входящим сообщениям электронной почты вместе с элементами сообщений электронной почты, такими как тема и основной текст. Каждое импортированное сообщение электронной почты становится пакетом, в котором элементы электронной почты, такие как вложения, текст сообщения или все сообщения электронной почты, создаются как отдельные документы в пакете.

Действия, которые необходимо выполнить для настройки импорта электронной почты Google (OAuth):

Получение URL-адреса перенаправления для создания приложения Google Mail

Чтобы настроить приложение Google Mail, необходимо указать имя хоста и URL-адрес авторизации Content Capture для экземпляра Oracle Content Management, к которому требуется подключение.

Чтобы получить URL-адрес перенаправления выполните указанные ниже действия.

  1. Войдите в систему Oracle Content Management как администратор и перейдите в раздел "Захват контента".
  2. Откройте свою процедуру и перейдите на вкладку Захват.

  3. В таблице Задания обработчика импорта нажмите Добавить задание обработчика импорта, чтобы создать новое задание.

  4. На странице "Общие настройки" выполните указанные ниже действия.
    1. Введите имя в поле Имя задания импорта и префикс в поле Префикс пакета. Импортируемые пакеты именуются с использованием этого префикса, за которым следует число, которое увеличивается с каждым новым пакетом.
    2. В поле Источник импорта убедитесь, что выбран Источник эл. почты.
  5. На странице "Настройки источника импорта" в разделе Протокол подключения выберите Google Mail (OAuth).

    Отобразится URL-адрес перенаправления. Скопируйте этот URL-адрес в формате https://<hostname>.<domainname>.com:<port>/capture/admin/faces/completeAuthorization. Возможно, для вашего URL-адреса нет порта. Без порта URL-адрес будет иметь следующий формат: https://<hostname>.<domainname>.com/capture/admin/faces/completeAuthorization

    Примечание.:

    Не отправляйте свои входные данные и не переходите с этой страницы. После создания приложения Google Mail и получения идентификатора и секретного кода клиента необходимо вернуться на эту страницу, чтобы настроить Google Mail OAuth. Полученные данные необходимо ввести в поля "Идентификатор клиента" и "Секретный код клиента" соответственно.

Настройка приложения Google Mail для импорта электронной почты

Чтобы настроить приложение Google Mail, выполните указанные ниже действия.

  1. Перейдите на консоль Google API в другом окне браузера.
  2. На странице Управление ресурсами отобразится список проектов, если они уже были созданы на консоли Google Developers. Если вы еще не выполнили указанные ниже действия, сделайте это.
    1. Нажмите СОЗДАТЬ ПРОЕКТ.
    2. Введите Имя проекта.
    3. Чтобы упростить идентификацию проекта на консоли, отредактируйте Идентификатор проекта, для чего нажмите кнопку РЕДАКТИРОВАТЬ и введите значимый идентификатор.
    4. Необходимо выбрать местоположение, если были определены какие-либо организационные ресурсы или папки. В противном случае примите значения по умолчанию и нажмите СОЗДАТЬ.

      Создается проект и выполняется перенаправление к списку ваших проектов в консоли.

  3. В левом верхнем углу нажмите Значок навигации Google developer, выберите API и услуги, затем выберите Инфопанель.

    Примечание.:

    Если недавно созданная инфопанель проекта не отображается, выберите проект в раскрывающемся списке в левом верхнем углу.
  4. На левой боковой панели нажмите Библиотека, чтобы перейти на страницу Библиотека API. Найдите библиотеку Gmail API и включите ее.
  5. В левом верхнем углу нажмите Значок навигации Google developer, выберите API и услуги, а затем Экран согласия OAuth. Выберите целевых пользователей на "Экране согласия OAuth" и нажмите СОЗДАТЬ.
  6. На странице "Редактирование регистрации приложений" на вкладке Экран согласия OAuth выполните указанные ниже действия.
    • В поле Имя приложения введите название продукта, например, Gmail App
    • В раскрывающемся списке Адрес эл. почты службы поддержки пользователей выберите свой адрес электронной почты для поддержки пользователей.
    • Выполните прокрутку вниз до раздела Контактная информация разработчика и в поле Адреса эл. почты введите свой адрес электронной почты.
    • Нажмите СОХРАНИТЬ И ПРОДОЛЖИТЬ.
  7. На вкладке Области выполните указанные ниже действия.
    1. Нажмите ДОБАВИТЬ ИЛИ УДАЛИТЬ ОБЛАСТИ.
    2. В разделе Обновить выбранные области установите флажки для указанных ниже областей GMail API или вручную введите эти области в поле Добавить области вручную и нажмите ДОБАВИТЬ В ТАБЛИЦУ. Затем нажмите ОБНОВИТЬ.
    3. Нажмите СОХРАНИТЬ И ПРОДОЛЖИТЬ.

      Области userinfo.email и userinfo.profile отображаются в разделе Ваши неконфиденциальные области, а область gmail.modify отображается в разделе Ваши ограниченные области на вкладке Области.

  8. На вкладке Тестовые пользователи нажмите СОХРАНИТЬ И ПРОДОЛЖИТЬ.
  9. На вкладке Сводка можно просмотреть настройки, а затем нажать НАЗАД К ИНФОПАНЕЛИ.
  10. В поле Статус публикации в разделе Тестирование нажмите ПУБЛИКОВАТЬ ПРИЛОЖЕНИЕ, а затем в диалоговом окне Передать в производство? нажмите ПОДТВЕРДИТЬ, чтобы опубликовать приложение.
  11. На левой панели нажмите Учетные данные и выполните указанные ниже действия.
    1. На странице Учетные данные нажмите СОЗДАТЬ УЧЕТНЫЕ ДАННЫЕ и выберите Идентификатор клиента OAuth.
    2. В раскрывающемся списке Тип приложения выберите Веб-приложение.
    3. Присвойте клиенту имя, например Клиент приложения Gmail OAuth.
    4. В разделе Авторизованные URI перенаправления нажмите ДОБАВИТЬ URI и вставьте URL-адрес перенаправления, скопированный из процедуры Content Capture.
    5. В разделе Авторизованные источники JavaScript нажмите ДОБАВИТЬ URI и вставьте URL-адрес перенаправления, но удалите все символы, которые следуют после домена или после порта, если URI содержит порт.
    6. Нажмите СОЗДАТЬ.

      Значения идентификатора клиента и секретного кода клиента отображаются в диалоговом окне Клиент OAuth создан. Запишите эти значения и нажмите OK.

      Теперь вернитесь к Content Capture в Oracle Content Management и начните с того места, где вы остановились. То есть, начните с ввода идентификатора клиента и секретный код, чтобы настроить Google Mail OAuth.

Настройка Google Mail OAuth для импорта электронной почты Capture

Чтобы задать настройки задания импорта электронной почты Google Mail OAuth, выполните указанные ниже действия.

  1. Вернитесь к процедуре захвата и начните с того места, где вы остановились.
  2. На вкладке Учетные записи эл. почты вы выбрали протокол подключения Google Mail (OAuth). Теперь введите идентификатор и секретный код клиента, скопированные во время настройки приложения Google Mail, в поля Идентификатор клиента и Секретный код клиента.

  3. В таблице Учетные записи электронной почты для обработки нажмите Добавить учетную запись электронной почты.

  4. Чтобы предоставить заданию обработчика электронной почты доступ к учетной записи электронной почты, на странице входа в Google Mail введите адрес электронной почты и пароль, соответствующие идентификатору электронной почты, который вы собираетесь использовать.

  5. Подтвердите свой выбор, нажав Разрешить.

    Идентификатор электронной почты отображается в таблице Учетные записи электронной почты для обработки в столбце Адреса электронной почты. Его статус должен быть Проверено.

    В эту таблицу можно добавить дополнительные идентификаторы Google Mail, выполнив указанные ниже действия. Чтобы удалить идентификатор электронной почты, выберите его строку в таблице и нажмите Удалить идентификатор электронной почты.

  6. На вкладке Фильтры сообщений укажите, где и как искать сообщения электронной почты и/или вложения.

    1. В поле Папки для обработки укажите одну или несколько папок для поиска в указанных учетных записях электронной почты. Значение по умолчанию — папка "Входящие" на сервере. Чтобы указать несколько папок, разделяйте их символом ";" (точка с запятой). Чтобы указать подпапки, используйте разделитель пути, применимый для почтового сервера, например "/" (косая черта), как в "папка/подпапка".

    2. По умолчанию Content Capture обрабатывает все сообщения электронной почты в указанной папке, если к заданию не применен фильтр сообщений. При необходимости в таблице Фильтры сообщений установите флажок Включено для каждого элемента электронной почты, который требуется найти, затем введите символы в поле Поле содержит.

      Например, для поиска сообщений электронной почты, тема или тело сообщения которых содержит слово платеж, необходимо установить флажок Включено для обоих полей поиска, включить платеж в каждую запись в Поле содержит и выбрать оператор поиска Or.

    3. В поле Оператор поиска выберите оператор поиска, который будет использоваться для указанных фильтров сообщений: And (по умолчанию) — импорт, только если все критерии поиска совпадают, а Or — импорт, если совпадает любой из критериев поиска.

  7. На вкладке Обработка укажите способ обработки сообщений электронной почты и их вложений. Можно указать, какую информацию включить, и приоритет для назначения пакетам на основе приоритета электронной почты.

    1. В разделе Параметры сообщения электронной почтыукажите, следует ли импортировать файл тела сообщения. Выберите формат импорта (текст или EML) и укажите, следует ли включать его при отсутствии вложений, а также следует ли импортировать все сообщения электронной почты (включая вложения) в виде EML-файла.

    2. В поле Включить вложения, соответствующие этим маскам, укажите файлы вложений на основе их масок файлов. Можно ввести несколько масок файлов, разделенных запятой или точкой с запятой. Например, можно включить все PDF-файлы (*.pdf).

    3. В поле Исключить вложения, соответствующие этим маскам, укажите файлы вложений, исключаемые на основе их масок файлов. Можно ввести несколько масок файлов, разделенных запятой или точкой с запятой.

    4. При необходимости выберите Всегда выполнять постобработку, если вложения не соответствуют маскам, Включите вложения, соответствующие этим маскам и Исключить вложения, соответствующие этим маскам. Если это поле включено и вложения не соответствуют указанным маскам, импорт электронной почты считается невыполненным и выполняется постобработка в соответствии с настройками, заданными в поле При неудачном импорте на вкладке Постобработка.

      Примечание.:

      Поле Всегда выполнять постобработку, если вложения не соответствуют маскам отключено, если одновременно включены поля Импортировать файл тела сообщения и Включить, если нет вложений.

    5. В разделе Порядок документов укажите порядок, в котором элементы (например, тело сообщения и вложения) из сообщения электронной почты будут упорядочены в импортированных пакетах в виде документов.

    6. В разделе Включить в примечание пакета выберите элементы сообщения (например, Дата/время получения, Исходящий адрес, Адрес получателя, Тема и Тело сообщения).

    7. В разделе Приоритет пакетаможно дополнительно назначить приоритет каждому новому пакету в зависимости от приоритета его электронной почты (низкий, нормальный или высокий). Например, в поле Высокий введите 8, чтобы в Content Capture назначить сообщениям электронной почты с высоким приоритетом приоритет пакета 8. Считается, что у сообщений электронной почты, которым приоритет не назначен, обычный приоритет.

  8. На вкладке Постобработка укажите, что происходит с сообщениями электронной почты после успешного или неудачного импорта. Можно удалять сообщения, перемещать их в указанную папку в учетной записи электронной почты или, в случае сбоя импорта, предотвращать удаление сообщений. Например, если задание выполняется регулярно, можно предотвратить повторный импорт успешно импортированных сообщений электронной почты, переместив их в указанную папку.

  9. Заполните остальные страницы задания обработчика импорта, как описано в разделе Добавление или изменение задания обработчика импорта.

Теперь можно протестировать задание импорта электронной почты. Обработчик импорта проверяет настроенные учетные записи электронной почты на наличие сообщений и ищет в папках соответствующие сообщения электронной почты. Если найдены соответствующие сообщения электронной почты, обработчик импорта создает пакет и документ Content Capture для каждого документа, импортируемого из сообщения электронной почты. При необходимости обработчик импорта заполняет поля метаданных метаданными электронной почты и удаляет успешно импортированные сообщения или перемещает их в папку.

Периодически приложение Content Capture извлекает сообщения электронной почты из учетной записи электронной почты, которую вы настроили на вкладке Учетные записи электронной почты. Однако, если требуется выполнить импорт электронной почты в определенное время, выберите задание импорта электронной почты в таблице Задания обработчика импорта и нажмите на значок Проверить электронную почту. Этот значок недоступен, если задание импорта электронной почты находится в автономном режим.