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

EmailOutput

Utilize o nó EmailOutput para enviar mensagens de e-mail para um ou mais destinatários.

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

Propósito

O nó EmailOutput entrega uma mensagem de e-mail de um fluxo de mensagens para um servidor SMTP especificado por você.

É possível configurar o nó EmailOutput usando as propriedades do nó WebSphere® Message Broker Toolkit, ou dinamicamente a partir do ambiente local e do cabeçalho de saída de email (EmailOutputHeader) que estão associados à mensagem (para obter informações adicionais, consulte Produzindo Mensagens de E-mail Dinâmicas). É possível configurar o nó EmailOutput para produzir um email com um único anexo. Quando você produz mensagens de email dinamicamente, é possível especificar diversos anexos.

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

Ícone do nó EmailOutput

Examine a amostra a seguir para ver como utilizar esse nó:

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.

Configurando o Nó EmailOutput

Quando tiver colocado uma instância do nó EmailOutput 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.

A seguir está uma descrição de quatro níveis de configuração do nó EmailOutput:
  • Opção 1: Configure o nó EmailOutput usando as propriedades do nó no WebSphere Message Broker Toolkit para enviar um e-mail com um assunto e texto definidos estaticamente para uma lista de destinatários definida estaticamente. O mesmo e-mail é enviado para os mesmos destinatários e não possui anexos. Este método é útil quando você deseja testar o nó EmailOutput ou quando apenas a notificação é suficiente. Para obter detalhes adicionais, consulte Enviando um E-mail.
  • Opção 2: Esta opção é igual à Opção 1, mas com a inclusão de um anexo. Esta opção faz a mensagem de e-mail ser construída como uma mensagem MIME. O assunto, texto e lista de destinatários permanecem estáticos, mas o conteúdo do anexo é buscado dinamicamente a partir da mensagem transmitida para o nó EmailOutput no tempo de execução. O local do anexo na mensagem é definido estaticamente. Para obter detalhes adicionais, consulte Enviando um E-mail com um Anexo.
  • Opção 3: Esta opção permite que as propriedades nas Opções 1 e 2 sejam opcionais e sejam substituídas no tempo de execução por valores que são especificados no ambiente local, no cabeçalho de saída de e-mail (EmailOutputHeader) ou no corpo da mensagem. Esta opção permite que seja produzida uma mensagem de e-mail dinâmica, na qual o servidor SMTP, lista de destinatários, assunto, texto e vários anexos sejam determinados no tempo de execução. Esta opção requer que nós anteriores no fluxo de mensagens construam estas substituições. Quando um valor de texto não estiver especificado nas propriedades do nó para o corpo principal do e-mail, o corpo da mensagem transmitida para o nó EmailOutput será utilizado. Entretanto, o conteúdo que você configura na propriedade Texto da Mensagem de E-mail substitui o texto gerado dynamicamente no corpo da mensagem. Para obter detalhes adicionais, consulte Produzindo Mensagens de E-mail Dinâmicas.
  • Opção 4: Esta opção transmite uma mensagem MIME para o nó EmailOutput. O nó EmailOutput utiliza o analisador MIME para gravar a mensagem MIME em um fluxo de bits. Essa mensagem é, então enviada à lista de destinatários no cabeçalho SMTP. As substituições do ambiente local não são levadas em consideração quando uma mensagem MIME é transmitida. Para obter detalhes adicionais, consulte Enviando uma Mensagem MIME.

Cabeçalho de Saída de E-mail

O cabeçalho de saída de e-mail (EmailOutputHeader) é um filho da raiz. Os valores especificados neste cabeçalho substituem as propriedades configuradas no nó. Use o cabeçalho de saída SMTP para especificar qualquer um dos atributos de e-mail, como seus destinatários.
Local Descrição
Root.EmailOutputHeader.To Uma lista separada por vírgula de endereços de e-mail.
Root.EmailOutputHeader.Cc Uma lista separada por vírgula de endereços de e-mail.
Root.EmailOutputHeader.Bcc Uma lista separada por vírgula de endereços de e-mail.
Root.EmailOutputHeader.From Uma lista separada por vírgula de endereços de e-mail.
Root.EmailOutputHeader.Reply-To Uma lista separada por vírgula de endereços de e-mail.
Root.EmailOutputHeader.Subject O assunto do e-mail.

Ambiente local

Use o ambiente local para especificar substituições nas informações de conexão do servidor SMTP e anexos.
Ambiente local Descrição
Destination.Email.SMTPServer O Server:Port do servidor SMTP. A porta é opcional; se você não especificá-la, o valor padrão será 25.
Destination.Email.SecurityIdentity A identidade de segurança para a autenticação com o servidor SMTP, que pode ser o nome do par ID de usuário e senha que é definido utilizando o comando mqsisetdbparms, ou ela pode fazer referência a um recurso externo que tem um atributo securityIdentity que faz referência a um ID de usuário e senha que são definidos utilizando o comando mqsisetdbparms. Em ambos os casos, o valor é anexado depois da cadeia "smtp::". Por exemplo, se você utilizar o comando mqsisetdbparms para criar um ID de usuário e uma senha do smtp::myUseridPassword, securityIdentity especificada no nó, ou indiretamente em um recurso externo, será myUseridPassword.
Destination.Email.BodyContentType Identifica que o corpo da mensagem de e-mail contém HTML em vez de texto simples. É possível configurar esta propriedade como text/plain, text/html ou text/xml; text/plain é o valor padrão.
Para configurar o tipo de conteúdo para o corpo da mensagem, use a notação a seguir.
SET OutputLocalEnvironment.Destination.Email.BodyContentType = 
"text/html"
Para configurar adicionalmente o conjunto de caracteres (charset) no qual o corpo da mensagem é enviado, use a notação a seguir.
SET OutputLocalEnvironment.Destination.Email.BodyContentType = 
"text/html; charset=utf-8"
Este exemplo envia um e-mail de texto/HTML com um charset igual a UTF-8.
Destination.Email.MultiPartContentType O tipo de multiparte, incluindo relacionado, misto e alternativo. É possível configurar qualquer valor aqui.
Destination.Email.Attachment.Content O anexo (BLOB/texto) ou uma expressão XPath ou ESQL que faz referência a um elemento; por exemplo, um elemento na árvore de mensagens ou ambiente local. O valor do elemento referido é obtido como o conteúdo do anexo.
  • Se o elemento for um BLOB, ele será um anexo.
  • Se o elemento for texto, verifique se ele pode ser resolvido para outro elemento na árvore de mensagens ou ambiente local. Se puder ser resolvido, utilize esse elemento. Se não puder ser resolvido, inclua este elemento como o anexo.
Destination.Email.Attachment.ContentType O tipo de anexo (também conhecido como Internet Media Type), incluindo text/plain, text/html e text/xml. É possível configurar qualquer valor aqui.
Destination.Email.Attachment.ContentName O nome do anexo.
Destination.Email.Attachment.ContentEncoding A codificação do anexo: 7bit, base64 ou quoted-printable.
  • 7bit é o valor padrão utilizado para texto ASCII.
  • Base64 é utilizado para não-ASCII, se dados não em inglês ou binários. Este formato pode ser difícil de ser lido.
  • Quoted-printable é uma alternativa a Base64 e é apropriado quando a maioria dos dados são ASCII com algumas partes não-ASCII. Este formato é mais legível; ele fornece uma codificação mais compacta, porque as partes ASCII não são codificadas.

Propriedades do Servidor Broker

Também é possível configurar o servidor SMTP, número de porta e identidade de segurança como uma propriedade de recurso externa do broker. Para fazer isto, use um alias especificado na propriedade Servidor e Porta SMTP no nó do EmailOutput. A identidade de segurança faz referência a um par ID do usuário e senha que é definido no broker utilizando o comando mqsisetdbparms. Utilize o comando mqsicreateconfigurableservice para criar um recurso externo do broker SMTP para o alias especificado no nó. Em seguida, utilize o comando mqsichangeproperties para criar uma propriedade SMTPServer com o valor no formato de server:port. O valor de porta é opcional; se não for especificado, o valor padrão será 25. Você também pode utilizar o comando mqsichangeproperties para criar uma propriedade SMTPSecurityIdentity com um valor que é o nome de uma identidade de segurança que pode ser resolvida no tempo de execução para um ID do usuário e senha para autenticação com o servidor SMTP. Por exemplo:
mqsicreateconfigurableservice MY_BROKER –c SMTP –o SMTP_MyAlias  
seguido por:
 mqsichangeproperties MY_BROKER –c SMTP –o SMTP_MyAlias –n serverName –v smtp.hursley.ibm.com:25 
Estes comandos substituem os valores do servidor SMTP e de porta especificados em quaisquer nós que também especificam um alias de SMTP_MyAlias. Se o ambiente local contiver qualquer substituição, ela terá preferência sobre as propriedades do recurso externo do broker. Consulte também o exemplo a seguir:
mqsichangeproperties MY_BROKER –c SMTP –o SMTP_MyAlias –n securityIdentity –v mySecurityIdentity  
Você também deve utilizar o comando mqsisetdbparms para definir a identidade de segurança no tempo de execução do broker.

Conectando Terminais

Conecte o terminal de entrada (In) ao nó do qual as mensagens de saída ligadas são roteadas.

Conecte o terminal Out ou Failure deste nó a outro nó neste fluxo de mensagens para processar a mensagem posteriormente, processar erros ou enviar a mensagem para um destino adicional.

Se você conectar um destes terminais de saída a outro nó no fluxo de mensagens, o ambiente local associado à mensagem será aprimorado com as seguintes informações para cada destino no qual a mensagem foi colocada por este nó:
Local Descrição
WrittenDestination.Email.smtpServer O Server:Port do servidor SMTP.
WrittenDestination.Email.messageId O ID da mensagem de e-mail enviada.

Estes valores são gravados em WrittenDestination na estrutura em árvore do ambiente local.

Se você não conectar nenhum terminal, a árvore de ambiente local ficará inalterada.

Terminais e Propriedades

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

Terminal Descrição
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Falha O terminal de saída para o qual a mensagem é roteada se uma falha for detectada quando uma mensagem for propagada. 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 Saída deste nó a outro nó do fluxo de mensagens para processar a mensagem posteriormente ou envie a mensagem para um destino adicional.

As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco se for necessário inserir um valor quando não for definido nenhum padrão); a coluna com cabeçalho C indica se a propriedade é configurável (é possível alterar o valor quando você incluir o fluxo de mensagens ao arquivo BAR na implementação).

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

Propriedade M P Default Descrição
Nome do Nó Não Não O tipo de nó, EmailOutput O nome do nó.
Descrição Breve Não Não   Uma breve descrição do nó.
Descrição Longa Não Não   Texto que descreve a finalidade do nó no fluxo de mensagens.

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

Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Servidor e Porta SMTP Não Sim   Esta propriedade define o servidor SMTP e porta para os quais os e-mails são enviados a partir desse nó e está no formato server:port; por exemplo: my.smtp.server:25. O valor de porta é opcional mas, se não for especificado, o valor padrão será 25.

É possível especificar um valor de alias para esta propriedade. Se o alias existir no tempo de execução, os valores especificados serão utilizados. Se o alias não existir no tempo de execução, o broker assumirá o valor como sendo um host SMTP válido.

smtpServer

As propriedades E-mail do nó EmailOutput são descritas na tabela a seguir.

Propriedade M P Default Descrição
Endereços Para Não Não   O destinatário ou destinatários do e-mail. Esta propriedade pode incluir um único endereço de e-mail ou uma lista separada por vírgula de endereços de e-mail.
Endereços Cc Não Não   O destinatário ou destinatários copiados no e-mail. Esta propriedade pode incluir um único endereço de e-mail ou uma lista separada por vírgula de endereços de e-mail.
Endereços Cco Não Não   O destinatário ou destinatários do e-mail com cópia oculta. Esta propriedade pode incluir um único endereço de e-mail ou uma lista separada por vírgula de endereços de e-mail.
Endereço De Não Não   O endereço de e-mail do remetente do e-mail.
Endereço Responder Para Não Não   O endereço de e-mail para o qual os destinatários do e-mail respondem.
Assunto do e-mail Não Não   O assunto do e-mail.
Texto da mensagem de e-mail Não Não   O texto principal do e-mail. Use esta propriedade para fornecer um corpo principal estático de um e-mail.

Se você usar esta propriedade, ela substituirá o conteúdo fornecido no corpo da árvore de mensagens que é transmitida ao nó de entrada. Se você não especificar um valor para esta propriedade, o texto do e-mail será o corpo da árvore de mensagens que é transmitida ao nó EmailOutput.

Tipo do Conteúdo do Corpo Não Não text/plain É possível utilizar esta propriedade para forçar o tipo de conteúdo para o corpo da mensagem de e-mail. Os valores válidos são:
  • Nenhum(a)
  • text/plain
  • text/html
  • text/xml

As propriedades Segurança do nó EmailOutput são descritas na tabela a seguir.

Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Identidade de segurança Não Sim   Um id de segurança para recuperar um ID do usuário e senha que são configurados no tempo de execução do broker. securityIdentity

As propriedades Anexo do nó EmailOutput são descritas na tabela a seguir.

Propriedade M P Default Descrição
Conteúdo do Anexo Não Não   Uma expressão XPath ou ESQL que faz referência a um elemento; por exemplo, um elemento na árvore de mensagens ou ambiente local. O conteúdo do anexo é o valor do elemento referido.
Nome do Conteúdo de Anexo Não Não   O nome do anexo que é visto pelo destinatário do e-mail . Esta propriedade é opcional. Se não for especificado um nome, será designado um nome padrão.
Tipo do Conteúdo de Anexo Não Não text/plain O tipo de anexo. Esta propriedade é opcional, mesmo que você tenha especificado um anexo. Os valores válidos são:
  • text/plain é texto simples.
  • text/html é HTML.
  • text/xml é XML.
  • application/octet-stream é o tipo padrão para não-texto e HTML (dados binários).
Codificação do Conteúdo de Anexo Não Não 7bit A codificação do anexo. Esta propriedade é opcional. Se não for especificado um valor, será designada a codificação padrão. Os valores válidos são:
  • 7bit é o valor padrão para texto ASCII.
  • base64 é utilizado para dados não-ASCII, se forem dados não em inglês ou binários.
  • quoted-printable é uma alternativa mais legível a base64. Utilize quoted-printable quando a maioria dos dados forem texto ASCII com algumas partes não-ASCII. Esta opção fornece uma codificação mais compacta, porque as partes ASCII não são codificadas.
Tipo do Conteúdo Multipartes Não Não Misto O tipo de multiparte. Os valores válidos são:
  • Misto: cada parte do corpo de MIME é independente de outros.
  • Alternativo: cada parte do corpo de MIME é uma alternativa para outras.
  • Relacionado: Todas as partes do corpo de MIME devem ser consideradas na agregação apenas.

As propriedades Validação do nó EmailOutput são descritas na tabela a seguir.

Consulte Propriedades de Validação para obter uma descrição integral dessas propriedades.

Propriedade M P Default Descrição Propriedade do Comando mqsiapplybaroverride
Validar Sim Sim Herdar Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum, Conteúdo e Valor, Conteúdo e Herdar. validateMaster
Ação de falha Sim Não Exceção Essa propriedade controla o que acontecerá se a validação falhar. Você pode configurar essa propriedade somente se configurar Validar como Conteúdo ou Conteúdo e Valor. Os valores válidos são Rastreio do Usuário, Registro de Erros Local, Exceção e Lista de Exceções.  
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:28:39


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