Atividade de envio de e Email
Introdução
Uma atividade de Email Enviar Email, usando sua conexão de Email, envia email usando o Protocolo Simples de Transferência de Correio (SMTP) para destinatários especificados e deve ser usado como alvo em uma operação.
Importante
Para enviar emails pelo Microsoft 365 (smtp.office365.com
), OAuth2 deve ser selecionado para Tipo de autenticação e ROPC (Resource Owned Password Credentials) deve ser selecionado para Tipo de concessão em uma conexão de Email.
Criar uma atividade de envio de e Email
Uma instância de uma atividade de Email Enviar Email é criada a partir de uma conexão de Email usando seu tipo de atividade Enviar Email.
Para criar uma instância de uma atividade, arraste o tipo de atividade para a quadro de design ou copie o tipo de atividade e cole-o na quadro de design. Para obter detalhes, consulte Criar uma instância de atividade ou ferramenta em Reutilização de componentes.
Uma Email existente de Enviar Email pode ser editada nestes locais:
- A quadro de design (veja menu de ações do componente em Tela de design).
- A aba Componentes do painel do projeto (consulte menu de ações do componente na aba Componentes do painel Projeto).
Configurar uma atividade de envio de e Email
Siga estas etapas para configurar uma atividade de Email Enviar Email:
-
Etapa 1: Insira um nome e especifique as configurações
Forneça um nome para a atividade e especifique as configurações para o email de saída. -
Etapa 2: Revise os esquemas de dados
Todos os esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos.
Etapa 1: insira um nome e especifique as configurações
Nesta etapa, forneça um nome para a atividade e especifique as configurações para o email de saída. Cada elemento da interface do usuário desta etapa é descrito abaixo.
Dica
Campos com ícone de variável suporte usando variáveis globais, variáveis do projeto e variáveis Jitterbit. Comece digitando um colchete aberto [
no campo ou clicando no ícone da variável para exibir uma lista das variáveis existentes para escolher.
-
Nome: Insira um nome para identificar a atividade. O nome deve ser exclusivo para cada Email de Enviar Email e não deve conter barras
/
ou dois pontos:
. -
Para: Insira os endereços de email separados por vírgula dos destinatários que receberão o email.
-
CC: Insira os endereços de email separados por vírgula dos destinatários para receber uma cópia do email.
-
BCC: Insira os endereços de email separados por vírgula dos destinatários para receber uma cópia oculta do email.
Nota
Se o mesmo endereço de email estiver presente em dois ou mais campos Para, CC ou BCC, ocorrerá um erro.
-
De: Insira o endereço de email do qual os destinatários receberão o email.
-
Assunto do e-mail: Insira o assunto do email.
-
Tipo de mensagem: Selecione o tipo de mensagem do Corpo do e-mail, Texto ou HTML.
-
Corpo do e-mail: Insira o corpo do email no formato do Tipo de mensagem selecionado.
-
Sensibilidade: Ao usar serviços de e-mail da Microsoft (como Microsoft 365 ou Outlook), você pode, opcionalmente, selecionar o nível de sensibilidade do email, um dos seguintes: Confidencial da empresa, Normal, Pessoal ou Privado:
-
Confidencial da empresa: Quando esta opção é selecionada, o texto Trate isto como confidencial é exibido na barra de informações do e-mail.
-
Normal: Quando esta opção é selecionada, nenhum texto é exibido na barra de informações do e-mail.
-
Pessoal: Quando esta opção é selecionada, o texto Por favor, trate isto como Pessoal é exibido na barra de informações do e-mail.
-
Privado: Quando esta opção é selecionada, o texto Por favor, trate isto como privado é exibido na barra de informações do e-mail.
-
-
Importância: Ao usar serviços de e-mail da Microsoft (como Microsoft 365 ou Outlook), você pode, opcionalmente, selecionar a opção importância do email, seja Alto ou Baixo. Quando qualquer uma dessas opções é selecionada, um indicador é exibido no email na caixa de entrada do destinatário.
-
Ativar S/MIME: Quando selecionado, os emails são assinados usando um certificado S/MIME autoassinado e estas opções adicionais ficam disponíveis:
Nota
Essas configurações são funcionais apenas em agentes privados. Se você estiver usando um agente de nuvem, habilitar esta opção não produzirá o resultado desejado e você não poderá assinar ou assinar e criptografar seus emails.
Nota
Você precisa de um certificado S/MIME próprio para assinar ou assinar e criptografar emails. Se ainda não tiver um, siga os passos descritos em Pré-requisitos para criptografia S/MIME.
-
Criptografar email com S/MIME: Selecione para criptografar seu email além de assiná-lo.
-
Alias do certificado: Insira o alias que você usou para identificar o certificado quando o importou para o truststore padrão (consulte Etapa 8 dos Pré-requisitos para criptografia S/MIME).
-
Senha da chave privada: Digite a senha para desbloquear sua chave privada (consulte Etapa 7 dos Pré-requisitos para criptografia S/MIME).
-
-
Salvar e Sair: Se habilitado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.
-
Próximo: Clique para armazenar temporariamente a configuração desta etapa e prosseguir para a próxima. A configuração não será salva até que você clique no botão Concluído na última etapa.
-
Descartar Alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicitará que você confirme se deseja descartar as alterações.
Nota
A entrada é necessária em pelo menos um dos campos de destinatário Para, CC ou BCC, a menos que uma transformação forneça a solicitação.
Etapa 2: Revise os esquemas de dados
Todos os esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos. Cada elemento da interface do usuário desta etapa é descrito abaixo.
-
Esquemas de dados: Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de transformação.
Nota
Os dados fornecidos em uma transformação têm precedência sobre a configuração da atividade.
Os esquemas de dados de solicitação e resposta consistem nestes nós e campos:
Nó/Campo do Esquema de Solicitação Descrição sendMailRequest
Nó da solicitação de email recipients
Nó de destinatários to
Nó de destinatários do campo "para" do e- email item
Nó do item de destinatários do email "para" do e-mail #text
Valor de sequência de caracteres de um único endereço de email de destinatário "para" cc
Nó de destinatários do campo "cc" do email item
Nó do item de destinatários do campo "cc" do email #text
Valor de sequência de caracteres de um único endereço de email de destinatário "cc" bcc
Nó do item de destinatários do email campo "bcc" item
Nó do item para que os destinatários recebam uma cópia oculta do email #text
Valor de sequência de caracteres de um único endereço de email de destinatário "bcc" from
String do campo "de" do email subject
String do campo "assunto" do email mailBody
String do campo "corpo" do email
Nota
Variáveis podem ser fornecidas neste campo.
messageType
String do tipo de mensagem, como text
ouHTML
attachments
Nó de anexos de email
Nota
Existem limites de tamanho para anexos. Consulte a documentação do seu servidor de email para obter informações sobre os limites de tamanho impostos.
item
Nó de item de anexos de email fileName
Cadeia de caracteres do nome do arquivo do anexo de email base64content
Sequência de caracteres do conteúdo do anexo codificado em base64
Dica
Você pode usar o Jitterbit
Base64Encode
função para codificar o conteúdo do anexo.sensitivity
O nível de sensibilidade do email, um dos company-confidential
,normal
,personal
, ouprivate
importance
A importância do email, seja high
oulow
Nó/Campo do Esquema de Resposta Descrição sendEmailResponse
Nó da resposta do email isSent
Booleano de se o email foi enviado ( true
) ou não (false
)errorDetails
Nó dos detalhes do erro errorCode
String do código de erro retornado pelo servidor de email errorMsg
String da mensagem de erro retornada pelo servidor de email -
Atualizar: Clique no ícone de atualização ou a palavra Atualizar para regenerar esquemas do endpoint de Email. Esta ação também regenera um esquema em outros locais do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.
-
Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.
-
Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.
-
Descartar Alterações: Após fazer as alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicitará que você confirme se deseja descartar as alterações.
Próximos passos
Após configurar uma atividade Enviar e Email, conclua a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas da operação. Você também pode configurar as configurações da operação, que incluem a capacidade de encadear operações que estejam no mesmo fluxo de trabalho ou em workflows diferentes.
As ações de menu de uma atividade podem ser acessadas no painel do projeto e na quadro de design. Para obter detalhes, consulte menu de ações da atividade em Noções básicas do conector.
As atividades de Email Enviar Email podem ser usadas como um alvo com esses padrões de operação:
Para usar a atividade com funções de script, grave os dados em um local temporário e use esse local temporário na função de script.
Quando estiver pronto, implantar e executar a operação e validar o comportamento verificando os logs de operação.