WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

EmailInput

Utilize o nó EmailInput para recuperar um e-mail, com ou sem anexo, de um servidor de e-mail que suporte Post Office Protocol 3 (POP3) ou Internet Message Access Protocol (IMAP).

Este tópico contém as seguintes seções:

Propósito

O nó EmailInput recebe um e-mail, com ou sem anexo, de um servidor de e-mail que suporte Post Office Protocol 3 (POP3) ou Internet Message Access Protocol (IMAP). O corpo do e-mail e quaisquer anexos 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. Os campos dessa estrutura são descritos na tabela a seguir:
Local do Elemento Tipo de Dados do Elemento Descrição
Root.EmailInputHeader.To CHARACTER Uma lista de endereços de e-mail separados por vírgulas.
Root.EmailInputHeader.Cc CHARACTER Uma lista de endereços de e-mail separados por vírgulas.
Root.EmailInputHeader.From CHARACTER Uma lista de endereços de e-mail separados por vírgulas.
Root.EmailInputHeader.ReplyTo CHARACTER Uma lista de endereços de e-mail separados por vírgulas.
Root.EmailInputHeader.Subject CHARACTER O resumo do conteúdo de e-mail ou o assunto do e-mail.
Root.EmailInputHeader.Size INTEGER O tamanho do e-mail, incluindo quaisquer anexos.
Root.EmailInputHeader.SentDate CHARACTER A data de entrega enviada do e-mail.
Essa estrutura é propagada com cada mensagem gravada no terminal Out do nó EmailInput. Para obter mais informações sobre a árvore lógica MIME, consulte Analisador e Domínio MIME.

Utilizando o Nó EmailInput em um Fluxo de Mensagens

Para ativar a função que se torna disponível nos fix packs do WebSphere Message Broker, use o parâmetro -f no comando mqsichangebroker. Para informações adicionais, consulte Comando mqsichangebroker.

É possível configurar o nó EmailInput utilizando as propriedades de nó no WebSphere Message Broker Toolkit. Um possível uso do nó EmailInput é a sondagem de um servidor de e-mail para e-mails em intervalos regulares e a recuperação de um e-mail quando ele está disponível. O fluxo de mensagens recebe o e-mail do servidor de e-mail como uma mensagem MIME.

No exemplo de fluxo de mensagens a seguir, o nó EmailInput transmite o e-mail, que está associado ao analisador MIME, para um nó Filter. O nó Filter processa o e-mail e o direciona para um nó MQHeader ou para um nó FileOutput, dependendo se o e-mail tem ou não um anexo.

Se o e-mail não contiver um anexo, o nó Filter enviará o e-mail para um nó MQHeader para customização MQ Message Descriptor (MQMD). O nó MQHeader inclui um cabeçalho do WebSphere MQ na árvore de mensagens e transmite a mensagem para o nó MQOutput. O nó MQOutput serializa o corpo da mensagem, por exemplo, o conteúdo do texto do e-mail, e coloca o corpo do e-mail em uma fila WebSphere MQ para processamento adicional.

Se o e-mail não contiver um anexo, o nó Filter enviará o e-mail para um nó FileOutput. O nó FileOutput então salva o anexo como um arquivo denominado email_attachment.dat em uma unidade de disco rígido especificada por você e, neste exemplo, o conteúdo do texto do e-mail é descartado. É possível realizar esse exemplo criando-se o fluxo de mensagens:

O diagrama mostra como é possível utilizar o nó EmailInput para receber um e-mail, com ou sem anexos, de um servidor de-mail e como processar o e-mail.

O nó EmailInput está contido no repositório E-mail da paleta do nó do fluxo de mensagens e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

Esta imagem mostra o ícone do nó EmailInput.

Visualize a seguinte amostra para ver como usar o nó EmailInput:

Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao WebSphere Message Broker Toolkit ou o centro de informações on-line. Você só poderá executar amostras quando usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit.

Usando Serviços Configuráveis para o Nó EmailInput

É possível configurar o nó EmailInput para obter a URL do servidor de e-mail e informações de identificação de segurança de um serviço configurável. Para obter detalhes sobre criar, alterar, relatar e excluir os serviços configuráveis, consulte Alterando Informações de Conexão para o Nó EmailInput.

Utilizando uma identidade de segurança para se autenticar com um servidor de e-mail

É possível utilizar o comando mqsisetdbparms para configurar um objeto de identidade de segurança de ID de usuário e senha para o nó EmailInput ou serviço configurável EmailServer para utilizar para acessar o servidor de e-mail. Para obter informações detalhadas sobre como configurar o suporte à identidade de segurança do servidor de e-mail, consulte Comando mqsisetdbparms.

Configurando o Nó EmailInput

Quando tiver colocado uma instância do nó EmailInput em um fluxo de mensagens, você poderá configurá-lo. Para obter informações adicionais, consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades.

Todas as propriedades obrigatórias para as quais é necessário digitar um valor (aquelas que não têm um valor padrão definido) são marcadas com um asterisco.

Para configurar o nó EmailInput utilizando as propriedades do nó no WebSphere Message Broker Toolkit para recuperar um e-mail, com ou sem anexos, consulte Recebendo um E-mail.

Terminais e Propriedades

Os terminais do nó EmailInput são descritos na tabela a seguir.

Terminal Descrição
Falha O terminal de saída para o qual a mensagem será roteada se uma falha do nó EmailInput for detectada quando uma mensagem for propagada ou quando um nó EmailInput falhar ao acessar o servidor de e-mail. Conecte o terminal Falha deste nó a outro nó no fluxo de mensagens para processar os erros.
Out O terminal de saída para o qual a mensagem é roteada se tiver sido propagada com êxito. Conecte o terminal Out desse nó a outro nó no fluxo de mensagens para processar a mensagem posteriormente ou envie a mensagem para um destino adicional.
Catch O terminal de saída para o qual a mensagem será roteada se for emitida uma exceção downstream e capturada por este nó. As exceções serão capturadas somente se o terminal estiver anexado.

As tabelas a seguir descrevem as propriedades do nó EmailInput.

A coluna da tabela intitulada O indica se a propriedade é obrigatória. Por exemplo, a propriedade é marcada com um asterisco significando que é necessário inserir um valor se nenhum padrão é definido.

A coluna intitulada C indica se a propriedade é configurável. Por exemplo, é possível alterar o valor quando você inclui o fluxo de mensagens no arquivo BAR para implementá-lo.

As propriedades Descrição do nó EmailInput são descritas na tabela a seguir.

Propriedade M C Default Descrição
Nome de nó Não Não Entrada de E-mail O nome do nó.
Descrição Breve Não Não Nenhum(a) Uma breve descrição do nó.
Descrição Longa Não Não Nenhum(a) Texto que descreve a finalidade do nó no fluxo de mensagens.

As propriedades Básicas do nó EmailInput são descritas na tabela a seguir.

Propriedade M C Default Descrição Propriedade do Comando mqsiapplybaroverride
Servidor de E-mail SIM SIM Nenhum(a) A propriedade Servidor de E-mail é definida como um nome de serviço configurável, por exemplo: myEmailConfigurableServiceName, ou como uma URL. A URL permite especificar um protocolo, nome do host e número da porta, que são as informações mínimas necessárias para o acesso ao servidor de e-mail.

A URL deve ser constituída da seguinte estrutura:

protocol://hostname:port

Em que:

  • protocol pode ser pop3 ou imap.
  • hostname é o endereço TCP/IP do Protocolo da Internet versão 4 (IPv4) ou nome do host resolvível por DNS do host de e-mail.
  • port é o número da porta na qual o servidor de e-mail está atendendo conexões por meio do POP3 ou IMAP. É possível inserir um número inteiro no intervalo 1 - 65535.

Por exemplo: pop3://myemailserver.com:12345 ou imap://myemailserver.com:56789.

Não há valor padrão para essa propriedade; entretanto, ela é obrigatória e portanto deve ser configurada com um nome de serviço configurável ou uma URL.

É possível obter os valores hostname e port do servidor de e-mail ou administrador do servidor de e-mail.

emailServer
As propriedades Sondagem do nó EmailInput estão descritas na seguinte tabela.
Propriedade M C Default Descrição Propriedade do Comando mqsiapplybaroverride
Intervalo de sondagem (em segundos) SIM SIM 5 O intervalo em que o nó EmailInput sonda o servidor de e-mail em busca de novos e-mails. waitInterval
As propriedades Segurança do nó EmailInput são descritas na tabela a seguir.
Propriedade M C Default Descrição Propriedade do Comando mqsiapplybaroverride
Identidade de Segurança Não SIM Nenhum(a) O nome do objeto de identidade de segurança que é criado e configurado pelo comando mqsisetdbparms contendo o ID do usuário e a senha a serem utilizados pelo broker para autenticação com o servidor de e-mail. Utilize o comando mqsisetdbparms para configurar o ID do usuário e a senha da identidade de segurança a ser acessado pelo broker.

O valor padrão para essa propriedade é Nenhum, que significa que o ID do usuário e a senha não são transmitidos para o servidor de e-mail.

Para obter mais informações sobre o suporte à identidade de segurança do servidor, consulte Comando mqsisetdbparms.

securityIdentity
As propriedades Repetição do nó EmailInput são descritas na tabela a seguir. Para obter mais informações sobre como configurar as propriedades Tentar Novamente do nó EmailInput, consulte Recebendo um E-mail.
Propriedade M C Default Descrição Propriedade do Comando mqsiapplybaroverride
Tentar mecanismo novamente SIM Não Repetição Curta e Longa Como o nó EmailInput trata a falha de um fluxo de mensagens. Os valores válidos são Falha, Repetições Curtas ou Repetições Curtas e Longas.  
Tentar limite novamente SIM SIM 0 O número de vezes para tentar a transação do fluxo de mensagens novamente quando o valor da propriedade Tentar Mecanismo Novamente estiver configurado como Repetições Curtas. retryThreshold
Intervalo de repetições curtas (em segundos) Não SIM 0 O intervalo, em segundos, entre cada nova tentativa se o valor da propriedade Limite de Novas Tentativas não estiver configurado como zero. shortRetryInterval
Intervalo de repetições longas (em segundos) Não SIM 300 O intervalo, em segundos, entre cada nova tentativa se o valor da propriedade Tentar Mecanismo Novamente for Intervalo de Repetições Curtas e Longas e as novas tentativas do mecanismo estiverem esgotadas. longRetryInterval
Ação no e-mail com falha SIM Não Excluir E-mail 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 falharem. emailFailureAction
As propriedades Transações do nó EmailInput estão descritas na seguinte tabela.
Propriedade M C Default Descrição Propriedade do Comando mqsiapplybaroverride
Modo de Transação Não SIM Não O modo de transação no nó EmailInput determina se o restante dos nós no fluxo de mensagens é executado no ponto de sincronização. Os valores válidos são Sim ou Não.  
As propriedades Instâncias do nó EmailInput são descritas na tabela a seguir.
Propriedade M C Default Descrição Propriedade do Comando mqsiapplybaroverride
Conjunto de instâncias adicionais Não SIM Utilizar Conjunto Associado ao Fluxo de Mensagens O conjunto do qual as instâncias adicionais são obtidas.

Se você selecionar o valor da propriedade Utilizar Conjunto Associado ao Fluxo de Mensagens, instâncias adicionais serão obtidas do conjunto de fluxos de mensagens.

Se você selecionar o valor da propriedade Utilizar Conjunto Associado ao Nó, as instâncias adicionais serão alocadas das instâncias adicionais do nó com base no número especificado na propriedade Instâncias Adicionais.

componentLevel
Instâncias Adicionais Não SIM 0 O número de instâncias adicionais que o nó EmailInput pode iniciar se a propriedade Conjunto de Instâncias Adicionais estiver configurada com o valor Utilizar Conjunto Associado ao Nó. additionalInstances
As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:44


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | bc16200_