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