Atividade Obter E-mail

A atividade Obter E-mail é uma atividade iniciadora. Quando uma orquestração que inicia com uma atividade Obter E-mail é implementada no Integration Appliance, ele sonda o servidor POP3 para e-mail(s) da conta especificada no intervalo especificado.

Nota: A atividade Obter E-mail requer que o servidor POP3 suporte os comandos TOP e UIDL. Embora isso seja opcional no protocolo POP3, a maioria dos servidores os suportará.

O servidor POP3 e a conta de e-mail sondados são definidos no terminal de e-mail associado à atividade Obter E-mail.

Durante o tempo de execução, a atividade Obter E-mail pesquisa um servidor POP3 para obter mensagens de e-mail recebidas de uma conta de e-mail específica, conforme mostrado no diagrama a seguir.

Figura 1.

Se quaisquer e-mails forem localizados, a seguinte ação ocorrerá para cada e-mail: A expressão regular definida para o campo Assunto é verificada com relação ao assunto da mensagem de correio recebida e a expressão regular definida para o campo De é verificada com relação à conta de e-mail do remetente da mensagem de correio recebida. Se ambas as expressões regulares corresponderem, uma tarefa de orquestração será criada para processar o e-mail e o e-mail será marcado para exclusão no servidor POP3. Quando o processo for concluído, o email será excluído do servidor POP3. Para obter mais informações sobre a correspondência de expressões regulares, consulte o procedimento do Configurando a Atividade.
Nota: Duas atividades Obter Email não devem pesquisar no mesmo servidor POP3 ao mesmo horário usando a mesma conta de email mesmo se as expressões regulares especificadas na tarefa Configurar da atividade forem diferentes. Se duas atividades Obter Email estiverem tentando obter email usando a mesma conta de email, quando a primeira atividade Obter Email processar o email a partir do servidor POP3 e remover o email do servidor, a segunda atividade Obter Email continuará tentando novamente recuperar o email do servidor POP3 e a seguinte exceção poderá ser lançada:
Exceção de protocolo: com.jscape.inet.pop.PopException: Erro em TOP 671 0: -ERR A mensagem solicitada não está mais disponível; ela pode ter sido excluída.

Acessando um Anexo de Mensagem de Email

Para acessar o anexo de um email recebido, você deve incluir uma atividade Ler MIME na orquestração após a atividade Obter Email, conforme mostrado na figura anterior. Além disso, você deve mapear os dois parâmetros de saída da atividade Obter Email para variáveis na orquestração e, em seguida, mapear essas variáveis para os parâmetros de entrada da atividade Ler MIME. Durante o tempo de execução, a atividade Ler MIME lê o Cabeçalho MIME e o corpo da mensagem e, em seguida, fragmenta os anexos contidos no corpo da mensagem e coloca o resultado no parâmetro de saída XML parts. Para obter informações adicionais, consulte Atividade Ler MIME.

Incluindo uma Atividade Obter Email na Orquestração

  1. Crie ou abra uma orquestração. Uma representação gráfica da orquestração é exibida.
  2. Selecione a guia Atividades e expanda a pasta Email.
  3. Arraste a atividade Obter Email para a orquestração.
  4. Selecione a atividade. A Lista de Verificação é exibida.

Criando, Selecionando ou Editando um Terminal de Email

  1. Clique na tarefa Selecionar Terminal na Lista de Verificação e escolha a partir de uma das seguintes ações:
    • Selecione um terminal existente:
      1. Selecione Procurar. O Explorador de Projetos é exibido.
      2. Selecione um terminal existente e clique em OK. Conclua as etapas em Configurando a Atividade.
    • Selecione um terminal existente e edite o terminal:
      1. Selecione Procurar. O Explorador de Projetos é exibido.
      2. Selecione um terminal existente e clique em OK.
      3. Clique em Editar. A área de janela Editar Terminal é exibida.
    • Crie um novo terminal: Selecione Novo. A área de janela Criar Terminal é exibida.
  2. Crie ou edite um terminal de email. Para obter informações adicionais, consulte Criando ou Editando um Terminal de E-mail.

Configurando a Atividade

  1. Selecione a tarefa Configurar a partir da Lista de Verificação. A área de janela Configurar é exibida.
  2. Configure todos os campos nessa área de janela, conforme descrito na tabela a seguir. Nesta tarefa, você especifica as expressões regulares usadas para corresponder com os campos Assunto e De de emails sondados. Uma expressão regular deve ser especificada para esses dois campos, mesmo se a expressão regular for igual a *, o que significa que todas as cadeias correspondem. Para que uma mensagem recebida seja processada, as cadeias Assunto e De do correio devem corresponder às suas respectivas expressões regulares. Em cada um dos campos de expressão regular, os seguintes curingas são suportados:
    • * (asterisco) - para zero ou mais caracteres
    • ? (ponto de interrogação) - para zero ou um caractere
    Tabela 1.
    Campo Descrição
    Correspondências de assunto Insira uma expressão regular que corresponda aos assuntos de emails que iniciam uma tarefa de orquestração para processar o email. Na expressão regular, é possível especificar uma combinação de caracteres e curingas.
    Correspondências de De   Insira uma expressão regular que defina o endereço de email do remetente dos emails que iniciam uma tarefa de orquestração para processar o email. Na expressão regular, é possível especificar uma combinação de caracteres e curingas.
    A tabela a seguir mostra algumas expressões regulares de exemplo e o resultado da correspondência de expressões regulares para o texto de amostra.
    Tabela 2.
    Expressão Regular Texto de Amostra Resultado
    *test* test corresponde
    *test* ttttesttt corresponde
    test test corresponde
    test ttttesttt não corresponde, precisa corresponder exatamente à cadeia de expressão regular: test
    test est não corresponde, precisa corresponder exatamente à cadeia de expressão regular: test
    ?est test corresponde
    ?est best corresponde
    ?est est corresponde

Especificando as Regras de Entrega

  1. Selecione a tarefa Regras de Entrega a partir da Lista de Verificação. A área de janela Regras de Entrega é exibida.
  2. Especifique o intervalo de tempo para sondar o servidor POP3 para novos emails:
    1. Selecione uma unidade de tempo no menu: segundos, minutos, horas ou dias.
    2. Especifique a quantidade de tempo usando uma das seguintes opções de entrada:
      • Clicando no campo Sondar Mudanças a cada e inserindo um novo valor.
      • Usando as setas para cima e para baixo.
Para obter informações adicionais, consulte Comportamento do Intervalo de Pesquisa.

Especificando as Opções de Nova Tentativa

  1. Selecione a tarefa Tentar Novamente a partir da Lista de Verificação. A área de janela Tentar Novamente é exibida.
  2. Configure as opções de nova tentativa para se conectar a um servidor POP3. A tabela a seguir define as opções de nova tentativa para uma conexão com um servidor POP3:
    Tabela 3.
    Campo Descrição
    Tentar novamente  
    1) Aguardar __ segundo(s) entre cada nova tentativa. Especifica o número de segundos que o Integration Appliance aguarda antes de tentar estabelecer uma conexão com o servidor POP3.
    2) Tentar se conectar __ vezes antes de falhar. Especifica a contagem de novas tentativas - o número máximo de vezes que o Integration Appliance tenta estabelecer uma conexão com o servidor POP3 antes de emitir um erro.

    Se uma orquestração que inicia com uma atividade Obter Email for implementada e o Integration Appliance não puder se conectar ao servidor POP3 especificado, o Integration Appliance registrará os erros de conexão como avisos no log do sistema até o valor da contagem de novas tentativas ser atingido. Quando a contagem de novas tentativas é atingido, o Integration Appliance registra um erro no log do sistema, reconfigura a contagem de erros de conexão para zero e continua tentando estabelecer uma conexão com o servidor POP3.

    Por exemplo, você configura a contagem de novas tentativas para 3. O primeiro, segundo e terceiro erros de conexão aparecem no log do sistema como Avisos. O Integration Appliance registra o quarto erro de conexão como um erro e reconfigura a contagem de erros de conexão para zero. Portanto, o quinto erro de conexão gera um aviso no log do sistema. O Integration Appliance continua tentando estabelecer uma conexão com o servidor POP3.

Mapeando a Saída da Atividade

  1. Selecione a tarefa Mapear Saídas na Lista de Verificação. Os parâmetros de saída da atividade são exibidos na área de janela Da Atividade.
  2. Nesta tarefa, mapeie os parâmetros de saída mailheader (do tipo XML) e body (da sequência de tipos) para variáveis. Você deve mapear os parâmetros de saída da atividade para que a orquestração seja válida. Consulte Criando um Mapa para obter instruções gerais sobre mapeamento. O parâmetro de saída mailheader contém meta informações sobre o email, por exemplo, os endereços de email para os quais a mensagem está sendo enviada e o cabeçalho MIME da própria mensagem. O parâmetro de saída body contém o corpo do email e os anexos associados.
    CUIDADO:
    A ordem dos anexos e o corpo na saída de corpo dependem do cliente de email que enviou a mensagem e do tipo de mensagem (texto simples ou HTML.).
Nota: Quando usar uma carga útil não em inglês, os mailheader, mimeHeader e otherheaders precisam ser mapeados na orquestração na atividade getEmail, e mapeados a partir da orquestração novamente na atividade sendMail.