Partilhar via


Tarefa Enviar Email

Aplica-se a: SQL Server SSIS Integration Runtime no Azure Data Factory

A tarefa Enviar Email envia uma mensagem de email. Usando a tarefa Enviar Email, um pacote pode enviar mensagens se as tarefas no fluxo de trabalho do pacote tiverem êxito ou falharem ou enviar mensagens em resposta a um evento que o pacote ativa em tempo de execução. Por exemplo, a tarefa pode notificar um administrador de banco de dados sobre o êxito ou a falha da tarefa Fazer Backup do Banco de Dados.

Você pode configurar a tarefa Enviar Email das seguintes formas:

  • Fornecendo o texto da mensagem de email.

  • Fornecendo uma linha de assunto para a mensagem de email.

  • Definindo o nível de prioridade da mensagem. A tarefa dá suporte a três níveis de prioridade: normal, baixa e alta.

  • Especificando os destinatários nas linhas Para, Cc e Cco. Se a tarefa especificar vários destinatários, eles serão separados por ponto-e-vírgulas.

    Observação

    As linhas Para, Cc e Cco são limitadas a 256 caracteres cada, conforme os padrões da Internet.

  • Incluindo anexos. Se a tarefa especificar vários anexos, eles serão separados pelo caractere barra vertical (|).

    Observação

    Se um arquivo de anexo não existir quando o pacote for executado, ocorrerá um erro.

  • Especificando o gerenciador de conexões SMTP a ser usado.

    Importante

    O gerenciador de conexões SMTP dá suporte apenas para autenticação anônima e Autenticação do Windows. Ele não suporta a autenticação básica.

O texto da mensagem pode ser uma cadeia de caracteres que você fornece, uma conexão com um arquivo que contém o texto ou o nome de uma variável que contém o texto. A tarefa usa um gerenciador de conexões de arquivos para se conectar a um arquivo. Para obter mais informações, consulte Flat File Connection Manager.

A tarefa usa um gerenciador de conexões SMTP para se conectar a um servidor de email. Para obter mais informações, consulte SMTP Connection Manager.

Mensagens de log personalizadas disponíveis na tarefa Enviar Email

A tabela a seguir relaciona as entradas de log personalizadas para a tarefa Enviar Email. Para obter mais informações, consulte Log do SSIS (Integration Services).

Entrada de log Descrição
SendMailTaskBegin Indica que a tarefa começou a enviar uma mensagem de email.
SendMailTaskEnd Indica que a tarefa terminou de enviar uma mensagem de email.
SendMailTaskInfo Fornece informações descritivas sobre a tarefa.

Configurando a tarefa Enviar Email

Você pode definir propriedades pelo Designer do SSIS ou programaticamente.

Para obter mais informações sobre as propriedades que podem ser definidas no SSIS Designer, clique no tópico a seguir:

Para obter informações sobre como definir essas propriedades programaticamente, clique no tópico a seguir:

Para obter informações sobre como definir essas propriedades no Designer do SSIS , clique em Definir as propriedades de uma tarefa ou de um contêiner.

Editor da Tarefa Enviar Email (página Geral)

Use a página Geral da caixa de diálogo Editor da Tarefa Enviar Email para nomear e descrever a tarefa Enviar Email.

Opções

Nome
Forneça um nome exclusivo para a tarefa Enviar Email. Esse nome é usado como rótulo no ícone de tarefa.

Nota Nomes de tarefa devem ser exclusivos no pacote.

Descrição
Digite uma descrição para a tarefa Enviar Email.

Editor da tarefa Enviar Email (página Email)

Use a página Email da caixa de diálogo do Editor da Tarefa Enviar Email para especificar destinatários, o tipo de mensagem e a prioridade de uma mensagem. Você também pode anexar arquivos à mensagem. O texto da mensagem pode ser uma cadeia de caracteres fornecida por você, uma conexão com um arquivo que contém o texto ou o nome de uma variável que contém o texto.

Opções

SMTPConnection
Selecione um gerenciador de conexões SMTP na lista ou clique em <Nova conexão...> para criar um gerenciador de conexões.

Importante

O gerenciador de conexões SMTP dá suporte apenas para autenticação anônima e Autenticação do Windows. Ele não suporta a autenticação básica.

Tópicos relacionados: Gerenciador de conexões SMTP

De
Especifique o endereço de email do remetente.

Para
Forneça os endereços de email dos destinatários, separados por ponto-e-vírgula.

Cc
Especifique os endereços de email de outras pessoas que também receberão cópias da mensagem, separando todos os emails por ponto-e-vírgula.

Cco
Especifique os endereços de email de outras pessoas que também receberão cópias da mensagem com cópia oculta (Cco), separando todos os emails por ponto-e-vírgula.

Assunto
Indique o assunto da mensagem de email.

MessageSourceType
Selecione o tipo de origem da mensagem. As opções dessa propriedade são listadas na tabela a seguir.

Valor Descrição
Entrada Direta Defina a origem do texto da mensagem. Selecionar este valor faz com que seja exibida a opção dinâmica MessageSource.
Conexão do Arquivo Defina a origem do arquivo que contém o texto da mensagem. Selecionar este valor faz com que seja exibida a opção dinâmica MessageSource.
Variável Defina a origem de uma variável que contém o texto da mensagem. Selecionar este valor faz com que seja exibida a opção dinâmica MessageSource.

Prioridade
Defina a prioridade da mensagem.

Anexos
Forneça os nomes de arquivo dos anexos à mensagem de email, separados por uma barra vertical (|).

Observação

As linhas Para, Cc e Cco são limitadas a 256 caracteres, de acordo com os padrões da Internet.

Opções dinâmicas de MessageSourceType

MessageSourceType = Entrada direta

MessageSource
Digite o texto da mensagem ou clique no botão Procurar (...) e digite a mensagem na caixa de diálogo Origem da mensagem.

MessageSourceType = Conexão do arquivo

MessageSource
Selecione um Gerenciador de conexões de arquivos na lista ou clique em <Nova conexão...> para criar um gerenciador de conexões.

Tópicos relacionados: File Connection Manager, File Connection Manager Editor

MessageSourceType = Variável

MessageSource
Selecione uma variável na lista ou clique em <Nova variável...> para criar uma variável.

Tópicos relacionados: Variáveis do Integration Services (SSIS), Adicionar variável

Confira também

Tarefas do Integration Services
Fluxo de Controle