Conexão ao Exchange

Concept Information

Use o conector de dados do Exchange para importar dados do servidor de e-mail e calendário do Exchange da Microsoft. Você pode importar dados de uma única conta do Exchange.

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.

Antes de começar

Para conectar-se ao Exchange, você deve obter o seguinte:

o nome de domínio ou o endereço IP do servidor do Exchange (URL do Exchange Web Services)
a versão da plataforma Exchange à qual você está se conectando
a conta do usuário da conexão, incluindo o nome do usuário e a senha

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

Criar uma conexão do Exchange

No menu principal do Analytics, selecione Importar > Banco de dados e aplicativo.
Na guia novas conexões, na seção Conectores do ACL, selecione Exchange.
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.
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 Exchange é salva na guia Conexões existentes. No futuro, você poderá reconectar o Exchange 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 Exchange, consulte Trabalho com a Janela de Acesso a Dados.

Configurações de conexão

Configurações básicas

Configuração	Descrição	Exemplo
Usuário	O usuário da conta de Exchange usada para autenticação. Juntamente com Senha, este campo é usado para autenticação no servidor.	recipient@example.com
Senha	A senha da conta de Exchange usada para autenticação. Juntamente com Usuário, este campo é usado para autenticação no servidor.
Servidor	O endereço do servidor Exchange ao qual você está se conectando. Essa propriedade deve ser definida como o URL do Exchange Web Services. Para o Exchange Online, defina a propriedade como https://outlook.office365.com/EWS/Exchange.asmx.	https://outlook.office365.com/EWS/Exchange.asmx
Plataforma	A plataforma associada ao servidor do Exchange.	Exchange_Online

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
Esquema de autorização	O esquema usado para autenticação. Juntamente com Senha e Usuário, este campo é usado para autenticação no servidor. BASIC é a opção padrão. Use as seguintes opções para selecionar o esquema de autenticação: NTLM usa as suas credenciais do Windows para autenticação. BASIC usa a autenticação HTTP BASIC. Nota A Microsoft anunciou que vai desativar a autenticação Basic para o Exchange Web Services em outubro de 2020. Considere o uso de um esquema de autenticação alternativo. DIGEST usa a autenticação HTTP DIGEST. NEGOTIATE negocia um mecanismo de autenticação com o servidor. Defina AuthScheme como NEGOTIATE para usar autenticação Kerberos. KERBEROSDELEGATION usa delegação por meio do protocolo Kerberos. Defina o Usuário e a Senha da conta que você quer personificar.	BASIC
Tipo de personificação	O tipo de identificador a ser usado com personificação para enviar solicitações ao site do Exchange: PrincipalName representa o nome principal do usuário (UPN) da conta a ser usada para personificação. Essa propriedade deve ser o UPN do domínio onde existe a conta do usuário SID representa a forma de linguagem de definição do descritor de segurança (SDDL) do identificador de segurança (SID) da conta a ser usada para personificação PrimarySmtpAddress representa o endereço principal do Simple Mail Transfer Protocol (SMTP) da conta a ser usada para a personificação do Exchange. Se o endereço principal do SMTP for informado, será necessária uma pesquisa adicional do serviço de diretório Active Directory para obter o SID do usuário. Recomendamos que você use o SID ou UPN, se disponível SmtpAddress representa o endereço do Simple Mail Transfer Protocol (SMTP) da conta a ser usada para a personificação do Exchange. Se o endereço do SMTP for informado, será necessária uma pesquisa adicional do Active Directory para obter o SID do usuário. Recomendamos que você use o SID ou UPN, se disponível	PrincipalName
Usuário de personificação	O usuário a ser personificado para enviar solicitações ao site do Exchange.
Incluir conteúdo	Especifica se o conteúdo do corpo da mensagem deve ser incluído em todos os registros retornados. Cuidado Esta configuração afeta o desempenho. Se você estiver trabalhando com muitos registros, a consulta poderá expirar.	falso
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
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.
Identificadores em maiúsculas	Relata todos os identificadores em maiúsculas, incluindo nomes de tabelas e colunas.	falso
Esquema de autenticaçã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

Personificar contas de usuário

Os usuários com as permissões necessárias e com a função ApplicationImpersonation no Exchange podem ler os dados da caixa de correio de outros usuários de duas formas:

usando os campos Tipo de personificação e Usuário de personificação para configurar a conexão

usando o filtro ImpersonationUser em uma cláusula WHERE no modo SQL:

SELECT * FROM "Exchange"."DRAFTS" "DRAFTS" WHERE ImpersonationUser='usuário@exemplo.com'

Recuperar o corpo da mensagem

Por padrão, o corpo da mensagem só é retornado quando você seleciona um registro de uma tabela. Se mais de um registro for retornado, esse campo ficará em branco.

Se quiser recuperar o corpo da mensagem de mais de um registro com uma única consulta, você deverá definir a opção Incluir conteúdo em Configurações avançadas.

Nota

Usando este conector, você pode listar os nomes de arquivos dos anexos. No entanto, não é possível acessar o conteúdo dos arquivos dos anexos. Você pode acessar apenas o conteúdo do corpo da mensagem.

O retorno do corpo da mensagem consome muitos recursos e, se usado para vários registros, afeta o desempenho. Se você precisar examinar o corpo 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 de cada mensagem.

Limitação de filtragem

As combinações de condição de filtro e campo a seguir não são permitidas:

Campos	Operadores não compatíveis
Todos os campos de datahora	Em (=)
SenderName	É (=) Inicia com (LIKE "%valor") Contém (LIKE "%valor%")
SenderEmailAddress
FromName

Atualizações de conector de dados

Quando atualiza o Analytics ou o Agente do Robôs, você deve testar todos os scripts que importam dados usando um dos conectores de dados do Analytics (comando ACCESSDATA).

É possível que alterações feitas por fornecedores externos de fontes de dados ou drivers ODBC exigiram atualizações em um ou mais conectores de dados. Pode ser necessário atualizar as conexões de dados com script para que continuem a funcionar corretamente.

Execute novamente a importação A maneira mais fácil de atualizar uma conexão é executar manualmente uma importação usando a janela Acesso a Dados na versão atualizada do Analytics. Copie o comando ACCESSDATA do log e use-o para atualizar o script.
Nota
Antes de se conectar a uma fonte de dados e executar novamente a importação, limpe o cache do conector para remover o conjunto existente de nomes de tabelas.
Na guia Conexões existentes na janela Acesso a Dados, ao lado do nome do conector, selecione > Limpar cache.
Atualize as especificações de campos Também pode ser necessário atualizar as especificações de campos no corpo do script para compatibilizá-lo com as alterações do esquema da tabela na fonte de dados ou no driver ODBC. As possíveis alterações incluem nomes de campos, tipos de dados de campos e comprimentos de campos e registro.
Verifique os resultados de todas as filtragens Você também deve verificar os resultados de qualquer filtragem aplicada durante a importação de dados. Confirme se a filtragem de importação está incluindo e excluindo corretamente os registros.

Alterações do conector de dados do Exchange

As alterações específicas efetuadas no conector de dados do Exchange são listadas a seguir.

Versão do Analytics	Tabela do Exchange	Alteração
14.2	n/d	O nome do esquema do Exchange no conector foi alterado de Exchange para EWS. Exemplo da alteração necessária no comando ACCESSDATA: Antes SELECT * FROM "Exchange"."Calendar" "Calendar" Agora SELECT * FROM "EWS"."Calendar" "Calendar"
	Calendar	Campo renomeado: Recurrence_DayOfWeek renomeado para Recurrence_DaysOfWeek Campo adicionado: ModifiedOccurrences_Aggregate DeletedOccurrences_Aggregate Tipo de dados alterado: Recurrence_StartDate alterado de data para datahora Recurrence_EndDate alterado de data para datahora
	Inbox e SentItems	Campo renomeado: ToRecipients_Name renomeado para ToRecipients_Names ToRecipients_EmailAddress renomeado para ToRecipients_EmailAddresses ToRecipients_ItemId renomeado para ToRecipients_ItemIds CcRecipients_Name renomeado para CcRecipients_Names CcRecipients_EmailAddress renomeado para CcRecipients_EmailAddresses CcRecipients_ItemId renomeado para CcRecipients_ItemIds BccRecipients_Name renomeado para BccRecipients_Names BccRecipients_EmailAddress renomeado para BccRecipients_EmailAddresses BccRecipients_ItemId renomeado para BccRecipients_ItemIds
	Tarefas	Campo renomeado: Recurrence_NumberOfOccurences renomeado para Recurrence_NumberOfOccurrences