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.
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.

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
- Crie ou abra uma orquestração. Uma representação gráfica da orquestração é exibida.
- Selecione a guia Atividades e expanda a pasta Email.
- Arraste a atividade Obter Email para a orquestração.
- Selecione a atividade. A Lista de Verificação é exibida.
Criando, Selecionando ou Editando um Terminal de Email
- Clique na tarefa Selecionar Terminal na Lista de Verificação e
escolha a partir de uma das seguintes ações:
- Selecione um terminal existente:
- Selecione Procurar. O Explorador de Projetos é exibido.
- Selecione um terminal existente e clique em OK. Conclua as etapas em Configurando a Atividade.
- Selecione um terminal existente e edite o terminal:
- Selecione Procurar. O Explorador de Projetos é exibido.
- Selecione um terminal existente e clique em OK.
- Clique em Editar. A área de janela Editar Terminal é exibida.
- Crie um novo terminal: Selecione Novo. A área de janela Criar Terminal é exibida.
- Selecione um terminal existente:
- Crie ou edite um terminal de email. Para obter informações adicionais, consulte Criando ou Editando um Terminal de E-mail.
Configurando a Atividade
- Selecione a tarefa Configurar a partir da Lista de Verificação. A área de janela Configurar é exibida.
- 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
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 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. 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
- Selecione a tarefa Regras de Entrega a partir da Lista de Verificação. A área de janela Regras de Entrega é exibida.
- Especifique o intervalo de tempo para sondar o servidor POP3 para novos
emails:
- Selecione uma unidade de tempo no menu: segundos, minutos, horas ou dias.
- 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.
Especificando as Opções de Nova Tentativa
- Selecione a tarefa Tentar Novamente a partir da Lista de Verificação. A área de janela Tentar Novamente é exibida.
- 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
- 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.
- 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.).