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:
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:
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.
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.
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 | 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.
Para
configurar adicionalmente o conjunto de caracteres (charset) no qual o corpo da mensagem
é enviado, use a notação a seguir.
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.
|
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.
|
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.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.
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.
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:
|
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:
|
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:
|
Tipo do Conteúdo Multipartes | Não | Não | Misto | O tipo de multiparte. Os valores válidos são:
|
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. |
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. |