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 Azure Service Principal¶

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

Uso de la Autenticación OAuth¶

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

Credenciales Integradas¶

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

Credenciales Personalizadas¶

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

Cuándo Crear una Aplicación OAuth Personalizada¶

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

Creación de una Aplicación OAuth Personalizada¶

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

Credenciales Integradas¶

Autenticarse con las Credenciales de OAuth Integradas¶

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

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

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

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

Credenciales Personalizadas¶

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

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

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

Obtenga un Token de Acceso OAuth¶

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

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

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

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

Máquinas Sin Cabeza¶

Uso de OAuth en una Máquina Sin Cabeza¶

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

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

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

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

Cree una aplicación OAuth personalizada

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

Obtenga un código verificador

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

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

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

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

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

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

Conectarse a datos

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

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

Transferir configuración de OAuth

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

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

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

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

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

Creación de una Aplicación OAuth Personalizada¶

Cuándo Crear una Aplicación OAuth Personalizada¶

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

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

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

Pasos para Crear una Aplicación OAuth Personalizada¶

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

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

Consentimiento del Administrador¶

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

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.

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

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

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

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

Credenciales Personalizadas¶

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

Creación de una Aplicación OAuth Personalizada¶

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

Creación de una Aplicación OAuth Personalizada¶

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

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

Pasos para Crear una Aplicación OAuth Personalizada¶

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

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

Credenciales Personalizadas¶

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

Autenticación con Su Aplicación OAuth¶

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

Obtenga un Token de Acceso OAuth¶

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

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

Tareas Administrativas¶

El conector Jitterbit para Office 365 se puede usar para realizar tareas administrativas. Esto se puede hacer especificando la columna UserId para ejecutar operaciones CUD.

La Columna de ID de Usuario¶

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

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

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

Notas Importantes¶

Procedimientos Almacenados¶

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

Archivos de Configuración y Sus Rutas¶

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

Características Avanzadas¶

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

Vistas definidas por el usuario

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

Configuración SSL

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

Apoderado

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

Vistas Definidas por el Usuario¶

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

Hay dos formas de crear vistas definidas por el usuario:

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

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

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

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

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

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

Por ejemplo:

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

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

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

Esquema para Vistas Definidas por el Usuario¶

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

Trabajar con Vistas Definidas por el Usuario¶

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

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

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

Dando como resultado la consultar efectiva a la fuente:

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

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

Configuración SSL¶

Personalización de la Configuración SSL¶

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

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

Modelo de Datos¶

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

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

Mesas

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

Procedimientos almacenados

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

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

Mesas¶

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

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

Conector Jitterbit para Tablas de Office 365¶

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¶

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¶

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¶

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¶

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¶

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¶

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¶

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¶

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¶

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¶

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¶

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¶

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¶

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¶

Asignar Licencia¶

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

Aporte¶

Columnas del Conjunto de Resultados¶

Cancelar Evento¶

Cancela un evento.

Aporte¶

Columnas del Conjunto de Resultados¶

Crear Carpeta¶

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

Aporte¶

Columnas del Conjunto de Resultados¶

CrearEsquema¶

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

Aporte¶

Columnas del Conjunto de Resultados¶

Descargar Archivos Adjuntos¶

Descargar los archivos adjuntos de un correo

Aporte¶

Columnas del Conjunto de Resultados¶

DescargarCorreo Electrónico¶

Descargar el Correo

Aporte¶

Columnas del Conjunto de Resultados¶

Descargar Archivo¶

Descargar el archivo

Aporte¶

Columnas del Conjunto de Resultados¶

Reenviar Evento¶

Reenviar eventos a los destinatarios.

Aporte¶

Columnas del Conjunto de Resultados¶

ReenviarCorreo¶

Recuperar correo reenviado.

Aporte¶

Columnas del Conjunto de Resultados¶

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¶

Columnas del Conjunto de Resultados¶

Obtener Token de Acceso de OAuth¶

Obtiene un token de autenticación de Office365.

Aporte¶

Columnas del Conjunto de Resultados¶

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¶

Columnas del Conjunto de Resultados¶

MoveMail¶

Mover correo.

Aporte¶

Columnas del Conjunto de Resultados¶

RefreshOAuthAccessToken¶

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

Aporte¶

Columnas del Conjunto de Resultados¶

Enviar Correo¶

Enviar correo.

Aporte¶

Subir Archivo¶

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

Aporte¶

Columnas del Conjunto de Resultados¶

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¶

Sys_schemas¶

Enumera los esquemas disponibles.

La siguiente consultar recupera todos los esquemas disponibles:

SELECT * FROM sys_schemas

Columnas¶

Sys_tables¶

Enumera las tablas disponibles.

La siguiente consultar recupera las tablas y vistas disponibles:

SELECT * FROM sys_tables

Columnas¶

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¶

Sys_procedimientos¶

Enumera los procedimientos almacenados disponibles.

La siguiente consultar recupera los procedimientos almacenados disponibles:

SELECT * FROM sys_procedures

Columnas¶

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¶

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¶

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¶

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¶