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

Os endpoints de email permitem que os usuários chamem um serviço enviando um ou mais documentos (como anexos de email) para uma conta de email especificada. A caixa de entrada de 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, os usuários autorizados podem chamar um processo enviando arquivos por email para a conta apropriada. Os resultados serão retornados ao usuário remetente (por padrão) ou ao usuário definido nas configurações de endpoint.

Antes de configurar um endpoint de email, crie uma conta de email POP3 ou IMAP para ser usada pelo endpoint. 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 endpoints de email são configurados com um nome de usuário autorizado e uma senha para a caixa de entrada de email, que são necessários ao invocar o serviço. A conta de e-mail está protegida pelo sistema do servidor de e-mail no qual está configurada.

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

Antes de configurar um endpoint 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 duas finalidades:

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

Você pode configurar POP3, IMAP ou SMTP para usar o Secure Sockets Layer (SSL) como um endpoint 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 que são comuns para todos os endpoints de email e para fornecer valores default para todos os endpoints 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 ponto de extremidade de email para o serviço Concluir Tarefa.

Alterar os valores padrão para 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 foi usada por quartzo para agendar a sondagem do diretório de entrada.

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

Contagem de Repetição: O número de vezes que o diretório de entrada é sondado. A contagem de repetição padrão a ser usada se esse valor não for especificado na configuração do endpoint. Um valor -1 indica uma varredura indefinida do diretório. O valor padrão é -1.

Atraso quando o trabalho é iniciado: O valor padrão, em segundos, para o atraso antes que o trabalho comece a verificar o ponto de extremidade. O valor padrão é 0.

Tamanho do Lote: O número de emails que o destinatário processa por verificação para obter o desempenho ideal. Um valor -1 indica todos os emails. O valor padrão é 2.

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

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

Padrão de 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]'port'). O valor padrão é *.*.

Destinatários do Trabalho Bem-sucedido: Um ou mais endereços de email que são usados para enviar emails para indicar trabalhos bem-sucedidos. Por padrão, uma mensagem de tarefa bem-sucedida é sempre enviada ao remetente da tarefa inicial. Até 100 recipients são suportados. Para desativar essa configuração, deixe esse campo em branco.

Destinatários do Trabalho com Falha: Um ou mais endereços de email que são usados para enviar emails para indicar trabalhos com falha. Por padrão, uma mensagem de tarefa com falha é sempre enviada ao remetente que enviou a tarefa inicial. Até 100 recipients são suportados. Para desativar essa configuração, deixe esse 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 de Caixa de Entrada: O protocolo de email do ponto de extremidade de email a ser usado para verificar a caixa de entrada. As opções são IMAP ou POP3. O servidor de e-mail do host da caixa de entrada deve suportar esses protocolos.

Tempo Limite da Caixa de Entrada: Especifica o tempo que o ponto de extremidade aguardará antes de cancelar ao tentar se conectar à caixa de entrada. Se uma conexão não for adquirida antes que o valor de tempo limite seja 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 selecionado, habilita 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 do provedor de email a ser usada quando enviar email para obter 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 sobre 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" correto, especifique um valor para a configuração "Enviar de".

SMTP SSL Habilitado: Quando selecionado, habilita SSL em SMTP.

Incluir o corpo do email original como um anexo: Por padrão, ao enviar um email para o Forms Server, o texto original da mensagem será incluído no corpo da mensagem. Para incluir o texto como um anexo, selecione essa opção.

Usar a Linha de Assunto Original para Emails de Resultado: Por padrão, o servidor do Forms usa os valores especificados nas configurações de Assunto do Email Bem-sucedido e Assunto do Email de Erro como 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 de Êxito: Depois de enviar um email para um terminal de email para iniciar ou continuar um processo, você receberá uma mensagem de email de retorno do Servidor do AEM Forms. Se o email for bem-sucedido, você receberá um email de sucesso. Se seu 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 endpoint.

Corpo do Email de Êxito: permite que você especifique o texto do corpo das mensagens de email de êxito enviadas para este ponto de extremidade.

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 este ponto de extremidade.

Assunto do Email de Erro: Permite que você especifique a linha de assunto das mensagens de email de falha enviadas para este ponto de extremidade. Esse texto é exibido após o Prefixo do assunto do email de erro.

Corpo do Email de Erro: Permite que você especifique a primeira linha do texto do corpo das mensagens de email de falha enviadas para este ponto de extremidade.

Informações de Resumo de Email: Cada mensagem de êxito ou falha inclui uma seção contendo o texto do email original enviado ao Forms Server. Essa configuração especifica o texto que aparece acima dessa seção.

Validar Caixa de Entrada Antes de Criar/Atualizar Este Ponto de Extremidade: Quando essa opção é selecionada, o Forms Server verifica se as configurações SMTP/POP3 estão corretas antes de criar o ponto de extremidade. Quando você clica em Adicionar, é exibida uma mensagem informando se a conta da caixa de entrada é válida. Se essa opção não estiver selecionada, o AEM Forms Server criará o endpoint 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 de Emails Enviados com Falha: Especifica um diretório no qual armazenar resultados se o servidor de emails SMTP não estiver operacional.

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

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

Nome: Uma configuração obrigatória que identifica o ponto de extremidade. Não inclua um caractere < porque ele trunca o nome exibido no Workspace. Se você estiver inserindo um URL como o nome do endpoint, verifique se ele está em conformidade com as regras de sintaxe especificadas no 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 precisar ser agendado usando uma expressão cron.

Contagem de Repetição: Número de vezes que o ponto de extremidade de 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 verificação que o destinatário usa para verificar se há emails de entrada.

Atraso no início do trabalho: O tempo de espera para verificação depois que o agendador é iniciado.

Tamanho do Lote: O número de emails que o destinatário processa por verificação para obter o desempenho ideal. Um valor -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 invocar um serviço de destino do 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 do adobe.com será processado; o email de outros domínios será ignorado.

Padrão de 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]'port').

Destinatários 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 tarefa bem-sucedida é sempre enviada ao remetente. Se você digitar remetente, os resultados do email serão enviados para ele. Até 100 recipients são suportados. Especifique recipients adicionais com endereços de email, separados por vírgulas (,).

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

Destinatários do Trabalho com Falha: Um endereço de email para o qual as mensagens são enviadas para indicar trabalhos com falha. Por padrão, uma mensagem de tarefa com falha é sempre enviada ao remetente. Se você digitar remetente, os resultados do email serão enviados para ele. Até 100 recipients são suportados. Especifique recipients adicionais com endereços de email, separados por vírgulas (,).

Para desativar essa configuração, deixe a configuração em branco. Em alguns casos, você deseja acionar um processo e não deseja uma notificação por email sobre o 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 usada pelo servidor de email. O valor padrão para POP3 é 110 e o valor padrão para IMAP é 143. Se o SSL estiver ativado, o valor default para POP3 será 995 e o valor default para IMAP será 993.

Protocolo de Caixa de Entrada: O protocolo de email do ponto de extremidade de email a ser usado para verificar a caixa de entrada. Os valores são IMAP ou POP3. O servidor de e-mail do host da caixa de entrada deve suportar 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 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 de POP3/IMAP Habilitado: selecione esta configuração para forçar o provedor de email a usar SSL para verificar a caixa de entrada. Certifique-se de que seu servidor de e-mail 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 para a porta SMTP é 25.

Usuário SMTP: A conta de usuário do provedor de email a ser usada quando ele enviar notificações de resultados e erros por email.

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 sobre 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" correto, especifique um valor para a configuração "Enviar de".

SMTP SSL Habilitado: selecione esta configuração para forçar o provedor de email a usar SSL para verificar a caixa de entrada. Certifique-se de que seu servidor de e-mail suporta SSL.

Pasta de Emails Enviados com Falha: Especifica um diretório no qual armazenar resultados se o servidor de emails 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 é enviada para cada documento processado.

Por exemplo, um terminal de email é criado para um serviço que pega 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 forem processados, se o endpoint estiver configurado como síncrono, um único email de resposta será 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 PDF.

O valor padrão é assíncrono.

Incluir o corpo do email original como um anexo: Por padrão, ao enviar um email para o Forms Server, o texto original da mensagem será incluído no corpo da mensagem. Para incluir o texto como um anexo, selecione essa opção.

Usar a linha de assunto original para emails de resultado: Por padrão, o servidor Forms usa os valores especificados nas configurações de Assunto do Email Bem-sucedido e Assunto do Email de Erro como 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 de Êxito: Depois de enviar um email para um terminal de email para iniciar ou continuar um processo, você receberá uma mensagem de email de retorno do Servidor do AEM Forms. Se o email for bem-sucedido, você receberá um email de sucesso. Se seu 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 endpoint.

Corpo do Email de Êxito: permite que você especifique o texto do corpo das mensagens de email de êxito enviadas para este ponto de extremidade.

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 este ponto de extremidade.

Assunto do Email de Erro: Permite que você especifique a linha de assunto das mensagens de email de falha enviadas para este ponto de extremidade. Esse texto é exibido após o Prefixo do assunto do email de erro.

Corpo do Email de Erro: Permite que você especifique a primeira linha do texto do corpo das mensagens de email de falha enviadas para este ponto de extremidade.

Informações de Resumo de Email: Cada mensagem de êxito ou falha inclui uma seção contendo o texto do email original enviado ao Forms Server. Essa configuração especifica o texto que aparece acima dessa seção.

Valide a Caixa de Entrada antes de criar/atualizar este ponto de extremidade: Quando essa opção é selecionada, o Forms Server verifica se as configurações SMTP/POP3 estão corretas antes de criar o ponto de extremidade. Quando você clica em Adicionar, é exibida uma mensagem informando se a conta da caixa de entrada é válida. Se essa opção não estiver selecionada, o AEM Forms Server criará o endpoint sem validar a caixa de entrada.

Nome da Operação: Esta configuração é obrigatória. Uma lista de operações que podem ser atribuídas ao endpoint de email. A operação selecionada aqui determina quais campos são exibidos nas seções Mapeamentos de Parâmetro de Entrada e Mapeamentos de Parâmetro de Saída.

Mapeamentos de Parâmetros 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 como ele é exibido.

Variável: é possível mapear uma cadeia de caracteres do assunto do email, corpo, cabeçalho ou 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 terminal 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. Inserir * seleciona qualquer documento anexado. Inserir example.pdf seleciona qualquer documento anexado chamado example.pdf.

Mapeamentos do Parâmetro 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 de anexo:

%F Representa o nome de arquivo do arquivo de origem (sem incluir 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âmetros de Saída do ponto de extremidade. Se a resposta do serviço retornar vários anexos de arquivo, você não poderá 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:

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

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

Mapa: o padrão é Resultado/%F/ e o destino de origem é Resultado%%sourcefilename%%file1 e Resultado%%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 (saída 1) e Result%%sourcefilename2.ps (saída 2).

Criar um terminal de email para o serviço de Tarefa Concluída 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.