Partilhar via


Tarefa de Enviar Correio

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

A tarefa Enviar Email envia uma mensagem de e-mail. Ao usar a tarefa Enviar Correio, um pacote pode enviar mensagens se as tarefas no fluxo de trabalho do pacote tiverem sucesso ou falhar, ou enviar mensagens em resposta a um evento que o pacote gera em tempo de execução. Por exemplo, a tarefa pode notificar um administrador de base de dados sobre o sucesso ou fracasso da tarefa de Backup Database.

Pode configurar a tarefa Enviar Correio das seguintes formas:

  • Forneça o texto da mensagem para o e-mail.

  • Forneça uma linha de assunto para a mensagem de e-mail.

  • Defina o nível de prioridade da mensagem. A tarefa suporta três níveis de prioridade: normal, baixo e alto.

  • Especifique os destinatários nas linhas To, Cc e Bcc. Se a tarefa especificar múltiplos destinatários, estes são separados por ponto e vírgula.

    Observação

    As linhas To, Cc e Bcc estão limitadas a 256 caracteres cada, de acordo com os padrões da Internet.

  • Inclui anexos. Se a tarefa especificar múltiplos anexos, estes são separados pelo carácter pipe (|).

    Observação

    Se um ficheiro anexo não existir quando o pacote é executado, ocorre um erro.

  • Especifique o gestor de ligação SMTP a usar.

    Importante

    O gestor de ligações SMTP suporta apenas autenticação anónima e Autenticação do Windows. Não suporta autenticação básica.

O texto da mensagem pode ser uma cadeia que fornece, uma ligação a um ficheiro que contém o texto, ou o nome de uma variável que contém o texto. A tarefa utiliza um gestor de ligações de ficheiros para se ligar a um ficheiro. Para mais informações, consulte Gestor de Ligação de Ficheiros Planos.

A tarefa utiliza um gestor de ligações SMTP para se ligar a um servidor de correio. Para mais informações, consulte SMTP Connection Manager.

Mensagens de registo personalizadas disponíveis na tarefa Enviar Correio

A tabela seguinte lista as entradas de registo personalizadas para a tarefa Enviar Correio. Para obter mais informações, consulte o Log de Serviços de Integração (SSIS) .

Entrada de log Description
EnviarCorreioTarefaInício Indica que a tarefa iniciou o envio de uma mensagem de e-mail.
SendMailTaskEnd Indica que a tarefa terminou de enviar uma mensagem de e-mail.
SendMailTaskInfo Fornece informações descritivas sobre a tarefa.

Configuração da Tarefa de Enviar Correio

Você pode definir propriedades por meio do SSIS Designer ou programaticamente.

Para informações sobre as propriedades que pode definir no SSIS Designer, clique no seguinte tópico:

Para informações sobre como definir programaticamente estas propriedades, clique no seguinte tópico:

Para informações sobre como definir estas propriedades no SSIS Designer, clique em Definir as Propriedades de uma Tarefa ou Contentor.

Editor de Tarefas de Envio de Correio (Página Geral)

Use a página Geral da caixa de diálogo Enviar Correio do Editor de Tarefas para nomear e descrever a tarefa Enviar Correio.

Opções

Nome
Dê um nome único para a tarefa Enviar Correio. Esse nome é usado como o rótulo no ícone da tarefa.

Nota Os nomes das tarefas devem ser únicos dentro de um pacote.

Descrição
Escreve uma descrição da tarefa Enviar E-mail.

Editor de Tarefas de Enviar Email (Página de Email)

Use a página de Email da caixa de diálogo do Editor de Tarefas de Enviar Email para especificar destinatários, tipo de mensagem e prioridade para uma mensagem. Também pode anexar ficheiros à mensagem. O texto da mensagem pode ser uma cadeia que fornece, uma ligação de ficheiro a um ficheiro que contém o texto, ou o nome de uma variável que contém o texto.

Opções

SMTPConnection
Seleciona um gestor de ligações SMTP na lista, ou clica <em Nova ligação...> para criar um novo gestor de ligações.

Importante

O gestor de ligações SMTP suporta apenas autenticação anónima e Autenticação do Windows. Não suporta autenticação básica.

Tópicos Relacionados:Gestor de Ligação SMTP

De
Especifique o endereço de e-mail do remetente.

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

Cc
Especifique os endereços de e-mail, delimitados por ponto e vírgula, dos indivíduos que também recebem cópias da mensagem.

Cco
Especifique os endereços de e-mail, delimitados por ponto e vírgula, dos indivíduos que recebem cópias cegas a carvão (Bcc) da mensagem.

Assunto
Forneça um assunto para a mensagem de e-mail.

MessageSourceType
Selecione o tipo de origem da mensagem. Esta propriedade tem as opções listadas na tabela a seguir.

Valor Description
Entrada direta Defina a fonte para o texto da mensagem. Ao selecionar este valor, aparece a opção dinâmica, MessageSource.
Conexão de arquivo Defina a fonte para o ficheiro que contém o texto da mensagem. Ao selecionar este valor, aparece a opção dinâmica, MessageSource.
Variável Defina a fonte para uma variável que contenha o texto da mensagem. Ao selecionar este valor, aparece a opção dinâmica, MessageSource.

Prioridade
Defina a prioridade da mensagem.

Attachments
Forneça os nomes dos ficheiros anexos à mensagem de e-mail, delimitados pelo carácter pipe (|).

Observação

As linhas To, Cc e Bcc estão limitadas a 256 caracteres, de acordo com os padrões da Internet.

MessageSourceType Opções Dinâmicas

MessageSourceType = Entrada Direta

MessageSource
Escreva o texto da mensagem ou clique no botão de navegar (...) e depois escreva a mensagem na caixa de diálogo Fonte da Mensagem .

MessageSourceType = Ligação ao ficheiro

MessageSource
Selecione um gestor de ligações de ficheiros na lista ou clique em <Nova ligação...> para criar um novo gestor de ligações.

Tópicos relacionados:Gerenciador de Conexão de Ficheiros, Editor de Gerenciador de Conexão de Ficheiros

MessageSourceType = Variável

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

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

Ver também

Tarefas dos Serviços de Integração
Controle de Fluxo