Atividade de Envio de E-mail E-mail¶
Introdução¶
Uma atividade de Enviar E-mail E-mail, usando sua Conexão E-mail, envia e-mail usando o SMTP (Simple Mail Transfer Protocol) para destinatários especificados e deve ser usado como destino em uma operação.
Importante
Para enviar e-mails por meio do Microsoft 365 (smtp.office365.com
), OAuth2 deve ser selecionado para Authentication Type e ROPC (Resource Owned Password Credentials) deve ser selecionado para Grant Type em uma Conexão de E-mail.
Criar uma Atividade de Envio E-mail E-mail¶
Uma instância de uma atividade de Enviar E-mail E-mail é criada a partir de uma Conexão E-mail usando seu tipo de atividade **Enviar E-mail.
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 Criando uma instância de atividade em Reutilização de componente.
Uma atividade existente de Enviar E-mail E-mail pode ser editada a partir destes locais:
- A quadro de design (consulte Menu de ações do componente em Quadro de Design).
- A aba Componentes do painel do projeto (consulte Menu de ações do componente na Guia Componentes do painel do projeto).
Configurar uma Atividade de Envio E-mail E-mail¶
Siga estas etapas para configurar uma atividade E-mail Enviar E-mail:
-
Etapa 1: Digite um nome e especifique as configurações
Forneça um nome para a atividade e especifique as configurações para o e-mail de saída. -
Etapa 2: Revise os Esquemas de Dados
Quaisquer 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 e-mail de saída. Cada elemento da interface do usuário desta etapa é descrito a seguir.
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: Digite um nome para identificar a atividade. O nome deve ser exclusivo para cada atividade E-mail Enviar E-mail e não deve conter barras
/
ou dois pontos:
. -
Para: Insira endereços e-mail separados por vírgulas dos destinatários para receber o e-mail.
-
CC: Insira os endereços e-mail separados por vírgula dos destinatários para receber uma cópia do e-mail.
-
BCC: Insira os endereços e-mail separados por vírgulas dos destinatários para receber uma cópia oculta do e-mail.
Nota
Se o mesmo endereço e-mail estiver presente em dois ou mais dos campos To, CC ou BCC, ocorrerá um erro.
-
De: Insira o endereço e-mail do qual os destinatários receberão o e-mail.
-
Mail Subject Line: Insira a linha de assunto do e-mail.
-
Message Type: Selecione o tipo de mensagem do Mail Body, Text ou HTML.
-
Mail Body: Insira o corpo do e-mail no formato do Message Type selecionado.
-
Save & Exit: Se ativado, clique para salvar a configuração desta etapa e fechar a configuração da atividade.
-
Avançar: Clique para armazenar temporariamente a configuração desta etapa e continuar na próxima etapa. 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 solicita que você confirme que deseja descartar as alterações.
Nota
A entrada é necessária em pelo menos um dos campos de destinatário To, CC ou BCC, a menos que uma transformação forneça a solicitação.
Etapa 2: Revisar os Esquemas de Dados¶
Quaisquer esquemas de solicitação ou resposta gerados a partir do endpoint são exibidos. Cada elemento da interface do usuário desta etapa é descrito a seguir.
-
Esquemas de Dados: Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante 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ó do pedido e-mail recipients
Nó de destinatários to
Nó de destinatários do campo "para" e-mail item
Nó do item de destinatários do campo "para" do e-mail #text
Valor de string de um único endereço e-mail do destinatário "para" cc
Nó de destinatários do campo "cc" do e-mail item
Nó do item de destinatários do campo "cc" do e-mail #text
Valor de string de um único endereço e-mail de destinatário "cc" bcc
Nó do item de destinatários do campo "bcc" do e-mail item
Nó do item para os destinatários receberem uma cópia oculta do e-mail #text
Valor de string de um único endereço e-mail de destinatário "coco" from
String do campo "de" e-mail subject
String do campo "assunto" e-mail mailBody
String do campo "corpo" e-mail
Nota
Variáveis podem ser fornecidas neste campo.
messageType
String do tipo de mensagem, como text
ouHTML
attachments
Nó de anexos e-mail
Nota
Aplicam-se limites de tamanho para anexos. Consulte a documentação do seu servidor e-mail para obter informações sobre os limites de tamanho aplicados.
item
Nó do item de anexos e-mail fileName
String do nome de arquivo do anexo e-mail base64content
String do conteúdo do anexo codificado em base64
Dica
Você pode usar o Jitterbit's
Base64Encode
para codificar o conteúdo do anexo.Nó/campo do esquema de resposta Descrição sendEmailResponse
Nó da resposta do e-mail isSent
Booleano de se o e-mail foi enviado ( true
) ou não (false
)errorDetails
Nó dos detalhes do erro errorCode
String do código de erro retornado pelo servidor e-mail errorMsg
String da mensagem de erro retornada pelo servidor e-mail -
Atualizar: Clique no ícone de atualização
ou a palavra Atualizar para regenerar esquemas do endpoint E-mail. Essa ação também regenera um esquema em outros locais do projeto em que 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 solicita que você confirme que deseja descartar as alterações.
Próximos Passos¶
Depois de configurar uma atividade E-mail Enviar E-mail, conclua a configuração da operação adicionando e configurando outras atividades, transformações ou scripts como etapas da operação. Você também pode definir as configurações de operação, que incluem a capacidade de encadear operações que estão no mesmo workflows ou em diferentes.
As ações de menu para uma atividade podem ser acessadas no painel do projeto e na quadro de design. Para obter detalhes, consulte Menu de ações de atividade em Noções básicas do conector.
As atividades de Enviar E-mail mail E-mail podem ser usadas como destino com esses padrões de operação:
Um caso de uso típico é usar uma atividade E-mail Send E-mail no Two-transformation Pattern. Neste exemplo, a primeira transformação (Send E-mail Request) cria uma estrutura de solicitação que é passada para a atividade E-mail Send E-mail. A segunda transformação (Send E-mail Response) recebe a estrutura de resposta, que é gravada em uma variável por uma atividade Variable Write (Write Send E-mail Response) e uma mensagem é então registrada pelo script Write to Operation Log:
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 da operação.