Detalles de Conexión de Microsoft Project

Introducción

Versión del conector

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

Empezando

Compatibilidad con la versión de Microsoft Project

Al habilitar el acceso SQL bidireccional a Project Server, el conector modela las APIs de CSOM y OData de Microsoft Project como una base de datos relacional. Jitterbit Connector para Microsoft Project puede conectarse tanto a la nube como a las versiones locales de Project Server.

Establecer una Conexión

Conexión a Microsoft Project

Para conectarse a la fuente de datos de Microsoft Project, primero deberá especificar las siguientes propiedades de conexión.

• URL: (Obligatorio) Establézcalo en una URL de aplicación web de Microsoft Project válida. Por ejemplo:

  http://contoso.com/sites/pwa/
  

• Schema: (Opcional) Hay dos esquemas disponibles, "ODataV1" y "ODataV2". El esquema "ODataV2" (predeterminado) se puede usar para operaciones CRUD completas. Sin embargo, para fines de generación de informes, el esquema "ODataV1" es superior, ya que proporciona datos más granulares y expone los campos personalizados. Vea Modelo de datos para obtener más información sobre la funcionalidad disponible en cada Schema.

• ProjectId: (Opcional) Si se especifica el esquema "ODataV2", también puede establecer esta propiedad en un ID de proyecto específico, a fin de definir el proyecto predeterminado para todas las operaciones que lo requieran.

Autenticación en Project Online

Hay varios métodos de autenticación disponibles para conectarse a Microsoft Project, incluido el servicio de cookies de SharePoint Online para conectarse en SharePoint Online, OAuth y SSO. Los proveedores de identidad de SSO admitidos son: Azure Active Directory, OneLogin y OKTA.

Autenticación con el Servicio de Cookies de SharePoint Online

Para conectarse a Microsoft Project en SharePoint Online utilizando sus credenciales de inicio de sesión, configure AuthScheme a SharePointOnlineCookies, el User y Password a sus credenciales de usuario.

Autenticación con OAuth

Para usar el estándar de autenticación OAuth 2.0, primero debe crear una aplicación OAuth personalizada para obtener OAuthClientId, OAuthClientSecret. Además de esas propiedades, establezca CallbackURL. Consulte Uso de la autenticación OAuth2 para más información.

Debe configurar el AuthScheme a OAuth para hacer cumplir el esquema de autenticación OAuth.

Autenticación con ADFS

Selecciona el AuthScheme a ADFS. Es necesario establecer las siguientes propiedades de conexión:

• User: Configure esto para el usuario de ADFS.
• Password: Establézcalo en la contraseña de ADFS para el usuario.
• SSOLoginURL: establezca esto en la URL de inicio de sesión utilizada por el proveedor de SSO.

A continuación se muestra una cadena de conexión de ejemplo:

AuthScheme=ADFS;User=username;Password=password;SSOLoginURL='https://sts.company.com';

ADFS Integrado

El flujo integrado de ADFS indica que se está conectando con currently logged in Windows user credentials. Para usar el flujo integrado de ADFS, simplemente no especifique el User y Password, pero por lo demás siga los mismos pasos en la guía ADFS anterior.

Autenticación con Okta

Selecciona el AuthScheme a Okta. Las siguientes propiedades de conexión se utilizan para conectarse a Okta:

• User: Configure esto para el usuario de Okta.
• Password: establezca esto en la contraseña de Okta para el usuario.
• SSOLoginURL: establezca esto en la URL de inicio de sesión utilizada por el proveedor de SSO.

La siguiente SSOProperties son necesarios para autenticarse en Okta:

• APIToken (opcional): establezca esto en el token de API que el cliente creó a partir de la organización de Okta. Debe usarse al autenticar a un usuario a través de una aplicación confiable o un proxy que anula el contexto de solicitud del cliente de OKTA.
• MFAType (opcional): configure esto solo en caso de que haya configurado el flujo MFA. Actualmente solo admitimos los siguientes tipos: OktaVerify, Correo y SMS.
• MFAPassCode (opcional): configure esto solo en caso de que haya configurado el flujo MFA. Si está configurado como vacío/no válido, el controlador emitirá inicialmente un desafío de MFA que activará la plataforma para enviarle una contraseña de un solo uso a su dispositivo o correo, según el tipo de MFA configurado. Debe volver a emitir otra conexión en la que el valor de la contraseña de un solo uso recuperado se pase a la propiedad de conexión MFAPassCode.

La siguiente es una cadena de conexión de ejemplo:

AuthScheme=Okta;SSOLoginURL='https://example.okta.com/home/appType/0bg4ivz6cJRZgCz5d6/46';User=oktaUserName;Password=oktaPassword;

Autenticación con OneLogin

Selecciona el AuthScheme a OneLogin. Las siguientes propiedades de conexión se utilizan para conectarse a OneLogin:

• User: Configure esto para el usuario OneLogin.
• Password: establezca esto en la contraseña de OneLogin para el usuario.

La siguiente SSOProperties son necesarios para autenticarse en OneLogin:

• OAuthClientId: establezca el OAuthClientId, que se puede obtener seleccionando Developers > API Credentials > Credential > ClientId.
• OAuthClientSecret: establezca OAuthClientSecret, que se puede obtener seleccionando Developers > API Credentials > Credential > ClientSecret.
• Subdominio: establezca el subdominio del usuario de OneLogin que accede a la aplicación SSO. Por ejemplo, si su URL de OneLogin es splinkly.onelogin.com, ingrese splinkly como el valor del subdominio.
• AppId: establezca el ID de la aplicación SSO.
• Región (opcional): establezca la región en la que reside su cuenta de OneLogin. La API de OneLogin funciona en varias regiones y esta propiedad se utiliza para encontrar el dominio correcto. Puede tomar uno de los siguientes valores:
  • EE. UU. (predeterminado)
  • UE

La siguiente es una cadena de conexión de ejemplo: La siguiente cadena de conexión usa una clave API para conectarse a OneLogin:

AuthScheme=OneLogin;User=OneLoginUserName;Password=OneLoginPassword;SSOProperties='OAuthClientID=3fc8394584f153ce3b7924d9cd4f686443a52b;OAuthClientSecret=ca9257fd5cc3277abb5818cea28c06fe9b3b285d73d06;Subdomain=OneLoginSubDomain;AppId=1433920';

Uso de la Autenticación OAuth2

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

Credenciales Personalizadas

Puede registrar una aplicación para obtener el OAuthClientId y OAuthClientSecret.

Cuándo Crear una Aplicación OAuth Personalizada

Debe crear una aplicación OAuth personalizada en el flujo de escritorio.

Credenciales Personalizadas

Cuándo Usar una Aplicación OAuth Personalizada

Autenticación de Escritorio con una Aplicación OAuth Personalizada

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

Obtenga y Actualice el Token de Acceso de OAuth

Después de configurar lo siguiente, está listo para conectarse:

• OAuthClientId: Establézcalo en el ID de cliente asignado cuando registró su aplicación.
• OAuthClientSecret: establezca esto en el secreto de cliente asignado cuando registró su aplicación.
• CallbackURL: establezca esto en la devolución de llamada definida cuando registró su aplicación.
• URL: establezca esto en la URL de su instancia de servicio.
• 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. Actualiza el token de acceso cuando caduca.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Obtenga un Token de Acceso OAuth

Establezca las siguientes propiedades de conexión para obtener OAuthAccessToken:

• 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 devolución de llamada definida cuando registró su aplicación.
• URL: establezca esto en la URL de su instancia de servicio.

A continuación, puede llamar a procedimientos almacenados* para completar el intercambio de OAuth:

1. Llame a GetOAuthAuthorizationURL procedimiento almacenado. Establezca la entrada CallbackURL en la devolución de llamada que especificó en la configuración de su aplicación.

   El procedimiento almacenado* devuelve la URL al extremo de OAuth.

2. Abra la URL, inicie sesión y autorice la aplicación. Se le redirigirá a la URL de devolución de llamada.

3. Llame al GetOAuthAccessToken procedimiento almacenado. Establezca la entrada del Verificador en el parámetro "código" en la cadena de consultar de la URL de devolución de llamada.

Actualizar el Token de Acceso de OAuth

Puede establecer InitiateOAuth a REFRESH para actualizar automáticamente el token de acceso de OAuth cuando caduque, o puede llamar a RefreshOAuthAccessToken procedimiento almacenado* para actualizar el token manualmente.

Actualización automática

Para actualizar el token con InitiateOAuth, configure lo siguiente en la primera conexión de datos:

• OAuthAccessToken: establezca esto en el token de acceso devuelto por GetOAuthAccessToken.
• InitiateOAuth: Establézcalo en ACTUALIZAR. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.
• OAuthSettingsLocation: Establézcalo en la ruta donde el conector guardará los valores de OAuth, para que se conserven entre las conexiones.
• 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.
• OAuthRefreshToken: establezca esto en el token de actualización devuelto por GetOAuthAccessToken.
• URL: establezca esto en la URL de su instancia de servicio.

En conexiones de datos posteriores, establezca lo siguiente:

• InitiateOAuth
• OAuthSettingsLocation
• URL: establezca esto en la URL de su instancia de servicio.

Actualización manual

Puede usar el RefreshOAuthAccessToken procedimiento almacenado* para actualizar manualmente el OAuthAccessToken. Llame al procedimiento almacenado* después del valor del parámetro ExpiresIn devuelto por GetOAuthAccessToken ha transcurrido. Necesita establecer las siguientes propiedades de conexión:

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

A continuación, puede llamar a RefreshOAuthAccessToken con el siguiente conjunto de parámetros:

• OAuthRefreshToken: Establézcalo en OAuthRefreshToken devuelto por GetOAuthAccessToken.

Máquinas Sin Cabeza

Uso de OAuth en una Máquina Sin Cabeza

Para establecer una conexión con la fuente de datos de Microsoft Project 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 utilizando 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

Establezca las siguientes propiedades en la máquina sin periféricos:

• InitiateOAuth = APAGADO.
• OAuthClientId = Identificación del cliente.
• OAuthClientSecret = Secreto del cliente.
• URL = La URL de su sitio ( https://{site}.sharepoint.com/sites/pwa).

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 redirige a la URL de devolución de llamada, que contiene el código verificador.
3. Guarde el valor del código verificador. Establecerá esto en el OAuthVerifier propiedad de conexión.

En la máquina sin periféricos, establezca las siguientes propiedades de conexión para obtener los valores de autenticación de OAuth:

• OAuthClientId = Identificación del cliente.
• OAuthClientSecret = Secreto del cliente.
• URL = La URL de su sitio ( https://{site}.sharepoint.com/sites/pwa).
• 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 el siguiente conjunto de propiedades:

• 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.
• URL = La URL de su sitio ( https://{site}.sharepoint.com/sites/pwa).

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

Autenticarse Usando Credenciales de OAuth Personalizadas

Puede crear una aplicación OAuth a través de la interfaz de usuario de su sitio o ingresando manualmente el enlace de creación de la aplicación de su sitio en su navegador: https://{site}.sharepoint.com/sites/{Project_Web_App_Site}/\_layouts/15/appregnew.aspx.

Después de completar los campos obligatorios, puede hacer clic en "Crear" y se mostrarán las siguientes credenciales.

Tenga en cuenta que al crear la aplicación OAuth, se le pedirá que especifique una URL de devolución de llamada.

Esta es la URL a la que será redirigido después de otorgar acceso explícitamente. Microsoft Project requiere esta devolución de llamada para usar 'https://'.

Puede evitar esta restricción proporcionando 'https://oauth.cdata.com/oauth/' como devolución de llamada, y agregar una propiedad de conexión de estado adicional que contendrá la devolución de llamada de redirección real. Copie el ClientID y el ClientSecret que necesitará más adelante.
Para acceder a la API del proyecto de Microsoft, debemos otorgar permisos de alcance a la aplicación creada. Para hacer eso, vaya a la siguiente URL: https://{site}.sharepoint.com/sites/{Project_Web_App_Site}/\_layouts/15/AppInv.aspx.<br/> En el campo ID de la aplicación, ingrese el ClientID obtenido al crear la aplicación y haga clic en Buscar. Los otros campos deben completarse automáticamente con los detalles de las aplicaciones, como Título, Dominio de la aplicación y URL de redireccionamiento. En el XML de solicitud de permisos ingrese lo siguiente:

<AppPermissionRequests>
<AppPermissionRequest Scope="http://sharepoint/projectserver" Right="Manage"/>
<AppPermissionRequest Scope="http://sharepoint/projectserver/projects" Right="Write"/>
<AppPermissionRequest Scope="http://sharepoint/projectserver/enterpriseresources" Right="Write"/>
<AppPermissionRequest Scope="http://sharepoint/projectserver/reporting" Right="Read"/>
</AppPermissionRequests>

Estos son los permisos predeterminados necesarios para tener acceso completo a la API. Además, el usuario que inició sesión debe asegurarse de tener los permisos adecuados para acceder a la API. En caso de que su Project Web App (PWA) esté en modo de permiso de Proyecto, puede otorgar explícitamente acceso a los servicios web para usuarios de PWA específicos. Para hacer esto, puede seguir los pasos a continuación.

1. Abra la página 'Configuración de PWA' en su PWA.
2. Haga clic en 'Administrar usuarios' en la sección de seguridad.
3. Haga clic en el 'Nombre de usuario' del usuario interesado.
4. En la página 'Editar usuario', expanda la sección Permisos globales.
5. Asegúrese de que la casilla de verificación 'Permitir' de 'Access Project Server Reporting Service' la opción en la sección 'General' está marcada.

En caso de que su PWA esté en modo de permiso de SharePoint, deberá agregar al usuario interesado en un grupo con al menos 'Access Project Server Reporting Service' permiso habilitado, como: Visores de cartera, Gestores de cartera y Administradores. Para hacer esto, puede seguir los pasos a continuación.

1. Abra la página 'Configuración de PWA' en su PWA.
2. Haga clic en 'Administrar usuarios' en la sección de seguridad.
3. Haga clic en el 'Nombre de usuario' del usuario interesado.
4. En 'Editar usuario' y en 'Grupos de seguridad', seleccione uno de los grupos con los permisos de acceso requeridos (como: Visores de cartera, Gestores de cartera y Administradores) y haga clic en '>' botón para agregar el usuario actual.

Ahora puede usar estas credenciales para conectarse a Microsoft Project configurándolas como las siguientes propiedades de conexión:

• InitiateOAuth = GETANDREFRESH.
• OAuthClientId = Identificación del cliente.
• OAuthClientSecret = Secreto del cliente.
• CallbackURL = Su URL de devolución de llamada.
• URL = La URL de su sitio ( https://{site}.sharepoint.com/sites/{Project_Web_App_Site }).

Alternativamente, para usar la devolución de llamada:

Ahora puede usar estas credenciales para conectarse a Microsoft Project configurándolas como las siguientes propiedades de conexión:

• InitiateOAuth = GETANDREFRESH.
• OAuthClientId = Identificación del cliente.
• OAuthClientSecret = Secreto del cliente.
• CallbackURL = https://oauth.cdata.com/oauth/.
• Estado = Su URL de devolución de llamada real (por ejemplo , http://localhost:3333).
• URL = La URL de su sitio ( https://{site}.sharepoint.com/sites/{Project_Web_App_Site }).

Desaprobación de CSOM

Se han realizado algunos cambios en el conector en la edición 2020 que deben tenerse en cuenta.

Soporte CSOM Discontinuado

Antes de la edición 2020 del conector, se admitían las conexiones a Microsoft Project mediante la interfaz CSOM y OData, lo que generaba dificultades para mantener los dos esquemas simultáneamente.

Al eliminar la compatibilidad con CSOM, las conexiones a Microsoft Project se optimizan debido a la falta de propiedades de conexión especiales creadas específicamente para cada esquema. Además, la interfaz OData ahora puede realizar todas las mismas operaciones CRUD que el CSOM es capaz de hacer. Por último, el CSOM está mal documentado y es más propenso a errores que OData.

Por estas razones, se tomó la decisión de desaprobar el apoyo a la CSOM a favor de apoyar exclusivamente el OData interfaz.

Rendimiento Mejorado con Operaciones Masivas de OData

Una ventaja adicional de usar la interfaz OData de Microsoft Project exclusivamente es el soporte para operaciones masivas eficientes.

Los datos de Microsoft Project deben desprotegerse, se realiza una operación de INSERTAR/ACTUALIZAR/ELIMINAR, los cambios se publican y, finalmente, los cambios se desprotegen.

A veces, el paso de pago puede fallar, lo que genera numerosas solicitudes por operación INSERTAR/ACTUALIZAR/ELIMINAR.

Con el soporte lote del conector, puede reducir drásticamente la cantidad de solicitudes enviadas, ya que se pueden enviar varios registros a la vez a través del proceso de entrada/salida.

Consulte Procesamiento por lotes para obtener detalles sobre las operaciones lote.

Características Avanzadas

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

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

Hay dos formas de crear vistas definidas por el usuario:

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

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

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

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

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

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

Por ejemplo:

{
    "MyView": {
        "query": "SELECT * FROM Projects 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

Descripción general

Jitterbit Connector para Microsoft Project modela los objetos de Microsoft Project como tablas y vistas relacionales. Un objeto de Microsoft Project tiene relaciones con otros objetos; en las tablas, estas relaciones se expresan a través de claves foráneas.

Conexión con el esquema ODataV2

El Modelo de datos ODataV2 (predeterminado) se puede usar para operaciones CRUD completas. Los metadatos de las columnas principales se recuperan dinámicamente para cada entidad, pero el esquema es fijo y los campos personalizados no están incluidos.

Mesas y Vistas describen un ejemplo de las tablas disponibles en la API de ODataV2.

Conexión con el esquema ODataV1

El Modelo de datos ODataV1 solo se puede utilizar para leer datos. Los metadatos se recuperan dinámicamente, incluidos los campos personalizados para este esquema.

Puntos de vista describen una muestra de las vistas disponibles en la API de ODataV1.

Características clave

• El conector modela entidades de Microsoft Project como tablas y vistas relacionales, lo que le permite escribir SQL para consultar datos de Microsoft Project.
• Procedimientos almacenados* le permiten ejecutar operaciones en Microsoft Project.
• La conectividad en vivo a estos objetos significa que cualquier cambio en su cuenta de Microsoft Project se refleja de inmediato al usar el conector.

Procesamiento colaborativo de consultas

El conector descarga la mayor parte posible del procesamiento de la instrucción SELECT en Microsoft Project y luego procesa el resto de la consultar en la memoria. Ver SupportEnhancedSQL para obtener más información sobre cómo el conector elude las limitaciones de la API con el procesamiento del lado del cliente en memoria.

Las declaraciones SELECT para las tablas principales se admiten principalmente en el lado del servidor. Por ejemplo:

SELECT * FROM Tasks WHERE Id = '61a6cc2d-cff5-e911-b093-00155ddc7224'

se ejecutará del lado del servidor.

Nota: Al ejecutar sentencias SELECT en tablas secundarias, todo se procesa del lado del cliente.

Modelo de Datos ODataV2

El esquema ODataV2 implementa los extremos del servicio ProjectServer, que admite operaciones CRUD completas.

Mesas

Mesas se recuperan dinámicamente de la cuenta de Microsoft Project autenticada.

Puntos de Vista

Solo lectura Vistas se recuperan dinámicamente de la cuenta de Microsoft Project autenticada.

Procedimientos Almacenados

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

Procedimientos almacenados son interfaces similares a funciones para Microsoft Project. Procedimientos almacenados* le permiten ejecutar operaciones en Microsoft Project.

Ventajas de ODataV2 en Comparación con ODataV1

• Admite operaciones de escritura (INSERTAR, ACTUALIZAR y ELIMINAR) en las tablas expuestas.

Limitaciones de ODataV2

• Para consultar algunas tablas y vistas, como Asignaciones, Recursos del proyecto, Enlaces de tareas y Tareas,

  el ProjectId debe especificarse en los criterios de la cláusula WHERE de la consulta o a través de ProjectId propiedad de conexión.

• Los campos personalizados no están expuestos.

Mesas

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

Generalmente, consultar tablas de Microsoft Project 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 Microsoft Project

Asignaciones

Recuperar y modificar asignaciones.

Información Específica de la Tabla

Para consultar esta tabla, se debe especificar ProjectId en los criterios de la cláusula WHERE de la consulta o a través de ProjectId propiedad de conexión.

SELECT * FROM Assignments WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Columnas

Calendarios

Recuperar y modificar calendarios.

Columnas

EnterpriseResources

Recuperar y modificar recursos.

Columnas

Etapas

Recuperar y modificar fases del proyecto.

Columnas

ProyectoRecursos

Recuperar y modificar recursos del proyecto.

Información Específica de la Tabla

Para consultar esta tabla, se debe especificar ProjectId en los criterios de la cláusula WHERE de la consulta o a través de ProjectId propiedad de conexión.

SELECT * FROM ProjectResources WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Columnas

Proyectos

Recuperar y modificar proyectos.

Columnas

Etapas

Recuperar y modificar etapas del proyecto.

Columnas

Enlaces de Tareas

Recuperar y modificar enlaces de tareas.

Información Específica de la Tabla

Para consultar esta tabla, se debe especificar ProjectId en los criterios de la cláusula WHERE de la consulta o a través de ProjectId propiedad de conexión.

SELECT * FROM TaskLinks WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Columnas

Tareas

Recuperar y modificar tareas.

Información Específica de la Tabla

Para consultar esta tabla, se debe especificar ProjectId en los criterios de la cláusula WHERE de la consulta o a través de ProjectId propiedad de conexión.

SELECT * FROM Tasks WHERE ProjectId = '99a38309-dc1d-eb11-bf8a-00155d9c6312'

Columnas

TimeSheetLines

Recuperar y modificar hojas de tiempo.

Columnas

Hojas de Horas

Recuperar y modificar hojas de tiempo.

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 Microsoft Project

Asignación_recurso

Recuperar y modificar asignaciones.

Columnas

Tarea_asignación

Recuperar y modificar asignaciones.

Columnas

Eventos

Recuperar eventos.

Columnas

ProyectoDetallesPáginas

Recuperar detalles del proyecto.

Columnas

EtapaDetallePáginas

Recuperar detalles del proyecto..

Columnas

Tareas_Asignaciones

Recuperar y modificar asignaciones.

Columnas

Tareas_Calendario

Recuperar y modificar asignaciones.

Columnas

Períodos de Hoja de Tiempo

Recuperar períodos del parte de horas.

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 Microsoft Project

Registrarse

Registre el proyecto especificado.

Aporte

Columnas del Conjunto de Resultados

Verificar

Echa un vistazo al proyecto especificado.

Aporte

Columnas del Conjunto de Resultados

Obtener Token de Acceso de OAuth

Obtiene un token de autenticación de Microsoft Project.

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 OAuthAccessToken desde esta URL.

Aporte

Columnas del Conjunto de Resultados

GetOnlineCookies

Recupera las cookies para la autenticación con SharePoint Online.

Aporte

Columnas del Conjunto de Resultados

Publicar

Publicar el proyecto especificado.

Aporte

Columnas del Conjunto de Resultados

RefreshOAuthAccessToken

Actualiza el token de acceso de OAuth utilizado para la autenticación con Microsoft Project.

Aporte

Columnas del Conjunto de Resultados

Buscar

Busca OData usando la URL dada.

Aporte

Columnas del Conjunto de Resultados

Modelo de Datos ODataV1

El esquema ODataV1 implementa los extremos del servicio ProjectData, que es de solo lectura y solo se puede usar para generar informes.

Puntos de Vista

Solo lectura Vistas se recuperan dinámicamente de la cuenta de Microsoft Project autenticada.

Procedimientos Almacenados

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

Procedimientos almacenados son interfaces similares a funciones para Microsoft Project. Procedimientos almacenados* le permiten ejecutar operaciones en Microsoft Project.

Ventajas de ODataV1 en Comparación con ODataV2

• Los campos personalizados se exponen como columnas de vista.
• No se requiere ProjectId para consultar ninguna de las vistas expuestas, ya que los extremos de ProjectData devuelven datos para todos los proyectos disponibles.

Limitaciones de ODataV1

• No se admite ninguna operación de escritura ya que este esquema es de solo lectura.

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 Microsoft Project

Líneas Base de Asignación

Recuperar líneas base de asignación.

Columnas

AsignaciónBaselineTimephasedDataSet

Recuperar el conjunto de datos con fases temporales de la línea de base de la asignación.

Columnas

Asignaciones

Recuperar asignaciones.

Columnas

AsignaciónConjunto de Datos de Fase Temporal

Recuperar el conjunto de datos de fase temporal de la asignación.

Columnas