Configurar o Google Mail (OAuth) para Importação de E-mail

Você pode configurar o processador de importação para usar o Google mail OAuth para importar no Content Capture arquivos anexados às mensagens de e-mail de entrada, com os elementos da mensagem, como assunto e texto do corpo. Cada mensagem de e-mail importada se torna um batch, com os elementos do e-mail, como anexos, corpo da mensagem ou o e-mail inteiro, criados como documentos distintos dentro do batch.

Veja o que você precisa fazer para configurar a importação de e-mail do Google (OAuth):

Obter o URL de Redirecionamento para Criar um Aplicativo Google Mail

Para poder configurar um aplicativo Google Mail, você precisa do nome do host do Content Capture e dos detalhes do URL de autorização da instância do Oracle Content Management à qual você deseja se conectar.

Para obter o URL de redirecionamento:

  1. Acesse o Oracle Content Management como administrador e vá para o Content Capture.
  2. Abra seu procedimento e vá para a guia Capturar.

  3. Na tabela Jobs do Processador de Importação, clique em Adicionar job do processador de importação para criar um novo job.

  4. Na página Definições Gerais:
    1. Digite um nome no campo Nome do Job de Importação e um prefixo no campo Prefixo de Batch. Os batches importados são nomeados usando esse prefixo, seguido por um número que é incrementado com cada novo batch.
    2. No campo Origem de Importação, certifique-se de selecionar Origem de E-mail.
  5. Na página Definições da Origem de Importação, na seção Protocolo de Conexão, selecione Google Mail (OAuth).

    Um URL de Redirecionamento é exibido. Copiei esse URL, cujo formato é https://<hostname>.<domainname>.com:<port>/capture/admin/faces/completeAuthorization. O URL pode ou não ter uma porta. Sem uma porta, o formato do URL seria este: https://<hostname>.<domainname>.com/capture/admin/faces/completeAuthorization

    Nota:

    Não submeta ainda suas entradas nem navegue para fora dessa página. Retorne para essa página para configurar o Google mail OAuth, depois de ter criado um aplicativo Google Mail e obtido o ID e o Segredo do Cliente. Você vai digitá-los nos campos ID do Cliente e Segredo do Cliente.

Configurar um Aplicativo Google Mail para Importação de E-mail

Para configurar um aplicativo Google Mail:

  1. Vá para o Console de APIs do Google em outra janela do browser.
  2. Na página Manage resources (Gerenciar recursos), você verá uma lista de seus projetos se já os tiver criado na Console de Desenvolvedores do Google. Se não tiver feito isso ainda, proceda desta forma:
    1. Clique em CREATE PROJECT (CRIAR PROJETO).
    2. Digite o Project name (Nome do projeto).
    3. Para ajudar a identificar facilmente seu projeto na console, edite o Project ID (ID do Projeto) clicando em EDIT (EDITAR) e digitando um nome significativo.
    4. Selecione um local se tiver definido quaisquer recursos organizacionais ou pastas. Se não tiver feito isso, aceite o padrão e clique em CREATE (CRIAR).

      Seu projeto será criado e você será redirecionado para sua lista de projetos na console.

  3. No canto superior esquerdo, clique em ícone de navegação do desenvolvedor do Google, selecione APIs & Services (APIs e Serviços) e depois selecione Dashboard (Painel de Controle).

    Nota:

    Se você não estiver vendo o painel de controle do projeto recém-criado, selecione seu projeto na lista drop-down do canto superior esquerdo.
  4. Na barra lateral esquerda, clique em Library (Biblioteca) para ir até a página API Library (Biblioteca de APIs). Em seguida, procure a biblioteca Gmail API e ative-a.
  5. No canto superior esquerdo, clique em ícone de navegação do desenvolvedor do Google, selecione APIs & Services (APIs e Serviços) e depois OAuth consent screen (Tela de consentimento do OAuth). Escolha seus usuários de destino na tela de consentimento do OAuth e, em seguida, clique em CREATE (CRIAR).
  6. Na página Edit app registration (Editar registro do aplicativo), na guia OAuth consent screen (Tela de consentimento do OAuth):
    • No campo App name (Nome do aplicativo), digite o nome do produto, por exemplo, Gmail App.
    • Na lista drop-down User support email (E-mail do suporte ao usuário), selecione seu endereço de e-mail do suporte ao usuário.
    • Role para baixo até a seção Developer contact information (Informações de contato do desenvolvedor) e, no campo Email addresses (Endereços de e-mail), digite seu endereço de e-mail.
    • Clique em SAVE AND CONTINUE (SALVAR E CONTINUAR).
  7. Na guia Scopes (Escopos):
    1. Clique em ADD OR REMOVE SCOPES (ADICIONAR OU REMOVER ESCOPOS).
    2. Na seção Update selected scopes (Atualizar escopos selecionados), marque as caixas de seleção para os seguintes escopos de API do GMail ou digite esses escopos na caixa Manually add scopes (Adicionar escopos manualmente) e clique em ADD TO TABLE (ADICIONAR À TABELA). Em seguida, clique em UPDATE (ATUALIZAR).
    3. Clique em SAVE AND CONTINUE (SALVAR E CONTINUAR).

      Os escopos userinfo.email e userinfo.profile são exibidos na seção Your non-sensitive scopes (Seus escopos não sensíveis) e o escopo gmail.modify é exibido na seção Your restricted scopes (Seus escopos restritos) na guia Scopes (Escopos).

  8. Na guia Test users (Testar usuários), clique em SAVE AND CONTINUE (SALVAR E CONTINUAR).
  9. Na guia Summary (Resumo), você pode verificar suas definições e depois clicar em BACK TO DASHBOARD (VOLTAR AO PAINEL DE CONTROLE).
  10. Em Publishing Status (Status de Publicação), na seção Testing (Testando), clique em PUBLISH APP (PUBLICAR APLICATIVO), e na caixa de diálogo Push to production? (Enviar para produção?), clique em CONFIRM (CONFIRMAR) para publicar o aplicativo.
  11. Na barra lateral esquerda, clique em Credentials (Credenciais) e depois faça o seguinte:
    1. Na página Credentials (Credenciais), clique em CREATE CREDENTIALS (CRIAR CREDENCIAIS) e selecione OAuth client ID (ID do cliente OAuth).
    2. Na lista drop-down Application type (Tipo de aplicativo), selecione Web application (Aplicativo Web).
    3. Dê um nome ao cliente, por exemplo, Gmail OAuth App Client.
    4. Em Authorized redirect URIs (URIs de redirecionamento autorizados), clique em ADD URI (ADICIONAR URI) e cole o URL de redirecionamento que você copiou no procedimento do Content Capture.
    5. Em Authorized JavaScript origins (Origens JavaScript autorizadas), clique em ADD URI (ADICIONAR URI) e cole o URL de redirecionamento, mas remova tudo após o domínio e após a porta se o URI incluir uma porta.
    6. Clique em CREATE (CRIAR).

      Os valores Client ID (ID do Cliente) e Client Secret (Segredo do Cliente) são exibidos na caixa de diálogo OAuth client created (Cliente OAuth criado). Anote esses valores e clique em OK.

      Agora volte ao Content Capture no Oracle Content Management e comece de onde você parou. Ou seja, comece digitando o ID e o segredo do cliente para configurar o Google mail OAuth.

Configurar o Google Mail OAuth para Importação de E-mail do Capture

Para configurar as definições do job do processador de importação de e-mail do Google Mail OAuth:

  1. Volte para o procedimento Capturar e comece de onde você parou.
  2. Na guia Contas de E-mail, você selecionou o protocolo de conexão Google Mail (OAuth). Agora, digite o ID e o segredo do cliente que você copiou no momento de configurar seu aplicativo Google mail nos campos UD do Cliente e Segredo do Cliente.

  3. Na tabela Contas de E-mail a Serem Processadas, clique em Adicionar conta de e-mail.

  4. Para fornecer ao job do processador de e-mail um acesso à conta de e-mail, na página de acesso ao Google Mail, digite o endereço de e-mail e a senha do ID de e-mail que você vai usar.

  5. Confirme suas opções clicando em Permitir.

    O ID de e-mail é exibido na tabela Contas de E-mail a Serem Processadas, na coluna Endereços de E-mail. Seu status deverá ser Verificado.

    Você pode adicionar mais IDs do Google Mail nessa tabela usando as etapas seguidas até aqui. Para excluir um ID de e-mail, selecione a linha dele na tabela e clique em Excluir ID de e-mail.

  6. Na guia Filtros de Mensagens, especifique onde e como procurar mensagens de e-mail e/ou anexos.

    1. No campo Pastas a Serem Processadas, digite uma ou mais pastas a serem pesquisadas nas contas de e-mail especificadas. O valor padrão é a caixa de entrada do servidor. Para especificar várias pastas, separe-as com um ; (ponto e vírgula). Para especificar subpastas, inclua um delimitador de caminho aplicável ao servidor de e-mail, como / (barra), como em pasta/subpasta.

    2. Por padrão, o Content Capture processará todos os e-mails na pasta especificado, a menos que um filtro de mensagens seja aplicado ao job. Se preferir, na tabela Filtros de Mensagens, selecione o campo Ativado para cada elemento de e-mail a ser pesquisado; em seguida, digite os caracteres a serem encontrados no campo Campo Contém.

      Por exemplo, para procurar e-mails cujo assunto ou corpo da mensagem contenha a palavra payment, você selecionaria Enabled para ambos os campos de pesquisa, incluiria payment em cada entrada Campo Contém e selecionaria o operador de pesquisa Ou.

    3. No campo Operador de Pesquisa, selecione o operador de pesquisa a ser usado para os filtros de mensagens especificados: And (padrão) só importará se todos os critérios de pesquisa corresponderem, enquanto Or importará se qualquer critério de pesquisa corresponder.

  7. Na guia Processamento, especifique como processar as mensagens de e-mail e seus anexos. Você pode especificar quais informações incluir e a prioridade a ser designada aos batches, com base na prioridade do e-mail.

    1. Em Opções de Mensagem de E-mail, especifique se o arquivo do corpo da mensagem deve ser importado. Especifique o formato de importação (texto ou EML) e se ele deve ser incluído quando nenhum anexo estiver presente e se a mensagem de e-mail inteira (incluindo anexos) deve ser importada como arquivo EML.

    2. No campo Incluir anexos que correspondam a esta(s) máscara(s), especifique os arquivos de anexo com base em suas máscaras de arquivo. Você pode digitar várias máscaras de arquivo separadas por vírgula ou ponto-e-vírgula. Por exemplo, você poderá incluir todos os arquivos PDF (*.pdf).

    3. No campo Excluir anexos que correspondam a esta(s) máscara(s), especifique os arquivos de anexo a serem excluídos com base em suas máscaras de arquivo. Você pode digitar várias máscaras de arquivo separadas por vírgula ou ponto-e-vírgula.

    4. Se preferir, selecione Sempre pós-processar quando os anexos não corresponderem à(s) máscara(s), Incluir anexos que correspondam a esta(s) máscara(s) e Excluir anexos que correspondam a esta(s) máscara(s). Se esse campo estiver ativado e os anexos não corresponderem à(s) máscara(s) especificada(s), a importação do e-mail será considerada malsucedida e pós-processada de acordo com as definições que você especificar no campo Mediante uma Importação com Falha na guia Pós-processamento.

      Nota:

      O campo Sempre pós-processar quando os anexos não corresponderem à(s) máscara(s) é desativado quando os campos Importar arquivo do corpo da mensagem e Incluir quando não houver anexo são ativados juntos.

    5. Em Ordem dos Documentos, especifique a ordem na qual os elementos (por exemplo, corpo da mensagem e anexos) de uma mensagem de e-mail devem ser ordenados como documentos nos batches importados.

    6. Em Incluir Observações sobre o Batch, selecione os elementos da mensagem (como Data/Hora do Recebimento, Endereço do Remetente, Endereço do Destinatário, Assunto e Corpo da Mensagem).

    7. Em Prioridade do Batch, você pode designar uma prioridade a cada novo batch com base na prioridade do e-mail (baixa, normal ou alta). Por exemplo, digite 8 no campo Alta para designar aos e-mails de alta prioridade uma prioridade de batch igual a 8 no Content Capture. Os e-mails que não tiverem uma prioridade designada serão considerados de prioridade normal.

  8. Na guia Pós-processamento, especifique o que acontece com as mensagens de e-mail após a importação bem-sucedida ou com falha. Você pode excluir mensagens, movê-las para uma pasta especificada dentro da conta de e-mail ou, no caso de falha na importação, evitar que mensagens sejam excluídas. Por exemplo, se o job for executado regularmente, você poderá impedir que e-mails importados com sucesso sejam importados novamente, movendo-os para uma pasta especificada.

  9. Preencha outras páginas do job do processador de importação conforme descrito em Adicionar ou Editar um Job do Processador de Importação.

Agora você pode testar o job de importação de e-mail. O processador de importação verifica as contas de e-mail configuradas para ver se há mensagens e procura e-mails correspondentes nas pastas. Se forem encontrados e-mails correspondentes, o processador de importação criará um batch do Content Capture e um documento para cada documento que estiver sendo importado da mensagem de e-mail. O processador de importação pode preencher os campos de metadados com metadados de e-mail e excluir as mensagens importadas com sucesso ou movê-las para uma pasta.

Periodicamente, o Content Capture extrai os e-mails da conta de e-mail que você configura na guia Contas de E-mail. No entanto, se você quiser acionar uma importação de e-mail em um determinado horário, selecione um job de importação de e-mail na tabela Jobs do Processador de Importação e clique no ícone Verificar e-mail. Esse ícone estará desativado se o job de importação de e-mail estiver off-line.