Atividade Enviar E-mail

Uma orquestração que contém a atividade Enviar E-mail está agindo como um cliente de e-mail durante o tempo de execução.

A atividade Enviar E-mail se conecta ao servidor SMTP e envia uma mensagem para o servidor, conforme mostrado na figura a seguir.
Figura 1.
As etapas para incluir e configurar uma atividade Enviar E-mail são descritas nos procedimentos a seguir.

Incluindo uma Atividade Enviar E-mail na Orquestração

  1. Crie ou abra uma orquestração. Uma representação gráfica da orquestração é exibida.
  2. Selecione a guia Atividades e expanda a pasta E-mail.
  3. Arraste a atividade Enviar E-mail para a orquestração.
  4. Selecione a atividade. A Lista de Verificação é exibida.

Criando, Selecionando ou Editando um Terminal de E-mail

  1. Clique na tarefa Selecionar Terminal na Lista de Verificação e escolha a partir de uma das seguintes ações:
    • Selecione um terminal existente:
      1. Selecione Procurar. O Explorador de Projetos é exibido.
      2. Selecione um terminal existente e clique em OK. Conclua as etapas em Configurando a Atividade.
    • Selecione um terminal existente e edite o terminal:
      1. Selecione Procurar. O Explorador de Projetos é exibido.
      2. Selecione um terminal existente e clique em OK.
      3. Clique em Editar. A área de janela Editar Terminal é exibida.
    • Crie um novo terminal: Selecione Novo. A área de janela Criar Terminal é exibida.
  2. Crie ou edite um terminal de e-mail. Para obter informações adicionais, consulte Criando ou Editando um Terminal de E-mail.

Configurando a Atividade

  1. Selecione a tarefa Configurar a partir da Lista de Verificação. A área de janela Configurar é exibida.
  2. Configure todos os campos nessa área de janela, conforme descrito na tabela a seguir:
    Tabela 1.
    Campo Descrição
    Endereço do Remetente Especifica o endereço do remetente do e-mail. Você deve especificar o endereço de e-mail usando o formato de e-mail padrão: email@domain.extension. Este campo é necessário.
    Até Especifica os endereços dos destinatários do e-mail. Você deve especificar os endereços de e-mail usando o formato de e-mail padrão: email@domain.extension. Um ou mais endereços podem ser especificados. Separe os endereços com vírgulas ou ponto e vírgulas. Você deve especificar pelo menos um endereço. Este campo é necessário.
    CC Especifica os endereços da cópia carbono do e-mail. Você deve especificar os endereços de e-mail usando o formato de e-mail padrão: email@domain.extension. Um ou mais endereços podem ser especificados. Separe os endereços com vírgulas ou ponto e vírgulas. Este campo é opcional.
    Assunto Especifica o assunto do e-mail.

Especificando as Opções de Nova Tentativa

  1. Selecione a tarefa Tentar Novamente a partir da Lista de Verificação. A área de janela Tentar Novamente é exibida.
  2. Configure as opções de nova tentativa para se conectar a um servidor SMTP. A tabela a seguir descreve as opções de nova tentativa para se conectar a um Servidor SMTP:
    Tabela 2.
    Campo Descrição
    Tentar novamente  
    1) Aguardar ___ segundo(s) entre cada nova tentativa. Especifica o número de segundos que o Integration Appliance aguarda antes de tentar estabelecer uma conexão com o Servidor SMTP.
    2) Tentar se conectar ___ vezes antes de falhar. Especifica a contagem de novas tentativas - o número máximo de vezes que o Integration Appliance tenta estabelecer uma conexão com o Servidor SMTP antes de emitir um erro e parar o processamento da tarefa de orquestração atual.

    Se você implementar uma orquestração que contém uma atividade Enviar E-mail e o Integration Appliance não puder se conectar ao Servidor SMTP especificado, o Integration Appliance registrará os erros de conexões como avisos no sistema e os logs de orquestração até o valor de contagem de novas tentativas ser atingido. Quando a contagem de novas tentativas é atingida, o Integration Appliance registra um erro nos logs do sistema e da orquestração e para o processamento da tarefa de orquestração atual.

    Por exemplo, você configura a contagem de novas tentativas para 3. O primeiro, segundo e terceiro erros de conexão aparecem no log do sistema como avisos. O Integration Appliance registra o quarto erro de conexão como um erro e para o processamento da tarefa de orquestração atual.

     

Mapeando a Entrada da Atividade

  1. Selecione a tarefa Mapear Entradas na Lista de Verificação. Os parâmetros de entrada da atividade são exibidos na área de janela Para Atividade.
  2. Nesta tarefa, é possível mapear variáveis para os seguintes parâmetros de entrada da atividade:
    • O parâmetro de entrada body contém o corpo do e-mail e os anexos associados. O parâmetro de entrada body é do tipo cadeia. Você deve mapear uma variável ou designar um valor-padrão para o parâmetro de entrada body.
    • O parâmetro de entrada mailheader opcional contém meta informações sobre o e-mail, por exemplo, os endereços de e-mail para os quais a mensagem está sendo enviada e o mimeHeader da própria mensagem. O parâmetro de entrada mailheader é opcional, você não precisa mapear uma variável ou designar valores-padrão para o parâmetro de entrada mailheader.

      Se o parâmetro de entrada mailheader opcional não estiver listado na área de janela Para Atividade da área de janela Mapear Entradas, selecione Mapear > Mostrar Parâmetros Opcionais no menu da barra de ferramentas ou clique com o botão direito do mouse na área de janela Para Atividade e selecione a opção Mostrar Parâmetros Opcionais. Se a opção Mapear > Mostrar Parâmetros Opcionais não for selecionável no menu da barra de ferramentas, clique em um nó na área de janela Mapear Entradas para tornar essa opção ativa.

      É possível substituir opcionalmente as configurações especificadas na tarefa Configurar da Lista de Verificação dinamicamente durante o tempo de execução, passando valores de variáveis para os nós especificados na tabela a seguir. Por exemplo, durante o tempo de execução, é possível substituir a configuração do campo Endereço do Remetente, mapeando uma variável para o nó from do parâmetro de entrada mailheader. Durante o tempo de execução, o valor da variável é o endereço from no e-mail enviado.

      Tabela 3.
      Nós do Parâmetro de Entrada mailheader Descrição Quais configurações substitui na tarefa Configurar?  
      from Especifica o endereço do remetente do e-mail. Você deve especificar o endereço de e-mail usando o formato de e-mail padrão: email@domain.extension. O nó from do parâmetro de entrada mailheader substitui o campo Endereço do Remetente especificado na tarefa Configurar.
      to Especifica os endereços dos destinatários do e-mail. Você deve especificar os endereços de e-mail usando o formato de e-mail padrão: email@domain.extension. Um ou mais endereços podem ser especificados. Separe os endereços com vírgulas ou ponto e vírgulas. O nó to do parâmetro de entrada mailheader substitui o campo Para especificado na tarefa Configurar.
      cc Especifica os endereços da cópia carbono do e-mail. Você deve especificar os endereços de e-mail usando o formato de e-mail padrão: email@domain.extension. Um ou mais endereços podem ser especificados. Separe os endereços com vírgulas ou ponto e vírgulas. O nó cc do parâmetro de entrada mailheader substitui o campo CC especificado na tarefa Configurar.
      subject Especifica o assunto do e-mail. O nó subject do parâmetro de entrada mailheader substitui o campo Assunto especificado na tarefa Configurar.
      mimeHeader Especifica o cabeçalho MIME do e-mail. Nenhum.
      otherHeaders Especifica um elemento que contém um conjunto de cabeçalhos MIME como pares nome/valor ainda não especificados no nó mimeHeader. Por exemplo, o cabeçalho MIME: Content-Location não está especificado no cabeçalho MIME, portanto, o seguinte nó headerItem pode ser igual aos seguintes valores: otherheaders/headerItem/name é igual a Content-Location otherHeaders/headerItem/value é igual ao valor do cabeçalho MIME Content-Location, por exemplo, a cadeia: RN-Preamble Múltiplos cabeçalhos MIME podem ser especificados, portanto, este é um nó recorrente. Nenhum.
      Nota: É possível usar a atividade Gravar MIME para construir o conteúdo do nó mimeHeader do parâmetro de entrada mailheader opcional. Por exemplo, seria possível incluir uma atividade Gravar MIME na orquestração antes da atividade Enviar E-mail e fazer com que a atividade Gravar MIME preenchesse o conteúdo da variável XML do mimeHeader e, em seguida, introduzir a variável mimeHeader na atividade Enviar E-mail.

      Consulte Criando um Mapa para obter informações adicionais