Conexão ao e-mail

Use o conector de dados de e-mail do Analytics para importar mensagens de e-mail de uma única conta usando os protocolos padrão de e-mail IMAP ou POP. Quando você se conecta a um servidor de e-mail, cada nome de tabela representa uma pasta de caixa postal no servidor e cada registro representa uma mensagem de e-mail.

Nota

Não é possível usar esse conector de forma independente do Analytics. Você pode configurar um DSN para o driver usando o Administrador de Fonte de Dados ODBC do Windows. No entanto, é necessário testar a conexão ao DSN dentro do Analytics e não da caixa de diálogo de configuração do DSN do Windows do conector.

Esse conector somente recupera mensagens de e-mail de uma única conta armazenada em servidores de e-mail. Ele não se conecta a recursos como bate-papo ou tarefas, incluídos em alguns clientes de e-mail.

Antes de começar

Para conectar-se ao e-mail, você deve obter:

  • o nome de domínio ou o endereço IP do servidor de e-mail
  • a porta de conexão correta
  • a conta do usuário da conexão, incluindo o nome do usuário e a senha

Nota

O servidor de e-mail deve usar o protocolo IMAP ou POP.

Para obter ajuda na coleta dos pré-requisitos de conexão, entre em contato com o administrador de conectores da sua organização. Se o administrador não conseguir ajudá-lo, você ou o administrador deve entrar em contato com o suporte do conector.

Criar uma conexão de e-mail

  1. No menu principal do Analytics, selecione Importar > Banco de dados e aplicativo.
  2. Na guia Novas conexões, na seção Conectores do ACL, selecione seu conector E-mail.

    Dica

    Você pode filtrar a lista de conectores disponíveis inserindo uma cadeia de pesquisa na caixa Filtrar conexões. Os conectores são listados em ordem alfabética.

  3. No painel Configurações de Conexão de Dados, insira as configurações da conexão e clique em Salvar e conectar na parte inferior do painel.

    Você pode aceitar o Nome de conexão padrão ou inserir um novo nome.

A conexão do conector é salva na guia Conexões existentes. No futuro, você poderá reconectar esse conector usando a conexão salva.

Após estabelecer a conexão, a janela Acesso a Dados abre na Área de preparação e você pode começar a importar dados. Para obter ajuda na importação de dados do conector, consulte Importar dados usando a janela de Acesso a Dados.

Configurações de conexão

Configurações básicas

Configuração Descrição Exemplo
Protocolo

O tipo do servidor de e-mail ao qual se conectar:

  • IMAP
  • POP
IMAP
Usuário O usuário da conta de e-mail usada para autenticação. Juntamente com Senha, este campo é usado para autenticação nos servidores de e-mail. recipient@example.com
Senha

A senha da conta de e-mail usada para autenticação. Juntamente com Usuário, este campo é usado para autenticação nos servidores de e-mail.

 
Servidor

O nome ou o endereço do servidor de e-mail.

Essa propriedade especifica o endereço IP ou o nome de domínio do servidor de e-mail. Ela deve ser definida antes de tentar uma conexão e não poderá ser alterada enquanto a conexão estiver ativa.

imap.gmail.com
Porta

A porta do servidor de e-mail. O valor padrão é:

  • IMAP 143 (não SSL) ou 993 (SSL)
  • POP 110 (não SSL) ou 995 (SSL)

É necessário um número de porta válido (um valor entre 1 e 65535) para que a conexão possa ser feita. A propriedade deve ser definida antes de tentar uma conexão e não poderá ser alterada após estabelecer a conexão.

993

Configurações avançadas

Configuração Descrição Exemplo
Converter datahora para GMT

Converte os campos datahora para o fuso horário GMT durante a importação. Se falso, o valor de datahora é convertido para o fuso horário do sistema operacional da máquina que executa o Analytics.

verdadeiro
Serviços de e-mail

O nome do serviço de e-mail sendo usado.

Otimiza a conexão IMAP para o serviço com o qual você está trabalhando. Você pode usar um dos seguintes nomes:

  • AOL
  • Gmail
  • Outlook
  • Yahoo
  • Outros

Nota

O conector de e-mail não permite recuperar o conteúdo do campo Assunto das caixas postais de tarefas ou calendário de uma conta do Outlook 365. Se você estiver se conectando a uma conta do Outlook 365, considere o uso do conector do Exchange. Para obter mais informações, consulte Conexão ao Exchange

Outros
Incluir mensagem

Especifica se o conteúdo do corpo e os dados do anexo da mensagem devem ser incluídos ou não.

Cuidado

Esta configuração afeta o desempenho. Se você estiver trabalhando com muitos registros, a consulta poderá expirar.

falso
É HTML

Determina se o corpo da mensagem é HTML ou texto simples.

verdadeiro
Keep alive

Determina se a conexão deve ser mantida ativa entre instâncias.

verdadeiro
Listar caixas de correio

Especifica se todas as caixas de correio devem ser listadas ou apenas as caixas de correio IMAP assinadas. Somente para IMAP:

  • Tudo
  • Assinado
Tudo
Limite do tamanho da chave

O comprimento máximo de uma coluna de chave primária. A definição do tamanho como 0 fará com que o comprimento da chave volte ao comprimento original.

Essa propriedade faz com que o conector ignore o comprimento relatado para todas as colunas de chave primária.

255
Mapear para Long Varchar

Controla se uma coluna é retornada como SQL_LONGVARCHAR.

Use essa configuração para mapear todas as colunas maiores que o tamanho especificado para que sejam relatadas como SQL_LONGVARCHAR em vez de SQL_VARCHAR.

-1
Mapear para WVarchar

Controla se os tipos de cadeia são mapeados para SQL_WVARCHAR em vez de SQL_VARCHAR. É definido por padrão.

As colunas de cadeia devem ser mapeadas para SQL_WVARCHAR para acomodar diversos conjuntos de caracteres internacionais. Portanto, MapToWVarchar é definido como verdadeiro por padrão. Você pode defini-lo como falso para usar SQL_VARCHAR.

verdadeiro
Máximo de itens Número máximo de itens a retornar. 100
Pseudocolunas

Indica se pseudocolunas devem ou não ser incluídas como colunas na tabela.

Essa configuração é particularmente útil no Entity Framework, que não permite a definição de um valor para uma pseudocoluna a menos que seja uma coluna de tabela.

O valor dessa configuração de conexão deve ter o formato "Tabela1=Coluna1, Tabela1=Coluna2, Tabela2=Coluna3". Você pode usar o caractere "*" para incluir todas as tabelas e todas as colunas.

MinhaTabela=*
Certificado de servidor SSL

O certificado a ser aceito do servidor na conexão usando TLS/SSL. Você pode especificar:

  • certificado PEM completo
  • caminho para um arquivo local que contém o certificado
  • a chave pública
  • a impressão digital do MD5 (os valores hexa também podem ser separados por espaço ou dois pontos)
  • a impressão digital do SHA1 (os valores hexa também podem ser separados por espaço ou dois pontos)

Para uma conexão TLS/SSL, esta propriedade pode ser usada para especificar o certificado TLS/SSL a ser aceito do servidor. Qualquer outro certificado que não tenha uma relação de confiança com a máquina será rejeitado.

C:\cert.cer
Oferecer suporte a SQL avançado

Aprimora a funcionalidade do SQL além do que pode ser oferecido diretamente pela API por meio da ativação de processamento na memória do lado do cliente:

  • verdadeiro o conector transfere a maior parte possível do processamento da instrução SELECT ao IMAP e processa o resto da consulta na memória. Dessa forma, o driver pode executar predicados, associações e agregações fora do padrão
  • falso o conector limita a execução do SQL ao que é permitido pela API do IMAP

Execução de predicados

O conector determina quais das cláusulas são permitidas pela origem de dados e as envia à origem para obter o menor superconjunto de linhas que atenda à consulta. Em seguida, filtra o resto das linhas localmente. O filtro opera com streaming, o que permite que o driver filtre eficazmente até mesmo conjuntos de dados muito grandes.

Execução de associações

O conector usa várias técnicas de associação na memória. O driver equilibra a utilização de memória com a necessidade de ler a mesma tabela mais de uma vez.

Execução de agregados

O conector recupera todas as linhas necessárias para processar a agregação na memória.

 
Modo UID Se verdadeiro, são usadas IDs de mensagem permanentes em vez das IDs temporárias padrão. falso
Identificadores em maiúsculas Relata todos os identificadores em maiúsculas, incluindo nomes de tabelas e colunas. falso
Esquema de autorização de proxy

O tipo de autenticação usado para autenticar no proxy ProxyServer.

Esse valor especifica o tipo de autenticação usado para autenticar no proxy HTTP especificado por ProxyServer e ProxyPort.

Nota

Por padrão, o conector usa as configurações do proxy de sistema, sem necessidade de configurações adicionais. Se você quiser conectar-se a outro proxy, será necessário definir ProxyAutoDetect como falso, além de ProxyServer e ProxyPort. Para autenticar, defina ProxyAuthScheme e, se necessário, ProxyUser e ProxyPassword.

O tipo de autenticação pode ser um dos seguintes:

  • BASIC O driver executa a autenticação HTTP BASIC
  • DIGEST O driver executa a autenticação HTTP DIGEST.
  • NEGOTIATE O driver recupera um token NTLM ou Kerberos de acordo com o protocolo aplicável para autenticação
  • PROPRIETARY O driver não gera um token NTLM ou Kerberos. Você deve fornecer esse token no cabeçalho de autorização da solicitação HTTP
BASIC
Detecção automática de proxy Indica se as configurações do proxy de sistema devem ser usadas ou não. Defina ProxyAutoDetect como FALSO para usar configurações de proxy personalizadas. Essa configuração tem precedência sobre as outras configurações de proxy. verdadeiro
Usuário do proxy

Um nome de usuário usado para autenticar no proxy ProxyServer.

As opções ProxyUser e ProxyPassword são usadas para conexão e autenticação no proxy HTTP especificado em ProxyServer.

Você pode selecionar um dos seguintes tipos de autenticação em ProxyAuthScheme. Se você estiver usando autenticação HTTP, defina essa propriedade como o nome de usuário de um usuário reconhecido pelo proxy HTTP. Se você estiver usando autenticação Windows ou Kerberos, defina essa propriedade como um nome de usuário em um dos seguintes formatos:

  • usuário@domínio
  • domínio\usuário
john_doe@example.com
Senha do proxy

Uma senha usada para autenticar no proxy ProxyServer.

Essa propriedade é usada para autenticar em um servidor proxy HTTP compatível com autenticação NTLM (Windows), Kerberos ou HTTP. Para especificar o proxy HTTP, você pode definir ProxyServer e ProxyPort. Para especificar o tipo de autenticação, defina ProxyAuthScheme.

Se você estiver usando autenticação HTTP, defina adicionalmente ProxyUser e ProxyPassword para o proxy HTTP.

Se você estiver usando autenticação NTLM, defina ProxyUser e ProxyPassword como a senha do Windows. As propriedades abaixo também podem ser necessárias para concluir a autenticação Kerberos

 
Servidor proxy

O nome do host ou o endereço IP de um proxy pelo qual o tráfego HTTP será roteado.

O nome do host ou o endereço IP de um proxy pelo qual o tráfego HTTP será roteado. O driver pode usar os tipos de autenticação HTTP, Windows (NTLM) ou Kerberos para autenticar em um proxy HTTP.

Por padrão, o driver usa o proxy de sistema. Se você precisar usar outro proxy, defina ProxyAutoDetect como falso.

206.174.193.115
Porta do proxy A porta TCP onde o proxy ProxyServer é executado. 80
Tipo de SSL do proxy

O tipo de SSL usado para conexão ao proxy ProxyServer:

  • AUTO Se o URL for um URL HTTPS, o conector usará a opção TUNNEL. Se o URL for um URL HTTP, o conector usará a opção NEVER (padrão)
  • ALWAYS A conexão terá sempre o SSL ativado
  • NEVER A conexão não tem o SSL ativado
  • TUNNEL A conexão é feita por meio de um proxy de túnel. O servidor do proxy abre uma conexão para o host remoto e o tráfego vai e volta pelo proxy
AUTO

Recuperação de corpo e anexos de mensagens

Por padrão, o corpo e os anexos da mensagem só são retornados quando você seleciona um registro de uma tabela. Se mais de um registro for retornado, esses campos ficarão em branco.

Se quiser recuperar o corpo e os anexos da mensagem de mais de um registro, você deverá definir a opção Incluir mensagem em Configurações avançadas. O retorno desses campos consome muitos recursos e, se usado para vários registros, afeta o desempenho. Se você precisar examinar o corpo ou os anexos da mensagem, tente usar outros campos para identificar as mensagens cujos detalhes você quer analisar. Em seguida, consulte esse subconjunto de mensagens individualmente para examinar o corpo e os anexos da mensagem.

Ajuda do Analytics 14.1