Detalles de Conexión de Microsoft Exchange¶

Introducción¶

Versión del conector

Esta documentación se basa en la versión 21.0.8257 del conector.

Empezando¶

Compatibilidad con la versión de Exchange

El conector Jitterbit para Exchange se conecta con la API REST.

Establecer una Conexión¶

Esquemas Disponibles¶

Hay dos servicios disponibles para conectarse a Exchange. Estos son EWS (Exchange Web Services) y Microsoft Graph. Exchange Web Services está disponible para Exchange OnPremise y Online, pero ya no recibe actualizaciones. Microsoft recomienda cambiar al uso de Microsoft Graph para los usuarios de Exchange Online. Ambos están disponibles con nuestra herramienta.

Para cambiar entre los dos, use Schema propiedad de conexión para configurar EWS o MSGraph. Si desea utilizar EWS con Exchange Online, configure Schema al EWS y al Platform a Exchange_Online.

Conexión a Exchange Mediante Exchange OnPremise¶

Al usar una edición OnPremise de Exchange, OnPremise Set User, Password, y AuthScheme; de forma predeterminada, el conector realiza la autenticación básica, pero también se admiten Windows (NTLM), Kerberos y la autenticación delegada.

Autenticación con Kerberos¶

Consulte Uso de Kerberos para obtener detalles sobre cómo autenticarse con Kerberos

Además de los valores de autenticación, configure Server propiedad a la dirección del servidor de Exchange al que se está conectando y configurada Platform a la versión Exchange. Finalmente, establezca Schema a EWS.

Conexión a Exchange Mediante Exchange Online¶

Al conectarse a Exchange Online, la autenticación se realizará a través de OAuth. Si se conecta a la plataforma Exchange Online a través de EWS, configure AuthScheme propiedad de AzureAD, AzureServicePrincipal o AzureMSI. De lo contrario, si usará Microsoft Graph para conectarse a Exchange Online, los recursos se extraerán de un servicio diferente, por lo que Schema debe establecerse en MSGraph. Cuando Schema se establece en MSGraph, el Platform el valor será ignorado.

Autenticación Mediante Azure AD¶

Azure AD es un tipo de conexión que pasa por OAuth. Establecer su AuthScheme a AzureAD y consulte Uso de la autenticación OAuth para obtener una guía de autenticación.

Autenticación Mediante Azure Service Principal¶

Azure Service Principal es un tipo de conexión que pasa por OAuth. Establecer su AuthScheme a AzureServicePrincipal y consulte Uso de la autenticación principal de servicio de Azure para obtener una guía de autenticación.

Autenticación Mediante Autenticación MSI¶

Si está ejecutando Exchange en una máquina virtual de Azure, puede aprovechar las credenciales de identidad de servicio administrado (MSI) para conectarse:

• AuthScheme: Establézcalo en AzureMSI.

Las credenciales de MSI se obtendrán automáticamente para la autenticación.

Uso de la Autenticación OAuth¶

OAuth requiere que el usuario que se autentica interactúe con Exchange usando el navegador. El conector facilita esto de varias maneras, como se describe a continuación.

Credenciales Integradas¶

Consulte Credenciales integradas para conectarse con las credenciales incrustadas del conector y omitir la creación de una aplicación OAuth personalizada.

Credenciales Personalizadas¶

En lugar de conectarse con las credenciales integradas del conector, puede registrar una aplicación con Credenciales personalizadas para obtener el OAuthClientId y OAuthClientSecret.

Cuándo Crear una Aplicación OAuth Personalizada¶

La creación de una aplicación OAuth personalizada es opcional, ya que el conector ya está registrado con Exchange y puede conectarse con sus credenciales integradas. Es posible que desee crear una aplicación de OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en el extremo de Exchange OAuth para otorgar permisos al conector.

Creación de una Aplicación OAuth Personalizada¶

Consulte Crear una aplicación OAuth personalizada para un procedimiento.

Credenciales Integradas¶

Autenticarse con las Credenciales de OAuth Integradas¶

Autenticación de Escritorio con la Aplicación OAuth Integrada¶

Puede conectarse sin configurar ninguna propiedad de conexión para sus credenciales de usuario.

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth.

1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
2. Obtiene un nuevo token de acceso cuando caduca el anterior.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Credenciales Personalizadas¶

Hay dos tipos de autenticación de aplicaciones disponibles: usar un secreto de cliente y usar un certificado. Puede usar cualquiera de ellos dependiendo de la autenticación de la aplicación configurada.

Autenticación de Escritorio con Su Aplicación OAuth¶

Siga los pasos a continuación para autenticarse con las credenciales de una aplicación OAuth personalizada. Consulte Crear una aplicación OAuth personalizada.

Obtenga un Token de Acceso OAuth¶

Está listo para conectarse después de configurar uno de los siguientes grupos de propiedades de conexión según el tipo de autenticación.

1. Authenticating using a Client Secret
   • OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
   • OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.
   • CallbackURL: establezca esto en la URL de redireccionamiento en la configuración de su aplicación.
   • AuthScheme: establezca esto en "AzureAD" en la configuración de su aplicación.
   • InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken..
2. Authenticating using a Certificate
   • OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
   • OAuthJWTCert: establezca esto en el almacén de certificados JWT.
   • OAuthJWTCertType: establezca esto en el tipo de almacén de certificados especificado por OAuthJWTCert.
   • CallbackURL: establezca esto en la URL de redireccionamiento en la configuración de su aplicación.
   • AuthScheme: establezca esto en "AzureAD" en la configuración de su aplicación.
   • InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken..

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth:

1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
2. Obtiene un nuevo token de acceso cuando caduca el antiguo.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Máquinas Sin Cabeza¶

Uso de OAuth en una Máquina Sin Cabeza¶

Para crear orígenes de datos de Exchange en servidores sin periféricos u otras máquinas en las que el conector no puede abrir un navegador, debe autenticarse desde otra máquina. La autenticación es un proceso de dos pasos.

1. En lugar de instalar el conector en otra máquina, puede seguir los pasos a continuación para obtener el OAuthVerifier valor. O bien, puede instalar el conector en otra máquina y transferir los valores de autenticación de OAuth, después de autenticarse a través del flujo habitual basado en el navegador.
2. A continuación, puede configurar el conector para actualizar automáticamente el token de acceso desde la máquina sin periféricos.

Puede seguir el flujo de autenticación de OAuth sin cabeza usando las credenciales de OAuth integradas del conector o usando las credenciales de OAuth para su aplicación de OAuth personalizada.

Uso de las Credenciales para una Aplicación OAuth Personalizada¶

Cree una aplicación OAuth personalizada

Consulte Crear una aplicación OAuth personalizada para un procedimiento. Luego puede seguir los procedimientos a continuación para autenticarse y conectarse a los datos.

Obtenga un código verificador

En la máquina sin periféricos, configure uno de los siguientes grupos de propiedades según el tipo de autenticación:

1. Authenticating using a Client Secret
   • InitiateOAuth: Ajústelo a APAGADO.
   • OAuthClientId: establezca esto en la ID de la aplicación en la configuración de su aplicación.
   • OAuthClientSecret: establezca esto en el secreto de la aplicación en la configuración de su aplicación.
2. Authenticating using a Certificate
   • InitiateOAuth: Ajústelo a APAGADO.
   • OAuthClientId: establezca esto en la ID de la aplicación en la configuración de su aplicación.
   • OAuthJWTCert: establezca esto en el almacén de certificados JWT.
   • OAuthJWTCertType: establezca esto en el tipo de almacén de certificados especificado por OAuthJWTCert.

Luego puede seguir los pasos a continuación para autenticarse desde otra máquina y obtener el OAuthVerifier propiedad de conexión.

1. Llame a GetOAuthAuthorizationURL procedimiento almacenado* con el parámetro de entrada CallbackURL establecido en el URI de redirección exacto que especificó en la configuración de su aplicación.
2. Abra la URL devuelta en un navegador. Inicie sesión y otorgue permisos al conector. A continuación, se le redirigirá a la URL de devolución de llamada. La página web indicará que no se pudo acceder al sitio.
3. Inspeccione la URL de la página de este sitio y busque code valor. Estará presente en la URL en la forma code=XXXXXX (terminado con &, que denota el siguiente parámetro de URL ) El valor después de "code=" es el código verificador.
4. Guarde el valor del código verificador. Establecerá esto en el OAuthVerifier propiedad de conexión.

En la máquina sin periféricos, configure uno de los siguientes grupos de propiedades de conexión según el tipo de autenticación para obtener los valores de autenticación de OAuth:

• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
• OAuthVerifier: Establézcalo en el código del verificador.
• OAuthSettingsLocation: configure esto para conservar los valores de autenticación OAuth cifrados en el archivo especificado.
• InitiateOAuth: Establézcalo en ACTUALIZAR.

Conectarse a datos

Después de generar el archivo de configuración de OAuth, configure las siguientes propiedades para conectarse a los datos:

• OAuthSettingsLocation: Establézcalo en el archivo que contiene los valores de autenticación de OAuth cifrados. Asegúrese de que este archivo otorgue permisos de lectura y escritura al proveedor para habilitar la actualización automática del token de acceso.
• InitiateOAuth: Establézcalo en ACTUALIZAR.

Transferir configuración de OAuth

Siga los pasos a continuación para instalar el conector en otra máquina, autenticar y luego transferir los valores de OAuth resultantes.

En una segunda máquina, instale el conector y conéctese con uno de los siguientes grupos de propiedades según el tipo de autenticación:

1. Authenticating using a Client Secret
   • OAuthSettingsLocation: establezca esto en un archivo de texto grabable.
   • InitiateOAuth: Establézcalo en GETANDREFRESH.
   • OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
   • OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.
   • CallbackURL: establezca esto en la URL de devolución de llamada en la configuración de su aplicación.
2. Authenticating using a Certificate
   • OAuthSettingsLocation: establezca esto en un archivo de texto grabable.
   • InitiateOAuth: Establézcalo en GETANDREFRESH.
   • OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
   • OAuthJWTCert: establezca esto en el almacén de certificados JWT.
   • OAuthJWTCertType: establezca esto en el tipo de almacén de certificados especificado por OAuthJWTCert.
   • CallbackURL: establezca esto en la URL de devolución de llamada en la configuración de su aplicación.

Pruebe la conexión para autenticarse. Los valores de autenticación resultantes se escriben, se cifran, en la ruta especificada por OAuthSettingsLocation. Una vez que haya probado con éxito la conexión, copie el archivo de configuración de OAuth en su máquina sin periféricos. En la máquina sin periféricos, configure las siguientes propiedades de conexión para conectarse a los datos:

• InitiateOAuth: Establézcalo en ACTUALIZAR.
• OAuthSettingsLocation: establezca esto en la ruta a su archivo de configuración de OAuth. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.

Creación de una Aplicación OAuth Personalizada¶

Cuándo Crear una Aplicación OAuth Personalizada¶

La creación de una aplicación OAuth personalizada es opcional, ya que el conector ya está registrado con Exchange y puede conectarse con sus credenciales integradas.

Es posible que desee crear una aplicación de OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en el extremo de Exchange OAuth para otorgar permisos al conector.

Siga los pasos a continuación para crear una aplicación OAuth personalizada y obtener las propiedades de conexión en un flujo de autenticación OAuth específico.

Pasos para Crear una Aplicación OAuth Personalizada¶

Siga los pasos a continuación para obtener los valores de OAuth para su aplicación, el OAuthClientId y OAuthClientSecret.

1. Inicie sesión en https://portal.azure.com.
2. En el panel de navegación de la izquierda, seleccione Azure Active Directory, luego Registros de aplicaciones y haga clic en el botón Nuevo registro.
3. Ingrese un nombre de aplicación y configure el botón de opción para la configuración de inquilino deseada. Al crear una aplicación OAuth personalizada en Azure Active Directory, puede definir si la aplicación es de un solo inquilino o de varios inquilinos. Si selecciona la opción predeterminada de "Cuentas solo en este directorio organizacional", deberá configurar AzureTenant propiedad de conexión al ID del arrendatario de Azure AD al establecer una conexión con Jitterbit Connector for Exchange. De lo contrario, el intento de autenticación fallará con un error. Si su aplicación es solo para uso privado, "Solo cuentas en el directorio de esta organización" debería ser suficiente. De lo contrario, si desea distribuir su aplicación, elija una de las opciones de múltiples inquilinos.
4. Luego configure la URL de redireccionamiento a algo como http://localhost:33333, el valor predeterminado del conector. O configure un puerto diferente de su elección y configure CallbackURL a la URL de respuesta exacta que definiste.
5. Defina el tipo de autenticación de la aplicación en la sección Certificados y secretos. Hay dos tipos de autenticación disponibles: usando un secreto de cliente y usando un certificado. El método de autenticación recomendado es a través de un certificado, pero también puede crear un secreto de aplicación.
   • Option 1 - Upload a certificate: En la sección Certificados y secretos, seleccione Cargar certificado y seleccione el certificado para cargar desde su máquina local.
   • Option 2 - Create a new application secret: En la sección Certificados y secretos, seleccione Nuevo secreto de cliente para la aplicación y seleccione su duración. Después de guardar el secreto del cliente, se muestra el valor de la clave. Copie este valor ya que se muestra solo una vez y se usa como OAuthClientSecret.
6. Seleccione Permisos de API y luego haga clic en Agregar. Si planea que su aplicación se conecte sin un contexto de usuario, seleccione los Permisos de la aplicación (OAuthGrantType = CLIENTE). De lo contrario, al seleccionar permisos, utilice los permisos Delegados.
7. Si se conecta a Exchange a través del esquema EWS, seleccione la API de Exchange y agregue el permiso EWS.AccessAsUser.All. Si se conecta a Exchange a través del esquema MSGraph, seleccione Microsoft Graph API y agregue los siguientes permisos: Calendars.ReadWrite.Shared, Contacts.ReadWrite, Group.Read.All, Group.ReadWrite.All, User.ReadWrite.All y Mail .ReadWrite.Compartido.
8. Guarde sus cambios.
9. Si ha seleccionado usar permisos que requieren el consentimiento del administrador (como los Permisos de la aplicación), puede otorgarlos desde el arrendatario actual en la página Permisos de la API. De lo contrario, siga los pasos en Consentimiento del administrador.

Consentimiento del Administrador¶

El consentimiento del administrador se refiere a cuando el administrador de un arrendatario de Azure Active Directory otorga permisos a una aplicación que requiere que un administrador dé su consentimiento para el caso de uso. La aplicación integrada dentro de Jitterbit Connector for Exchange no contiene permisos que requieran el consentimiento del administrador. Por lo tanto, esta información se aplica solo a las aplicaciones personalizadas.

Permisos de Consentimiento del Administrador¶

Al crear una nueva aplicación de OAuth en Azure Portal, debe especificar qué permisos requerirá la aplicación. Algunos permisos pueden estar marcados como "Consentimiento del administrador requerido". Por ejemplo, todos los permisos de Grupos requieren el consentimiento del administrador. Si su aplicación requiere el consentimiento del administrador, hay varias formas de hacerlo.

La forma más fácil de otorgar el consentimiento del administrador es simplemente hacer que un administrador inicie sesión en portal.azure.com y navegue hasta la aplicación que ha creado en Registros de aplicaciones. En Permisos de API, habrá un botón para Otorgar consentimiento. Puede dar su consentimiento aquí para que su aplicación tenga permisos en el arrendatario bajo el que se creó.

Si su organización tiene varios inquilinos o es necesario otorgar permisos a la aplicación para otros inquilinos fuera de su organización, GetAdminConsentURL se puede utilizar para generar la URL de autorización del administrador. A diferencia de GetOAuthAuthorizationURL, no se devolverá información importante desde este extremo. Si otorga acceso, simplemente devolverá un valor booleano que indica que se otorgaron los permisos.

Una vez que un administrador otorga el consentimiento, la autenticación se puede realizar normalmente.

Credenciales del Cliente¶

Las credenciales del cliente hacen referencia a un flujo en OAuth en el que no se lleva a cabo una autenticación directa del usuario. En cambio, las credenciales se crean solo para la aplicación en sí. Todas las tareas realizadas por la aplicación se realizan sin un contexto de usuario predeterminado. Esto hace que el flujo de autenticación sea un poco diferente al estándar.

Flujo de OAuth del Cliente¶

Todos los permisos relacionados con el flujo de autenticación del cliente requieren el consentimiento del administrador. Esto significa que la aplicación integrada con Jitterbit Connector for Exchange no se puede usar en el flujo de autenticación del cliente. Debe crear su propia aplicación OAuth para usar las credenciales del cliente. Consulte Crear una aplicación OAuth personalizada para más detalles.

En su Registro de aplicaciones en portal.azure.com, vaya a Permisos de API y seleccione los permisos de Microsoft Graph. Hay dos conjuntos distintos de permisos: permisos delegados y de aplicación. Los permisos utilizados durante la autenticación de credenciales del cliente se encuentran en Permisos de la aplicación. Seleccione los permisos aplicables que necesita para su integración.

Está listo para conectarse después de configurar uno de los siguientes grupos de propiedades de conexión según el tipo de autenticación.

1. Authenticating using a Client Secret
   • InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
   • AzureTenant: Configure esto para el arrendatario al que desea conectarse.
   • OAuthGrantType: Establézcalo en CLIENTE.
   • OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
   • OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.
2. Authenticating using a Certificate
   • InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
   • AzureTenant: Configure esto para el arrendatario al que desea conectarse.
   • OAuthGrantType: Establézcalo en CLIENTE.
   • OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
   • OAuthJWTCert: establezca esto en el almacén de certificados JWT.
   • OAuthJWTCertType: establezca esto en el tipo de almacén de certificados especificado por OAuthJWTCert.

La autenticación con las credenciales del cliente se realizará automáticamente como cualquier otra conexión, excepto que no se abrirá ninguna ventana que pregunte al usuario. Debido a que no hay un contexto de usuario, no hay necesidad de una ventana emergente en el navegador. Las conexiones se llevarán a cabo y se manejarán internamente.

Uso de la Autenticación Principal de Servicio de Azure¶

La autenticación como entidad principal de servicio de Azure se gestiona a través del flujo de credenciales de cliente de OAuth y no implica la autenticación directa del usuario. En cambio, las credenciales se crean solo para la aplicación en sí. Todas las tareas realizadas por la aplicación se realizan sin un contexto de usuario predeterminado, pero en función de los roles asignados. El acceso de la aplicación a los recursos se controla a través de los permisos de los roles asignados.

Credenciales Personalizadas¶

Deberá registrar una aplicación de OAuth para obtener los valores de propiedad de OAuth antes de conectarse a la fuente de datos de Exchange. Puede comprobar las Credenciales personalizadas guía sobre cómo configurar las propiedades de OAuth.

Creación de una Aplicación OAuth Personalizada¶

Consulte Crear una aplicación OAuth personalizada para un procedimiento.

Creación de una Aplicación OAuth Personalizada¶

Es necesario crear una aplicación de OAuth personalizada y una entidad de servicio que pueda acceder a los recursos necesarios cuando se autentica mediante una entidad de servicio de Azure.

Siga los pasos a continuación para crear una aplicación OAuth personalizada y obtener las propiedades de conexión para la autenticación de la entidad de servicio de Azure.

Pasos para Crear una Aplicación OAuth Personalizada¶

Siga los pasos a continuación para obtener los valores de OAuth para su aplicación.

1. Inicie sesión en <https://portal.azure.com>.
2. En el panel de navegación de la izquierda, seleccione Azure Active Directory, luego Registros de aplicaciones y haga clic en el botón Nuevo registro.
3. Ingrese un nombre de aplicación y configure el botón de opción para "Cualquier directorio de Azure AD - Multiusuario". Luego configure la URL de redireccionamiento a algo como http://localhost:33333, el valor predeterminado del conector.
4. Copie el valor de ID de la aplicación (cliente) que se muestra en la sección Descripción general después de crear la aplicación, ya que este valor se usa como OAuthClientId
5. Defina el tipo de autenticación de la aplicación en la sección Certificados y secretos. Hay dos tipos de autenticación disponibles: usando un secreto de cliente y usando un certificado. El método de autenticación recomendado es a través de un certificado, pero también puede crear un secreto de aplicación.
   • Option 1 - Upload a certificate: En la sección Certificados y secretos, seleccione Cargar certificado y seleccione el certificado para cargar desde su máquina local.
   • Option 2 - Create a new application secret: En la sección Certificados y secretos, seleccione Nuevo secreto de cliente para la aplicación y seleccione su duración. Después de guardar el secreto del cliente, se muestra el valor de la clave. Copie este valor ya que se muestra solo una vez y se usa como OAuthClientSecret.
6. En la pestaña Autenticación, asegúrese de marcar la opción: Tokens de acceso (utilizados para flujos implícitos).
7. Abra la página Suscripciones buscando y seleccionando el servicio Suscripciones en la barra de búsqueda.
8. Seleccione la suscripción particular para asignar la aplicación, luego abra la sección Control de acceso (IAM) y haga clic en el botón Agregar asignación de rol.
9. Seleccione Propietario como el rol para asignar a su aplicación OAuth creada.

Credenciales Personalizadas¶

Siga los pasos a continuación para autenticarse con las credenciales de una aplicación OAuth personalizada. Consulte Crear una aplicación OAuth personalizada.

Autenticación con Su Aplicación OAuth¶

Hay dos tipos de autenticación de aplicaciones disponibles: usar un secreto de cliente y usar un certificado. Puede usar cualquiera de ellos dependiendo de la autenticación de la aplicación configurada.

Obtenga un Token de Acceso OAuth¶

Está listo para conectarse después de configurar uno de los siguientes grupos de propiedades de conexión según el tipo de autenticación.

1. Authenticating using a Client Secret
   • AuthScheme: establezca esto en "AzureServicePrincipal" en la configuración de su aplicación.
   • InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
   • AzureTenant: Configure esto para el arrendatario al que desea conectarse.
   • OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
   • OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.
2. Authenticating using a Certificate
   • AuthScheme: establezca esto en "AzureServicePrincipal" en la configuración de su aplicación.
   • InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
   • AzureTenant: Configure esto para el arrendatario al que desea conectarse.
   • OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
   • OAuthJWTCert: establezca esto en el almacén de certificados JWT.
   • OAuthJWTCertType: establezca esto en el tipo de almacén de certificados especificado por OAuthJWTCert.

Uso de Kerberos¶

Esta sección muestra cómo utilizar el conector para autenticarse en Exchange mediante Kerberos.

Autenticación con Kerberos¶

Para autenticarse en Exchange mediante Kerberos, establezca las siguientes propiedades:

• AuthScheme: Establézcalo en NEGOTIATE.
• KerberosKDC: Establézcalo en host name or IP Address de su máquina Kerberos KDC.
• KerberosRealm: Establézcalo en the realm of the Exchange Kerberos principal. Este será el valor después del símbolo '@' (por ejemplo, EXAMPLE.COM) de principal value (por ejemplo, ServiceName/MyHost@EXAMPLE.COM).
• KerberosSPN: Establézcalo en service and host of the Exchange Kerberos Principal. Este será el valor antes del símbolo '@' (por ejemplo, ServiceName/MyHost) de principal value (por ejemplo, ServiceName/MyHost@EXAMPLE.COM).

Recuperar el Ticket de Kerberos¶

Puede utilizar una de las siguientes opciones para recuperar el vale de Kerberos requerido.

Archivo de Caché de Credenciales MIT Kerberos¶

Esta opción le permite utilizar el administrador de tickets MIT Kerberos o el comando kinit para obtener tickets. Tenga en cuenta que usted no necesitará configurar el User o Password propiedades de conexión con esta opción.

1. Asegúrese de tener una variable de ambiente creada llamada KRB5CCNAME.
2. Configure el KRB5CCNAME variable de ambiente a una ruta que apunta a su credential cache file (por ejemplo, C:\krb_cache\krb5cc_0 o /tmp/krb5cc_0). Este archivo se creará al generar su ticket con MIT Kerberos Ticket Manager.
3. Para obtener un ticket, abra la aplicación MIT Kerberos Ticket Manager, haga clic en Get Ticket, enter your principal name and password, then click OK. Si tiene éxito, la información del ticket aparecerá en Kerberos Ticket Manager y ahora se almacenará en el archivo de caché de credenciales.
4. Ahora que se ha creado el archivo de caché de credenciales, el conector utilizará el archivo de caché para obtener el vale de Kerberos para conectarse a Exchange.

Como alternativa a la configuración de KRB5CCNAME variable de ambiente, puede establecer directamente la ruta del archivo usando KerberosTicketCache propiedad. Cuando se establece, el conector utilizará el archivo de caché especificado para obtener el vale de Kerberos para conectarse a Exchange.

Archivo de Tabla de Claves¶

Si no se ha configurado la variable de entorno KRB5CCNAME, puede recuperar un ticket de Kerberos usando un Keytab File. Para hacer esto, configure User propiedad al nombre de usuario deseado y configure KerberosKeytabFile propiedad a una ruta de archivo que apunta al archivo keytab asociado con el usuario.

Usuario y Contraseña¶

Si no se han establecido ni la variable de entorno KRB5CCNAME ni la propiedad KerberosKeytabFile, puede recuperar un boleto usando un User and Password combination. Para hacer esto, configure User y Password propiedades al combo de usuario/contraseña que usa para autenticarse con Exchange.

Autenticación Entre Reinos¶

Los ambientes de Kerberos más complejos pueden requerir la autenticación entre dominios donde se utilizan múltiples dominios y servidores KDC (por ejemplo, donde se usa un dominio/KDC para la autenticación del usuario y otro dominio/KDC para obtener el ticket de servicio).

En tal ambiente, el KerberosRealm y KerberosKDC las propiedades se pueden establecer en los valores necesarios para la autenticación del usuario. El KerberosServiceRealm y KerberosServiceKDC las propiedades se pueden configurar a los valores requeridos para obtener el ticket de servicio.

Tareas Administrativas en Línea de Exchange¶

El conector Jitterbit para Exchange se puede utilizar para realizar tareas administrativas con MSGraph Schema. Esto se puede hacer especificando la columna UserId para ejecutar operaciones CUD.

La Columna de ID de Usuario¶

Muchas tablas exponen una columna de ID de usuario especial. Esto está diseñado para ser utilizado por un administrador para modificar registros en la cuenta de otro usuario. Si no es administrador o no desea este comportamiento, no especifique el ID de usuario cuando realice una operación INSERTAR/ACTUALIZAR/ELIMINAR. Por ejemplo, ejecutar lo siguiente insertará un contacto para otro usuario:

INSERT INTO Contacts (displayName, CompanyName, UserId) VALUES ('Bill', 'Bob Co', '12345')

La solicitud anterior tendrá el efecto general de intentar agregar un contacto en el recurso en /users/12345/contacts. Cuando no se especifica UserId, los recursos afectados se modificarán en /users/me/contacts. En general, si no es administrador, solo puede afectar o ver registros en /usuarios/yo, por lo que no se recomienda configurar el ID de usuario cuando no es administrador.

Note: No se admite la especificación de UserId junto con un operador 'OR' de cualquier consultar dada. Como alternativa, puede usar 'UNION' para recuperar el mismo conjunto de resultados.

Selección de Datos de Intercambio¶

Nota: A continuación se describe el comportamiento cuando Schema está configurado en EWS. No tiene ningún impacto en MSGraph.

FindItem Frente a GetItem¶

De forma predeterminada, el conector realizará la llamada a la API FindItem de Exchange Web Services y solo solicitará información de resumen sobre los elementos cuando se realice una operación SELECT. Cualquier solicitud que pueda devolver más de un artículo solo devolverá información resumida. Por ejemplo:

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE Surname='Smith'

Si desea solicitar el contenido de un mensaje o más información sobre un contacto o evento del calendario, deberá configurar IncludeContent a TRUE, especifique los ItemIds de los elementos o limite sus resultados a un solo elemento. Por ejemplo:

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE ItemId='AZQ111222...'

O

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE ItemdId IN ('AZQ111222...', 'AZQ111223...', 'AZQ111224...', 'AZQ111225...')

O

SELECT ItemId, Surname, EmailAddress1 FROM Contacts WHERE Surname='Smith' LIMIT 1

Carpetas Públicas y Personalizadas¶

Si desea leer desde una carpeta pública o personalizada, primero deberá identificar el FolderId de la carpeta desde la que desea leer. Esto se puede hacer enviando una consultar de lectura desde ParentFolder (para una carpeta personalizada) o desde la tabla relevante para el tipo de objeto almacenado en una Carpeta pública, usando la Bandeja de entrada si la Carpeta pública

contiene mensajes. Por ejemplo:

Encontrar el FolderId de una subcarpeta de la Bandeja de entrada:

SELECT DisplayName, FolderId FROM Inbox

Encontrar el FolderId de una carpeta personalizada que contiene contactos:

SELECT DisplayName, FolderId FROM Contacts WHERE ParentFolderName='publicfoldersroot'

Si su carpeta pública está anidada, es posible que deba realizar una consultar SELECCIONAR por separado en la carpeta personalizada principal:

SELECT DisplayName, FolderId FROM Contacts WHERE ParentFolderId='AAEuAAAAAAAa...'

Creación de Elementos en Carpetas Públicas y Personalizadas¶

Inserción en Carpetas Públicas y Personalizadas¶

Si desea crear un elemento en una carpeta pública o personalizada, primero deberá identificar el FolderID de la carpeta desde la que desea leer (consulte Selección de datos de intercambio). Una vez que conozca el FolderID, puede usar este valor como ParentFolderId cuando cree un nuevo objeto. Para crear un objeto en una carpeta pública o personalizada, utilice el

tipo de objeto como la tabla (o Bandeja de entrada si la carpeta contiene Mensajes). Por ejemplo:

Inserción en una subcarpeta de la Bandeja de entrada:

INSERT INTO Inbox (Subject, FromEmailAddress, ToRecipients_EmailAddress, ParentFolderId) VALUES ('New email message', 'user1@email.com', 'user2@email.com', 'AAEuAAAAAAAa...')

Insertar en una carpeta pública que contiene contactos:

INSERT INTO Contacts (GivenName, Surname, EmailAddress1, ParentFolderId) VALUES ('Jill', 'Smith', 'user3@email.com', 'AAEuAAAAAAAa...')

Actualización o Eliminación de Elementos en Carpetas Públicas y Personalizadas¶

Actualización o Eliminación de un Elemento en Carpetas Públicas y Personalizadas¶

A diferencia de leer o insertar en una carpeta pública o personalizada, no necesita el FolderId para actualizar o eliminar un elemento. Simplemente necesita saber qué tipo

de objeto que contiene la carpeta y use ese tipo como la Tabla (o use la Bandeja de entrada para una carpeta que contenga Mensajes). Por ejemplo:

Actualización de un elemento de mensaje en una carpeta personalizada:

UPDATE Inbox SET Subject = 'Updated email message' WHERE ItemID = 'AZQ111222...')

Eliminación de un elemento de contacto de una carpeta pública:

DELETE FROM Contacts WHERE ItemID = 'AZQ111222...')

Ajuste Fino del Acceso a los Datos¶

Usuarios Suplantados¶

Los administradores suelen utilizar este método de autenticación para configurar el acceso de una cuenta de servicio.
Para suplantar todas las solicitudes, establezca las siguientes propiedades de conexión en el momento de la conexión.
Para suplantar a un usuario para una consultar individual, utilice las pseudocolumnas del mismo nombre.

• ImpersonationUser: Configure esto para que el usuario suplante.
• ImpersonationType: establezca esto en el formato que está utilizando para especificar el usuario. Por ejemplo, UPN o SID.

Notas Importantes¶

Procedimientos Almacenados¶

• Las funciones de procedimientos almacenados descritas en esta documentación no se admiten actualmente.
• Debido a que los procedimientos almacenados no se admiten actualmente, cualquier característica que dependa de los procedimientos almacenados tampoco se admite actualmente.

Archivos de Configuración y Sus Rutas¶

• Todas las referencias a la adición de archivos de configuración y sus rutas se refieren a archivos y ubicaciones en Harmony Agente donde está instalado el conector. Estas rutas deben ajustarse según corresponda según el agente y el sistema operativo. Si se utilizan varios agentes en un grupo de agentes, se requerirán archivos idénticos en cada agente.

Características Avanzadas¶

Esta sección detalla una selección de funciones avanzadas del conector de Exchange.

Vistas definidas por el usuario

El conector le permite definir tablas virtuales, llamadas vistas definidas por el usuario, cuyo contenido se decide mediante una consultar preconfigurada. Estas vistas son útiles cuando no puede controlar directamente las consultas que se envían a los controladores. Consulte Vistas definidas por el usuario para obtener una descripción general de la creación y configuración de vistas personalizadas.

Configuración SSL

Usar Configuración SSL para ajustar cómo el conector maneja las negociaciones de certificados TLS/SSL. Puede elegir entre varios formatos de certificado; ver el SSLServerCert propiedad en "Opciones de cadena de conexión" para obtener más información.

Apoderado

Para configurar el conector mediante Configuración de proxy de Agente Privado, Selecciona el Use Proxy Settings casilla de verificación en la pantalla de configuración de la conexión.

Vistas Definidas por el Usuario¶

El conector Jitterbit para Exchange le permite definir una tabla virtual cuyo contenido se decide mediante una consultar preconfigurada. Estas se denominan Vistas definidas por el usuario, que son útiles en situaciones en las que no puede controlar directamente la consultar que se envía al controlador, por ejemplo, cuando se utiliza el controlador de Jitterbit. Las vistas definidas por el usuario se pueden utilizar para definir predicados que siempre se aplican. Si especifica predicados adicionales en la consultar a la vista, se combinan con la consultar ya definida como parte de la vista.

Hay dos formas de crear vistas definidas por el usuario:

• Cree un archivo de configuración con formato JSON que defina las vistas que desea.
• Declaraciones DDL.

Definición de Vistas Utilizando un Archivo de Configuración¶

Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json. El conector detecta automáticamente las vistas especificadas en este archivo.

También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.

Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:

• Cada elemento raíz define el nombre de una vista.
• Cada elemento raíz contiene un elemento hijo, llamado query, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

{
    "MyView": {
        "query": "SELECT * FROM Contacts WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Utilizar el UserDefinedViews propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Vistas Definidas por el Usuario¶

Las vistas definidas por el usuario se exponen en UserViews esquema por defecto. Esto se hace para evitar que el nombre de la vista entre en conflicto con una entidad real en el modelo de datos. Puede cambiar el nombre del esquema utilizado para UserViews configurando UserViewsSchemaName propiedad.

Trabajar con Vistas Definidas por el Usuario¶

Por ejemplo, una instrucción SQL con una vista definida por el usuario llamada UserViews.RCustomers solo enumera clientes en Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Dando como resultado la consultar efectiva a la fuente:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Ese es un ejemplo muy simple de una consultar a una vista definida por el usuario que es efectivamente una combinación de la consultar de vista y la definición de vista. Es posible componer estas consultas en patrones mucho más complejos. Todas las operaciones de SQL están permitidas en ambas consultas y se combinan cuando corresponde.

Configuración SSL¶

Personalización de la Configuración SSL¶

De forma predeterminada, el conector intenta negociar SSL/TLS comparando el certificado del servidor con el almacén de certificados de confianza del sistema.

Para especificar otro certificado, consulte SSLServerCert propiedad de los formatos disponibles para hacerlo.

Modelo de Datos¶

Jitterbit Connector for Exchange modela Exchange 2 y las APIs de Exchange como tablas relacionales, vistas y procedimientos almacenados. Estos se definen en archivos de esquema, que son archivos de configuración simples basados en texto.

Las entidades disponibles, así como las limitaciones y los requisitos de la API para consultar estas entidades, se documentan en Modelo de datos de EWS y Modelo de datos de MSGraph. Puedes usar el SupportEnhancedSQL función, configurada de forma predeterminada, para eludir la mayoría de estas limitaciones.

Descripción general

Los modelos de datos ilustran un ejemplo de cómo podría ser su ambiente de Exchange. El modelo de datos real se obtendrá dinámicamente en función de su cuenta de Exchange.

Características clave

• Las tablas y las vistas se definen dinámicamente para modelar calendarios, documentos y proyectos en Exchange.
• Procedimientos almacenados* le permiten ejecutar operaciones en Exchange, incluida la descarga y carga de objetos.
• La conectividad en vivo a estos objetos significa que cualquier cambio en su cuenta de Exchange se refleja de inmediato al usar el conector.

Modelo de datos EWS

Modelo de datos EWS describe los esquemas disponibles para conectarse a Exchange OnPremise y Exchange Online mediante EWS. Puede usar tablas para trabajar con datos de Exchange en vivo. Puede usar procedimientos almacenados* proporcionado por Jitterbit Connector for Exchange para automatizar el trabajo con datos de Exchange.

Modelo de datos MSGraph

Modelo de datos MSGraph describe los esquemas disponibles para conectarse a cuentas de Exchange Online a través de Microsoft Graph. Puede usar tablas para trabajar con datos de Exchange en vivo. Puede usar procedimientos almacenados* proporcionado por Jitterbit Connector for Exchange para automatizar el trabajo con datos de Exchange.

Modelo de Datos de EWS¶

El Jitterbit Connector for Exchange modela las entidades de Exchange como Tablas y Procedimientos almacenados. Estos se definen en archivos de esquema, que son archivos de configuración simples basados en texto.

Las limitaciones y los requisitos de la API se documentan en esta sección; puedes usar el SupportEnhancedSQL función, configurada de forma predeterminada, para eludir la mayoría de estas limitaciones.

Procedimientos almacenados* son interfaces similares a funciones para Exchange. Se pueden usar para buscar, actualizar y modificar información en Exchange.

Mesas¶

El conector modela los datos en Exchange en una lista de tablas que se pueden consultar mediante instrucciones SQL estándar.

Generalmente, consultar tablas de Exchange es lo mismo que consultar una tabla en una base de datos relacional. A veces hay casos especiales, por ejemplo, incluir una determinada columna en la cláusula WHERE puede ser necesario para obtener datos para ciertas columnas de la tabla. Esto suele ser necesario para situaciones en las que se debe realizar una solicitud separada para cada fila para obtener ciertas columnas. Estos tipos de situaciones están claramente documentados en la parte superior de la página de la tabla vinculada a continuación.

Conector Jitterbit para Tablas de Intercambio¶

Calendario¶

Cree, actualice, elimine y consultar elementos del Calendario.

Información Específica de la Tabla¶

Actualizar y Eliminar

El conector necesitará ItemChangeKey para actualizar o eliminar un elemento. Sin embargo, si no está seguro de ItemChangeKey, el conector puede recuperarlo del servidor de Exchange automáticamente. Tenga en cuenta que esto puede aumentar el tiempo necesario para realizar una consultar.

Seleccionar eventos recurrentes

Al realizar una operación SELECCIONAR en la tabla Calendario, el conector no incluirá eventos recurrentes individuales de manera predeterminada (solo se incluirá el elemento maestro). Si desea ver las recurrencias individuales de un evento recurrente, deberá especificar el ItemId. Su consultar deberá incluir una cláusula WHERE similar a la siguiente:

SELECT Subject,IsRecurring,Recurrence_StartDate,Recurrence_EndDate,Recurrence_Interval,Recurrence_Type,Recurrence_NumberOfOccurrences,FirstOccurrence_Start  FROM Calendar WHERE ItemId='myid'

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Calendar_OpcionalAsistentes¶

Los asistentes opcionales para un evento en particular. Se debe especificar un ItemId al consultar esta vista.

Información Específica de la Tabla¶

Actualizar y Eliminar

El conector necesitará ItemChangeKey para actualizar o eliminar un elemento. Sin embargo, si no está seguro de ItemChangeKey, el conector puede recuperarlo del servidor de Exchange automáticamente. Tenga en cuenta que esto puede aumentar el tiempo necesario para realizar una consultar.

insertando

Al realizar una operación SELECCIONAR en la tabla Calendario, el conector no incluirá eventos recurrentes individuales de manera predeterminada (solo se incluirá el elemento maestro). Si desea ver las recurrencias individuales de un evento recurrente, deberá filtrar la búsqueda por la columna IsRecurring y usar Start y End para especificar un período de tiempo. Su consultar deberá incluir una cláusula WHERE similar a la siguiente:

INSERT INTO Calendar_OptionalAttendees (EmailAddress, ItemId, SendMeetingInvitations) VALUES ('johndoe@example.com', 'itemid', 'SendOnlyToChanged')

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Calendar_RequiredAsistentes¶

Los asistentes requeridos para un evento en particular. Se debe especificar un ItemId al consultar esta vista.

Información Específica de la Tabla¶

Insertar declaraciones

Al realizar una operación INSERT, deberá especificar EmailAddress y ItemId. Además, hay una propiedad llamada SendMeetingInvitations que puede configurar para decidir a quién se le notifica cuando inserta los asistentes requeridos.

INSERT INTO Calendar_RequiredAttendees (EmailAddress, ItemId, SendMeetingInvitations) VALUES ('johndoe@example.com', 'itemid', 'SendOnlyToChanged')

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Contactos¶

Cree, actualice, elimine y consultar elementos de Contactos.

Información Específica de la Tabla¶

Actualizar y Eliminar

El conector necesitará ItemChangeKey para actualizar o eliminar un elemento. Sin embargo, si no está seguro de ItemChangeKey, el conector puede recuperarlo del servidor de Exchange automáticamente. Tenga en cuenta que esto puede aumentar el tiempo necesario para realizar una consultar.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Objetos Eliminados¶

Crear, actualizar, eliminar y consultar elementos eliminados.

Información Específica de la Tabla¶

Seleccionar Correos de las subcarpetas de elementos eliminados

Al realizar una operación SELECCIONAR en la tabla Elementos eliminados, el conector no incluirá los elementos de las subcarpetas en Elementos eliminados, sino solo los elementos contenidos en la carpeta Elementos eliminados. Si desea recuperar los elementos de las subcarpetas DeletedItems, deberá especificar ParentFolderId-s en la cláusula WHERE. Puede obtener cada ID de subcarpeta de DeletedItems ejecutando una consultar filtrada por ParentFolderName en la tabla Carpetas. Puede usar la consultar de ejemplo a continuación para recuperar los elementos dentro de las subcarpetas DeletedItems:

SELECT * FROM DeletedItems where ParentFolderId in (Select FolderId from Folders where ParentFolderName='DeletedItems' and TotalCount>0)

Actualizar y Eliminar

El conector necesitará ItemChangeKey para actualizar o eliminar un elemento. Sin embargo, si no está seguro de ItemChangeKey, el conector puede recuperarlo del servidor de Exchange automáticamente. Tenga en cuenta que esto puede aumentar el tiempo necesario para realizar una consultar.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Borradores¶

Cree, actualice, elimine y consultar elementos de Borrador.

Información Específica de la Tabla¶

Seleccionar Correos de las subcarpetas de borradores

Al realizar una operación SELECCIONAR en la tabla Borradores, el conector no incluirá los elementos de las subcarpetas en Borradores, sino solo los elementos contenidos en la carpeta Borradores. Si desea recuperar los elementos de las subcarpetas Borradores, deberá especificar ParentFolderId-s en la cláusula WHERE. Puede obtener cada ID de subcarpeta de Borradores ejecutando una consultar filtrada por ParentFolderName en la tabla Carpetas. Puede usar la consultar de ejemplo a continuación para recuperar los elementos dentro de las subcarpetas Borradores:

SELECT * FROM Drafts where ParentFolderId in (Select FolderId from Folders where ParentFolderName='Drafts' and TotalCount>0)

Actualizar y Eliminar

El conector necesitará ItemChangeKey para actualizar o eliminar un elemento. Sin embargo, si no está seguro de ItemChangeKey, el conector puede recuperarlo del servidor de Exchange automáticamente. Tenga en cuenta que esto puede aumentar el tiempo necesario para realizar una consultar.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Carpetas¶

Cree, actualice, elimine y consultar subcarpetas para una carpeta determinada.

Información Específica de la Tabla¶

Actualizar y Eliminar

El conector necesitará FolderChangeKey para actualizar o eliminar un elemento. Sin embargo, si no está seguro de la FolderChangeKey, el conector puede recuperarla del servidor de Exchange automáticamente. Tenga en cuenta que esto puede aumentar el tiempo necesario para realizar una consultar.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Bandeja de Entrada¶

Cree, actualice, elimine y consultar elementos de la bandeja de entrada.

Información Específica de la Tabla¶

Seleccionar Correos de las subcarpetas de la bandeja de entrada

Al realizar una operación SELECCIONAR en la tabla Bandeja de entrada, el conector no incluirá los elementos de las subcarpetas en Bandeja de entrada, sino solo los elementos contenidos en la carpeta Bandeja de entrada. Si desea recuperar los elementos de las subcarpetas de la bandeja de entrada, deberá especificar ParentFolderId-s en la cláusula WHERE. Puede obtener cada ID de subcarpeta de Bandeja de entrada ejecutando una consultar filtrada por ParentFolderName en la tabla Carpetas. Puede usar la consultar de ejemplo a continuación para recuperar los elementos dentro de las subcarpetas de la bandeja de entrada:

SELECT * FROM Inbox where ParentFolderId in (Select FolderId from Folders where ParentFolderName='Inbox' and TotalCount>0)

Actualizar y Eliminar

El conector necesitará ItemChangeKey para actualizar o eliminar un elemento. Sin embargo, si no está seguro de ItemChangeKey, el conector puede recuperarlo del servidor de Exchange automáticamente. Tenga en cuenta que esto puede aumentar el tiempo necesario para realizar una consultar.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Correo Electrónico No Deseado¶

Cree, actualice, elimine y consultar elementos de Correo no deseado.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Bandeja de Salida¶

Cree, actualice, elimine y consultar los elementos de la Bandeja de salida.

Información Específica de la Tabla¶

Seleccionar Correos de las subcarpetas de la bandeja de salida

Al realizar una operación SELECCIONAR en la tabla Bandeja de salida, el conector no incluirá los elementos de las subcarpetas en Bandeja de salida, sino solo los elementos contenidos en la carpeta Bandeja de salida. Si desea recuperar los elementos de las subcarpetas de la bandeja de salida, deberá especificar ParentFolderId-s en la cláusula WHERE. Puede obtener cada ID de subcarpeta de Bandeja de salida ejecutando una consultar filtrada por ParentFolderName en la tabla Carpetas. Puede usar la consultar de ejemplo a continuación para recuperar los elementos dentro de las subcarpetas de la Bandeja de salida:

SELECT * FROM Outbox where ParentFolderId in (Select FolderId from Folders where ParentFolderName='Outbox' and TotalCount>0)

Actualizar y Eliminar

El conector necesitará ItemChangeKey para actualizar o eliminar un elemento. Sin embargo, si no está seguro de ItemChangeKey, el conector puede recuperarlo del servidor de Exchange automáticamente. Tenga en cuenta que esto puede aumentar el tiempo necesario para realizar una consultar.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Elementos Enviados¶

Crear, actualizar, eliminar y consultar elementos enviados.

Información Específica de la Tabla¶

Seleccionar Correos de las subcarpetas SentItems

Al realizar una operación SELECCIONAR en la tabla Elementos enviados, el conector no incluirá los elementos de las subcarpetas en Elementos enviados, sino solo los elementos contenidos en la carpeta Elementos enviados. Si desea recuperar los elementos de las subcarpetas SentItems, deberá especificar ParentFolderId-s en la cláusula WHERE. Puede obtener cada Id. de subcarpeta SentItems ejecutando una consultar filtrada por ParentFolderName en la tabla Carpetas. Puede usar la consultar de ejemplo a continuación para recuperar los elementos dentro de las subcarpetas SentItems:

SELECT * FROM SentItems where ParentFolderId in (Select FolderId from Folders where ParentFolderName='SentItems' and TotalCount>0)

Actualizar y Eliminar

El conector necesitará ItemChangeKey para actualizar o eliminar un elemento. Sin embargo, si no está seguro de ItemChangeKey, el conector puede recuperarlo del servidor de Exchange automáticamente. Tenga en cuenta que esto puede aumentar el tiempo necesario para realizar una consultar.

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Tareas¶

Crear, actualizar, eliminar y consultar elementos de Tareas.

Información Específica de la Tabla¶

Actualizar y Eliminar

El conector necesitará ItemChangeKey para actualizar o eliminar un elemento. Sin embargo, si no está seguro de ItemChangeKey, el conector puede recuperarlo del servidor de Exchange automáticamente. Tenga en cuenta que esto puede aumentar el tiempo necesario para realizar una consultar.

Campos de recurrencia

Para INSERTAR, SELECCIONAR o ACTUALIZAR los campos de recurrencia en una tarea, deberá asegurarse de configurar solo los campos asociados con los campos Recurrence_Type y Recurrence_Duration. Por favor, consulte las tablas a continuación:

Valores de tipo de recurrencia y campos asociados

Recurrence_Duration y campos asociados

Columnas¶

Pseudo-Columnas¶

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Procedimientos Almacenados¶

Procedimientos almacenados* están disponibles para complementar los datos disponibles del Modelo de datos. Puede ser necesario actualizar los datos disponibles desde una vista usando un procedimiento almacenado* porque los datos no proporcionan actualizaciones bidireccionales directas, similares a tablas. En estas situaciones, la recuperación de los datos se realiza utilizando la vista o tabla adecuada, mientras que la actualización se realiza llamando a un procedimiento almacenado. Procedimientos almacenados* toman una lista de parámetros y devuelven un conjunto de datos que contiene la colección de tuplas que constituyen la respuesta.

Conector Jitterbit para Procedimientos Almacenados de Exchange¶

Crear Archivos Adjuntos¶

Cree y agregue un archivo adjunto a un correo existente.

Procedimiento Almacenado* Información Específica¶

Utilice el procedimiento CreateAttachments para agregar un archivo adjunto a un correo existente. Para especificar las rutas de archivo de los archivos adjuntos, utilice la entrada de archivos adjuntos, mientras que para el contenido codificado en base 64, especifique AttachmentContent y AttachmentName.

EXECUTE CreateAttachments ItemId = 'AQMkAGRlMWQ5MDg0LWI5ZTQtNDk2Yi1hOTQ1LTU4YzFmMzEwZjlhMgBGAAAD/FjxR3cIwE6TEGSCVtIHcwcAQyR2Iw3coEOaUD1BLt0tnAAAAxEAAABDJHYjDdygQ5pQPUEu3S2cAAVZoayvAAAA', Attachments = 'C:\Users\User\Desktop\logfile.txt,C:\Users\User\Desktop\TestConnectionLog.txt'

Aporte

Columnas del conjunto de resultados

Obtener archivo adjunto¶

Recupera los archivos adjuntos indicados.

Entrada¶

Columnas del conjunto de resultados¶

GetOAuthAccessToken¶

Obtiene un token de autenticación de Outlook.

Entrada¶

Columnas del conjunto de resultados¶

GetOAuthAuthorizationURL¶

Obtiene la URL de autorización que el usuario debe abrir por separado para otorgar acceso a su aplicación. Solo se necesita al desarrollar aplicaciones web. Solicitará el OAuthAccessToken desde esta URL.

Entrada¶

Columnas del conjunto de resultados¶

GetUserOofSettings¶

Proporciona acceso a la configuración OOF de un usuario. Un usuario se identifica por la dirección de correo del usuario. Si el mensaje OOF es nulo y OOF está habilitado, no se envía ningún mensaje OOF.

Entrada¶

Columnas del conjunto de resultados¶