Conexão de Email no Jitterbit Studio

Introdução

Uma conexão de Email, criada usando o conector de Email, estabelece acesso a um servidor de email. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades de Email associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

Criar ou editar uma conexão de email

Uma nova conexão de Email é criada usando o conector de Email a partir de uma dessas localizações:

• A aba Pontos de extremidade e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
• A página Pontos de extremidade globais (veja Criar um ponto de extremidade global em Pontos de extremidade globais).

Uma conexão de Email existente pode ser editada a partir dessas localizações:

• A aba Pontos de extremidade e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
• A aba Componentes do painel do projeto (veja Menu de ações de componentes em Aba Componentes do painel do projeto).
• A página Pontos de extremidade globais (veja Editar um ponto de extremidade global em Pontos de extremidade globais).

Configurar uma conexão de email

Cada elemento da interface do usuário da tela de configuração da conexão de Email é descrito abaixo.

• Nome da Conexão: Insira um nome para identificar a conexão. O nome deve ser exclusivo para cada conexão de Email e não deve conter barras / ou dois pontos :. Este nome também é usado para identificar o endpoint de Email, que se refere tanto a uma conexão específica quanto às suas atividades.

• Tipo de Autenticação: Selecione o método de autenticação, um de Autenticação Básica ou OAuth2:

  • Autenticação Básica: Autenticação de servidor SMTP e IMAP com combinações de nome de usuário e senha.

  • OAuth2: Esta opção está confirmada para funcionar com Microsoft 365 (veja os pré-requisitos). Espera-se que outros servidores de email funcionem, mas não foram testados pela Jitterbit. Quando selecionado, esses campos adicionais para configurar a autenticação OAuth 2.0 ficam visíveis:

    • Host: Insira o host para autenticação OAuth.

      Dica

      Para autenticação OAuth do Microsoft Entra ID, insira https://login.microsoftonline.com como o host.

    • ID do Inquilino: Insira o ID do inquilino.

    • ID do Cliente: Insira o ID do cliente.

    • Segredo do Cliente: Insira o segredo do cliente.

    • Escopo: Insira o escopo.

    • Tipo de Concessão: Selecione Credenciais do Cliente (padrão) ou ROPC (Credenciais de Senha de Recurso Proprietário) como o tipo de concessão para autenticação OAuth. Se ROPC (Credenciais de Senha de Recurso Proprietário) for selecionado, você pode especificar uma Senha adicional.

      Importante

      Para enviar emails através do Microsoft 365 (smtp.office365.com), você deve selecionar ROPC (Credenciais de Senha de Recursos Proprietários) para Tipo de Concessão.

    • Senha: Insira uma senha válida. Visível apenas se o Tipo de Concessão estiver definido como ROPC (Credenciais de Senha de Recursos Proprietários).

• Atividade: Selecione o tipo de atividade a ser associado a esta conexão, um dos Ambos, Enviar Email ou Ler Email:

  • Ambos: A conexão será associada às atividades Enviar email e Ler email. Quando selecionado, todos os campos abaixo são exibidos.

  • Enviar Email: A conexão será associada apenas à atividade Enviar email. Quando selecionado, apenas os campos que começam com SMTP são exibidos.

  • Ler Email: A conexão será associada apenas à atividade Ler email. Quando selecionado, apenas os campos que começam com IMAP são exibidos.

• Host SMTP: Insira o nome do host do servidor de email SMTP. Este campo é exibido apenas se a Atividade selecionada for Ambos ou Enviar Email.

• Porta SMTP: Insira o número da porta do servidor de email SMTP com o qual se conectar. A porta padrão é 25. Um valor neste campo é aplicável apenas se o campo Segurança SMTP abaixo estiver definido como Nenhuma ou TLS. Se o campo Segurança SMTP estiver definido como SSL, então a porta 465 é sempre utilizada, independentemente do valor inserido no campo Porta SMTP. Este campo é exibido apenas se o tipo de Atividade selecionado acima for Ambos ou Enviar Email.

• Segurança SMTP: Quando a Atividade estiver definida como Ambos ou Enviar Email, use o menu para selecionar uma dessas opções:

  • Nenhuma: O servidor de email não requer autenticação.

  • SSL: O servidor de email utiliza criptografia SSL para autenticação.

  • TLS: O servidor de email utiliza criptografia TLS para autenticação.

• Nome de Usuário SMTP: Insira o nome de usuário (se requerido pelo servidor de email SMTP).

• Senha SMTP: Insira a senha (se exigida pelo servidor de email SMTP). Visível apenas quando o Tipo de Autenticação está definido como Autenticação Básica.

  Nota

  Ao conectar-se ao Gmail, insira uma senha de aplicativo em vez da senha da conta.

• Host IMAP: Insira o nome do host do servidor de email IMAP com o qual se conectar. Este campo é exibido apenas quando a Atividade está definida como Ambos ou Ler Email.

• Porta IMAP: Insira o número da porta do servidor de email IMAP com o qual se conectar. A porta padrão é 993. Este campo é exibido apenas quando a Atividade está definida como Ambos ou Ler Email.

• Segurança IMAP: Quando a Atividade está definida como Ambos ou Ler Email, use o menu para selecionar uma dessas opções:

  • Nenhuma: O servidor de email não requer autenticação.

  • SSL: O servidor de email usa criptografia SSL para autenticação.

  • TLS: O servidor de email usa criptografia TLS para autenticação.

• Nome de Usuário IMAP: Insira o nome de usuário (se exigido pelo servidor de email IMAP).

• Senha IMAP: Insira a senha (se exigida pelo servidor de email IMAP). Visível apenas quando o Tipo de Autenticação está definido como Autenticação Básica.

  Nota

  Ao conectar-se ao Gmail, insira uma senha de aplicativo em vez da senha da conta.

• Usar Configurações de Proxy (Apenas Agente Privado): Ao usar um agente privado, esta configuração pode ser selecionada para usar as configurações de proxy do agente privado. Esta opção é funcional apenas ao usar OAuth 2.0 como o Tipo de Autenticação.

• Testar: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelo(s) agente(s) no grupo de agentes associado ao ambiente atual. Este conector suporta a suspensão do download da versão mais recente do conector usando a política organizacional Desativar Atualização Automática do Conector. Os campos de nome de usuário e senha para um determinado protocolo são usados para verificação apenas se ambos estiverem presentes e o campo de segurança estiver definido como SSL ou TLS.

• Salvar Alterações: Clique para salvar e fechar a configuração da conexão.

• Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem pede para você confirmar que deseja descartar as alterações.

• Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem pede para você confirmar que deseja excluir a conexão.

Próximas etapas

Depois que uma conexão de Email foi criada, você coloca um tipo de atividade na tela de design para criar instâncias de atividade a serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).

As ações do menu para uma conexão e seus tipos de atividade estão acessíveis a partir do painel do projeto e da paleta de componentes de design. Para detalhes, veja Menus de ações em Fundamentos do Conector.

Estes tipos de atividade estão disponíveis:

• Enviar Email: Envia email usando o Protocolo Simples de Transferência de Correio (SMTP) para destinatários especificados e é destinado a ser usado como um alvo em uma operação.

• Ler Email: Recupera emails não lidos usando o Protocolo de Acesso a Mensagens da Internet (IMAP) e é destinado a ser usado como uma fonte para fornecer dados a uma operação.