Configuração de pontos de extremidade de email configuring-email-endpoints

Os pontos de extremidade de email permitem que os usuários invoquem um serviço ao enviar um ou mais documentos (como anexos de email) para uma conta de email específica. A caixa de entrada do email atua como um ponto de coleta para os anexos. O serviço monitora a caixa de entrada e processa os anexos. Os resultados da conversão são encaminhados ao usuário definido no endpoint .

Para um endpoint de email, usuários autorizados podem invocar um processo ao enviar arquivos por email para a conta apropriada. Os resultados serão retornados ao usuário que enviou (por padrão) ou ao usuário definido nas configurações do ponto de extremidade.

Antes de configurar um ponto de extremidade de email, crie uma conta de email POP3 ou IMAP para uso pelo ponto de extremidade. Configure uma conta separada para cada tipo de conversão. Por exemplo, uma conta pode ser configurada para gerar documentos PDF padrão a partir de anexos de arquivos recebidos e outra conta pode ser configurada para gerar documentos PDF seguros.

Todos os pontos de extremidade de email são configurados com um nome de usuário autorizado e senha para a caixa de entrada de email, que são necessários ao chamar o serviço. A conta de email é protegida pelo sistema de servidor de email em que está configurada.

Se os usuários enviarem documentos com caracteres de idioma da Europa Ocidental em nomes de arquivo e caminho de conversão, eles deverão usar um aplicativo de email que ofereça suporte aos tipos de codificação necessários (Latin1 [ISO-8859-1]da Europa Ocidental [Windows]ou UTF-8). Para obter mais informações, consulte o Instalação e implantação de formulários AEM documento para o servidor de aplicativos.

Antes de configurar um terminal de email, configure o serviço de Email . (Consulte Definir configurações padrão de ponto de extremidade de email.) Os parâmetros de configuração do serviço de email têm dois objetivos:

Configurar SSL para um endpoint de email configure-ssl-for-an-email-endpoint

Você pode configurar POP3, IMAP ou SMTP para usar o SSL (Secure Sockets Layer) para um terminal de email.

Definir configurações padrão de ponto de extremidade de email configure-default-email-endpoint-settings

Você pode usar a página Gerenciamento de serviço para configurar atributos comuns a todos os pontos de extremidade de email e fornecer valores padrão para todos os pontos de extremidade de email.

Para que o fluxo de trabalho de formulários receba e manipule mensagens de email recebidas dos usuários, é necessário criar um terminal de email para o serviço Tarefa completa. Este ponto de extremidade de email requer configurações adicionais, conforme descrito em Criar um terminal de email para o serviço Concluir tarefa.

Alterar os valores padrão de pontos de extremidade de email change-the-default-values-for-email-endpoints

Configurações padrão de ponto de extremidade de email default-email-endpoint-settings

Expressão Cron: A expressão cron usada pelo quartzo para agendar a pesquisa do diretório de entrada.

Intervalo de repetição: O número de vezes que a pesquisa de diretório é repetida. O intervalo de repetição padrão é em segundos, se esse valor não for especificado na configuração do ponto de extremidade. O valor padrão é 10. Este valor não pode ser inferior a 10.

Contagem de repetição: O número de vezes em que o diretório de entrada é pesquisado. A contagem de repetição padrão a ser usada se esse valor não for especificado na configuração de ponto de extremidade. Um valor de -1 indica a verificação indefinida do diretório. O valor padrão é -1.

Atraso no início do trabalho: O valor padrão, em segundos, para o atraso antes que a tarefa comece a verificar o ponto de extremidade. O valor padrão é 0.

Tamanho do lote: O número de emails que o receptor processa por varredura para obter desempenho ideal. Um valor de -1 indica todos os emails. O valor padrão é 2.

Assíncrono: Identifica o tipo de invocação como assíncrona ou síncrona. Processos transitórios e síncronos só podem ser invocados de forma síncrona. O valor padrão é assíncrono.

Padrão de domínio: O padrão de nome de domínio usado para filtrar emails recebidos. Por exemplo, se adobe.com for usado, somente o email de adobe.com será processado; o email de outros domínios é ignorado.

Padrão do arquivo: Os padrões de anexo de arquivo de entrada aceitos pelo provedor. Isso inclui arquivos com extensões específicas (*.dat, *.xml), nomes específicos (dados) e expressões compostas no nome e na extensão (.[dD][aA][Tt]). O valor padrão é *.*.

Recipients do trabalho bem-sucedido: Um ou mais endereços de email usados para enviar emails para indicar trabalhos bem-sucedidos. Por padrão, uma mensagem de trabalho bem-sucedida é sempre enviada ao remetente do trabalho inicial. Há suporte para até 100 recipients. Para desativar essa configuração, deixe este campo em branco.

Recipients da tarefa com falha: Um ou mais endereços de email usados para enviar emails para indicar tarefas com falha. Por padrão, uma mensagem de trabalho com falha é sempre enviada ao remetente que enviou o trabalho inicial. Há suporte para até 100 recipients. Para desativar essa configuração, deixe este campo em branco.

Host da caixa de entrada: O nome do host da caixa de entrada ou o endereço IP do provedor de email a ser verificado.

Porta da caixa de entrada: O número da porta da caixa de entrada do provedor de email a ser verificado. Se o valor for 0, a porta IMAP ou POP3 padrão será usada.

Protocolo da caixa de entrada: O protocolo de email do endpoint de email a ser usado para verificar a caixa de entrada. As opções são IMAP ou POP3. O servidor de correio do host da caixa de entrada deve oferecer suporte a esses protocolos.

Tempo limite da caixa de entrada: Especifica o tempo que o ponto de extremidade aguardará antes de ser cancelado ao tentar se conectar à caixa de entrada. Se uma conexão não for adquirida antes do valor de tempo limite ser atingido, a caixa de entrada não será sondada.

Usuário da caixa de entrada: O nome de usuário necessário para fazer logon na conta de email. Dependendo do servidor de email e da configuração, esse nome pode ser apenas a parte do nome de usuário do email ou pode ser o endereço de email completo.

Senha da caixa de entrada: A senha do usuário da Caixa de entrada.

SSL POP3/IMAP Habilitado: Quando selecionada, ativa o SSL.

Host SMTP: O nome do host do servidor de email que o provedor de email usa para enviar resultados e mensagens de erro. Por exemplo, mail.example.com

Porta SMTP: A porta usada para se conectar ao servidor de email. O valor padrão é 25.

Usuário SMTP: A conta de usuário que o provedor de email deve usar ao enviar email para resultados e erros.

Senha SMTP: A senha da conta SMTP. Alguns servidores de email não exigem uma senha SMTP.

Enviar de: O endereço de email (por exemplo, user@company.com) usado para enviar notificações por email de resultados e erros. Se você não especificar um valor Enviar de , o servidor de email tentará determinar o endereço de email combinando o valor especificado na configuração Usuário SMTP com um domínio padrão configurado no servidor de email. Se o servidor de email não tiver um domínio padrão e você não especificar um valor para Enviar de, poderão ocorrer erros. Para garantir que as mensagens de email tenham o endereço de origem correto, especifique um valor para a configuração Enviar de .

SSL SMTP Ativado: Quando selecionada, ativa o SSL em SMTP.

Inclua O Corpo Original Do Email Como Um Anexo: Por padrão, ao enviar um email para o servidor de formulários, o texto original da mensagem é incluído no corpo da mensagem. Para incluir o texto como anexo, selecione essa opção.

Use A Linha De Assunto Original Para Emails De Resultado: Por padrão, o servidor Forms usa os valores especificados nas configurações Assunto do email de sucesso e Assunto do email de erro como a linha de assunto ao enviar mensagens de email de resultado. Para usar a mesma linha de assunto do email original enviado ao servidor, selecione essa opção.

Assunto do email bem-sucedido: Depois de enviar um email para um endpoint de email para iniciar ou continuar um processo, você recebe uma mensagem de email de retorno do servidor de formulários AEM. Se o email for bem-sucedido, você receberá um email bem-sucedido. Se o email falhar, você receberá um email de falha informando por que ele falhou. Essa configuração permite especificar a linha de assunto das mensagens de email de sucesso enviadas para esse terminal.

Corpo de email bem-sucedido: Permite que você especifique o texto do corpo das mensagens de email de sucesso enviadas para esse terminal.

Prefixo do Assunto do Email de Erro: Permite que você especifique o texto usado no início da linha de assunto das mensagens de email de falha enviadas para esse terminal.

Assunto do Email de Erro: Permite especificar a linha de assunto das mensagens de email de falha enviadas para esse terminal. Este texto é exibido após o Prefixo de assunto do email de erro.

Corpo do email de erro: Permite que você especifique a primeira linha no texto do corpo das mensagens de email de falha enviadas para esse terminal.

Informações de resumo do email: Cada mensagem de sucesso ou falha inclui uma seção que contém o texto original do email enviado ao servidor de formulários. Essa configuração especifica o texto que aparece acima dessa seção.

Validar A Caixa De Entrada Antes De Criar/Atualizar Este Ponto Final: Quando essa opção é selecionada, o servidor de formulários verifica se as configurações SMTP/POP3 estão corretas antes de criar o terminal. Ao clicar em Adicionar, uma mensagem é exibida informando se a conta da caixa de entrada é válida. Se essa opção não estiver selecionada, o servidor do AEM forms criará o ponto de extremidade sem validar a caixa de entrada.

Codificação do conjunto de caracteres: O formato de codificação a ser usado para a mensagem de email. O padrão é UTF-8, que a maioria dos usuários fora do Japão usará. Os usuários em um ambiente japonês podem escolher ISO2022-JP.

Pasta Enviada por Email com Falha: Especifica um diretório no qual armazenar resultados se o servidor de email SMTP não estiver operacional.

Configurações do ponto de extremidade de email email-endpoint-settings

Use as configurações a seguir para configurar um ponto de extremidade de email.

Nome: Uma configuração obrigatória que identifica o endpoint. Não inclua um caractere < porque ele trunca o nome exibido no Workspace. Se estiver inserindo um URL como o nome do ponto de extremidade, verifique se ele está em conformidade com as regras de sintaxe especificadas na RFC1738.

Descrição: Uma descrição do ponto de extremidade. Não inclua um caractere < porque ele trunca a descrição exibida no Workspace.

Expressão Cron: Insira uma expressão cron se o email tiver de ser agendado usando uma expressão cron.

Contagem de repetição: Número de vezes que o ponto de extremidade do email verifica a pasta ou o diretório. Um valor de -1 indica varredura indefinida. O valor padrão é -1.

Intervalo de repetição: A taxa de varredura que o receptor usa para verificar emails recebidos.

Atraso no início do trabalho: O tempo de espera para a verificação após o agendador ser iniciado.

Tamanho do lote: O número de emails que o receptor processa por varredura para obter desempenho ideal. Um valor de -1 indica todos os emails. O valor padrão é 2.

Nome de usuário: Uma configuração obrigatória, que é o nome de usuário usado ao chamar um serviço de direcionamento de email. O valor padrão é SuperAdmin.

Nome do domínio: Uma configuração obrigatória, que é o domínio do usuário. O valor padrão é DefaultDom.

Padrão de domínio: Especifica os padrões de domínio do email de entrada que o provedor aceita. Por exemplo, se adobe.com for usado, somente o email de adobe.com será processado; o email de outros domínios é ignorado.

Padrão do arquivo: Especifica os padrões de anexo de arquivo de entrada aceitos pelo provedor. Isso inclui arquivos com extensões específicas (*.dat, *.xml), nomes específicos (dados) ou expressões compostas no nome e na extensão (*.[dD][aA][Tt]).

Recipients do trabalho bem-sucedido: Um endereço de email para o qual as mensagens são enviadas para indicar trabalhos bem-sucedidos. Por padrão, uma mensagem de trabalho bem-sucedida é sempre enviada ao remetente. Se você digitar o remetente, os resultados do email serão enviados ao remetente. Há suporte para até 100 recipients. Especifique recipients adicionais com endereços de email, separados por vírgulas (,).

Para desativar esta configuração, deixe a configuração em branco. Em alguns casos, você deseja acionar um processo e não desejar uma notificação por email do resultado.

Recipients da tarefa com falha: Um endereço de email para o qual são enviadas mensagens para indicar tarefas com falha. Por padrão, uma mensagem de trabalho com falha é sempre enviada ao remetente. Se você digitar o remetente, os resultados do email serão enviados ao remetente. Há suporte para até 100 recipients. Especifique recipients adicionais com endereços de email, separados por vírgulas (,).

Para desativar esta configuração, deixe a configuração em branco. Em alguns casos, você deseja acionar um processo e não desejar uma notificação por email do resultado.

Host da caixa de entrada: O nome do host da caixa de entrada ou o endereço IP do provedor de email a ser verificado.

Porta da caixa de entrada: A porta que o servidor de email usa. O valor padrão para POP3 é 110 e o valor padrão para IMAP é 143. Se SSL estiver ativado, o valor padrão para POP3 é 995 e o valor padrão para IMAP é 993.

Protocolo da caixa de entrada: O protocolo de email do endpoint de email a ser usado para verificar a caixa de entrada. Os valores são IMAP ou POP3. O servidor de correio do host da caixa de entrada deve oferecer suporte a esses protocolos.

Tempo limite da caixa de entrada: O tempo limite, em segundos, para o provedor de email aguardar as respostas da caixa de entrada.

Usuário da caixa de entrada: O nome de usuário necessário para fazer logon na conta de email. Dependendo do servidor de email e da configuração, esse valor pode ser apenas a parte do nome do usuário do email ou pode ser o endereço de email completo.

Senha da caixa de entrada: A senha do usuário da caixa de entrada.

SSL POP3/IMAP Habilitado: Selecione esta configuração para forçar o provedor de email a usar SSL para digitalizar a caixa de entrada. Certifique-se de que o seu servidor de correio suporta SSL.

Host SMTP: O nome do host do servidor de email que o provedor de email usa para enviar resultados e mensagens de erro.

Porta SMTP: O valor padrão da porta SMTP é 25.

Usuário SMTP: A conta de usuário que o provedor de email deve usar ao enviar notificações por email de resultados e erros.

Senha SMTP: A senha da conta SMTP. Alguns servidores de email não exigem uma senha SMTP.

Enviar de: O endereço de email (por exemplo, user@company.com) usado para enviar notificações por email de resultados e erros. Se você não especificar um valor Enviar de , o servidor de email tentará determinar o endereço de email combinando o valor especificado na configuração Usuário SMTP com um domínio padrão configurado no servidor de email. Se o servidor de email não tiver um domínio padrão e você não especificar um valor para Enviar de, poderão ocorrer erros. Para garantir que as mensagens de email tenham o endereço de origem correto, especifique um valor para a configuração Enviar de .

SSL SMTP Ativado: Selecione esta configuração para forçar o provedor de email a usar SSL para digitalizar a caixa de entrada. Certifique-se de que o seu servidor de correio suporta SSL.

Pasta Enviada por Email com Falha: Especifica um diretório no qual armazenar resultados se o servidor de email SMTP não estiver operacional.

assíncrono: Quando definido como síncrono, todos os documentos de entrada são processados e uma única resposta é retornada. Quando definido como assíncrono, uma resposta será enviada para cada documento processado.

Por exemplo, um ponto de extremidade de email é criado para um serviço que utiliza um único documento do Word e retorna esse documento como um arquivo PDF. Um email pode ser enviado para a caixa de entrada do ponto de extremidade que contém vários (3) documentos do Word. Quando todos os três documentos são processados, se o endpoint estiver configurado como síncrono, um único email de resposta é enviado com todos os três documentos anexados. Se o endpoint for assíncrono, um email de resposta será enviado depois que cada documento do Word for convertido em PDF. O resultado são três emails, cada um com um único anexo de PDF.

O valor padrão é assíncrono.

Inclua o corpo do email original como anexo: Por padrão, ao enviar um email para o servidor de formulários, o texto original da mensagem é incluído no corpo da mensagem. Para incluir o texto como anexo, selecione essa opção.

Use a linha de assunto original para emails de resultado: Por padrão, o servidor Forms usa os valores especificados nas configurações Assunto do email de sucesso e Assunto do email de erro como a linha de assunto ao enviar mensagens de email de resultado. Para usar a mesma linha de assunto do email original enviado ao servidor, selecione essa opção.

Assunto do email bem-sucedido: Depois de enviar um email para um endpoint de email para iniciar ou continuar um processo, você recebe uma mensagem de email de retorno do servidor de formulários AEM. Se o email for bem-sucedido, você receberá um email bem-sucedido. Se o email falhar, você receberá um email de falha informando por que ele falhou. Essa configuração permite especificar a linha de assunto das mensagens de email de sucesso enviadas para esse terminal.

Corpo de email bem-sucedido: Permite que você especifique o texto do corpo das mensagens de email de sucesso enviadas para esse terminal.

Prefixo do Assunto do Email de Erro: Permite que você especifique o texto usado no início da linha de assunto das mensagens de email de falha enviadas para esse terminal.

Assunto do Email de Erro: Permite especificar a linha de assunto das mensagens de email de falha enviadas para esse terminal. Este texto é exibido após o Prefixo de assunto do email de erro.

Corpo do email de erro: Permite que você especifique a primeira linha no texto do corpo das mensagens de email de falha enviadas para esse terminal.

Informações de resumo do email: Cada mensagem de sucesso ou falha inclui uma seção que contém o texto original do email enviado ao servidor de formulários. Essa configuração especifica o texto que aparece acima dessa seção.

Validar a Caixa de entrada antes de criar/atualizar este ponto de extremidade: Quando essa opção é selecionada, o servidor de formulários verifica se as configurações SMTP/POP3 estão corretas antes de criar o terminal. Ao clicar em Adicionar, uma mensagem é exibida informando se a conta da caixa de entrada é válida. Se essa opção não estiver selecionada, o servidor do AEM forms criará o ponto de extremidade sem validar a caixa de entrada.

Nome da Operação: Essa configuração é obrigatória. Uma lista de operações que podem ser atribuídas ao ponto de extremidade do email. A operação selecionada aqui determina quais campos são exibidos nas seções Mapeamentos do parâmetro de entrada e Mapeamentos do parâmetro de saída .

Mapeamentos do parâmetro de entrada: Usado para configurar a entrada necessária para processar o serviço e a operação. Os dois tipos de entrada são literal e variável:

Literal: O email usa o valor inserido no campo conforme é exibido.

Variável: Você pode mapear uma sequência de caracteres do assunto do email, do corpo, do cabeçalho ou do endereço de email do remetente. Para fazer isso, use uma das seguintes palavras-chave: %SUBJECT%, %BODY%, %HEADER% ou %SENDER%. Por exemplo, se você usar %SUBJECT%, o conteúdo do assunto do email será usado como parâmetro de entrada. Para selecionar anexos, insira um padrão de arquivo que o ponto de extremidade de email possa usar para selecionar os documentos anexados. Por exemplo, inserir *.pdf seleciona qualquer documento anexado que tenha uma extensão de nome de arquivo .pdf. Entrando no &último; seleciona qualquer documento anexado. Inserir example.pdf seleciona qualquer documento anexado chamado example.pdf.

Mapeamentos de parâmetros de saída: Usado para configurar a saída do serviço e da operação. Os seguintes caracteres nos valores de mapeamento do parâmetro de saída são expandidos no nome do arquivo do anexo:

%F Representa o nome de arquivo do arquivo de origem (não incluindo uma extensão).

%E Representa a extensão do arquivo de origem.

Qualquer ocorrência da barra invertida () é substituída por %%.

observação ​: Se a mensagem de solicitação de serviço incluir vários anexos de arquivo, você não poderá usar os parâmetros %F e %E para a propriedade Mapeamentos de Parâmetro de Saída do ponto de extremidade. Se a resposta dos serviços retornar vários anexos de arquivo, não será possível especificar o mesmo nome de arquivo para mais de um anexo. Se você não seguir essas recomendações, o serviço chamado criará os nomes dos arquivos retornados e os nomes não serão previsíveis.

Os seguintes valores estão disponíveis:

Objeto único: O provedor de email não tem o destino da pasta de origem; os resultados são retornados como anexos. O padrão é Result/%F.ps e retorna Result%%sourcefilename.ps como o anexo do nome de arquivo.

Lista: O padrão é Result/%F/ e retorna Result%%sourcefilename%%file1 como o anexo do nome de arquivo.

Mapa: O padrão é Result/%F/ e o destino de origem é Result%%sourcefilename%%file1 e Result%%sourcefilename%%file2. Se o mapa contiver mais de um objeto e o padrão for Result/%F.ps, os anexos do arquivo de resposta serão Result%%sourcefilename1.ps (output 1) e Result%%sourcefilename2.ps (output 2).

Criar um terminal de email para o serviço Concluir tarefa create-an-email-endpoint-for-the-complete-task-service

Para que o fluxo de trabalho de formulários receba e manipule mensagens de email recebidas dos usuários, é necessário criar um terminal de email para o serviço Tarefa completa.