Saltar al contenido

Detalles de Conexión de Microsoft Office 365

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 Office 365

Todas las versiones alojadas de Office 365 son compatibles a través de Microsoft Graph API v1.0. Incluye información accesible desde las ediciones 365 de Exchange/Outlook, Teams, Tasks y OneDrive.

Establecer una Conexión

Conexión a Microsoft Office 365

Autenticación Mediante Microsoft Entra 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.

Uso de la Autenticación OAuth

OAuth requiere que el usuario que se autentica interactúe con Office 365 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 en Office 365 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 OAuth de Office 365 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 fuentes de datos de Office 365 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 en Office 365 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 OAuth de Office 365 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 para Office 365. 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. Seleccione la API de Microsoft Graph y luego seleccione los permisos que buscará su aplicación.
  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 para Office 365 no contiene permisos que requieran el consentimiento del administrador. Por lo tanto, esta información se aplica solo a las aplicaciones personalizadas.

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 para Office 365 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 Office 365. 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

Actualmente, solo se admite el uso de un secreto de cliente para la autenticación.

Obtenga un Token de Acceso OAuth

Está listo para conectarse después de configurar las siguientes propiedades de conexión:

  • 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.

Tareas Administrativas

El conector Jitterbit para Office 365 se puede usar para realizar tareas administrativas. 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.

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 Office 365.

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 Office 365 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 Usando 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 Events 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

El conector modela la API de Office 365 como tablas relacionales. Cualquier cambio en los datos remotos se refleja inmediatamente en sus consultas; las definiciones de la tabla se recuperan dinámicamente. Cuando se conecta, el conector se conecta a Office 365 y obtiene la lista de tablas y los metadatos de las tablas llamando a los servicios web correspondientes.

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.

Mesas

Mesas muestra definiciones de un sitio de Office 365 de ejemplo. El modelo de datos real se obtendrá dinámicamente en función de sus credenciales de usuario y el sitio de Office 365.

Procedimientos almacenados

NOTE: Los procedimientos almacenados no se admiten actualmente. Consulte la nota anterior para detalles.

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

Mesas

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

Por lo general, consultar tablas de Office 365 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 Office 365

Nombre Descripción
Calendars Esta tabla es dinámica y se asigna al campo correspondiente en la API.
Contacts La tabla Contactos de Office365.
Conversations La tabla Conversaciones de Office365.
Events Este campo es dinámico y se asigna al campo correspondiente en la API.
Files Los archivos de la tabla de Office365.
Groups Los grupos de tablas de Office365.
Messages La tabla Mensajes de Office365.
Plans Los planes de mesa de Office365.
Tasks La tabla Tareas de Office365.
Users La tabla de usuarios de Office365.

Calendarios

Esta tabla es dinámica y se asigna al campo correspondiente en la API.

Información Específica de la Tabla
Seleccionar

Puede consultar Calendarios especificando una ID o seleccionando todo:

SELECT * FROM Calendars WHERE ID = 'your Calendar ID goes here'

Seleccione una determinada columna de la entidad y filtre por esa columna:

SELECT ID FROM Calendars WHERE name LIKE 'Calendar%'
Insertar

Especifique un Nombre como mínimo para crear un nuevo Calendario:

INSERT INTO Calendars (Name) VALUES ('John')

Nota: En caso de credenciales de cliente, se requiere ID de usuario para crear un nuevo calendario:

INSERT INTO Calendars(Name, UserId)values('Test123', '92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe');
Columnas
Nombre Tipo Solo lectura Referencias Descripción
id [KEY] String Verdadero Este campo es dinámico y se asigna al campo correspondiente en la API.
Etag String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
allowedOnlineMeetingProviders String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
canEdit Bool Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
canShare Bool Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
canViewPrivateItems Bool Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
changeKey String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
color String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
defaultOnlineMeetingProvider String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
hexColor String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
isDefaultCalendar Bool Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
isRemovable Bool Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
isTallyingResponses Bool Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
name String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
owner_address String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
owner_name String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
UserId [KEY] String Falso La columna UserId para la tabla Calendarios.

Contactos

La tabla Contactos de Office365.

Información Específica de la Tabla
Seleccionar

Puede consultar los contactos especificando una ID o seleccionando todo:

SELECT * FROM Contacts WHERE ID = 'your Contact ID goes here'

Seleccione una determinada columna de la entidad y filtre por esa columna:

SELECT GivenName FROM Contacts WHERE GivenName LIKE 'John%'
Insertar

Especifique un Nombre y un Apellido como mínimo para crear un nuevo Contacto:

INSERT INTO Contacts (GivenName, Surname) VALUES ('John', 'Smith')

Nota: En caso de credenciales de cliente, se requiere ID de usuario para crear un nuevo contacto:

INSERT INTO Contacts (GivenName, Surname, UserId) VALUES ('John', 'Smith', '92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe')
Columnas
Nombre Tipo Solo lectura Referencias Descripción
id [KEY] String Verdadero El identificador único del contacto.
Etag String Falso
categories String Falso Las categorías asociadas con el contacto.
changeKey String Falso Identifica la versión del contacto. Esto cambia cada vez que se cambia el contacto.
createdDateTime Datetime Falso La hora en que se creó el contacto.
lastModifiedDateTime Datetime Falso La hora en que se modificó el contacto por última vez.
assistantName String Falso El nombre del asistente del contacto.
birthday Datetime Falso El cumpleaños del contacto.
businessAddress_city String Falso La ciudad de la dirección comercial del contacto.
businessAddress_countryOrRegion String Falso El país o región de la dirección comercial del contacto.
businessAddress_postalCode String Falso El código postal de la dirección comercial del contacto.
businessAddress_state String Falso El estado de la dirección comercial del contacto.
businessAddress_street String Falso La calle de la dirección comercial del contacto.
businessHomePage String Falso La página de inicio comercial del contacto.
businessPhones String Falso Los números de teléfono de la empresa del contacto.
children String Falso Los nombres de los hijos del contacto.
companyName String Falso El nombre de la empresa del contacto.
department String Falso El departamento del contacto.
displayName String Falso El nombre para mostrar del contacto.
emailAddresses String Falso Una colección de direcciones de correo asociadas con el contacto.
fileAs String Falso El nombre con el que se archiva el contacto.
generation String Falso La generación del contacto.
givenName String Falso El nombre de pila del contacto.
homeAddress_city String Falso La ciudad de la dirección de casa del contacto.
homeAddress_countryOrRegion String Falso El país o la región de la dirección particular del contacto.
homeAddress_postalCode String Falso El código postal de la dirección particular del contacto.
homeAddress_state String Falso El estado de la dirección particular del contacto.
homeAddress_street String Falso La calle de la dirección particular del contacto.
homePhones String Falso Números de teléfono de casa del contacto
imAddresses String Falso La dirección de mensajería instantánea (IM) del contacto.
initials String Falso Las iniciales del contacto.
jobTitle String Falso El cargo del contacto.
manager String Falso El nombre del administrador del contacto.
middleName String Falso El segundo nombre del contacto.
mobilePhone String Falso El número de teléfono móvil del contacto.
nickName String Falso El apodo del contacto.
officeLocation String Falso La ubicación de la dirección del contacto.
otherAddress_city String Falso La ciudad de la otra dirección del cliente.
otherAddress_countryOrRegion String Falso El país o región de la otra dirección del cliente.
otherAddress_postalCode String Falso El código postal de la otra dirección del cliente
otherAddress_state String Falso El estado de la otra dirección del cliente.
otherAddress_street String Falso La calle de la otra dirección del cliente.
parentFolderId String Falso El ID de la carpeta principal del contacto.
personalNotes String Falso Las notas del usuario sobre el contacto.
profession String Falso La profesión del contacto.
spouseName String Falso El nombre del cónyuge/pareja del contacto.
surname String Falso El apellido del contacto.
title String Falso El título del contacto.
yomiCompanyName String Falso El nombre fonético japonés de la empresa del contacto.
yomiGivenName String Falso El nombre fonético japonés (primer nombre) del contacto.
yomiSurname String Falso El apellido fonético japonés (apellido) del contacto.
UserId [KEY] String Falso El ID de usuario del contacto.

Conversaciones

La tabla Conversaciones de Office365.

Información Específica de la Tabla
Seleccionar

Se requiere GroupId para obtener conversaciones grupales.

SELECT * FROM Conversations WHERE GroupId = 'your GroupId goes here'

También puede obtener conversaciones grupales utilizando GroupId y Conversation Id.

SELECT * FROM Conversations WHERE ID = 'conversation ID here' AND GroupId = 'your GroupId goes here'
Insertar

Especifique GroupId, Topic, Content y NewParticipants para crear una nueva conversación. NewParticipants es un tipo complejo. Su formato es el siguiente: 'nombre1, email1; nombre2, correo electrónico2'.

INSERT INTO Conversations (GroupId, Topic, Content, NewParticipants) VALUES ('GroupId here', 'This is a test topic.', 'Hi, How Are you?', 'someone, someone@example.com')
Columnas
Nombre Tipo Solo lectura Referencias Descripción
id [KEY] String Verdadero La columna de ID para la tabla Conversaciones.
Etag String Falso
hasAttachments Bool Falso La columna hasAttachments para la tabla Conversaciones.
lastDeliveredDateTime Datetime Falso La columna lastDeliveredDateTime para la tabla Conversaciones.
preview String Falso La columna de vista previa de la tabla Conversaciones.
topic String Falso La columna de tema para la tabla Conversaciones.
uniqueSenders String Falso La columna uniqueSenders para la tabla Conversaciones.
GroupId [KEY] String Falso La columna GroupId para la tabla Conversaciones.
Content String Falso La columna Contenido de la tabla Conversaciones.
NewParticipants String Falso La columna NewParticipants para la tabla Conversaciones.

Eventos

Este campo es dinámico y se asigna al campo correspondiente en la API.

Información Específica de la Tabla
Seleccionar

La propiedad 'me' se usa de forma predeterminada para devolver eventos.

Puede usar el ID de usuario en la cláusula WHERE para anular esto al buscar eventos.

SELECT * FROM Events WHERE UserId = 'abc123' AND Subject LIKE '%test%'

El GroupId puede ser un ID de tipo de calendario o un ID de grupo. Por ejemplo:

SELECT * FROM Events WHERE GroupId = 'enter your group ID here'
Insertar

Para crear un nuevo evento, se requieren el inicio y el final, incluida la zona horaria.

INSERT INTO Events (Subject, Body_Content, Start_DateTime, Start_TimeZone, End_DateTime, End_TimeZone) VALUES ('New Test Event', 'Event created using Office365Provider', '2016-01-01T10:00:00', 'UTC', '2016-01-01T11:00:00', 'UTC')

Nota: De forma predeterminada, esta declaración creará su evento en el calendario predeterminado.

Nota: En caso de credenciales de cliente, se requiere ID de usuario para crear un nuevo evento:

INSERT INTO Events (Subject, Body_Content, Start_DateTime, Start_TimeZone, End_DateTime, End_TimeZone, UserId) VALUES ('New Test Event', 'Event created using Office365Provider', '2016-01-01T10:00:00', 'UTC', '2016-01-01T11:00:00', 'UTC', '92dfdfc6-f1d4-4965-9f71-30e4da4fa7fe')
Columnas
Nombre Tipo Solo lectura Referencias Descripción
id [KEY] String Verdadero Este campo es dinámico y se asigna al campo correspondiente en la API.
Etag String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
categories String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
changeKey String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
createdDateTime Datetime Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
lastModifiedDateTime Datetime Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
allowNewTimeProposals Bool Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
attendees String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
body_content String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
body_contentType String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
bodyPreview String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
end_dateTime Datetime Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
end_timeZone String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
hasAttachments Bool Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
hideAttendees Bool Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
iCalUId String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
importance String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
isAllDay Bool Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
isCancelled Bool Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
isDraft Bool Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
isOnlineMeeting Bool Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
isOrganizer Bool Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
isReminderOn Bool Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
location_address_city String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
location_address_countryOrRegion String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
location_address_postalCode String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
location_address_state String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
location_address_street String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
location_coordinates_accuracy Double Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
location_coordinates_altitude Double Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
location_coordinates_altitudeAccuracy Double Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
location_coordinates_latitude Double Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
location_coordinates_longitude Double Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
location_displayName String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
location_locationEmailAddress String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
location_locationType String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
location_locationUri String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
location_uniqueId String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
location_uniqueIdType String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
locations String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
onlineMeeting_conferenceId String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
onlineMeeting_joinUrl String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
onlineMeeting_phones String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
onlineMeeting_quickDial String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
onlineMeeting_tollFreeNumbers String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
onlineMeeting_tollNumber String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
onlineMeetingProvider String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
onlineMeetingUrl String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
organizer_emailAddress_address String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
organizer_emailAddress_name String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
originalEndTimeZone String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
originalStart Datetime Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
originalStartTimeZone String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
recurrence_pattern_dayOfMonth Int Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
recurrence_pattern_daysOfWeek String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
recurrence_pattern_firstDayOfWeek String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
recurrence_pattern_index String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
recurrence_pattern_interval Int Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
recurrence_pattern_month Int Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
recurrence_pattern_type String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
recurrence_range_endDate Datetime Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
recurrence_range_numberOfOccurrences Int Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
recurrence_range_recurrenceTimeZone String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
recurrence_range_startDate Datetime Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
recurrence_range_type String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
reminderMinutesBeforeStart Int Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
responseRequested Bool Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
responseStatus_response String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
responseStatus_time Datetime Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
sensitivity String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
seriesMasterId String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
showAs String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
start_dateTime Datetime Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
start_timeZone String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
subject String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
transactionId String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
type String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
webLink String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
UserId String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.
GroupId String Falso Este campo es dinámico y se asigna al campo correspondiente en la API.

Archivos

Los archivos de la tabla de Office365.

Información Específica de la Tabla
Seleccionar

Recupere archivos utilizando el ID de usuario o el ID de archivo (Id), por ejemplo, o simplemente filtre por una columna determinada:

SELECT * FROM Files WHERE UserId = 'MyUserId'

SELECT Name, LastModifiedDateTime FROM Files WHERE Name LIKE 'test%'

Para trabajar con archivos de nivel de carpeta, debemos especificar parentReference_path en la consultar.

SELECT * FROM files WHERE parentReference_path = '/drives/b!3LIvU2zISEqicGlWkgVknKxKT-q7gM5IqlBJ4w4MZqaX6BQc_vtwQpnqaldXkH9I/root:/Test_Shubham';
Insertar

La operación de inserción no es compatible con esta tabla.

Nota: Consulte Subir archivo (o Crear Carpeta para crear una carpeta) para insertar y actualizar el contenido de un archivo.

Columnas
Nombre Tipo Solo lectura Referencias Descripción
id [KEY] String Verdadero La columna de ID para los archivos de la tabla.
Etag String Falso La columna Etag para la tabla Archivos.
createdBy_application_displayName String Falso La columna createdBy_application_displayName para la tabla Archivos.
createdBy_application_id String Falso La columna createdBy_application_id para la tabla Archivos.
createdDateTime Datetime Falso La columna createdDateTime para la tabla Archivos.
description String Falso La columna de descripción de la tabla Archivos.
lastModifiedBy_application_displayName String Falso La columna lastModifiedBy_application_displayName de la tabla Archivos.
lastModifiedBy_application_id String Falso La columna lastModifiedBy_application_id para la tabla Archivos.
lastModifiedDateTime Datetime Falso La columna lastModifiedDateTime para la tabla Archivos.
name String Falso La columna de nombre de la tabla Archivos.
parentReference_driveId String Falso La columna parentReference_driveId para la tabla Archivos.
parentReference_driveType String Falso La columna parentReference_driveType para la tabla Archivos.
parentReference_id String Falso La columna parentReference_id para la tabla Archivos.
parentReference_name String Falso La columna parentReference_name para la tabla Archivos.
parentReference_path String Falso La columna parentReference_path para la tabla Archivos.
parentReference_shareId String Falso La columna parentReference_shareId para la tabla Archivos.
parentReference_sharepointIds_listId String Falso La columna parentReference_sharepointIds_listId para la tabla Archivos.
parentReference_sharepointIds_listItemId String Falso La columna parentReference_sharepointIds_listItemId para la tabla Archivos.
parentReference_sharepointIds_listItemUniqueId String Falso La columna parentReference_sharepointIds_listItemUniqueId para la tabla Archivos.
parentReference_sharepointIds_siteId String Falso La columna parentReference_sharepointIds_siteId para la tabla Archivos.
parentReference_sharepointIds_siteUrl String Falso La columna parentReference_sharepointIds_siteUrl para la tabla Archivos.
parentReference_sharepointIds_tenantId String Falso La columna parentReference_sharepointIds_tenantId para la tabla Archivos.
parentReference_sharepointIds_webId String Falso La columna parentReference_sharepointIds_webId para la tabla Archivos.
parentReference_siteId String Falso La columna parentReference_siteId para la tabla Archivos.
webUrl String Falso La columna webUrl para la tabla Archivos.
audio_album String Falso La columna audio_album para la tabla Archivos.
audio_albumArtist String Falso La columna audio_albumArtist para la tabla Archivos.
audio_artist String Falso La columna audio_artist para la tabla Archivos.
audio_bitrate Long Falso La columna audio_bitrate para la tabla Archivos.
audio_composers String Falso La columna audio_composers para la tabla Archivos.
audio_copyright String Falso La columna audio_copyright para la tabla Archivos.
audio_disc Int Falso La columna audio_disc para la tabla Archivos.
audio_discCount Int Falso La columna audio_discCount para la tabla Archivos.
audio_duration Long Falso La columna audio_duration para la tabla Archivos.
audio_genre String Falso La columna audio_genre para la tabla Archivos.
audio_hasDrm Bool Falso La columna audio_hasDrm para la tabla Archivos.
audio_isVariableBitrate Bool Falso La columna audio_isVariableBitrate para la tabla Archivos.
audio_title String Falso La columna audio_title para la tabla Archivos.
audio_track Int Falso La columna audio_track para la tabla Archivos.
audio_trackCount Int Falso La columna audio_trackCount para la tabla Archivos.
audio_year Int Falso La columna audio_year para la tabla Archivos.
content String Falso La columna de contenido de la tabla Archivos.
cTag String Falso La columna cTag para la tabla Archivos.
deleted_state String Falso La columna delete_state para la tabla Archivos.
file_hashes_crc32Hash String Falso La columna file_hashes_crc32Hash para la tabla Archivos.
file_hashes_quickXorHash String Falso La columna file_hashes_quickXorHash para la tabla Archivos.
file_hashes_sha1Hash String Falso La columna file_hashes_sha1Hash para la tabla Archivos.
file_hashes_sha256Hash String Falso La columna file_hashes_sha256Hash para la tabla Archivos.
file_mimeType String Falso La columna file_mimeType para la tabla Archivos.
file_processingMetadata Bool Falso La columna file_processingMetadata para la tabla Archivos.
fileSystemInfo_createdDateTime Datetime Falso La columna fileSystemInfo_createdDateTime para la tabla Archivos.
fileSystemInfo_lastAccessedDateTime Datetime Falso La columna fileSystemInfo_lastAccessedDateTime para la tabla Archivos.
fileSystemInfo_lastModifiedDateTime Datetime Falso La columna fileSystemInfo_lastModifiedDateTime para la tabla Archivos.
folder_childCount Int Falso La columna folder_childCount para la tabla Archivos.
folder_view_sortBy String Falso La columna folder_view_sortBy para la tabla Archivos.
folder_view_sortOrder String Falso La columna folder_view_sortOrder para la tabla Archivos.
folder_view_viewType String Falso La columna folder_view_viewType para la tabla Archivos.
image_height Int Falso La columna image_height para la tabla Archivos.
image_width Int Falso La columna image_width para la tabla Archivos.
location_altitude Double Falso La columna location_altitude para la tabla Archivos.
location_latitude Double Falso La columna location_latitude para la tabla Archivos.
location_longitude Double Falso La columna location_longitude para la tabla Archivos.
package_type String Falso La columna tipo_paquete para la tabla Archivos.
pendingOperations_pendingContentUpdate_queuedDateTime Datetime Falso La columnapendienteOperations_pendingContentUpdate_queuedDateTime para la tabla Archivos.
photo_cameraMake String Falso La columna photo_cameraMake para la tabla Archivos.
photo_cameraModel String Falso La columna photo_cameraModel para la tabla Archivos.
photo_exposureDenominator Double Falso La columna photo_exposureDenominator para la tabla Archivos.
photo_exposureNumerator Double Falso La columna photo_exposureNumerator para la tabla Archivos.
photo_fNumber Double Falso La columna photo_fNumber para la tabla Archivos.
photo_focalLength Double Falso La columna photo_focalLength para la tabla Archivos.
photo_iso Int Falso La columna photo_iso para la tabla Archivos.
photo_orientation Int Falso La columna photo_orientation para la tabla Archivos.
photo_takenDateTime Datetime Falso La columna photo_takenDateTime para la tabla Archivos.
publication_level String Falso La columna nivel_publicación de la tabla Archivos.
publication_versionId String Falso La columna publishing_versionId para la tabla Archivos.
remoteItem_createdBy_application_displayName String Falso La columna remoteItem_createdBy_application_displayName de la tabla Archivos.
remoteItem_createdBy_application_id String Falso La columna remoteItem_createdBy_application_id para los archivos de la tabla.
remoteItem_createdDateTime Datetime Falso La columna remoteItem_createdDateTime para la tabla Archivos.
remoteItem_file_hashes_crc32Hash String Falso La columna remoteItem_file_hashes_crc32Hash para los archivos de la tabla.
remoteItem_file_hashes_quickXorHash String Falso La columna remoteItem_file_hashes_quickXorHash para los archivos de la tabla.
remoteItem_file_hashes_sha1Hash String Falso La columna remoteItem_file_hashes_sha1Hash para los archivos de la tabla.
remoteItem_file_hashes_sha256Hash String Falso La columna remoteItem_file_hashes_sha256Hash para los archivos de la tabla.
remoteItem_file_mimeType String Falso La columna remoteItem_file_mimeType para la tabla Archivos.
remoteItem_file_processingMetadata Bool Falso La columna remoteItem_file_processingMetadata para los archivos de la tabla.
remoteItem_fileSystemInfo_createdDateTime Datetime Falso La columna remoteItem_fileSystemInfo_createdDateTime para la tabla Archivos.
remoteItem_fileSystemInfo_lastAccessedDateTime Datetime Falso La columna remoteItem_fileSystemInfo_lastAccessedDateTime para la tabla Archivos.
remoteItem_fileSystemInfo_lastModifiedDateTime Datetime Falso La columna remoteItem_fileSystemInfo_lastModifiedDateTime para la tabla Archivos.
remoteItem_folder_childCount Int Falso La columna remoteItem_folder_childCount para la tabla Archivos.
remoteItem_folder_view_sortBy String Falso La columna remoteItem_folder_view_sortBy para la tabla Archivos.
remoteItem_folder_view_sortOrder String Falso La columna remoteItem_folder_view_sortOrder para la tabla Archivos.
remoteItem_folder_view_viewType String Falso La columna remoteItem_folder_view_viewType para los archivos de la tabla.
remoteItem_id String Falso La columna remoteItem_id para la tabla Archivos.
remoteItem_image_height Int Falso La columna remoteItem_image_height para los archivos de la tabla.
remoteItem_image_width Int Falso La columna remoteItem_image_width para los archivos de la tabla.
remoteItem_lastModifiedDateTime Datetime Falso La columna remoteItem_lastModifiedDateTime para la tabla Archivos.
remoteItem_name String Falso La columna remoteItem_name para la tabla Archivos.
remoteItem_package_type String Falso La columna remoteItem_package_type para la tabla Archivos.
remoteItem_parentReference_driveId String Falso La columna remoteItem_parentReference_driveId para los archivos de la tabla.
remoteItem_parentReference_driveType String Falso La columna remoteItem_parentReference_driveType para la tabla Archivos.
remoteItem_parentReference_id String Falso La columna remoteItem_parentReference_id para la tabla Archivos.
remoteItem_parentReference_name String Falso La columna remoteItem_parentReference_name para la tabla Archivos.
remoteItem_parentReference_path String Falso La columna remoteItem_parentReference_path para la tabla Archivos.
remoteItem_parentReference_shareId String Falso La columna remoteItem_parentReference_shareId para los archivos de la tabla.
remoteItem_parentReference_sharepointIds_listId String Falso La columna remoteItem_parentReference_sharepointIds_listId para la tabla Archivos.
remoteItem_parentReference_sharepointIds_listItemId String Falso La columna remoteItem_parentReference_sharepointIds_listItemId para la tabla Archivos.
remoteItem_parentReference_sharepointIds_listItemUniqueId String Falso La columna remoteItem_parentReference_sharepointIds_listItemUniqueId para la tabla Archivos.
remoteItem_parentReference_sharepointIds_siteId String Falso La columna remoteItem_parentReference_sharepointIds_siteId para los archivos de la tabla.
remoteItem_parentReference_sharepointIds_siteUrl String Falso La columna remoteItem_parentReference_sharepointIds_siteUrl para la tabla Archivos.
remoteItem_parentReference_sharepointIds_tenantId String Falso La columna remoteItem_parentReference_sharepointIds_tenantId para la tabla Archivos.
remoteItem_parentReference_sharepointIds_webId String Falso La columna remoteItem_parentReference_sharepointIds_webId para los archivos de la tabla.
remoteItem_parentReference_siteId String Falso La columna remoteItem_parentReference_siteId para la tabla Archivos.
remoteItem_shared_scope String Falso La columna remoteItem_shared_scope para la tabla Archivos.
remoteItem_shared_sharedDateTime Datetime Falso La columna remoteItem_shared_sharedDateTime para la tabla Archivos.
remoteItem_size Long Falso La columna remoteItem_size para la tabla Archivos.
remoteItem_specialFolder_name String Falso La columna remoteItem_specialFolder_name para la tabla Archivos.
remoteItem_video_audioBitsPerSample Int Falso La columna remoteItem_video_audioBitsPerSample para los archivos de la tabla.
remoteItem_video_audioChannels Int Falso La columna remoteItem_video_audioChannels para la tabla Archivos.
remoteItem_video_audioSamplesPerSecond Int Falso La columna remoteItem_video_audioSamplesPerSecond para la tabla Archivos.
remoteItem_video_bitrate Int Falso La columna remoteItem_video_bitrate para la tabla Archivos.
remoteItem_video_duration Long Falso La columna remoteItem_video_duration para la tabla Archivos.
remoteItem_video_fourCC String Falso La columna remoteItem_video_fourCC para la tabla Archivos.
remoteItem_video_frameRate Double Falso La columna remoteItem_video_frameRate para la tabla Archivos.
remoteItem_video_height Int Falso La columna remoteItem_video_height para la tabla Archivos.
remoteItem_video_width Int Falso La columna remoteItem_video_width para la tabla Archivos.
remoteItem_webDavUrl String Falso La columna remoteItem_webDavUrl para la tabla Archivos.
remoteItem_webUrl String Falso La columna remoteItem_webUrl para la tabla Archivos.
searchResult_onClickTelemetryUrl String Falso La columna searchResult_onClickTelemetryUrl para la tabla Archivos.
shared_owner_application_displayName String Falso La columna shared_owner_application_displayName de la tabla Archivos.
shared_owner_application_id String Falso La columna shared_owner_application_id para la tabla Archivos.
shared_scope String Falso La columna shared_scope para la tabla Archivos.
shared_sharedDateTime Datetime Falso La columna shared_sharedDateTime para la tabla Archivos.
sharepointIds_listId String Falso La columna sharepointIds_listId para la tabla Archivos.
sharepointIds_listItemId String Falso La columna sharepointIds_listItemId para la tabla Archivos.
sharepointIds_listItemUniqueId String Falso La columna sharepointIds_listItemUniqueId para la tabla Archivos.
sharepointIds_siteId String Falso La columna sharepointIds_siteId para la tabla Archivos.
sharepointIds_siteUrl String Falso La columna sharepointIds_siteUrl para la tabla Archivos.
sharepointIds_tenantId String Falso La columna sharepointIds_tenantId para la tabla Archivos.
sharepointIds_webId String Falso La columna sharepointIds_webId para la tabla Archivos.
size Long Falso La columna de tamaño para los archivos de la tabla.
specialFolder_name String Falso La columna specialFolder_name para la tabla Archivos.
video_audioBitsPerSample Int Falso La columna video_audioBitsPerSample para la tabla Archivos.
video_audioChannels Int Falso La columna video_audioChannels para la tabla Archivos.
video_audioFormat String Falso La columna video_audioFormat para la tabla Archivos.
video_audioSamplesPerSecond Int Falso La columna video_audioSamplesPerSecond para la tabla Archivos.
video_bitrate Int Falso La columna video_bitrate para la tabla Archivos.
video_duration Long Falso La columna video_duration para la tabla Archivos.
video_fourCC String Falso La columna video_fourCC para la tabla Archivos.
video_frameRate Double Falso La columna video_frameRate para la tabla Archivos.
video_height Int Falso La columna video_height para la tabla Archivos.
video_width Int Falso La columna video_width para la tabla Archivos.
webDavUrl String Falso La columna webDavUrl para la tabla Archivos.
UserId String Falso La columna UserId para la tabla Archivos.

Grupos

Los grupos de tablas de Office365.

Información Específica de la Tabla

Los grupos requieren permisos de administrador. Para trabajar con ellos, debe crear su propia aplicación OAuth personalizada y configurar el apropiadoOAuthClientId y OAuthClientSecret. En esta aplicación, debe configurarla para solicitar los permisos Group.Read.All y Group.ReadWrite.All. Esto se puede hacer en https://apps.dev.microsoft.com, o en el panel Registros de aplicaciones en http://portal.azure.com. Consulte Credenciales personalizadas para obtener más detalles sobre cómo crear una aplicación personalizada.

Para autorizar permisos de Grupos, un administrador debe otorgar permisos de Grupos para su organización en general. Esto se puede hacer a través del extremo de autorización del administrador. Simplemente haga que el administrador navegue a la siguiente página web y otorgue permisos. Luego ejecute la autorización de OAuth como de costumbre.

https://login.microsoftonline.com/common/adminconsent?client_id=[YourClientId]&redirect_uri=http://localhost:33333

Tenga en cuenta que si su organización tiene varios inquilinos, puede reemplazar /common/ en la URL con la identificación del inquilino para indicar a qué inquilino otorgar permisos.

Seleccionar

Recupere todos los grupos, especifique un GroupId (Id) o simplemente filtre por una determinada columna:

SELECT * FROM Groups
SELECT * FROM Groups WHERE Id = 'Group Id here'
SELECT Id, Description, DisplayName FROM Groups WHERE Name = 'test'
Insertar

Se requiere lo siguiente para crear un nuevo grupo de seguridad:

INSERT INTO Groups (DisplayName, MailEnabled, MailNickname, SecurityEnabled) VALUES ('Test group', false, 'test', true)
Columnas
Nombre Tipo Solo lectura Referencias Descripción
id [KEY] String Verdadero El identificador único para el grupo.
Etag String Falso
deletedDateTime Datetime Falso
allowExternalSenders Bool Falso Indica si personas externas a la organización pueden enviar mensajes al grupo.
assignedLabels String Falso
assignedLicenses String Falso
autoSubscribeNewMembers Bool Falso Indica si los nuevos miembros agregados al grupo se suscribirán automáticamente para recibir notificaciones correo.
classification String Falso
createdDateTime Datetime Falso
description String Falso Una descripción opcional para el grupo.
displayName String Falso El nombre para mostrar del grupo.
expirationDateTime Datetime Falso
groupTypes String Falso Especifica el tipo de grupo que se va a crear. Los valores posibles son Unificado para crear un grupo de Office 365 o DynamicMembership para grupos dinámicos. Para todos los demás tipos de grupos, como grupos con seguridad habilitada y grupos de seguridad habilitados para correo electrónico, no establezca esta propiedad.
hasMembersWithLicenseErrors Bool Falso
hideFromAddressLists Bool Falso
hideFromOutlookClients Bool Falso
isArchived Bool Falso
isSubscribedByMail Bool Falso Indica si el usuario actual está suscrito para recibir conversaciones correo.
licenseProcessingState_state String Falso
mail String Falso La dirección SMTP del grupo.
mailEnabled Bool Falso Especifica si el grupo está habilitado para correo. Si la propiedad securityEnabled también es verdadera, el grupo es un grupo de seguridad habilitado para correo; de lo contrario, el grupo es un grupo de distribución de Microsoft Exchange.
mailNickname String Falso El alias de correo del grupo, único en la organización.
membershipRule String Falso
membershipRuleProcessingState String Falso
onPremisesDomainName String Falso
onPremisesLastSyncDateTime Datetime Falso Indica la última vez que se sincronizó el grupo con el directorio local.
onPremisesNetBiosName String Falso
onPremisesProvisioningErrors String Falso
onPremisesSamAccountName String Falso
onPremisesSecurityIdentifier String Falso Contiene el identificador de seguridad (SID) local para el grupo que se sincronizó desde el local a la nube.
onPremisesSyncEnabled Bool Falso True si este grupo se sincroniza desde un directorio local; falso si este grupo se sincronizó originalmente desde un directorio local pero ya no está sincronizado; null si este objeto nunca se ha sincronizado desde un directorio local.
preferredDataLocation String Falso
preferredLanguage String Falso
proxyAddresses String Falso Las direcciones de proxy para los grupos de tablas.
renewedDateTime Datetime Falso
securityEnabled Bool Falso Especifica si el grupo es un grupo de seguridad. Si la propiedad mailEnabled también es verdadera, el grupo es un grupo de seguridad habilitado para correo; de lo contrario, es un grupo de seguridad. Debe ser falso para los grupos de Office 365.
securityIdentifier String Falso
theme String Falso
unseenCount Int Falso Recuento de publicaciones que el usuario actual no ha visto desde su última visita.
visibility String Falso Especifica la visibilidad de un grupo de Office 365. Los valores posibles son: Private, Public, HiddenMembership o vacío (que se interpreta como Public).

Mensajes

La tabla Mensajes de Office365.

Información Específica de la Tabla
Seleccionar

Puede recuperar todo de Mensajes, especificar un Mensaje (Id), UserId o ParentFolderId, o puede filtrar los resultados por una determinada columna:

SELECT * FROM Messages
SELECT * FROM Messages WHERE Id = 'MyMessageId'

SELECT * FROM Messages WHERE UserId = 'MyUserId'

SELECT * FROM Messages WHERE ParentFolderId = 'MyParentfolderId' 
SELECT * FROM Messages WHERE ParentFolderId = 'Drafts'
SELECT DisplayName, ID FROM Users WHERE DisplayName LIKE 'John%'
Insertar

Después de la inserción, se creará un nuevo mensaje en la carpeta Borradores del usuario.

INSERT INTO Messages (Subject, Body_Content, UserId) VALUES ('New test Email', 'Test Email created.', 'User ID goes here')

Nota: Para enviar el correo, consulte SendMail.

Problemas Conocidos

Actualmente hay un problema con esta tabla. A veces puede devolver un número inconsistente de resultados. Es decir, puede devolver un número X de filas para alguna consultar y si vuelve a intentar esa consultar poco después, devolverá un número diferente de filas, aunque no haya cambiado nada. Es posible que falten algunas filas.
Este es un problema conocido de API que actualmente no tiene solución. Tan pronto como Microsoft lo arregle en su API de Microsoft Graph, también funcionará automáticamente en este conector.

Dicho esto, hay una configuración que puede aplicar en el conector para recuperar todos los mensajes, pero tiene un inconveniente: los datos de 'eventos' y 'contactos' se devolverán junto con los datos de 'mensajes'. Así que no garantizamos la pureza de la información. Tendrá que confiar en su propio filtrado para distinguir entre las filas de mensajes y las que no son de mensajes.

Para activar la configuración simplemente agregue "ClientSidePaging=true;" (sin comillas) en el valor de Other propiedad de conexión.

Columnas
Nombre Tipo Solo lectura Referencias Descripción
id [KEY] String Verdadero La columna ID de la tabla Mensajes.
Etag String Falso La columna Etag de la tabla Mensajes.
categories String Falso La columna de categorías de la tabla Mensajes.
changeKey String Falso La columna changeKey de la tabla de mensajes.
createdDateTime Datetime Falso La columna createdDateTime de la tabla Messages.
lastModifiedDateTime Datetime Falso La columna lastModifiedDateTime de la tabla Messages.
bccRecipients String Falso La columna bccRecipients de la tabla Messages.
body_content String Falso La columna body_content de la tabla Mensajes.
body_contentType String Falso La columna body_contentType de la tabla Mensajes.
bodyPreview String Falso La columna bodyPreview de la tabla Mensajes.
ccRecipients String Falso La columna ccRecipients de la tabla Messages.
conversationId String Falso La columna conversacionId de la tabla Mensajes.
conversationIndex Binary Falso La columna de índice de conversación de la tabla Mensajes.
flag_completedDateTime_dateTime Datetime Falso La columna flag_completedDateTime_dateTime de la tabla de mensajes.
flag_completedDateTime_timeZone String Falso La columna flag_completedDateTime_timeZone de la tabla de mensajes.
flag_flagStatus String Falso La columna flag_flagStatus de la tabla Mensajes.
from_emailAddress_address String Falso La columna from_emailAddress_address de la tabla Mensajes.
from_emailAddress_name String Falso La columna from_emailAddress_name de la tabla Mensajes.
hasAttachments Bool Falso La columna hasAttachments de la tabla Messages.
importance String Falso La columna de importancia de la tabla Mensajes.
inferenceClassification String Falso La columna inferenceClassification de la tabla Messages.
internetMessageHeaders String Falso La columna internetMessageHeaders de la tabla Messages.
internetMessageId String Falso La columna internetMessageId de la tabla Mensajes.
isDeliveryReceiptRequested Bool Falso La columna isDeliveryReceiptRequested de la tabla de mensajes.
isDraft Bool Falso La columna isDraft de la tabla Mensajes.
isRead Bool Falso La columna isRead de la tabla Messages.
isReadReceiptRequested Bool Falso La columna isReadReceiptRequested de la tabla de mensajes.
parentFolderId String Falso La columna parentFolderId de la tabla Messages.
receivedDateTime Datetime Falso La columna de fecha y hora de recepción de la tabla de mensajes.
replyTo String Falso La columna responder a de la tabla Mensajes.
sender_emailAddress_address String Falso La columna sender_emailAddress_address de la tabla Mensajes.
sender_emailAddress_name String Falso La columna sender_emailAddress_name de la tabla Mensajes.
sentDateTime Datetime Falso La columna sentDateTime de la tabla Messages.
subject String Falso La columna de asunto de la tabla Mensajes.
toRecipients String Falso La columna toRecipients de la tabla Messages.
uniqueBody_content String Falso La columna uniqueBody_content de la tabla Messages.
uniqueBody_contentType String Falso La columna uniqueBody_contentType de la tabla Messages.
webLink String Falso La columna webLink de la tabla Mensajes.
UserId String Falso La columna UserId de la tabla Messages.
IsEventMessage Bool Falso La columna para distinguir si los mensajes son con calendario/invitaciones a eventos

Planes

Los planes de mesa de Office365.

Información Específica de la Tabla

El uso de Planes requiere acceso a los permisos de Grupos. Esto requiere la aprobación del administrador. Por este motivo, debe usar su propia aplicación OAuth para agregar los permisos de Grupos y desde Microsoft Graph. Consulte Crear una aplicación OAuth personalizada para más detalles.

Seleccionar

Todos los planes en MS Planner existen como parte de un grupo. Para recuperar la lista de planes disponibles, debe recuperar una lista de planes disponibles por grupo. Si no se especifica GroupId, la siguiente condición WHERE se agregará a cualquier consultar:

GroupId IN (SELECT ID FROM Groups)
Columnas
Nombre Tipo Solo lectura Referencias Descripción
createdBy_application_displayName String Falso La columna createdBy_application_displayName de la tabla Planes.
createdBy_application_id String Falso La columna createdBy_application_id para la tabla Planes.
createdDateTime Datetime Falso La columna createdDateTime para la tabla Planes.
owner String Falso La columna propietaria de la tabla Planes.
title String Falso La columna de título de la tabla Planes.
GroupId [KEY] String Falso La columna GroupId para la tabla Planes.

Tareas

La tabla Tareas de Office365.

Información Específica de la Tabla

Tareas requiere los permisos de Grupos y Tareas de Microsoft Graph. Por este motivo, debe crear su propia aplicación OAuth. Consulte Creación de una aplicación OAuth personalizada para más detalles.

Seleccionar

De forma predeterminada, si no se especifica ningún criterio, solo se mostrarán las tareas que se le hayan asignado personalmente. Por ejemplo:

SELECT * FROM Tasks

Para recuperar tareas en toda la organización, proporcione los ID de planes específicos o utilice una subselección para el ID de plan. Por ejemplo:

SELECT * FROM Tasks WHERE PlanId IN (SELECT ID FROM Plans)
Insertar

Para insertar una Tarea, se debe especificar el plan asociado:

INSERT INTO Tasks (Title, PlanId) VALUES ('My Title', '99999999-eeeeeeeee')
Actualizar

Para actualizar una Tarea, se debe especificar tanto el ID como el Etag:

UPDATE Tasks SET Title='New Title' WHERE ID = 'xxxxxx-AAAAAAAAAAA' AND Etag='W/\"XXXXXXQEBAQEBAQEBAQEBAQEBARCc=\"'
Borrar

Para eliminar una Tarea, se debe especificar tanto el ID como el Etag:

DELETE FROM Tasks WHERE ID = 'xxxxxx-AAAAAAAAAAA' AND Etag='W/\"XXXXXXQEBAQEBAQEBAQEBAQEBARCc=\"'
Columnas
Nombre Tipo Solo lectura Referencias Descripción
activeChecklistItemCount Int Falso La columna activeChecklistItemCount para la tabla Tareas.
assigneePriority String Falso La columna AssigneePriority para la tabla Tareas.
bucketId String Falso La columna bucketId para la tabla Tareas.
checklistItemCount Int Falso La columna checklistItemCount para la tabla Tareas.
completedBy_application_displayName String Falso La columna completeBy_application_displayName de la tabla Tareas.
completedBy_application_id String Falso La columna completeBy_application_id para la tabla Tareas.
completedDateTime Datetime Falso La columna de fecha y hora completada para las tareas de la tabla.
conversationThreadId String Falso La columna conversacionThreadId para la tabla Tareas.
createdBy_application_displayName String Falso La columna createdBy_application_displayName para la tabla Tareas.
createdBy_application_id String Falso La columna createdBy_application_id para la tabla Tareas.
createdDateTime Datetime Falso La columna createdDateTime para la tabla Tasks.
dueDateTime Datetime Falso La columna dueDateTime para la tabla Tareas.
hasDescription Bool Falso La columna hasDescription para la tabla Tareas.
orderHint String Falso La columna orderHint para la tabla Tareas.
percentComplete Int Falso La columna percentComplete para la tabla Tareas.
planId String Falso La columna planId para las tareas de la tabla.
previewType String Falso La columna previewType para la tabla Tasks.
referenceCount Int Falso La columna referenceCount para las tareas de la tabla.
startDateTime Datetime Falso La columna startDateTime para la tabla Tareas.
title String Falso La columna de título de la tabla Tareas.
Etag [KEY] String Falso La columna Etag para la tabla Tareas.

Usuarios

La tabla de usuarios de Office365.

Información Específica de la Tabla
Seleccionar

Consulte la tabla de usuarios recuperando todo de los usuarios, especificando una identificación o filtrando por una columna:

SELECT * FROM Users WHERE Id = '616391f0-32d8-4127-8f25-aa55771d6617'

SELECT DisplayName, ID FROM Users WHERE DisplayName LIKE 'John%'
Insertar

Se requiere lo siguiente para crear un nuevo usuario organizacional:

INSERT INTO Users (AccountEnabled, DisplayName, MailNickname, UserPrincipalName, PasswordProfile_ForceChangePasswordNextSignIn, PasswordProfile_Password) VALUES (false, 'John Smith', 'JohnS', 'smithjohn@yourcompanydomain.com', true, '123password')
Columnas
Nombre Tipo Solo lectura Referencias Descripción
id [KEY] String Verdadero
Etag String Falso
deletedDateTime Datetime Falso
accountEnabled Bool Falso
ageGroup String Falso
assignedLicenses String Falso
assignedPlans String Falso
businessPhones String Falso
city String Falso
companyName String Falso
consentProvidedForMinor String Falso
country String Falso
createdDateTime Datetime Falso
creationType String Falso
department String Falso
displayName String Falso
employeeHireDate Datetime Falso
employeeId String Falso
employeeOrgData_costCenter String Falso
employeeOrgData_division String Falso
employeeType String Falso
externalUserState String Falso
externalUserStateChangeDateTime Datetime Falso
faxNumber String Falso
givenName String Falso
identities String Falso
imAddresses String Falso
isResourceAccount Bool Falso
jobTitle String Falso
lastPasswordChangeDateTime Datetime Falso
legalAgeGroupClassification String Falso
licenseAssignmentStates String Falso
mailNickname String Falso
mobilePhone String Falso
officeLocation String Falso
onPremisesDistinguishedName String Falso
onPremisesDomainName String Falso
onPremisesImmutableId String Falso
onPremisesLastSyncDateTime Datetime Falso
onPremisesProvisioningErrors String Falso
onPremisesSamAccountName String Falso
onPremisesSecurityIdentifier String Falso
onPremisesSyncEnabled Bool Falso
onPremisesUserPrincipalName String Falso
otherMails String Falso
passwordPolicies String Falso
passwordProfile_forceChangePasswordNextSignIn Bool Falso
passwordProfile_forceChangePasswordNextSignInWithMfa Bool Falso
passwordProfile_password String Falso
postalCode String Falso
preferredLanguage String Falso
provisionedPlans String Falso
proxyAddresses String Falso
showInAddressList Bool Falso
signInSessionsValidFromDateTime Datetime Falso
state String Falso
streetAddress String Falso
surname String Falso
usageLocation String Falso
userPrincipalName String Falso
userType String Falso

Puntos de Vista

Las vistas se componen de columnas y pseudocolumnas. Las vistas son similares a las tablas en la forma en que se representan los datos; sin embargo, las vistas no admiten actualizaciones. Las entidades que se representan como vistas suelen ser entidades de solo lectura. A menudo, un procedimiento almacenado* está disponible para actualizar los datos si dicha funcionalidad es aplicable a la fuente de datos.

Las consultas se pueden ejecutar contra una vista como si fuera una tabla normal, y los datos que regresan son similares en ese sentido. Para obtener más información sobre las tablas y los procedimientos almacenados, vaya a sus entradas correspondientes en este documento de ayuda.

Conector Jitterbit para Vistas de Office 365

Nombre Descripción
CalendarView Recupere las ocurrencias, excepciones e instancias únicas de eventos en una vista de calendario definida por un intervalo de tiempo, desde el calendario predeterminado del usuario o desde algún otro calendario del usuario.
EventOccurrences Información de uso para la operación EventOccurrences.rsd.

Vista de Calendario

Recupere las ocurrencias, excepciones e instancias únicas de eventos en una vista de calendario definida por un intervalo de tiempo, desde el calendario predeterminado del usuario o desde algún otro calendario del usuario.

Información Específica de la Tabla
Seleccionar

Obtenga las ocurrencias, excepciones e instancias únicas de eventos en una vista de calendario definida por un rango de tiempo, desde el calendario predeterminado del usuario o desde algún otro calendario del usuario. De manera predeterminada, solo se devolverán las ocurrencias de eventos del calendario predeterminado del usuario en el rango de los últimos 30 días. Puede filtrar los resultados por CalendarId, UserId, Start_DateTime, End_DateTime.

Por ejemplo, las siguientes consultas se procesarán del lado del servidor:

Select * FROM CalendarView Where Start_DateTime>='2019-12-10 15:00' AND End_DateTime<='2020-01-10 14:30'
SELECT * FROM CalendarView Where CalendarId='AQMkAGRlMWQ5MDg0LWI5ZTQtNDk2Yi1hOTQ1LTU4YzFmMzEwZjlhMgBGAAAD-FjxR3cIwE6TEGSCVtIHcwcAQyR2Iw3coEOaUD1BLt0tnAAAAwcAAABDJHYjDdygQ5pQPUEu3S2cAAACC_IAAAA='
SELECT * from CalendarView Where CalendarId='AQMkAGRlMWQ5MDg0LWI5ZTQtNDk2Yi1hOTQ1LTU4YzFmMzEwZjlhMgBGAAAD-FjxR3cIwE6TEGSCVtIHcwcAQyR2Iw3coEOaUD1BLt0tnAAAAwcAAABDJHYjDdygQ5pQPUEu3S2cAAACC_IAAAA=' And UserId='a98f25b5-5da1-4937-8729-c0d03026caa0' AND Start_DateTime>='2019-12-15 08:00' AND End_DateTime<='2020-01-14 08:00'
Columnas
Nombre Tipo Referencias Descripción
id [KEY] String
Etag String
categories String
changeKey String
createdDateTime Datetime
lastModifiedDateTime Datetime
allowNewTimeProposals Bool
attendees String
body_content String
body_contentType String
bodyPreview String
end_dateTime Datetime
end_timeZone String
hasAttachments Bool
hideAttendees Bool
iCalUId String
importance String
isAllDay Bool
isCancelled Bool
isDraft Bool
isOnlineMeeting Bool
isOrganizer Bool
isReminderOn Bool
location_address_city String
location_address_countryOrRegion String
location_address_postalCode String
location_address_state String
location_address_street String
location_coordinates_accuracy Double
location_coordinates_altitude Double
location_coordinates_altitudeAccuracy Double
location_coordinates_latitude Double
location_coordinates_longitude Double
location_displayName String
location_locationEmailAddress String
location_locationType String
location_locationUri String
location_uniqueId String
location_uniqueIdType String
locations String
onlineMeeting_conferenceId String
onlineMeeting_joinUrl String
onlineMeeting_phones String
onlineMeeting_quickDial String
onlineMeeting_tollFreeNumbers String
onlineMeeting_tollNumber String
onlineMeetingProvider String
onlineMeetingUrl String
organizer_emailAddress_address String
organizer_emailAddress_name String
originalEndTimeZone String
originalStart Datetime
originalStartTimeZone String
recurrence_pattern_dayOfMonth Int
recurrence_pattern_daysOfWeek String
recurrence_pattern_firstDayOfWeek String
recurrence_pattern_index String
recurrence_pattern_interval Int
recurrence_pattern_month Int
recurrence_pattern_type String
recurrence_range_endDate Datetime
recurrence_range_numberOfOccurrences Int
recurrence_range_recurrenceTimeZone String
recurrence_range_startDate Datetime
recurrence_range_type String
reminderMinutesBeforeStart Int
responseRequested Bool
responseStatus_response String
responseStatus_time Datetime
sensitivity String
seriesMasterId String
showAs String
start_dateTime Datetime
start_timeZone String
subject String
transactionId String
type String
webLink String
UserId String
CalendarId String

EventoOcurrencias

Información de uso para la operación EventOccurrences.rsd.

Información Específica de la Tabla
Seleccionar

Puede consultar EventOccurrences especificando el Id. de evento, StartDatetime y EndDateTime. EventId es un campo obligatorio; en su lugar, StartDatetime y EndDateTime tienen un rango predeterminado de los últimos 30 días. Si consultar el filtrado solo por EventId y el evento específico no existe dentro de este rango de tiempo, obtendrá resultados vacíos.

SELECT * FROM [Ocurrencias de eventos] WHERE id='event id' AND StartDateTime='2018/01/01' AND EndDateTime='2018/12/31'

De forma predeterminada, si no se especifican los filtros StartDateTime y EndDateTime, solo se devolverán las ocurrencias de eventos del calendario predeterminado del usuario en el rango de los últimos 30 días. De lo contrario, la consultar obtendrá las ocurrencias del evento durante el período especificado por StartDateTime y EndDateTime.

Columnas
Nombre Tipo Referencias Descripción
GroupId String
UserId String
Events_id [KEY] String Eventos.id
id [KEY] String
categories String
changeKey String
createdDateTime Datetime
lastModifiedDateTime Datetime
allowNewTimeProposals Bool
attendees String
body_content String
body_contentType String
bodyPreview String
end_dateTime Datetime
end_timeZone String
hasAttachments Bool
hideAttendees Bool
iCalUId String
importance String
isAllDay Bool
isCancelled Bool
isDraft Bool
isOnlineMeeting Bool
isOrganizer Bool
isReminderOn Bool
location_address_city String
location_address_countryOrRegion String
location_address_postalCode String
location_address_state String
location_address_street String
location_coordinates_accuracy Double
location_coordinates_altitude Double
location_coordinates_altitudeAccuracy Double
location_coordinates_latitude Double
location_coordinates_longitude Double
location_displayName String
location_locationEmailAddress String
location_locationType String
location_locationUri String
location_uniqueId String
location_uniqueIdType String
locations String
onlineMeeting_conferenceId String
onlineMeeting_joinUrl String
onlineMeeting_phones String
onlineMeeting_quickDial String
onlineMeeting_tollFreeNumbers String
onlineMeeting_tollNumber String
onlineMeetingProvider String
onlineMeetingUrl String
organizer_emailAddress_address String
organizer_emailAddress_name String
originalEndTimeZone String
originalStart Datetime
originalStartTimeZone String
recurrence_pattern_dayOfMonth Int
recurrence_pattern_daysOfWeek String
recurrence_pattern_firstDayOfWeek String
recurrence_pattern_index String
recurrence_pattern_interval Int
recurrence_pattern_month Int
recurrence_pattern_type String
recurrence_range_endDate Datetime
recurrence_range_numberOfOccurrences Int
recurrence_range_recurrenceTimeZone String
recurrence_range_startDate Datetime
recurrence_range_type String
reminderMinutesBeforeStart Int
responseRequested Bool
responseStatus_response String
responseStatus_time Datetime
sensitivity String
seriesMasterId String
showAs String
start_dateTime Datetime
start_timeZone String
subject String
transactionId String
type String
webLink String

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 Office 365

Nombre Descripción
AssignLicense Agregue o elimine suscripciones para el usuario. También puede habilitar y deshabilitar planes específicos asociados con una suscripción
CancelEvent Cancela un evento.
CreateFolder Cargue un archivo nuevo o actualice el contenido de un archivo existente.
CreateSchema Crea un archivo de esquema para la tabla o vista especificada.
DownloadAttachments Descargar los archivos adjuntos de un correo
DownloadEmail Descargar el Correo
DownloadFile Descarga el archivo
ForwardEvent Reenviar eventos a los destinatarios.
ForwardMail Recuperar correo reenviado.
GetAdminConsentURL Obtiene la URL de consentimiento del administrador que un administrador de un dominio determinado debe abrir por separado para otorgar acceso a su aplicación. Solo se necesita cuando se usan credenciales de OAuth personalizadas.
GetOAuthAccessToken Obtiene un token de autenticación de Office365.
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 token de autenticación de esta URL.
MoveMail Mover correo.
RefreshOAuthAccessToken Actualiza el token de acceso de OAuth que se usa para la autenticación con varios servicios de Office 365.
SendMail Enviar correo.
UploadFile Cargue un archivo nuevo o actualice el contenido de un archivo existente.

Asignar Licencia

Agregue o elimine suscripciones para el usuario. También puede habilitar y deshabilitar planes específicos asociados con una suscripción

Aporte
Nombre Tipo Obligatorio Descripción
UserID String Falso El ID del Usuario para el que se debe asignar la Licencia. No alimentes si tienes que hacerlo por el Usuario con el que estás logueado.
UserPrincipalName String Falso El nombre principal del usuario para el que se debe asignar la licencia. No alimentes si tienes que hacerlo por el Usuario con el que estás logueado.
AddLicenseSkuId String Falso El identificador único para el SKU.
DisabledPlans String Falso Una colección de identificadores únicos separados por comas para los planes que han sido deshabilitados.
RemoveLicenses String Falso Una colección de GUID separados por comas que identifican las licencias que se van a quitar.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Status String Procedimiento almacenado* Estado de ejecución

Cancelar Evento

Cancela un evento.

Aporte
Nombre Tipo Obligatorio Descripción
EventId String Cierto Identificación del evento.
UserId String Falso Identificación del usuario.
UserPrincipalName String Falso El nombre principal del usuario para el que se debe asignar la licencia. No alimentes si tienes que hacerlo por el Usuario con el que estás logueado.
Comment String Falso Un comentario para incluir. Puede ser una cadena vacía.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Status String Procedimiento almacenado* Estado de ejecución

Crear Carpeta

Cargue un archivo nuevo o actualice el contenido de un archivo existente.

Aporte
Nombre Tipo Obligatorio Descripción
FolderName String Cierto Nombre de la carpeta a crear.
ParentId String Falso ID de la carpeta donde se encuentra el elemento actual.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Id String ID del Foler creado.

CrearEsquema

Crea un archivo de esquema para la tabla o vista especificada.

Aporte
Nombre Tipo Obligatorio Descripción
TableName String Cierto El nombre de la tabla o vista.
FileName String Cierto La ruta completa del archivo y el nombre del esquema a generar. Ej: 'C:\Users\User\Desktop\SmartSheet\sheet.rsd'
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Result String Devuelve éxito o fracaso.

Descargar Archivos Adjuntos

Descargar los archivos adjuntos de un correo

Aporte
Nombre Tipo Obligatorio Descripción
MessageId String Cierto ID del correo del que desea obtener los archivos adjuntos.
AttachmentId String Falso ID del archivo adjunto que desea descargar. Devuelve todos los archivos adjuntos del correo si no se especifica.
DownloadTo String Falso Dónde almacenar los archivos adjuntos. Si no se especifica, devuelve los bytes de contenido del archivo adjunto.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Id String ID del archivo adjunto descargado.
Name String Nombre del archivo adjunto descargado.
ContentBytes String Contenido del archivo adjunto.
LastmodifiedDatetime String Última fecha de modificación del archivo adjunto.
ContentType String Tipo de contenido del archivo adjunto. Si se especifica DownloadTo, este campo será nulo.

DescargarCorreo Electrónico

Descargar el Correo

Aporte
Nombre Tipo Obligatorio Descripción
MessageId String Cierto ID del Mensaje que desea descargar
DownloadTo String Cierto Dónde almacenar el archivo.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Status String Procedimiento almacenado* Estado de ejecución

Descargar Archivo

Descargar el archivo

Aporte
Nombre Tipo Obligatorio Descripción
FileId String Cierto ID del archivo que desea descargar
DownloadTo String Cierto Dónde almacenar el archivo.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Status String Procedimiento almacenado* Estado de ejecución

Reenviar Evento

Reenviar eventos a los destinatarios.

Aporte
Nombre Tipo Obligatorio Descripción
EventId String Cierto Identificación del evento.
ToRecipients String Cierto Una lista separada por punto y coma de los correos de los destinatarios.
UserId String Falso Identificación del usuario.
UserPrincipalName String Falso El nombre principal del usuario para el que se debe asignar la licencia. No alimentes si tienes que hacerlo por el Usuario con el que estás logueado.
Comment String Falso Un comentario para incluir. Puede ser una cadena vacía.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Status String Procedimiento almacenado* Estado de ejecución

ReenviarCorreo

Recuperar correo reenviado.

Aporte
Nombre Tipo Obligatorio Descripción
MessageId String Cierto ID del correo.
ToRecipients String Cierto Una lista separada por punto y coma de los correos de los destinatarios.
Comment String Falso BodyContent encima del mensaje original.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Id String ID de correo reenviado.

GetAdminConsentURL

Obtiene la URL de consentimiento del administrador que un administrador de un dominio determinado debe abrir por separado para otorgar acceso a su aplicación. Solo se necesita cuando se usan credenciales de OAuth personalizadas.

Aporte
Nombre Tipo Obligatorio Descripción
CallbackUrl String Falso La URL a la que se redirigirá al usuario después de autorizar su aplicación. Este valor debe coincidir con la URL de respuesta en la configuración de la aplicación de Azure AD.
State String Falso El mismo valor para el estado que envió cuando solicitó el código de autorización.
Scope String Falso Una lista separada por espacios de permisos para solicitar al administrador. El valor predeterminado es *offline_access https://graph.microsoft.com/group.read.all https://graph.microsoft.com/group.readwrite.all https://graph.microsoft.com/user.read https://graph.microsoft.com/user.readwrite.all https://graph.microsoft.com/calendars.readwrite https://graph.microsoft.com/contacts.readwrite https://graph.microsoft.com/mail.readwrite*.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
URL String La URL de autorización, ingresada en un navegador web para obtener el token de verificación y autorizar su aplicación.

Obtener Token de Acceso de OAuth

Obtiene un token de autenticación de Office365.

Aporte
Nombre Tipo Obligatorio Descripción
AuthMode String Falso El tipo de modo de autenticación a utilizar. Seleccione Aplicación para obtener tokens de autenticación a través de una aplicación de escritorio. Seleccione Web para obtener tokens de autenticación a través de una aplicación web. Los valores permitidos son APP, WEB. El valor predeterminado es APLICACIÓN.
CallbackUrl String Falso La URL a la que se redirigirá al usuario después de autorizar su aplicación. Este valor debe coincidir con la URL de respuesta que especificó en la configuración de la aplicación de Azure AD.
Verifier String Falso El verificador devuelto por Azure AD después de que el usuario haya autorizado su aplicación para tener acceso a sus datos. Este valor se devolverá como un parámetro para la URL de devolución de llamada.
State String Falso Una cadena arbitraria de su elección que se devuelve a su aplicación; un viaje de ida y vuelta exitoso de esta cadena ayuda a garantizar que su aplicación haya iniciado la solicitud.
Scope String Falso Una lista separada por espacios de permisos para solicitar al usuario cuando OAuthGrantType='CODE'. Consulte la API de Microsoft Graph para obtener una lista de los permisos disponibles. Cuando OAuthGrantType='CLIENT', un ámbito de 'https://graph.microsoft.com/.default' se usa '/.default' recoge los permisos que ya tiene su aplicación. El valor predeterminado es *offline_access https://graph.microsoft.com/group.read.all https://graph.microsoft.com/group.readwrite.all https://graph.microsoft.com/user.read https://graph.microsoft.com/user.readwrite.all https://graph.microsoft.com/calendars.readwrite https://graph.microsoft.com/contacts.readwrite https://graph.microsoft.com/mail.readwrite*.
Prompt String Falso El valor predeterminado es 'select_account', que solicita al usuario que seleccione la cuenta durante la autenticación. Establézcalo en 'Ninguno', para no solicitar, 'iniciar sesión' para obligar al usuario a ingresar sus credenciales o 'consentimiento' para activar el cuadro de diálogo de consentimiento de OAuth después de que el usuario inicie sesión, pidiéndole que otorgue permisos a la aplicación.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
OAuthAccessToken String El token de acceso utilizado para la comunicación con Office365.
ExpiresIn String El tiempo de vida restante en el token de acceso. Un -1 indica que no caducará.
OAuthRefreshToken String Actualizar token para renovar el token de acceso.

Obtener URL de Autorización de OAuth

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 token de autenticación de esta URL.

Aporte
Nombre Tipo Obligatorio Descripción
CallbackUrl String Falso La URL a la que se redirigirá al usuario después de autorizar su aplicación. Este valor debe coincidir con la URL de respuesta en la configuración de la aplicación de Azure AD.
State String Falso El mismo valor para el estado que envió cuando solicitó el código de autorización.
Scope String Falso Una lista separada por espacios de permisos para solicitar al usuario cuando OAuthGrantType='CODE'. Consulte la API de Microsoft Graph para obtener una lista de los permisos disponibles. Cuando OAuthGrantType='CLIENT', un ámbito de 'https://graph.microsoft.com/.default' se usa '/.default' recoge los permisos que ya tiene su aplicación. El valor predeterminado es *offline_access https://graph.microsoft.com/group.read.all https://graph.microsoft.com/group.readwrite.all https://graph.microsoft.com/user.read https://graph.microsoft.com/user.readwrite.all https://graph.microsoft.com/calendars.readwrite https://graph.microsoft.com/contacts.readwrite https://graph.microsoft.com/mail.readwrite*.
Prompt String Falso El valor predeterminado es 'select_account', que solicita al usuario que seleccione la cuenta durante la autenticación. Establézcalo en 'Ninguno' para que no se le solicite, 'iniciar sesión' para obligar al usuario a ingresar sus credenciales o 'consentimiento' para activar el cuadro de diálogo de consentimiento de OAuth después de que el usuario inicie sesión, pidiéndole que otorgue permisos a la aplicación.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
URL String La URL de autorización, ingresada en un navegador web para obtener el token de verificación y autorizar su aplicación.

MoveMail

Mover correo.

Aporte
Nombre Tipo Obligatorio Descripción
MessageId String Cierto La identificación del correo.
DestinationId String Cierto ID de la carpeta de destino a la que se moverá el correo.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Id String ID de correo movido.

RefreshOAuthAccessToken

Actualiza el token de acceso de OAuth que se usa para la autenticación con varios servicios de Office 365.

Aporte
Nombre Tipo Obligatorio Descripción
OAuthRefreshToken String Cierto El token de actualización devuelto del intercambio de código de autorización original.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
OAuthAccessToken String El token de autenticación devuelto por Azure AD. Esto se puede usar en llamadas posteriores a otras operaciones para este servicio en particular.
OAuthRefreshToken String Un token que puede usarse para obtener un nuevo token de acceso.
ExpiresIn String El tiempo de vida restante en el token de acceso.

Enviar Correo

Enviar correo.

Aporte
Nombre Tipo Obligatorio Descripción
Id String Falso El ID del mensaje a enviar (esto es opcional). El usuario puede usar una identificación de correo existente o enviar un nuevo correo completando opcionalmente los otros campos.
Subject String Falso El asunto del correo.
Content String Falso Contenido del cuerpo del Correo.
Attachments String Falso Los archivos adjuntos. Especifique Archivos adjuntos en el siguiente formato: nombre de archivo1, contenido de archivo1; nombre de archivo2, contenido de archivo2. Cada contenido de archivo puede ser datos base64 o la ruta de un archivo local con el carácter @ antes
FileName String Falso Nombre del archivo adjunto de correo.
LocalFile String Falso El archivo que contiene el contenido del archivo adjunto
ContentBytes String Falso Contenido del archivo adjunto codificado en base 64.
ToRecipients String Falso Los recipientes. Especifique los destinatarios en el siguiente orden: person1@example.com;person2@example.com.
CCRecipients String Falso Los destinatarios de CC. Especifique los destinatarios en el siguiente orden: person1@example.com;person2@example.com.
SenderEmail String Falso Se debe enviar la dirección de correo en nombre de quién. Configure esto si desea enviar un correo en nombre de la cuenta de otro usuario.
FromEmail String Falso La dirección de correo del Usuario desde la que se debe enviar el correo. Configure esto si desea enviar un correo desde la cuenta de otro usuario.
ContentType String Falso El tipo de contenido del cuerpo del correo. Los valores permitidos son texto, html. El valor predeterminado es texto.

Subir Archivo

Cargue un archivo nuevo o actualice el contenido de un archivo existente.

Aporte
Nombre Tipo Obligatorio Descripción
FileName String Cierto Nombre del archivo al que necesita cargar contenido. Solo especifíquelo si ya tiene un archivo existente.
ParentId String Cierto ID de la carpeta donde se encuentra el elemento actual.
Content String Falso Contenido del archivo a cargar.
LocalFile String Falso Archivo local que contiene el contenido que se va a cargar.
Columnas del Conjunto de Resultados
Nombre Tipo Descripción
Id String ID del archivo cargado.
\* String Resultados de carga de archivos.

Tablas del Sistema

Puede consultar las tablas del sistema que se describen en esta sección para acceder a la información del esquema, la información sobre la funcionalidad del origen de datos y las estadísticas de operación lote.

Tablas de Esquema

Las siguientes tablas devuelven metadatos de la base de datos para Office 365:

Tablas de Fuentes de Datos

Las siguientes tablas devuelven información sobre cómo conectarse y consultar la fuente de datos:

  • sys_connection_props: Devuelve información sobre las propiedades de conexión disponibles.
  • sys_sqlinfo: describe las consultas SELECT que el conector puede descargar al origen de datos.

Tablas de Información de Consulta

La siguiente tabla devuelve estadísticas de consultar para consultas de modificación de datos:

  • identidad_sys: devuelve información sobre operaciones lote o actualizaciones individuales.

Sys_catalogs

Enumera las bases de datos disponibles.

La siguiente consultar recupera todas las bases de datos determinadas por la cadena de conexión:

SELECT * FROM sys_catalogs
Columnas
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos.

Sys_schemas

Enumera los esquemas disponibles.

La siguiente consultar recupera todos los esquemas disponibles:

SELECT * FROM sys_schemas
Columnas
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos.
SchemaName String El nombre del esquema.

Sys_tables

Enumera las tablas disponibles.

La siguiente consultar recupera las tablas y vistas disponibles:

SELECT * FROM sys_tables
Columnas
Nombre Tipo Descripción
CatalogName String La base de datos que contiene la tabla o vista.
SchemaName String El esquema que contiene la tabla o vista.
TableName String El nombre de la tabla o vista.
TableType String El tipo de tabla (tabla o vista).
Description String Una descripción de la tabla o vista.
IsUpdateable Boolean Si la tabla se puede actualizar.

Sys_tablecolumns

Describe las columnas de las tablas y vistas disponibles.

La siguiente consultar devuelve las columnas y los tipos de datos de la tabla Eventos:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Events' 
Columnas
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene la tabla o vista.
SchemaName String El esquema que contiene la tabla o vista.
TableName String El nombre de la tabla o vista que contiene la columna.
ColumnName String El nombre de la columna.
DataTypeName String El nombre del tipo de datos.
DataType Int32 Un número entero que indica el tipo de datos. Este valor se determina en tiempo de ejecución en función del ambiente.
Length Int32 El tamaño de almacenamiento de la columna.
DisplaySize Int32 El ancho máximo normal de la columna designada en caracteres.
NumericPrecision Int32 El número máximo de dígitos en datos numéricos. La longitud de la columna en caracteres para datos de carácter y fecha y hora.
NumericScale Int32 La escala de columna o número de dígitos a la derecha del punto decimal.
IsNullable Boolean Si la columna puede contener nulo.
Description String Una breve descripción de la columna.
Ordinal Int32 El número de secuencia de la columna.
IsAutoIncrement String Si el valor de la columna se asigna en incrementos fijos.
IsGeneratedColumn String Si se genera la columna.
IsHidden Boolean Si la columna está oculta.
IsArray Boolean Si la columna es una matriz.

Sys_procedimientos

Enumera los procedimientos almacenados disponibles.

La siguiente consultar recupera los procedimientos almacenados disponibles:

SELECT * FROM sys_procedures
Columnas
Nombre Tipo Descripción
CatalogName String La base de datos que contiene el procedimiento almacenado.
SchemaName String El esquema que contiene el procedimiento almacenado.
ProcedureName String El nombre del procedimiento almacenado.
Description String Una descripción del procedimiento almacenado.
ProcedureType String El tipo de procedimiento, como PROCEDIMIENTO o FUNCIÓN.

Sys_procedureparameters

Describe procedimiento almacenado* parámetros.

La siguiente consultar devuelve información sobre todos los parámetros de entrada para el procedimiento almacenado SendMail:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='SendMail' AND Direction=1 OR Direction=2
Columnas
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene el procedimiento almacenado.
SchemaName String El nombre del esquema que contiene el procedimiento almacenado.
ProcedureName String El nombre del procedimiento almacenado* que contiene el parámetro.
ColumnName String El nombre del procedimiento almacenado* parámetro.
Direction Int32 Un número entero correspondiente al tipo de parámetro: entrada (1), entrada/salida (2) o salida (4). Los parámetros de tipo de entrada/salida pueden ser tanto parámetros de entrada como de salida.
DataTypeName String El nombre del tipo de datos.
DataType Int32 Un número entero que indica el tipo de datos. Este valor se determina en tiempo de ejecución en función del ambiente.
Length Int32 El número de caracteres permitidos para los datos de caracteres. El número de dígitos permitidos para datos numéricos.
NumericPrecision Int32 La máxima precisión para datos numéricos. La longitud de la columna en caracteres para datos de carácter y fecha y hora.
NumericScale Int32 El número de dígitos a la derecha del punto decimal en datos numéricos.
IsNullable Boolean Si el parámetro puede contener nulo.
IsRequired Boolean Si el parámetro es necesario para la ejecución del procedimiento.
IsArray Boolean Si el parámetro es una matriz.
Description String La descripción del parámetro.
Ordinal Int32 El índice del parámetro.

Sys_keycolumns

Describe las claves primarias y foráneas. La siguiente consultar recupera la clave principal de la tabla Eventos:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Events'
Columnas
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene la clave.
SchemaName String El nombre del esquema que contiene la clave.
TableName String El nombre de la tabla que contiene la clave.
ColumnName String El nombre de la columna clave.
IsKey Boolean Si la columna es una clave principal en la tabla a la que se hace referencia en el campo TableName.
IsForeignKey Boolean Si la columna es una clave externa a la que se hace referencia en el campo TableName.
PrimaryKeyName String El nombre de la clave principal.
ForeignKeyName String El nombre de la clave foránea.
ReferencedCatalogName String La base de datos que contiene la clave principal.
ReferencedSchemaName String El esquema que contiene la clave principal.
ReferencedTableName String La tabla que contiene la clave principal.
ReferencedColumnName String El nombre de la columna de la clave principal.

Sys_foreignkeys

Describe las claves foráneas. La siguiente consultar recupera todas las claves foráneas que hacen referencia a otras tablas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'
Columnas
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene la clave.
SchemaName String El nombre del esquema que contiene la clave.
TableName String El nombre de la tabla que contiene la clave.
ColumnName String El nombre de la columna clave.
PrimaryKeyName String El nombre de la clave principal.
ForeignKeyName String El nombre de la clave foránea.
ReferencedCatalogName String La base de datos que contiene la clave principal.
ReferencedSchemaName String El esquema que contiene la clave principal.
ReferencedTableName String La tabla que contiene la clave principal.
ReferencedColumnName String El nombre de la columna de la clave principal.
ForeignKeyType String Designa si la clave externa es una clave de importación (apunta a otras tablas) o de exportación (hace referencia desde otras tablas).

Sys_indexes

Describe los índices disponibles. Al filtrar en los índices, puede escribir consultas más selectivas con tiempos de respuesta de consultar más rápidos.

La siguiente consultar recupera todos los índices que no son claves principales:

SELECT * FROM sys_indexes WHERE IsPrimary='false'
Columnas
Nombre Tipo Descripción
CatalogName String El nombre de la base de datos que contiene el índice.
SchemaName String El nombre del esquema que contiene el índice.
TableName String El nombre de la tabla que contiene el índice.
IndexName String El nombre del índice.
ColumnName String El nombre de la columna asociada con el índice.
IsUnique Boolean True si el índice es único. Falso en caso contrario.
IsPrimary Boolean True si el índice es una clave principal. Falso en caso contrario.
Type Int16 Un valor entero correspondiente al tipo de índice: estadística (0), agrupado (1), hash (2) u otro (3).
SortOrder String El orden de clasificación: A para ascender o D para descender.
OrdinalPosition Int16 El número de secuencia de la columna en el índice.

Sys_connection_props

Devuelve información sobre las propiedades de conexión disponibles y las establecidas en la cadena de conexión.

Al consultar esta tabla, se debe usar la cadena de conexión de configuración:

jdbc:cdata:office365:config:

Esta cadena de conexión le permite consultar esta tabla sin una conexión válida.

La siguiente consultar recupera todas las propiedades de conexión que se han establecido en la cadena de conexión o se han establecido a través de un valor predeterminado:

SELECT * FROM sys_connection_props WHERE Value <> ''
Columnas
Nombre Tipo Descripción
Name String El nombre de la propiedad de conexión.
ShortDescription String Una breve descripción.
Type String El tipo de datos de la propiedad de conexión.
Default String El valor predeterminado si no se establece uno explícitamente.
Values String Una lista separada por comas de valores posibles. Se lanza un error de validación si se especifica otro valor.
Value String El valor que establezca o un valor predeterminado preconfigurado.
Required Boolean Si la propiedad es necesaria para conectarse.
Category String La categoría de la propiedad de conexión.
IsSessionProperty String Si la propiedad es una propiedad de sesión, utilizada para guardar información sobre la conexión actual.
Sensitivity String El nivel de sensibilidad de la propiedad. Esto informa si la propiedad está ofuscada en los formularios de registro y autenticación.
PropertyName String Una forma truncada en mayúsculas y minúsculas del nombre de la propiedad de conexión.
Ordinal Int32 El índice del parámetro.
CatOrdinal Int32 El índice de la categoría de parámetro.
Hierarchy String Muestra las propiedades dependientes asociadas que deben configurarse junto con esta.
Visible Boolean Informa si la propiedad está visible en la interfaz de usuario de la conexión.
ETC String Diversa información miscelánea sobre la propiedad.

Sys_sqlinfo

Describe el procesamiento de consultar SELECT que el conector puede descargar al origen de datos.

Procesamiento Colaborativo de Consultas

Al trabajar con fuentes de datos que no admiten SQL-92, puede consultar la vista sys_sqlinfo para determinar las capacidades de consultar de las APIs subyacentes, expresadas en sintaxis SQL. El conector descarga la mayor cantidad posible del procesamiento de sentencias SELECT al servidor y luego procesa el resto de la consultar en la memoria.

Descubrimiento de las Capacidades SELECT de la Fuente de Datos

A continuación se muestra un conjunto de datos de ejemplo de las capacidades de SQL. El siguiente conjunto de resultados indica la funcionalidad SELECT que el conector puede descargar en el origen de datos o en el lado del cliente del proceso. Su fuente de datos puede admitir sintaxis SQL adicional. Algunos aspectos de la funcionalidad SELECT se devuelven en una lista separada por comas si es compatible; de lo contrario, la columna contiene NO.

Nombre Descripción Valores posibles
AGGREGATE_FUNCTIONS Funciones de agregación admitidas. AVG, COUNT, MAX, MIN, SUM, DISTINCT
COUNT Si se admite la función COUNT. YES, NO
IDENTIFIER_QUOTE_OPEN_CHAR El carácter de apertura utilizado para escapar de un identificador. [
IDENTIFIER_QUOTE_CLOSE_CHAR El carácter de cierre utilizado para escapar de un identificador. ]
SUPPORTED_OPERATORS Una lista de operadores de SQL admitidos. =, >, <, >=, <=, <>, !=, LIKE, NOT LIKE, IN, NOT IN, IS NULL, IS NOT NULL, AND, OR
GROUP_BY Si se admite GROUP BY y, de ser así, el grado de compatibilidad. NO, NO_RELATION, EQUALS_SELECT, SQL_GB_COLLATE
STRING_FUNCTIONS Funciones de cadena admitidas. LENGTH, CHAR, LOCATE, REPLACE, SUBSTRING, RTRIM, LTRIM, RIGHT, LEFT, UCASE, SPACE, SOUNDEX, LCASE, CONCAT, ASCII, REPEAT, OCTET, BIT, POSITION, INSERT, TRIM, UPPER, REGEXP, LOWER, DIFFERENCE, CHARACTER, SUBSTR, STR, REVERSE, PLAN, UUIDTOSTR, TRANSLATE, TRAILING, TO, STUFF, STRTOUUID, STRING, SPLIT, SORTKEY, SIMILAR, REPLICATE, PATINDEX, LPAD, LEN, LEADING, KEY, INSTR, INSERTSTR, HTML, GRAPHICAL, CONVERT, COLLATION, CHARINDEX, BYTE
NUMERIC_FUNCTIONS Funciones numéricas compatibles. ABS, ACOS, ASIN, ATAN, ATAN2, CEILING, COS, COT, EXP, FLOOR, LOG, MOD, SIGN, SIN, SQRT, TAN, PI, RAND, DEGREES, LOG10, POWER, RADIANS, ROUND, TRUNCATE
TIMEDATE_FUNCTIONS Funciones de fecha/hora admitidas. NOW, CURDATE, DAYOFMONTH, DAYOFWEEK, DAYOFYEAR, MONTH, QUARTER, WEEK, YEAR, CURTIME, HOUR, MINUTE, SECOND, TIMESTAMPADD, TIMESTAMPDIFF, DAYNAME, MONTHNAME, CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, EXTRACT
REPLICATION_SKIP_TABLES Indica tablas omitidas durante la replicación.
REPLICATION_TIMECHECK_COLUMNS Una matriz de cadenas que contiene una lista de columnas que se usarán para verificar (en el orden dado) para usar como una columna modificada durante la replicación.
IDENTIFIER_PATTERN Valor de cadena que indica qué cadena es válida para un identificador.
SUPPORT_TRANSACTION Indica si el proveedor admite transacciones como compromiso y reversión. YES, NO
DIALECT Indica el dialecto SQL a usar.
KEY_PROPERTIES Indica las propiedades que identifican la base de datos uniforme.
SUPPORTS_MULTIPLE_SCHEMAS Indica si pueden existir varios esquemas para el proveedor. YES, NO
SUPPORTS_MULTIPLE_CATALOGS Indica si pueden existir varios catálogos para el proveedor. YES, NO
DATASYNCVERSION La versión de sincronización de datos necesaria para acceder a este controlador. Standard, Starter, Professional, Enterprise
DATASYNCCATEGORY La categoría Sincronización de datos de este controlador. Source, Destination, Cloud Destination
SUPPORTSENHANCEDSQL Si se admite la funcionalidad de SQL mejorada más allá de lo que ofrece la API. TRUE, FALSE
SUPPORTS_BATCH_OPERATIONS Si se admiten las operaciones lote. YES, NO
SQL_CAP Todas las funciones de SQL admitidas para este controlador. SELECT, INSERT, DELETE, UPDATE, TRANSACTIONS, ORDERBY, OAUTH, ASSIGNEDID, LIMIT, LIKE, BULKINSERT, COUNT, BULKDELETE, BULKUPDATE, GROUPBY, HAVING, AGGS, OFFSET, REPLICATE, COUNTDISTINCT, JOINS, DROP, CREATE, DISTINCT, INNERJOINS, SUBQUERIES, ALTER, MULTIPLESCHEMAS, GROUPBYNORELATION, OUTERJOINS, UNIONALL, UNION, UPSERT, GETDELETED, CROSSJOINS, GROUPBYCOLLATE, MULTIPLECATS, FULLOUTERJOIN, MERGE, JSONEXTRACT, BULKUPSERT, SUM, SUBQUERIESFULL, MIN, MAX, JOINSFULL, XMLEXTRACT, AVG, MULTISTATEMENTS, FOREIGNKEYS, CASE, LEFTJOINS, COMMAJOINS, WITH, LITERALS, RENAME, NESTEDTABLES, EXECUTE, BATCH, BASIC, INDEX
PREFERRED_CACHE_OPTIONS Un valor de cadena especifica las cacheOptions preferidas.
ENABLE_EF_ADVANCED_QUERY Indica si el controlador admite directamente consultas avanzadas provenientes de Entity Framework. De lo contrario, las consultas se manejarán del lado del cliente. YES, NO
PSEUDO_COLUMNS Una matriz de cadenas que indica las pseudocolumnas disponibles.
MERGE_ALWAYS Si el valor es verdadero, el modo de combinación se ejecuta a la fuerza en la sincronización de datos. TRUE, FALSE
REPLICATION_MIN_DATE_QUERY Una consultar de selección para devolver la fecha y hora de inicio de la réplica.
REPLICATION_MIN_FUNCTION Permite que un proveedor especifique el nombre de la fórmula que se usará para ejecutar un min del lado del servidor.
REPLICATION_START_DATE Permite que un proveedor especifique una fecha de inicio de réplica.
REPLICATION_MAX_DATE_QUERY Una consultar de selección para devolver la fecha y hora de finalización de la réplica.
REPLICATION_MAX_FUNCTION Permite que un proveedor especifique el nombre de la fórmula que se usará para ejecutar un máx. del lado del servidor.
IGNORE_INTERVALS_ON_INITIAL_REPLICATE Una lista de tablas que omitirán dividir la réplica en fragmentos en la réplica inicial.
CHECKCACHE_USE_PARENTID Indica si la instrucción CheckCache debe realizarse en la columna de clave principal. TRUE, FALSE
CREATE_SCHEMA_PROCEDURES Indica procedimientos almacenados* que se puede utilizar para generar archivos de esquema.

La siguiente consultar recupera los operadores que se pueden usar en la cláusula WHERE:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Tenga en cuenta que las tablas individuales pueden tener diferentes limitaciones o requisitos en la cláusula WHERE; consulte el Modelo de datos para obtener más información.

Columnas
Nombre Tipo Descripción
NAME String Un componente de la sintaxis SQL o una capacidad que se puede procesar en el servidor.
VALUE String Detalles sobre el SQL o la sintaxis de SQL admitidos.

Sys_identidad

Devuelve información sobre los intentos de modificación.

La siguiente consultar recupera los Id. de las filas modificadas en una operación lote:

SELECT * FROM sys_identity
Columnas
Nombre Tipo Descripción
Id String El ID generado por la base de datos devuelto de una operación de modificación de datos.
Batch String Un identificador para el lote. 1 para una sola operación.
Operation String El resultado de la operación en el lote: INSERTADO, ACTUALIZADO o ELIMINADO.
Message String ÉXITO o un mensaje de error si falla la actualización en el lote.

Asignación de Tipos de Datos

Asignaciones de Tipos de Datos

El conector asigna tipos del origen de datos al tipo de datos correspondiente disponible en el esquema. La siguiente tabla documenta estas asignaciones.

Oficina 365 (OData V4) Esquema
Edm.Binary binario
Edm.Boolean bool
Edm.Date fecha y hora
Edm.DateTimeOffset fecha y hora
Edm.Decimal decimal
Edm.Double doble
Edm.Guid guía
Edm.Int32 entero
Edm.String cadena
Edm.TimeOfDay tiempo

Propiedades de Configuraciones Avanzadas

Las propiedades de configuraciones avanzadas son las diversas opciones que se pueden utilizar para establecer una conexión. Esta sección proporciona una lista completa de las opciones que puede configurar. Haga clic en los enlaces para obtener más detalles.

Autenticación

Propiedad Descripción
AuthScheme El tipo de autenticación que se usará al conectarse a Microsoft Office 365.

Autenticación de Azure

Propiedad Descripción
AzureTenant El inquilino de Microsoft Online que se usa para acceder a los datos. Si no se especifica, se utilizará su tentant predeterminado.
AzureEnvironment El ambiente de Azure que se usará al establecer una conexión.

OAuth

Propiedad Descripción
InitiateOAuth Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.
OAuthClientId El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthClientSecret El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthGrantType El tipo de concesión para el flujo de OAuth.

SSL

Propiedad Descripción
SSLServerCert El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.

Inicio sesión

Propiedad Descripción
Logfile Una ruta de archivo que designa el nombre y la ubicación del archivo de registro.
Verbosity El nivel de detalle que determina la cantidad de detalles incluidos en el archivo de registro.
LogModules Módulos principales que se incluirán en el archivo de registro.
MaxLogFileSize Una cadena que especifica el tamaño máximo en bytes para un archivo de registro (por ejemplo, 10 MB).
MaxLogFileCount Una cadena que especifica el recuento máximo de archivos de registro.

Esquema

Propiedad Descripción
Location Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.
BrowsableSchemas Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC.
Tables Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA, TablaB, TablaC.
Views Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA, VistaB, VistaC.

Misceláneas

Propiedad Descripción
AllowDuplicateRecords Indica si el controlador debe comprobar las reglas de detección de duplicados configuradas.
IncludeFormattedValues Indica si se deben exponer las columnas que contienen valores con formato.
IncludeNavigationProperties Un valor booleano que indica si las propiedades de navegación deben incluirse en la lista de columnas.
MaxRows Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.
Other Estas propiedades ocultas se usan solo en casos de uso específicos.
Pagesize El número máximo de resultados que se devolverán por página desde Microsoft Office 365.
PseudoColumns Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.
Timeout El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

Autenticación

Esta sección proporciona una lista completa de las propiedades de autenticación que puede configurar.

Propiedad Descripción
AuthScheme El tipo de autenticación que se usará al conectarse a Office 365.

AuthScheme

El tipo de autenticación que se usará al conectarse a Microsoft Office 365. Actualmente, solo AzureServicePrincipal esta apoyado

Valores Posibles

AzureServicePrincipal

Tipo de Datos

string

Valor por Defecto

"AzureServicePrincipal"

Observaciones
  • AzureServicePrincipal: configure esto para autenticarse como una entidad de servicio de Azure.

Autenticación de Azure

Esta sección proporciona una lista completa de las propiedades de autenticación de Azure que puede configurar.

Propiedad Descripción
AzureTenant El inquilino de Microsoft Online que se usa para acceder a los datos. Si no se especifica, se utilizará su tentant predeterminado.
AzureEnvironment El ambiente de Azure que se usará al establecer una conexión.

AzureInquilino

El inquilino de Microsoft Online que se usa para acceder a los datos. Si no se especifica, se utilizará su tentant predeterminado.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El inquilino de Microsoft Online que se usa para acceder a los datos. Por ejemplo, "ejemplo.onmicrosoft.com". Como alternativa, especifique el ID de arrendatario. Este valor es el ID de directorio en Azure Portal > Active Directory de Azure > Propiedades.

Por lo general, no es necesario especificar el arrendatario. Microsoft puede determinar esto automáticamente cuando se utiliza el OAuthGrantType establecido en CÓDIGO (predeterminado). Sin embargo, puede fallar en el caso de que el usuario pertenezca a varios inquilinos. Por ejemplo, si un administrador del dominio A invita a un usuario del dominio B a ser un usuario invitado. El usuario ahora pertenecerá a ambos inquilinos. Es una buena práctica especificar el inquilino, aunque en general las cosas normalmente deberían funcionar sin tener que especificarlo.

El AzureTenant es necesario cuando se configura OAuthGrantType al CLIENTE. Cuando se usan credenciales de cliente, no hay contexto de usuario. Las credenciales se toman del contexto de la propia aplicación. Si bien Microsoft todavía permite obtener las credenciales de los clientes sin especificar qué arrendatario, tiene una probabilidad mucho menor de elegir el arrendatario específico con el que desea trabajar. Por esta razón, requerimos AzureTenant debe indicarse explícitamente para todas las conexiones de credenciales de clientes para garantizar que obtenga las credenciales que se aplican al dominio al que desea conectarse.

AzureAmbiente

El ambiente de Azure que se usará al establecer una conexión.

Valores Posibles

GLOBAL, CHINA, GERMANY, USGOVT, USGOVTDOD

Tipo de Datos

string

Valor por Defecto

"GLOBAL"

Observaciones

En la mayoría de los casos, funcionará dejar el ambiente establecido en global. Sin embargo, si su cuenta de Azure se ha agregado a un ambiente diferente, el AzureEnvironment se puede utilizar para especificar qué ambiente. Los valores disponibles son GLOBAL, CHINA, GERMANY, USGOVT y USGOVTDOD.

OAuth

Esta sección proporciona una lista completa de las propiedades de OAuth que puede configurar.

Propiedad Descripción
InitiateOAuth Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.
OAuthClientId El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthClientSecret El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.
OAuthGrantType El tipo de concesión para el flujo de OAuth.

Iniciar OAuth

Establezca esta propiedad para iniciar el proceso para obtener o actualizar el token de acceso de OAuth cuando se conecte.

Valores Posibles

GETANDREFRESH

Tipo de Datos

string

Valor por Defecto

"GETANDREFRESH"

Observaciones

Se admite la siguiente opción:

  • GETANDREFRESH: indica que el conector manejará todo el flujo de OAuth. Si no existe ningún token actualmente, se obtendrá. Si existe un token, se actualizará cuando corresponda.

Versión OAuth

La versión de OAuth que se está utilizando.

Valores Posibles

1.0, 2.0

Tipo de Datos

string

Valor por Defecto

"2.0"

Observaciones

La versión de OAuth que se está utilizando. Están disponibles las siguientes opciones: 1.0,2.0

OAuthClientId

El ID de cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Como parte del registro de una aplicación OAuth, recibirá el OAuthClientId valor, a veces también llamado clave de consumidor, y un secreto de cliente, el OAuthClientSecret.

OAuthClientSecretOAuthClientSecret

El secreto del cliente asignado cuando registra su aplicación con un servidor de autorización de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Como parte del registro de una aplicación OAuth, recibirá el secreto del cliente, también llamado secreto del consumidor. Establezca el secreto del cliente como OAuthClientSecret propiedad.

También recibirá un OAuthClientId, también denominada clave de consumidor.

Token de Acceso de OAuth

El token de acceso para conectarse mediante OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El OAuthAccessToken la propiedad se usa para conectarse usando OAuth. El OAuthAccessToken se recupera del servidor OAuth como parte del proceso de autenticación. Tiene un tiempo de espera dependiente del servidor y se puede reutilizar entre solicitudes.

El token de acceso se utiliza en lugar de su nombre de usuario y contraseña. El token de acceso protege sus credenciales manteniéndolas en el servidor.

URL de Devolución de Llamada

La URL de devolución de llamada de OAuth a la que volver cuando se autentica. Este valor debe coincidir con la URL de devolución de llamada que especifica en la configuración de su aplicación.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Durante el proceso de autenticación, el servidor de autorización de OAuth redirige al usuario a esta URL. Este valor debe coincidir con la URL de devolución de llamada que especifica en la configuración de su aplicación.

OAuthGrantType

El tipo de concesión para el flujo de OAuth.

Valores Posibles

CLIENT

Tipo de Datos

string

Valor por Defecto

"CLIENT"

Observaciones

El tipo de concesión para el flujo de OAuth. Solo el CLIENT la opción es compatible.

URL de Autorización de OAuth

La URL de autorización para el servicio OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

La URL de autorización para el servicio OAuth. En esta URL, el usuario inicia sesión en el servidor y otorga permisos a la aplicación. En OAuth 1.0, si se otorgan permisos, se autoriza el token de solicitud.

URL del Token de Acceso de OAuth

La URL desde la que recuperar el token de acceso de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

La URL desde la que recuperar el token de acceso de OAuth. En OAuth 1.0, el token de solicitud autorizado se intercambia por el token de acceso en esta URL.

OAuthVerifier

El código verificador devuelto desde la URL de autorización de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El código verificador devuelto desde la URL de autorización de OAuth. Esto se puede usar en sistemas en los que no se puede iniciar un navegador, como los sistemas sin cabeza.

Autenticación en Máquinas Sin Cabeza

Ver para obtener el OAuthVerifier valor.

Establezca OAuthSettingsLocation junto con OAuthVerifier. Cuando se conecta, el conector intercambia el OAuthVerifier para los tokens de autenticación de OAuth y los guarda, encriptados, en el archivo especificado. Establecer Iniciar OAuth para GETANDREFRESH automatizar el intercambio.

Una vez que se haya generado el archivo de configuración de OAuth, puede eliminar OAuthVerifier desde las propiedades de conexión y conéctese con OAuthSettingsLocation colocar.

Para actualizar automáticamente los valores del token de OAuth, establezca OAuthSettingsLocation y además configure InitiateOAuth refrescar.

OAuthRefreshToken

El token de actualización de OAuth para el token de acceso de OAuth correspondiente.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El OAuthRefreshToken la propiedad se usa para actualizar el OAuthAccessToken al usar la autenticación OAuth.

OAuthExpiresIn

La vida útil en segundos del AccessToken de OAuth.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Empareje con OAuthTokenTimestamp para determinar cuándo caducará el AccessToken.

OAuthTokenTimestamp

La marca de tiempo de la época de Unix en milisegundos cuando se creó el token de acceso actual.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Emparéjese con OAuthExpiresIn para determinar cuándo expirará AccessToken.

JWT OAuth

Esta sección proporciona una lista completa de las propiedades de JWT OAuth que puede configurar.

Propiedad Descripción
OAuthJWTCert El almacén de certificados JWT.
OAuthJWTCertType El tipo de almacén de claves que contiene el certificado JWT.
OAuthJWTCertPassword La contraseña para el certificado OAuth JWT.
OAuthJWTCertSubject El asunto del certificado OAuth JWT.
OAuthJWTIssuer El emisor del token web de Java.
OAuthJWTSubject El sujeto de usuario para el que la aplicación solicita acceso delegado.

OAuthJWTCert

El almacén de certificados JWT.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El nombre del almacén de certificados para el certificado de cliente.

El OAuthJWTCertType especifica el tipo de almacén de certificados especificado por OAuthJWTCert. Si la tienda está protegida con contraseña, especifique la contraseña en OAuthJWTCertPassword.

OAuthJWTCert se usa junto con OAuthJWTCertSubject para especificar certificados de cliente. Si OAuthJWTCert tiene un valor y OAuthJWTCertSubject, se inicia una búsqueda de un certificado. Consulte OAuthJWTCertSubject campo para más detalles.

Las designaciones de los almacenes de certificados dependen de la plataforma.

Las siguientes son designaciones de los almacenes de certificados de usuario y máquina más comunes en Windows:

Propiedad Descripción
MY Un almacén de certificados que contiene certificados personales con sus claves privadas asociadas.
CA Certificados de la autoridad certificadora.
ROOT Certificados raíz.
SPC Certificados de editor de software.

En Java, el almacén de certificados normalmente es un archivo que contiene certificados y claves privadas opcionales.

Cuando el tipo de almacén de certificados es PFXFile, esta propiedad debe establecerse en el nombre del archivo. Cuando el tipo es PFXBlob, la propiedad debe establecerse en el contenido binario de un archivo PFX (es decir, almacén de certificados PKCS12).

OAuthJWTCertType

El tipo de almacén de claves que contiene el certificado JWT.

Valores Posibles

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB

Tipo de Datos

string

Valor por Defecto

"USER"

Observaciones

Esta propiedad puede tomar uno de los siguientes valores:

Propiedad Descripción
USER Para Windows, esto especifica que el almacén de certificados es un almacén de certificados propiedad del usuario actual. Nota: Este tipo de tienda no está disponible en Java.
MACHINE Para Windows, esto especifica que el almacén de certificados es un almacén de máquinas. Nota: este tipo de tienda no está disponible en Java.
PFXFILE El almacén de certificados es el nombre de un archivo PFX (PKCS12) que contiene certificados.
PFXBLOB El almacén de certificados es una cadena (codificada en base 64) que representa un almacén de certificados en formato PFX (PKCS12).
JKSFILE El almacén de certificados es el nombre de un archivo de almacén de claves Java (JKS) que contiene certificados. Nota: este tipo de tienda solo está disponible en Java.
JKSBLOB El almacén de certificados es una cadena (codificada en base 64) que representa un almacén de certificados en formato de almacén de claves Java (JKS). Nota: este tipo de tienda solo está disponible en Java.
PEMKEY_FILE El almacén de certificados es el nombre de un archivo con codificación PEM que contiene una clave privada y un certificado opcional.
PEMKEY_BLOB El almacén de certificados es una cadena (codificada en base64) que contiene una clave privada y un certificado opcional.
PUBLIC_KEY_FILE El almacén de certificados es el nombre de un archivo que contiene un certificado de clave pública con codificación PEM o DER.
PUBLIC_KEY_BLOB El almacén de certificados es una cadena (codificada en base 64) que contiene un certificado de clave pública con codificación PEM o DER.
SSHPUBLIC_KEY_FILE El almacén de certificados es el nombre de un archivo que contiene una clave pública de estilo SSH.
SSHPUBLIC_KEY_BLOB El almacén de certificados es una cadena (codificada en base 64) que contiene una clave pública de estilo SSH.
P7BFILE El almacén de certificados es el nombre de un archivo PKCS7 que contiene certificados.
PPKFILE El almacén de certificados es el nombre de un archivo que contiene una PPK (clave privada PuTTY).
XMLFILE El almacén de certificados es el nombre de un archivo que contiene un certificado en formato XML.
XMLBLOB El almacén de certificados es una cadena que contiene un certificado en formato XML.

OAuthJWTCertPassword

La contraseña para el certificado OAuth JWT.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Si el almacén de certificados es de un tipo que requiere una contraseña, esta propiedad se usa para especificar esa contraseña para abrir el almacén de certificados.

OAuthJWTCertSubject

El asunto del certificado OAuth JWT.

Tipo de Datos

string

Valor por Defecto

"\*"

Observaciones

Al cargar un certificado, el asunto se utiliza para ubicar el certificado en el almacén.

Si no se encuentra una coincidencia exacta, se busca en la tienda temas que contengan el valor de la propiedad.

Si aún no se encuentra una coincidencia, la propiedad se establece en una cadena vacía y no se selecciona ningún certificado.

El valor especial "*" selecciona el primer certificado en el almacén de certificados.

El asunto del certificado es una lista separada por comas de valores y campos de nombre distinguido. Por ejemplo, "CN=www.server.com, OU=test, C=US, E=support@jitterbit.com". Los campos comunes y sus significados se muestran a continuación.

Campo Significado
CN Nombre común. Este es comúnmente un nombre de alojar como www.server.com.
O Organización
OU Unidad organizativa
L localidad
S Estado
C País
E Dirección de Correo

Si un valor de campo contiene una coma, debe estar entre comillas.

OAuthJWTIssuer

El emisor del token web de Java.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El emisor del token web de Java. Suele ser el ID del cliente o la dirección de Correo de la aplicación OAuth.

OAuthJWTAsunto

El sujeto de usuario para el que la aplicación solicita acceso delegado.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

El sujeto de usuario para el que la aplicación solicita acceso delegado. Por lo general, el nombre de la cuenta de usuario o la dirección de correo.

SSL

Esta sección proporciona una lista completa de las propiedades SSL que puede configurar.

Propiedad Descripción
SSLServerCert El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.

SSLServerCert

El certificado que se aceptará del servidor al conectarse mediante TLS/SSL.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Si usa una conexión TLS/SSL, esta propiedad se puede usar para especificar el certificado TLS/SSL que se aceptará del servidor. Se rechaza cualquier otro certificado que no sea de confianza para la máquina.

Esta propiedad puede tomar las siguientes formas:

Descripción Ejemplo
Un certificado PEM completo (ejemplo abreviado por brevedad) -----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE-----
Una ruta a un archivo local que contiene el certificado C:\cert.cer
La clave pública (ejemplo abreviado por brevedad) -----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY-----
La huella digital MD5 (los valores hexadecimales también pueden estar separados por espacios o dos puntos) ecadbdda5a1529c58a1e9e09828d70e4
La huella digital SHA1 (los valores hexadecimales también pueden estar separados por espacios o dos puntos) 34a929226ae0819f2ec14b4a3d904f801cbb150d

Si no se especifica, se acepta cualquier certificado en el que confíe la máquina.

La máquina valida los certificados como confiables según el almacén de confianza del sistema. El almacén de confianza utilizado es el valor 'javax.net.ssl.trustStore' especificado para el sistema. Si no se especifica ningún valor para esta propiedad, se utiliza el almacén de confianza predeterminado de Java (por ejemplo, JAVA_HOME\lib\security\cacerts).

Use '*' para indicar que acepta todos los certificados. Tenga en cuenta que esto no se recomienda debido a problemas de seguridad.

Esquema

Esta sección proporciona una lista completa de propiedades de esquema que puede configurar.

Propiedad Descripción
Location Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.
BrowsableSchemas Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA, SchemaB, SchemaC.
Tables Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA, TablaB, TablaC.
Views Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA, VistaB, VistaC.

Ubicación

Una ruta al directorio que contiene los archivos de esquema que definen tablas, vistas y procedimientos almacenados.

Tipo de Datos

string

Valor por Defecto

"%APPDATA%\\\Office365 Data Provider\\Schema"

Observaciones

La ruta a un directorio que contiene los archivos de esquema para el conector (archivos .rsd para tablas y vistas, archivos .rsb para procedimientos almacenados). La ubicación de la carpeta puede ser una ruta relativa desde la ubicación del ejecutable. El Location La propiedad solo es necesaria si desea personalizar las definiciones (por ejemplo, cambiar el nombre de una columna, ignorar una columna, etc.) o ampliar el modelo de datos con nuevas tablas, vistas o procedimientos almacenados.

Si no se especifica, la ubicación predeterminada es "%APPDATA%\\Office365 Data Provider\Schema" con %APPDATA% estando configurado en el directorio de configuración del usuario:

Plataforma %APPDATA%
Windows El valor de la variable de ambiente APPDATA
Mac ~/Biblioteca/Soporte de aplicaciones
Linux ~/.config

Esquemas Navegables

Esta propiedad restringe los esquemas informados a un subconjunto de los esquemas disponibles. Por ejemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Enumerar los esquemas de las bases de datos puede resultar costoso. Proporcionar una lista de esquemas en la cadena de conexión mejora el rendimiento.

Mesas

Esta propiedad restringe las tablas notificadas a un subconjunto de las tablas disponibles. Por ejemplo, Tablas=TablaA,TablaB,TablaC.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Listar las tablas de algunas bases de datos puede resultar costoso. Proporcionar una lista de tablas en la cadena de conexión mejora el rendimiento del conector.

Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.

Especifique las tablas que desea en una lista separada por comas. Cada tabla debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.

Puntos de Vista

Restringe las vistas informadas a un subconjunto de las tablas disponibles. Por ejemplo, Vistas=VistaA,VistaB,VistaC.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Listar las vistas de algunas bases de datos puede ser costoso. Proporcionar una lista de vistas en la cadena de conexión mejora el rendimiento del conector.

Esta propiedad también se puede utilizar como una alternativa a la lista automática de vistas si ya sabe con cuáles quiere trabajar y, de lo contrario, habría demasiadas para trabajar.

Especifique las vistas que desee en una lista separada por comas. Cada vista debe ser un identificador SQL válido con cualquier carácter especial escapado usando corchetes, comillas dobles o acentos graves. Por ejemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Tenga en cuenta que al conectarse a una fuente de datos con varios esquemas o catálogos, deberá proporcionar el nombre completo de la tabla en esta propiedad, como en el último ejemplo aquí, para evitar la ambigüedad entre las tablas que existen en varios catálogos o esquemas.

Misceláneas

Esta sección proporciona una lista completa de propiedades misceláneas que puede configurar.

Propiedad Descripción
DirectoryRetrievalDepth Especifique cuántas carpetas de profundidad desea obtener resultados para la tabla de archivos. Los recursos directamente en la raíz se encuentran en la profundidad 0. Los recursos de una carpeta más profunda se encuentran en la profundidad 1 y así sucesivamente. Puede especificar el valor -1 para obtener todos los datos en una unidad sin importar la profundidad en la que se encuentren.
MaxRows Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.
Other Estas propiedades ocultas se usan solo en casos de uso específicos.
Pagesize El número máximo de resultados para devolver por página desde Office 365.
PseudoColumns Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.
Timeout El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.
UseClientSidePaging Si el proveedor ADO.NET para Office 365 debe o no usar la paginación del lado del cliente.

Profundidad de Recuperación de Directorios

Especifique cuántas carpetas de profundidad desea obtener resultados para la tabla de archivos. Los recursos directamente en la raíz se encuentran en la profundidad 0. Los recursos de una carpeta más profunda se encuentran en la profundidad 1 y así sucesivamente. Puede especificar el valor -1 para obtener todos los datos en una unidad sin importar la profundidad en la que se encuentren.

Tipo de Datos

string

Valor por Defecto

"5"

Observaciones

Esta propiedad debe establecerse en la cadena de conexión o el controlador utilizará un valor predeterminado de DirectoryRetrievalDepth=5.

Filas Máximas

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

Tipo de Datos

int

Valor por Defecto

-1

Observaciones

Limita el número de filas devueltas cuando no se usa agregación o agrupación en la consultar. Esto ayuda a evitar problemas de rendimiento en el momento del diseño.

Otro

Estas propiedades ocultas se usan solo en casos de uso específicos.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Las propiedades enumeradas a continuación están disponibles para casos de uso específicos. Los casos de uso y la funcionalidad normales del controlador no deberían requerir estas propiedades.

Especifique varias propiedades en una lista separada por punto y coma.

Integración y Formateo
Propiedad Descripción
DefaultColumnSize Establece la longitud predeterminada de los campos de cadena cuando la fuente de datos no proporciona la longitud de columna en los metadatos. El valor predeterminado es 2000.
ConvertDateTimeToGMT Determina si se convierten los valores de fecha y hora a GMT, en lugar de la hora local de la máquina.
RecordToFile=filename Registra la transferencia de datos del socket subyacente al archivo especificado.

Tamaño de Página

El número máximo de resultados que se devolverán por página desde Office 365.

Tipo de Datos

int

Valor por Defecto

100

Observaciones

El Pagesize la propiedad afecta la cantidad máxima de resultados que se devolverán por página desde Office 365. Establecer un valor más alto puede resultar en un mejor rendimiento a costa de memoria adicional asignada por página consumida.

Pseudocolumnas

Esta propiedad indica si incluir o no pseudocolumnas como columnas en la tabla.

Tipo de Datos

string

Valor por Defecto

""

Observaciones

Esta configuración es particularmente útil en Entity Framework, que no le permite establecer un valor para una pseudocolumna a menos que sea una columna de tabla. El valor de esta configuración de conexión tiene el formato "Tabla1=Columna1, Tabla1=Columna2, Tabla2=Columna3". Puede usar el carácter "*" para incluir todas las tablas y todas las columnas; por ejemplo, "*=*".

Se Acabó el Tiempo

El valor en segundos hasta que se lanza el error de tiempo de espera, cancelando la operación.

Tipo de Datos

int

Valor por Defecto

60

Observaciones

Si Timeout = 0, las operaciones no expiran. Las operaciones se ejecutan hasta que se completan correctamente o hasta que encuentran una condición de error.

Si Timeout caduca y la operación aún no se ha completado, el conector genera una excepción.

UseClientSidePaging

Si el proveedor ADO.NET para Office 365 debe o no usar la paginación del lado del cliente.

Tipo de Datos

bool

Valor por Defecto

false

Observaciones

Algunas fuentes no admiten la paginación del lado del servidor. En estos casos, establezca UseClientSidePaging en verdadero. De lo contrario, déjalo como falso. Establecer UseClientSidePaging en verdadero en una fuente que ya admite la paginación puede generar resultados incompletos.