Você pode receber um e-mail, com ou sem anexos, de um
servidor de e-mail que suporte Post Office Protocol 3 (POP3) ou Internet Message Access
Protocol (IMAP).
Use o WebSphere Message Broker Toolkit para
configurar as propriedades no nó EmailInput
para poder receber um e-mail, com ou sem anexos.
- Inclua um nó EmailInput em
seu fluxo de mensagens.
- Editas seguintes propriedades do nó EmailInput:
- Na guia Básico, inclua a URL do servidor de e-mail, ou o nome
do serviço configurável EmailServer como o valor da propriedade
Servidor de E-mail, conforme descrito em Nó EmailInput. Por exemplo, pop3://myemailserver.com:12345 ou imap://myemailserver.com:56789.
- Na guia Segurança, inclua o nome do objeto de identidade de
segurança do par de ID do usuário e senha do servidor de e-mail como valor da propriedade
Identidade de Segurança. Para obter mais informações sobre o suporte à identidade de segurança do servidor, consulte Comando mqsisetdbparms.
- Configure as seguintes propriedades na guia Tentar Novamente:
- Tentar Mecanismo Novamente: Essa
propriedade define como o nó EmailInput trata
uma falha de fluxo de mensagens. Os valores válidos são Falha, Repetições Curtas ou Repetições Curtas e Longas. O
valor padrão para essa propriedade é
Repetições Curtas e Longas, que indica que o
e-mail é tentado novamente até que o limite de repetições curtas seja atingido; em
seguida, ocorrem repetições longas, significando que o e-mail nunca é excluído do
servidor de e-mail, mas também que o e-mail é repetido infinitamente. Os e-mails
serão excluídos do servidor de e-mail se a mensagem de e-mail falhar e o valor dessa
propriedade não estiver configurado como Repetições
Curtas e Longas.
- Limite de Repetições: É o número de vezes
para tentar a transação do fluxo de mensagens novamente quando o valor da propriedade
Tentar Mecanismo Novamente está configurado
como Repetições Curtas. O valor padrão para
essa propriedade é 0.
- Intervalo de Repetições Curtas (em
segundos): É o intervalo em segundos entre cada repetição se o valor da
propriedade Limite de Repetições não estiver
configurado como zero. O valor padrão para essa propriedade é
0. Se o e-mail for tentado novamente até o
limite de repetições curtas ser atingido e o e-mail falhar, ele será roteado para o
terminal de falha e será excluído do servidor de e-mail.
- Intervalo de Repetições Longas (em
segundos): É o intervalo em segundos entre cada repetição, se o valor da
propriedade Tentar Mecanismo Novamente for
Repetições Curtas e Longas e o limite de
repetições curtas tiver sido esgotado. O valor padrão para essa propriedade é
300 segundos.
- Ação no e-mail com falha: Essa propriedade
determina a ação que o nó EmailInput toma com
a origem de dados de entrada após todas as tentativas de processar o conteúdo do e-mail
falharem. Essa é uma propriedade somente leitura que é configurada com um valor padrão
igual a Excluir E-mail, que é usada com a
propriedade Tentar Mecanismo Novamente. Se a propriedade Tentar Mecanismo Novamente for
configurada como Repetições Curtas e Longas,
o fluxo de mensagens continuará tentando recuperar o e-mail do servidor de e-mail,
significando que o e-mail nunca é excluído. Se a propriedade Tentar Mecanismo Novamente
não for configurada como Repetições Curtas e
Longas, será usado o valor Excluir
E-mail da propriedade Ação no e-mail com falha, e o e-mail será excluído do
servidor de e-mail.
- Salve as mudanças.
- Inclua o fluxo de mensagens no arquivo BAR e implemente.
Quando uma mensagem é transmitida ao nó
EmailInput implementado, um e-mail é recebido
do servidor de e-mail e o corpo da mensagem de e-mail e qualquer anexo são propagados no
domínio Multipurpose Internet Mail Extensions (MIME). Todas as demais informações
relacionadas ao e-mail são armazenadas na árvore lógica MIME
Root.EmailInputHeader. Para obter uma lista completa dos elementos
de e-mail propagados na árvore lógica MIME quando você usar um nó
EmailInput, consulte
Nó EmailInput.
Quando um e-mail contendo um anexo é recebido, o nó
EmailInput coloca diferentes partes do corpo
do e-mail no domínio MIME, de modo que elas sejam associadas ao analisador MIME. O local
da árvore MIME que o nó EmailInput constrói
para receber as informações é o mesmo local que o nó
EmailOutput espera que os dados do e-mail
estejam ao enviar um e-mail. O anexo é armazenado na árvore lógica MIME no diretório
Root.MIME.Parts.Part.Data.
Em que Content-Type descreve o tipo de
dados que está no anexo.
A visualização do valor Root.Properties.ContentType no domínio
MIME permite gravar a lógica para analisar o anexo.
Para obter mais informações sobre a
árvore lógica MIME, consulte Analisador e Domínio MIME.
Os e-mails recebidos são excluídos de um servidor de e-mail que suporta POP3
ou IMAP somente quando os e-mails foram propagados com êxito depois de serem
processados pelos terminais Failure, Out ou Catch do nó
EmailInput e o fluxo de mensagens ter sido
executado com êxito.
Isso não faz parte de uma transação coordenada globalmente.
Os
e-mails são excluídos do servidor de e-mail nas seguintes circunstâncias:
- O terminal Failure não está conectado.
- Uma exceção ocorre no terminal Failure.
- A mensagem de e-mail falha e o valor da propriedade
Tentar Mecanismo Novamente não está configurado
como Repetições Curtas e Longas.
- O Limite de Repetições não está configurado
como 0 e o valor da propriedade
Intervalo de Repetições Curtas foi esgotado.
Para
obter mais informações sobre o processamento de respostas de um nó
EmailInput, bem como informações sobre
manipulação de retrocesso, consulte
Processando Respostas de um Nó EmailInput.