Configuración del acceso de OData al almacén de datos (solo SaaS)

ccppmop1581
Los clientes de SaaS pueden acceder el almacén de datos y desarrollar cuadros de mandos de análisis e informes mediante los puntos finales de REST (OData). Un servidor Hybrid Data Pipeline (HDP) en el entorno de
PPM (versión clásica)
se conecta al almacén de datos y muestra los puntos finales de OData para las entidades del almacén de datos. Como desarrollador de informes o usuario del negocio, puede utilizar una herramienta de inteligencia empresarial (por ejemplo, Microsoft Power BI o Tableau) para acceder a los puntos finales de OData. Mediante los puntos finales de OData como orígenes de datos, se pueden crear cuadros de mandos e informes propios.
2
2
La siguiente imagen muestra el flujo de datos desde el almacén de datos hasta una herramienta externa de BI mediante HDP OData.
La imagen muestra el flujo de datos desde el almacén de datos hasta una herramienta externa de BI mediante HDP OData.
Proporción de acceso al servicio OData del almacén de datos
Abra la página Servicio OData como administrador del sistema para ver las direcciones URL de los puntos finales de OData v2 o v4. Proporcione la cadena de autenticación de OData y la dirección URL a los usuarios de los informes. Los usuarios de informes, mediante sus credenciales de
PPM (versión clásica)
, pueden configurar la herramienta de BI para conectarse al servicio OData.
La siguiente sugerencia solo se aplica si se está utilizando la cuenta del servicio OData de usuario único disponible en
Clarity
15.3. Después de actualizar a la versión 15.4 o posterior, para algunos informes diseñados en versiones anteriores, actualice la configuración de la conexión para utilizar las nuevas credenciales de usuario de
Clarity
. En la versión 15.4 y posteriores, ya no se puede acceder a los puntos finales de OData mediante la cuenta de servicio OData de usuario único.
Siga estos pasos:
  1. Para acceder al almacén de datos utilizando OData, verifique que está utilizando la edición SaaS de
    Clarity
    15.4 o posterior.
  2. Inicie sesión en
    PPM (versión clásica)
    .
  3. Haga clic en
    Administración
    ,
    Organización y acceso
    y
    Recursos
    .
    1. Conceda el derecho de acceso
      Servicio OData del almacén de datos - Ir a
      a los administradores responsables de la gestión del acceso a la conexión de OData. Con este derecho, los administradores pueden abrir la página Servicio OData del almacén de datos en el paso siguiente.
    2. Conceda el derecho
      OData - Acceso
      para acceder a OData de
      Clarity
      y actuar en nombre de otros usuarios como una conexión de confianza.
  4. Haga clic en
    Administración
    ,
    Valores de configuración generales
    ,
    Servicio OData del almacén de datos
    .
    Aparece la siguiente información:
    • URL del punto final de OData v2 del almacén de datos
      Define la dirección URL de OData para la instancia de
      PPM (versión clásica)
      15.4 o posterior que muestra el almacén de datos al cliente. Utilice esta dirección URL para la autenticación externa con OData v2.
      Ejemplo:
      http://
      <host:puerto>
      /api/odata/ppm_hdp_datasource_v2
    • URL del punto final de OData v4 del almacén de datos
      Define la dirección URL de OData para la instancia de
      PPM (versión clásica)
      15.4 o posterior que muestra el almacén de datos al cliente. Utilice esta dirección URL para la autenticación externa con OData v4.
      Ejemplo:
      http://
      <host:puerto>
      /api/odata4/ppm_hdp_datasource_v4
    • Autenticador de OData
      Define el calificador que se debe utilizar al acceder a los puntos finales de OData con las credenciales de usuario de
      PPM (versión clásica)
      .
  5. Comparta la dirección URL de OData (v2 o v4) y la cadena de autenticación con los desarrolladores y usuarios de informes para que puedan acceder a los puntos finales de OData.
Acceso a los puntos finales de OData mediante las credenciales de
Clarity
Con el derecho de acceso necesario y las credenciales de
PPM (versión clásica)
, los usuarios de informes pueden acceder al servicio OData.
Siga estos pasos:
  1. Conceda acceso a los usuarios de informes a los puntos finales de OData como administrador de
    PPM (versión clásica)
    , tal como se muestra a continuación:
    1. A los usuarios existentes, asígneles el derecho de acceso
      Servicio OData de almacén de datos - Ir a
      .
    2. En el caso de nuevos usuarios de informes, cree los usuarios como recursos en
      PPM (versión clásica)
      y asígneles el derecho de acceso
      Servicio OData de almacén de datos - Ir a
      .
  2. Acceda al servicio OData mediante las credenciales de
    PPM (versión clásica)
    como usuario con los derechos de acceso requeridos, tal como se muestra a continuación:
    • Introduzca el nombre de usuario con el sufijo "|" (símbolo de barra vertical) seguido del autenticador de OData, del modo siguiente:
      <USUARIO_
      Clarity
      >
      |
      <AUTENTICADOR_ODATA>
      Por ejemplo, si el nombre de usuario de
      PPM (versión clásica)
      es
      PPMODataUser
      y el autenticador de OData es
      PPMOData
      , introduzca el nombre de usuario siguiente:
      PPMODataUser|PPMOData
      .
    • Escriba la contraseña de
      PPM (versión clásica)
      .
Los usuarios no pueden acceder a los puntos finales de OData del almacén de datos mediante las credenciales de inicio de sesión de Clarity SaaS Portal ni mediante las credenciales de dominio en un entorno de inicio de sesión único federado. Para permitir el acceso a la dirección URL del punto final de OData del almacén de datos en estos entornos, complete los pasos siguientes:
  1. Cree usuarios de informes específicos en
    PPM (versión clásica)
    .
    Puede reutilizar los usuarios del producto existentes proporcionados que no tienen la opción de autenticación externa seleccionada en las propiedades del recurso en Administración. Si la opción está seleccionada, cree usuarios de informes nuevos.
  2. Establezca una contraseña para estos usuarios en
    PPM (versión clásica)
    para que puedan utilizarla para acceder a los puntos finales de OData del almacén de datos.
Activación del contenido personalizado del almacén de datos
Cualquier dato que deba estar disponible en el almacén de datos debe primero agregarse al producto. Además, se deberán activar específicamente los datos para el almacén de datos. Por ejemplo, para ver los atributos personalizados del proyecto en los informes, agregue los atributos al objeto del proyecto en
PPM (versión clásica)
Studio. Active también los atributos del almacén de datos seleccionando la casilla de verificación
Incluir en el almacén de datos
. Consulte
Activación de atributos y objetos personalizados del almacén de datos
en el tema principal
Configuración del almacén de datos y de los dominios de generación de informes avanzada
.
Actualización de los puntos finales de OData
Mientras se agregan tablas y columnas nuevas en el almacén de datos, los puntos finales de OData pueden quedarse obsoletos. Ejecute o programe los trabajos siguientes en el orden indicado para actualizar los puntos finales de OData con los cambios más recientes en el almacén de datos. Este procedimiento garantizará que los informes reflejen los datos más actuales disponibles. Para obtener más detalles sobre los trabajos, consulte
Jobs Reference
.
  1. Carga del almacén de datos
    : Ejecute este trabajo inmediatamente después de haber configurado
    PPM (versión clásica)
    para OData. El trabajo copia los datos desde las tablas de
    PPM (versión clásica)
    y los visualiza en el esquema del almacén de datos.
  2. Derechos de acceso a la carga del almacén de datos
    : El trabajo extrae los derechos de acceso para las inversiones y recursos desde la base de datos de
    PPM (versión clásica)
    y los carga en el almacén de datos. Ejecute el trabajo cada vez que se modifiquen los derechos de acceso del usuario. También puede ejecutar este trabajo después de ejecutar el trabajo Carga del almacén de datos utilizando la opción de carga completa.
  3. Actualización del modelo OData del almacén de datos
    : Ejecute este trabajo solo cuando haya un cambio en el esquema del almacén de datos como por ejemplo un objeto o atributos nuevos. El trabajo crea los puntos finales de OData para v2 y v4 en función del esquema del almacén de datos. El conector de OData puede utilizar los puntos finales para la creación de informes. Ejecute el trabajo de actualización al menos una vez después de haber configurado
    PPM (versión clásica)
    para OData.
El acceso del usuario de solo lectura al almacén de datos actualizado puede variar debido a la secuencia de carga necesaria y a trabajos de actualización. La secuencia completa de las actualizaciones puede ocurrir en unos minutos o tardar hasta dos horas. Por ejemplo, los nuevos objetos personalizados se cargan en el paso 1 cuando se ejecuta el trabajo Carga del almacén de datos. Completamente automatizado para el usuario, un trabajo Actualizar concesión de la base de datos crea y actualiza los permisos y los sinónimos para estos nuevos objetos de base de datos, ahora en el almacén de datos. El trabajo automatizado Actualizar concesión de la base de datos está programado para ejecutarse cada 2 horas. Los nuevos objetos personalizados no son visibles como puntos finales de OData para las herramientas de generación de informes hasta que se haya completado el trabajo Actualizar concesión y se haya ejecutado de nuevo el trabajo Actualización del modelo OData del almacén de datos.
Verificación de la conexión de OData
Complete los siguientes pasos para verificar que está conectados al servicio de OData.
  1. Abra un explorador web.
  2. En función de la versión de OData (v2 o v4), copie y pegue la dirección URL del punto final de OData anotada de
    PPM (versión clásica)
    .
  3. Introduzca el nombre de usuario y la contraseña para acceder al servicio OData e intente conectarse.
    • Si la conexión se realiza correctamente, verá un XML con formato de salida de OData.
    • Si no ve esta salida, póngase en contacto con Soporte de CA.
Conexión con la herramienta de BI con el servicio de OData del almacén de datos
Como desarrollador de informes, conecte la herramienta de BI existente al origen de datos de OData. Se muestran los objetos de OData y puede iniciar la creación de informes para los usuarios finales.
Los procedimientos de esta sección deben considerarse solamente como recomendaciones. Consulte la documentación para su herramienta de BI específica para obtener las instrucciones de configuración de las tareas siguientes:
  • Conexión y generación de informes mediante la fuente de OData.
  • Recuperación de datos de muestra solo si va a establecer una conexión de OData.
  • Recuperación de datos limitados al generar informes para mejorar el rendimiento.
Trabaje con el Administrador de la herramienta de BI para resolver cualquier problema de conexión que pueda surgir.
Sugerencia de Soporte de CA:
Si aparece el siguiente error en los registros, indica que un cliente ha intentado recuperar demasiados registros a la vez:
ForbiddenException: The top request exceeds the maximum entities per page limit of 10000
Por ejemplo, el mensaje siguiente indica que se ha producio un error al ejecutar la solicitud para recuperar 50000 filas:
"GET /api/odata/test_DataSource/DWH?$top=50000 HTTP/1.1"
El límite del servicio ODATA es de 10000 entidades por página. Con SSIS, si una implementación no transfiere el parámetro $top, puede producirse el mismo error. Por lo tanto, es mejor utilizar la paginación para permanecer dentro del límite de 10000 regitros. Soporte de CA es consciente de este problema con SSIS; sin embargo, el límite de paginación de 10000 entidades también se aplica al intentar automatizar el proceso con otras herramientas de BI.
Conexión a OData mediante Microsoft Power BI Desktop
Si está utilizando Power BI, realice los siguientes pasos de alto nivel para conectarse a OData.
Siga estos pasos:
  1. En el menú principal de Power BI, seleccione
    Get Data
    ,
    OData Feed
    .
  2. En la ventana
    OData Feed
    , introduzca la dirección URL del punto final de OData del almacén de datos (v2 o v4) anotada de
    PPM (versión clásica)
    .
  3. Haga clic en
    OK
    .
  4. Seleccione
    Básica
    .
  5. Introduzca el nombre de usuario y la contraseña que anotó de
    PPM (versión clásica)
    para acceder al servicio de OData.
  6. Haga clic en
    Conectar
    .
    En una conexión correcta, verá una lista de tablas del almacén de datos que se pueden utilizar para generar los informes.
Conexión a OData mediante Microsoft Excel
Clarity
muestra OData y se pueden utilizar herramientas de terceros como Microsoft Excel para consumir OData. Sin embargo,
Clarity
no admite oficialmente el consumo de OData con ninguna herramienta de terceros. Se puede utilizar la información que se incluye en este artículo de la base de conocimiento para conectarse a OData mediante Microsoft Excel.
No recomendamos el uso de Excel para generar informes. Para crear informes, se recomienda utilizar una herramienta de generación de informes como Power BI. Power BI presenta los datos con mayor rapidez gracias al almacenamiento en caché y ofrece un mejor control y seguridad de los datos. Excel no proporciona la forma apropiada para asignar los usuarios de informes a los usuarios de
PPM (versión clásica)
.
Conexión a OData utilizando Tableau Desktop
Al conectarse a OData utilizando Tableau, se deben especificar entidades individuales de OData (tablas).
  1. En
    Connect
    ,
    To a Server
    , seleccione
    OData
    como fuente de datos.
  2. En el campo Servidor de la ventana OData, introduzca la dirección URL del punto final de OData del almacén de datos anotada de
    PPM (versión clásica)
    . Utilice el formato siguiente:
    http://<host>:<puerto>/api/odata/datasource/
    <entidad>
    Donde
    <entidad>
    especifica el nombre de la tabla del almacén de datos.
  3. Seleccione
    use a specific username and password
    . Especifique el nombre de usuario y la contraseña para acceder al servicio OData.
  4. Haga clic en
    Sign in
    .
  5. Repita los pasos de este procedimiento para conectarse a las tablas del almacén de datos adicionales.
OData v4 no es compatible con Tableau, solo admite v2. Microsoft Power BI es compatible con ambas versiones.
Implementación de la seguridad de nivel de fila para los informes de BI
Trabaje con la organización de seguridad de la información para revisar la información de acceso y almacenamiento de datos. Determine la compatibilidad de la información con sus estándares de seguridad de datos. HDP no aprovecha los usuarios, los grupos o el modelo de seguridad de la estructura organizativa disponible en
PPM (versión clásica)
. El desarrollador de informes de inteligencia empresarial puede utilizar las tablas de seguridad del almacén de datos para limitar los datos visibles para los usuarios de informes.
Antes de que los usuarios puedan generar informes, implemente la seguridad de nivel de fila para proteger los datos. Active la inversión y la seguridad del nivel de fila de recursos en los informes de inteligencia empresarial. Solo los recursos y las inversiones relevantes son visibles para los usuarios finales en función de sus derechos de acceso.
Ejemplo
: Un usuario A tiene acceso a la inversión 1 y a la inversión 2. El usuario B tiene acceso a la inversión 1 y a la inversión 4. Cuando un usuario inicia sesión en su entorno de generación de informes, los informes de la inversión muestran solo las filas para las inversiones 1 y 2. El usuario B ve solo las filas para las inversiones 1 y 4.
Para activar la seguridad de nivel de fila de los informes, utilice el atributo de ID del usuario de BI para asignar los usuarios de
PPM (versión clásica)
a los usuarios de informes en la herramienta de BI. El atributo ID del usuario de BI se incluye en el objeto del recurso y se instala con el Acelerador de la Oficina de gestión de proyectos. Consulte Instalación del complemento Acelerador de PMO. El atributo no está configurado para que aparezca en las vistas de recursos de forma predeterminada. Además, el atributo está activado para el almacén de datos de forma predeterminada. Sin embargo, la opción
Incluir en el almacén de datos
no está seleccionada y es de solo lectura para el atributo de seguridad.
Configuración de la seguridad de nivel de fila en
Clarity
Complete los pasos siguientes en
PPM (versión clásica)
como administrador:
  1. Configure las vistas de recursos para agregar el atributo de ID del usuario de BI. Para obtener más detalles, consulte
    Clarity
    Studio Objects and Attributes
    .
  2. Rellene el valor del atributo ID del usuario de BI para todos los usuarios de informes con su valor de inicio de sesión de seguridad de BI. Por ejemplo, asigne el usuario de
    PPM (versión clásica)
    (usuario A) al valor del ID de usuario de BI, el usuario [email protected]<nombre_empresa>.org.
Configuración de la seguridad de nivel de fila en la herramienta de BI
  1. Los desarrolladores de informes que utilizan cualquier herramienta de BI pueden utilizar la seguridad del almacén de datos para implementar la seguridad de nivel de fila tal y como lo describen los distribuidores. El siguiente procedimiento proporciona pasos genéricos de alto nivel mediante Power BI, por ejemplo. Consulte la documentación de la herramienta de BI para obtener instrucciones sobre cómo implementar la seguridad de nivel de fila en la herramienta de BI. Por ejemplo, consulte la documentación de Microsoft Power BI para obtener instrucciones sobre cómo implementar la seguridad de nivel de fila en Power BI para restringir el acceso a datos de informes.
  2. Para rellenar el ID de usuario de BI para DWH_INV_SECURITY_V y DWH_RES_SECURITY_V, ejecute el trabajo Carga de los derechos de acceso al almacén de datos.
Siga estos pasos:
  1. Cargue las tablas siguientes en el escritorio de Power BI para rellenar los datos del informe:
    • DWH_INV_INVESTMENT: Si está generando informes sobre las inversiones, la tabla rellena los datos de las inversiones. Esta tabla se utiliza normalmente con la seguridad de la inversión. Según el caso, podrá utilizar también otras tablas que contengan la clave de la inversión.
    • DWH_RES_RESOURCE: Si está generando informes sobre los recursos, la tabla rellena los datos del recurso. Esta tabla se utiliza normalmente con la seguridad de los recursos. Según el caso, se podrán utilizar otras tablas que contengan la clave del recurso.
    • DWH_INV_SECURITY_V: La vista rellena la información de los derechos de acceso para las inversiones. La vista incluye la columna BI_User_ID que es el ID de usuario de la herramienta de BI y refleja el valor tal y como se rellena en
      PPM (versión clásica)
      .
    • DWH_RES_SECURITY_V: La vista rellena la información de los derechos de acceso para los recursos. La vista incluye la columna BI_User_ID que es el ID de usuario de la herramienta de BI y refleja el valor tal y como se rellena en
      PPM (versión clásica)
      .
  2. Cree relaciones entre las tablas y las vistas.
  3. Defina una condición where para limitar los datos a un usuario específico.
    Por ejemplo, en Power BI, vaya a Modelo, Gestionar roles, Crear rol y cree una expresión DAX en el atributo del ID BI_User tal y como se muestra a continuación:
    [ID_USUARIO_BI] = NOMBREUSUARIO()
  4. Guarde y publique el informe.
Funciones del almacén de datos de
Clarity
compatibles
Se admiten las siguientes funciones de almacén de datos en la versión 4 de OData:
DWH_CAL_CURRENT_DATE_FCT DWH_CAL_DATE_ADD_FCT DWH_CAL_DATEDIFF_FCT DWH_CAL_DATEFORMAT_FCT DWH_CAL_DATELABEL_FCT DWH_CAL_DIFF_IN_SECONDS_FCT DWH_CAL_END_OF_MONTH_FCT DWH_CAL_PERIOD_START_FCT DWH_CAL_STARTDATE_FCT DWH_CAL_TRUNC_DATE_FCT DWH_CHART_COLOR_MAP_FCT DWH_CONVERT_CURRENCY_FCT DWH_DAYS_LATE_PCT_FCT DWH_DISPLAY_MAPPING_FCT DWH_GET_RETAIN_PRECISION_FCT DWH_INV_REMAINING_ALLOC_FCT DWH_NULL_DATE_FCT DWH_NULL_NUMBER_FCT DWH_NULL_VARCHAR_FCT DWH_START_DAYS_LATE_FCT DWH_START_DAYS_LATE_PCT_FCT DWH_TO_CHAR_FCT
Se las admiten funciones de almacén de datos en la versión 4 de OData, salvo las siguientes:
  • importaciones de función
  • funciones que devuelven tipos primitivos
  • funciones que devuelven entidades o tipos complejos
  • funciones que están enlazadas a entidades
  • funciones con parámetros OUT o INOUT
  • funciones con alias de parámetro
  • funciones invocadas por las opciones de OData $filter, $select o $orderby
  • funciones invocadas por valores de parámetro que incluyen parámetros de consulta de URL
  • funciones integradas
  • funciones sobrecargadas
  • funciones desenlazadas (operaciones estáticas)
Las vistas de RU como DWH_INV_TEAM_RU_PER_FACTS_M_V no se exponen como OData.
La versión 2 de OData no es compatible con ninguna función. La versión 2 ni siquiera es compatible con las funciones de almacén de datos.