Conexión a Exchange

Utilice el conector de datos de Exchange para importar datos del servidor de calendario y de correo electrónico Exchange de Microsoft. Puede importar datos desde una única cuenta de Exchange.

Nota

No puede utilizar este conector de manera independiente de Analytics. Puede configurar un DSN para el controlador utilizando el Administrador de origen de datos ODBC de Windows; sin embargo, debe probar la conexión DSN desde dentro de Analytics y no desde el cuadro de configuración del DSN de Windows del conector.

Antes de comenzar

Para conectarse a Exchange, debe contar con lo siguiente:

  • el nombre de dominio o la dirección IP del servidor de Exchange (URL de Servicios Web Exchange)
  • la versión de la plataforma de Exchange a la cual se está conectando
  • la cuenta de usuario que se está conectando, incluido el nombre de usuario y la contraseña

Si desea obtener ayuda para reunir los requisitos previos para la conexión, comuníquese con el administrador de Exchange de su organización. Si el administrador no puede ayudarlo, usted o el administrador deben comunicarse con el Soporte de Exchange.

Crear una conexión de Exchange

  1. Desde el menú principal de Analytics, seleccione Importar > Base de datos y aplicación.
  2. Desde la ficha Nuevas conexiones, en la sección Conectores de ACL, seleccione Exchange.

    Consejo

    Puede filtrar la lista de conectores disponibles introduciendo una cadena de búsqueda en el cuadro Filtrar conexiones. Los conectores se indican en orden alfabético.

  3. En el panel Configuración de conexiones de datos, ingrese la configuración de la conexión y, en la parte inferior del panel, haga clic en Guardar y conectar.

    Puede aceptar el Nombre de la conexión predeterminado o introducir uno nuevo.

La conexión de Exchange se guarda en la ficha Conexiones existentes. En el futuro, puede volver a conectarse a Exchange desde la conexión guardada.

Una vez que se establezca la conexión, se abre la ventana Data Access en el Área de almacenamiento temporal y puede comenzar a importar datos. Si desea obtener ayuda para importar datos desde Exchange, consulte Trabajo con la ventana Data Access.

Ajustes de conexión

Ajustes básicos

Ajuste Descripción Ejemplo
Usuario El usuario de la cuenta de Exchange que se utilizó para autenticar. Junto con la Contraseña, este campo se utiliza para autenticar en el servidor. destinatario@ejemplo.com
Contraseña

La contraseña de la cuenta de Exchange que se utilizó para autenticar. Junto con el Usuario, este campo se utiliza para autenticar en el servidor.

 
Servidor

La dirección del servidor de Exchange al cual se está conectando.

Se debe ajustar en la URL de Servicios Web Exchange. Para Exchange Online, debe ajustar la dirección en https://outlook.office365.com/EWS/Exchange.asmx.

https://outlook.office365.com/EWS/Exchange.asmx
Plataforma

La Plataforma asociada con el servidor de Exchange.

Exchange_Online

Ajustes avanzados

Ajuste Descripción Ejemplo
Convertir la Fechahora en GMT

Convierte los campos de fechahora en la zona horaria GMT durante la importación. Si es falso, el valor de fechahora se convierte a la zona horaria del sistema operativo del equipo que está ejecutando Analytics.

verdadero
AuthScheme

El esquema que se utilizó para la autenticación.

Junto con la Contraseña y el Usuario, este campo se utiliza para autenticar en el servidor. La opción predeterminada es BASIC. Utilice las siguientes opciones para seleccionar el esquema de autenticación:

  • NTLM utiliza sus credenciales de Windows para la autenticación.
  • BASIC utiliza autenticación HTTP básica.

    Nota

    Microsoft ha anunciado que dejará de usar la autenticación básica para los Servicios Web Exchange en octubre de 2020. Considere utilizar un sistema de autenticación alternativo.

  • DIGEST utiliza la autenticación HTTP implícita.
  • NEGOTIATE negocia un mecanismo de autenticación con el servidor. Ajuste AuthScheme en NEGOTIATE para utilizar la autenticación por Kerberos.
  • KERBEROSDELEGATION utiliza la delegación a través del protocolo Kerberos. Ajuste el Usuario y la Contraseña de la cuenta que desea utilizar.
BASIC
Tipo de usurpación de identidad

El tipo de identificador que se utilizará para hacer uso de una identidad al enviar solicitudes al sitio de Exchange:

  • PrincipalName representa el nombre principal del usuario (UPN) de la cuenta que desea utilizar como identidad. Debe ser un UPN para el dominio en el cual se encuentra la cuenta del usuario
  • SID representa el lenguaje de definición de descriptores de seguridad (SDDL) del identificador de seguridad (SID) de la cuenta que se utilizará como identidad
  • PrimarySmtpAddress representa la dirección primaria del Protocolo simple de transferencia de correo (SMTP) de la cuenta que desea utilizar como identidad de Exchange. Si se proporciona la dirección SMTP primaria, necesitará una búsqueda de servicio del directorio de Active Directory adicional para obtener el SID del usuario. Se recomienda utilizar el SID o el UPN si están disponibles
  • SmtpAddress representa la dirección de Protocolo simple de transferencia de correo (SMTP) de la cuenta que se debe usar para suplantar la identidad de Exchange. Si se proporciona la dirección SMTP, necesitará una búsqueda adicional en Active Directory para obtener el SID del usuario. Es conveniente que utilice el SID o el UPN si están disponibles
PrincipalName
Usuario de usurpación de identidad El usuario que se utilizará como identidad al enviar solicitudes al sitio de Exchange.  
Incluir contenido

Si incluir el contenido del cuerpo del mensaje para todos los registros que se devuelven.

¡Precaución!

Este ajuste afecta el desempeño y puede hacer que la consulta supere el tiempo de espera si está trabajando con muchos registros.

falso
Tamaño límite de la clave

La longitud máxima de la columna de clave primaria. Si ajusta el tamaño en 0, la longitud de la clave regresará a la longitud original.

Esta propiedad hace que el conector ignore la longitud reportada de todas las columnas clave primarias.

255
Asignar a Long Varchar

Controla si una columna se devuelve o no como SQL_LONGVARCHAR.

Utilice este ajuste para asignar cualquier columna con un tamaño mayor al especificado para que se reporte como SQL_LONGVARCHAR en lugar de SQL_VARCHAR.

-1
Asignar a WVarchar

Controla si los tipos de cadenas se asignan o no a SQL_WVARCHAR en lugar de SQL_VARCHAR. Está ajustado por valor predeterminado.

Las columnas de las cadenas se deben asignar a SQL_WVARCHAR para contener los diferentes conjuntos de caracteres internacionales; por lo tanto, MapToWVarchar está ajustado en verdadero como valor predeterminado. Puede ajustarlo en falso para utilizar SQL_VARCHAR.

verdadero
Pseudo columnas

Indica si se deben o no incluir pseudo columnas como columnas en la tabla.

Este ajuste resulta especialmente útil en Entity Framework, que no permite ajustar un valor para pseudo columnas a menos que se trate de una columna de la tabla.

El valor de este ajuste de la conexión tiene el formato "Table1=Column1, Table1=Column2, Table2=Column3". Puede usar el carácter "*" para incluir todas las tablas y todas las columnas.

MyTable=*
Cert Servidor SSL

El certificado que se debe aceptar desde el servidor al conectarse con TLS/SSL. Puede especificar cualquiera de las siguientes opciones:

  • certificado PEM completo
  • ruta a un archivo local que contiene el certificado
  • la clave pública
  • la huella digital MD5 (los valores hex también pueden estar separados por espacios o punto y coma)
  • la huella digital SHA1 (los valores hex también pueden estar separados por espacios o punto y coma)

Si está usando una conexión TLS/SSL, esta propiedad se puede usar para especificar que se acepte el certificado TLS/SSL desde el servidor. Cualquier otro certificado en el cual la máquina no confié será rechazado.

C:\cert.cer
Soporte SQL mejorado

Mejora la funcionalidad SQL más allá de lo que la API puede soportar directamente ya que activa el procesamiento del lado del cliente en la memoria:

  • true el conector descarga la mayor cantidad posible del procesamiento de la instrucción SELECT a IMAP y después procesa el resto de la consulta en la memoria. De esta manera, el controlador puede ejecutar predicados, uniones y acumulaciones no admitidos
  • false el conector limita la ejecución SQL a lo admitido por la API IMAP

Ejecución de predicados

El conector determina cuál de las cláusulas es admitida por el origen de los datos y después los envía al origen para obtener el superconjunto más pequeño de filas que satisfaga la consulta. A continuación, filtra el resto de las filas localmente. La operación de filtrado se transmite por secuencias, lo cual permite que el controlador filtre de manera eficaz conjuntos de datos incluso muy grandes.

Ejecución de uniones

El conector utiliza varias técnicas para unir en la memoria. El controlador compensa la utilización de la memoria con la necesidad de leer la misma tabla más de una vez.

Ejecución de Acumulaciones

El conector recupera todas las filas necesarias para procesar la acumulación en la memoria.

 
Identificadores de mayúsculas Reportar todos los identificadores en mayúscula, incluidos los nombres de las columnas y las tablas. falso
Esquema de aut. del proxy

El tipo de autenticación que se debe usar para autenticar el proxy ProxyServer.

Este valor especifica el tipo de autenticación que se debe usar para autenticar el proxy HTTP especificado por ProxyServer y ProxyPort.

Nota

El conector utilizará los ajustes de proxy del sistema por valor predeterminado, sin que sea necesaria más configuración; si desea conectarse a otro proxy, tendrá que ajustar ProxyAutoDetect en false, además de ProxyServer y ProxyPort. Para autenticar, configure ProxyAuthScheme y ajuste ProxyUser y ProxyPassword, si es necesario.

El tipo de autenticación puede ser uno de los siguientes:

  • BASIC El controlador realiza la autenticación HTTP BASIC
  • DIGEST El controlador realiza la autenticación HTTP implícita.
  • NEGOTIATE El controlador recupera un token de Kerberos o NTLM en el protocolo aplicable para la autenticación
  • PROPRIETARY El controlador no genera un token de Kerberos o NTLM. Debe proporcionar este token en el encabezado de autorización de la solicitud de HTTP
BASIC
Autodetección del proxy Indica si se deben usar los ajustes proxy del sistema o no. Ajuste ProxyAutoDetect en FALSE para usar ajustes proxy personalizados. Esto sustituye otros ajustes de proxy. verdadero
Usuario del proxy

Un nombre de usuario que se debe utilizar para autenticar el proxy ProxyServer.

Las opciones ProxyUser y ProxyPassword se utilizan para conectarse y autenticar con el proxy HTTP que se especificó en ProxyServer.

Puede seleccionar uno de los tipos de autenticación disponibles en ProxyAuthScheme. Si está utilizando la autenticación HTTP, ajuste este valor con el nombre de un usuario reconocido por el proxy HTTP. Si usted está utilizando autenticación de Windows o Kerberos, ajuste esta propiedad con un nombre de usuario que tenga uno de los siguientes formatos:

  • usuario@dominio
  • dominio\usuario
juan_perez@ejemplo.com
Contraseña del proxy

Una contraseña que se debe utilizar para autenticar el proxy ProxyServer.

Esta propiedad se utiliza para autenticar a un servidor de proxy HTTP que admita autenticación NTLM (Windows), Kerberos o HTTP authentication. Para especificar el proxy HTTP, puede ajustar ProxyServer y ProxyPort. Para especificar el tipo de autenticación, ajuste ProxyAuthScheme.

Si está utilizando autenticación HTTP, ajuste también ProxyUser y ProxyPassword al proxy HTTP.

Si está utilizando la autenticación NTLM. ajuste ProxyUser y ProxyPassword a su contraseña de Windows. Es posible que también necesite estos ajustes para completar la autenticación por Kerberos

 
Servidor del proxy

El nombre de host o la dirección IP de un proxy para enviar el tráfico HTTP.

El nombre de host o la dirección IP de un proxy para enviar el tráfico HTTP. El controlador puede utilizar la autenticación por Kerberos, Windows (NTLM) o HTTP para autenticar en un proxy HTTP.

Por valor predeterminado, el controlador utiliza el proxy del sistema. Si necesita utilizar otro proxy, ajuste ProxyAutoDetect en false.

206.174.193.115
Puerto del proxy El puerto TCP en el cual se está ejecutando el proxy ProxyServer. 80
Tipo de SSL del proxy

El tipo de SSL que se debe utilizar al conectarse al proxy ProxyServer:

  • AUTO Si la URL es una URL HTTPS, el conector utilizará la opción TUNNEL. Si la URL es una URL HTTP, el conector utilizará la opción NEVER (valor predeterminado)
  • ALWAYS la conexión siempre está habilitada para SSL
  • NEVER la conexión no está habilitada para SSL
  • TUNNEL la conexión es a través de un proxy de túnel: el servidor proxy abre una conexión al host remoto y el tráfico fluye a través del proxy hacia un lado y hacia el otro
AUTO

Suplantación de cuentas de usuario

Los usuarios con los permisos necesarios y el rol de ApplicationImpersonation en Exchange pueden leer los datos del buzón de correo de otros usuarios de dos maneras:

  • utilizando el Tipo de usurpación de identidad y Usuario de usurpación de identidad para configurar la conexión
  • utilizando el filtro ImpersonationUser en una cláusula WHERE en el modo SQL:
    SELECT * FROM "Exchange"."DRAFTS" "DRAFTS" WHERE ImpersonationUser='usuario@ejemplo.com'

Recuperación del cuerpo del mensaje

Por valor predeterminado, el cuerpo del mensaje se devuelve únicamente cuando usted selecciona un registro de una tabla. Si se devuelve más de un registro, este campo se deja en blanco.

Si desea recuperar el cuerpo del mensaje de más de un registro, debe ajustar la opción Incluir contenido en Ajustes avanzados.

Nota

Con este conector, puede hacer una lista de los nombres de archivo de los adjuntos; sin embargo, no puede acceder al contenido de los archivos adjuntos. Solo puede acceder al contenido del cuerpo del mensaje.

La devolución del cuerpo del mensaje requiere un uso intensivo de recursos y si lo solicita para varios registros puede afectar el rendimiento. Si necesita examinar el cuerpo del mensaje, intente utilizar otros campos para identificar los mensajes que desea analizar de forma detallada. Después, haga una consulta de este subconjunto de mensajes de manera individual para examinar el cuerpo del mensaje.

Limitaciones de los filtros

No se admiten las siguientes combinaciones de campo y condición de filtro:

Campos Operadores no soportados
Todos los campos de fechahora
  • El (=)
SenderName
  • Es (=)
  • Comienza con (LIKE "%valor")
  • Contiene (LIKE "%valor%")
SenderEmailAddress
FromName

Actualizaciones del conector de datos

Cuando actualiza Analytics, el Agente de Robots o el Servidor de AX, debe comprobar los scripts que importan datos con uno de los conectores de datos de Analytics (comando ACCESSDATA).

Es posible que los cambios realizados por los proveedores de controladores ODBC o los orígenes de datos de terceros requieran la actualización de uno o más conectores de datos. Tal vez sea necesario actualizar las conexiones de datos en los scripts para continuar trabajando correctamente.

  • Volver a ejecutar la importación La manera más sencilla de actualizar una conexión consiste en realizar una importación manualmente con la ventana Data Access en la versión actualizada de Analytics. Copie el comando ACCESSDATA desde el log y utilícelo para actualizar su script.

    Nota

    Antes de conectarse al origen de los datos y volver a ejecutar la importación, borre la caché del conector para limpiar los nombres del conjunto de tablas existentes.

    En la ficha Conexiones existentes de la ventana Data Access, junto al nombre del conector, seleccione > Borrar caché.

  • Actualice las especificaciones del campo Es posible que también deba actualizar las especificaciones del campo en el cuerpo del script para alinearas con los cambios en el esquema de la tabla dentro del origen de datos o el controlador ODBC. Algunos cambios posibles son los nombres de campos, los tipos de datos de los campos y la longitud de los campos y los registros.
  • Compruebe los resultados de los filtros También debe comprobar los resultados de los filtros que aplique como parte de la importación de datos. Confirme que el filtrado de la importación incluye y excluye correctamente los registros.

Cambios al conector de datos de Exchange

A continuación se indican los cambios específicos que se realizaron al conector de datos de Exchange.

Analytics versión Tabla de Exchange Cambio

14.2

n/d

En el conector se cambió el nombre del esquema de Exchange de Exchange a EWS.

Ejemplo de la actualización necesaria en el comando ACCESSDATA:

  • Antes SELECT * FROM "Exchange"."Calendar" "Calendar"
  • Ahora SELECT * FROM "EWS"."Calendar" "Calendar"

Calendario

Se cambió el nombre del campo:

  • Se cambió el nombre de Recurrence_DayOfWeek por Recurrence_DaysOfWeek

Se agregó el campo:

  • ModifiedOccurrences_Aggregate
  • DeletedOccurrences_Aggregate

Se modificó el tipo de datos:

  • Se cambió Recurrence_StartDate de fecha a fechahora
  • Se cambió Recurrence_EndDate de fecha a fechahora

Buzón de entrada y Elementos enviados

Se cambió el nombre del campo:

  • Se cambió el nombre de ToRecipients_Name por ToRecipients_Names
  • Se cambió el nombre de ToRecipients_EmailAddress por ToRecipients_EmailAddresses
  • Se cambió el nombre de ToRecipients_ItemId por ToRecipients_ItemIds
  • Se cambió el nombre de CcRecipients_Name por CcRecipients_Names
  • Se cambió el nombre de CcRecipients_EmailAddress por CcRecipients_EmailAddresses
  • Se cambió el nombre de CcRecipients_ItemId por CcRecipients_ItemIds
  • Se cambió el nombre de BccRecipients_Name por BccRecipients_Names
  • Se cambió el nombre de BccRecipients_EmailAddress por BccRecipients_EmailAddresses
  • Se cambió el nombre de BccRecipients_ItemId por BccRecipients_ItemIds

Tareas

Se cambió el nombre del campo:

  • Se cambió el nombre de Recurrence_NumberOfOccurences por Recurrence_NumberOfOccurrences