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.
- Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
- Obtiene un nuevo token de acceso cuando caduca el anterior.
- 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.
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 manualmenteOAuthAccessToken
..
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 porOAuthJWTCert
.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 manualmenteOAuthAccessToken
..
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:
- Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
- Obtiene un nuevo token de acceso cuando caduca el antiguo.
- 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.
- 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. - 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:
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.
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 porOAuthJWTCert
.
Luego puede seguir los pasos a continuación para autenticarse desde otra máquina y obtener el OAuthVerifier
propiedad de conexión.
- 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.
- 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.
- 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. - 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:
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.
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 porOAuthJWTCert
.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
.
- Inicie sesión en
https://portal.azure.com
. - 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.
- 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. - 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 configureCallbackURL
a la URL de respuesta exacta que definiste. - 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 comoOAuthClientSecret
.
- 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. - Seleccione la API de Microsoft Graph y luego seleccione los permisos que buscará su aplicación.
- Guarde sus cambios.
- 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.
Permisos de Consentimiento del Administrador
Al crear una nueva aplicación de OAuth en Azure Portal, debe especificar qué permisos requerirá la aplicación. Algunos permisos pueden estar marcados como "Consentimiento del administrador requerido". Por ejemplo, todos los permisos de Grupos requieren el consentimiento del administrador. Si su aplicación requiere el consentimiento del administrador, hay varias formas de hacerlo.
La forma más fácil de otorgar el consentimiento del administrador es simplemente hacer que un administrador inicie sesión en portal.azure.com y navegue hasta la aplicación que ha creado en Registros de aplicaciones. En Permisos de API, habrá un botón para Otorgar consentimiento. Puede dar su consentimiento aquí para que su aplicación tenga permisos en el arrendatario bajo el que se creó.
Si su organización tiene varios inquilinos o es necesario otorgar permisos a la aplicación para otros inquilinos fuera de su organización, GetAdminConsentURL se puede utilizar para generar la URL de autorización del administrador. A diferencia de GetOAuthAuthorizationURL, no se devolverá información importante desde este extremo. Si otorga acceso, simplemente devolverá un valor booleano que indica que se otorgaron los permisos.
Una vez que un administrador otorga el consentimiento, la autenticación se puede realizar normalmente.
Credenciales del Cliente
Las credenciales del cliente hacen referencia a un flujo en OAuth en el que no se lleva a cabo una autenticación directa del usuario. En cambio, las credenciales se crean solo para la aplicación en sí. Todas las tareas realizadas por la aplicación se realizan sin un contexto de usuario predeterminado. Esto hace que el flujo de autenticación sea un poco diferente al estándar.
Flujo de OAuth del Cliente
Todos los permisos relacionados con el flujo de autenticación del cliente requieren el consentimiento del administrador. Esto significa que la aplicación integrada con Jitterbit Connector 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.
Authenticating using a Client Secret
InitiateOAuth
: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmenteOAuthAccessToken
.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.
Authenticating using a Certificate
InitiateOAuth
: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmenteOAuthAccessToken
.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 porOAuthJWTCert
.
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.
- Inicie sesión en
<https://portal.azure.com>
. - 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.
- 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. - 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
- 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 comoOAuthClientSecret
.
- En la pestaña Autenticación, asegúrese de marcar la opción: Tokens de acceso (utilizados para flujos implícitos).
- Abra la página Suscripciones buscando y seleccionando el servicio Suscripciones en la barra de búsqueda.
- 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.
- 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 manualmenteOAuthAccessToken
.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:
- sys_catalogs: enumera las bases de datos disponibles.
- sys_schemas: enumera los esquemas disponibles.
- sys_tablas: enumera las tablas y vistas disponibles.
- sys_tablecolumns: Describe las columnas de las tablas y vistas disponibles.
- procedimientos_sys: describe los procedimientos almacenados disponibles.
- parámetros_procedimiento_sys: Describe procedimiento almacenado* parámetros.
- sys_keycolumns: describe las claves principal y externa.
- índices_sys: Describe los índices disponibles.
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.