Configuration de l'accès OData à l'entrepôt de données (SaaS uniquement)

ccppmop159
Les clients SaaS peuvent accéder à l'entrepôt de données et développer les tableaux de bord d'analyse et les rapports via les terminaux REST (OData). Un serveur HDP (Hybrid Data Pipeline) dans l'environnement
PPM classique
se connecte à l'entrepôt de données et présente les terminaux OData aux entités de l'entrepôt de données. En tant que développeur ou utilisateur de rapports, vous pouvez utiliser un outil d'aide à la décision (par exemple, Microsoft Power BI ou Tableau) pour accéder aux terminaux OData. En utilisant les terminaux OData comme sources de données, vous pouvez créer vos propres tableaux de bord et rapports.
2
2
L'image suivante illustre le flux de données de l'entrepôt de données à un outil externe d'aide à la décision exécuté à l'aide du protocole OData HDP :
The image shows the data flow from the data warehouse to an external BI tool using HDP OData.
Accès au service OData de l'entrepôt de données
En tant qu'administrateur système, ouvrez la page Service OData pour afficher les URL des terminaux OData v2 ou v4. Spécifiez l’URL et la chaîne d’authentification OData à vos utilisateurs de rapports. A l'aide de leurs informations d'identification
PPM classique
, les utilisateurs de rapport peuvent configurer leur outil BI pour se connecter au service OData.
Le conseil suivant s'applique uniquement si vous utilisiez le compte de service OData à utilisateur unique disponible dans
Clarity
15.3. Après une mise à niveau vers la version 15.4 ou supérieure, pour tous les rapports conçus précédemment, mettez à jour les paramètres de connexion pour utiliser à présent les nouvelles informations d'identification utilisateur
Clarity
. Dans les versions 15.4 et ultérieures, les terminaux OData ne sont plus accessibles via le compte de service OData mono-utilisateur.
Procédez comme suit :
  1. Pour accéder à l'entrepôt de données à l'aide du service OData, vérifiez que vous utilisez l'édition SaaS de
    Clarity
    15.4 ou version ultérieure.
  2. Connectez-vous à
    PPM classique
    .
  3. Cliquez sur
    Administration
    ,
    Organisation et accès
    ,
    Ressources
    .
    1. Accordez le droit d'accès
      Service OData de l'entrepôt de données - Naviguer
      aux administrateurs chargés de la gestion de l'accès à la connexion OData. Ce droit permet aux administrateurs d'ouvrir la page Service OData de l'entrepôt de données à l'étape suivante.
    2. Accordez le droit
      OData - Accéder
      pour accéder au service
      Clarity
      OData et agir au nom d'autres utilisateurs via une connexion sécurisée.
  4. Cliquez sur
    Administration
    ,
    Paramètres généraux
    ,
    Service OData de l'entrepôt de données
    .
    Les informations suivantes apparaissent :
    • URL du terminal OData v2 de l'entrepôt de données
      Définit l'URL du service OData pour l'instance
      PPM classique
      15.4 ou version ultérieure qui présente l'entrepôt de données au client. Utilisez cette URL pour l'authentification externe auprès du service OData v2.
      Exemple
      : http://
      <hôte:port>
      /api/odata/ppm_hdp_datasource_v2
    • URL du terminal OData v4 de l'entrepôt de données
      Définit l'URL du service OData pour l'instance
      PPM classique
      15.4 ou version ultérieure qui présente l'entrepôt de données au client. Utilisez cette URL pour l'authentification externe auprès du service OData v4.
      Exemple
      : http://
      <hôte:port>
      /api/odata/ppm_hdp_datasource_v4
    • Authentificateur OData
      Définit le qualificatif à utiliser pour accéder aux terminaux OData avec les informations d'identification utilisateur
      PPM classique
      .
  5. Partagez l'URL OData (v2 ou v4) et la chaîne d'authentification avec les utilisateurs et les développeurs de rapports pour leur permettre d'accéder aux terminaux OData.
Accès aux terminaux OData à l'aide des informations d'identification
Clarity
Avec les droit d'accès nécessaires et leurs informations d'identification
PPM classique
, les utilisateurs de rapports peuvent accéder au service OData.
Procédez comme suit :
  1. En tant qu'administrateur
    PPM classique
    , autorisez les utilisateurs de rapport à accéder aux terminaux OData comme suit :
    1. Affectez le droit d'accès
      Service OData de l'entrepôt de données - Naviguer
      aux utilisateurs existants.
    2. Pour les nouveaux utilisateurs de rapports, créez les utilisateurs en tant que ressources dans
      PPM classique
      et affectez-leur le droit
      Service OData de l'entrepôt de données - Naviguer
      .
  2. En tant qu'utilisateur disposant du droit d'accès nécessaire, accédez au service OData à l'aide de vos informations d'identification
    PPM classique
    , comme suit :
    • Entrez le nom d'utilisateur avec une barre verticale ( | ) comme suffixe, suivie de l'authentificateur OData comme suit :
      <utilisateur_
      Clarity
      >
      |
      <authentificateur_OData>
      . Par exemple, si le nom d'utilisateur 
      PPM classique
      est
      PPMODataUser
      et que l'authentificateur OData est
      PPMOData
      , entrez le nom d'utilisateur suivant :
      PPMODataUser|PPMOData
      .
    • Entrez le mot de passe
      PPM classique
      .
Les utilisateurs ne peuvent pas accéder aux terminaux OData de l'entrepôt de données à l'aide de leurs informations d'identification de connexion à Clarity SaaS Portal ou des informations d'identification du domaine dans un environnement à authentification unique fédérée. Pour autoriser l'accès à l'URL de terminal OData de l'entrepôt de données dans ces environnements, procédez comme suit :
  1. Créez des utilisateurs de rapport spécifiques dans
    PPM classique
    .
    Vous pouvez réutiliser les utilisateurs de produit existants. Pour cela, l'option Authentification externe doit être activée dans les propriétés de ressource, sous Administration. Si l'option est sélectionnée, créez des utilisateurs de rapport.
  2. Définissez un mot de passe pour ces utilisateurs dans
    PPM classique
    afin qu'ils puissent l'utiliser pour accéder aux terminaux OData de l'entrepôt de données.
Activation du contenu personnalisé pour l’entrepôt de données
Toutes les données que vous souhaitez mettre à disposition dans l’entrepôt de données doivent d'abord être ajoutées dans le produit. De plus, vous devez spécifiquement activer les données pour l’entrepôt de données. Par exemple, pour afficher vos attributs de projet personnalisés dans les rapports, ajoutez-les à l’objet Projet dans
PPM classique
Studio. De plus, activez les attributs pour l’entrepôt de données en sélectionnant la case à cocher
Inclure dans l'entrepôt de données
. Reportez-vous à la section
Activation des objets personnalisés et les attributs pour l’entrepôt de données
dans la section parente (
Configurer les domaines de l’entrepôt de données et de génération de rapports avancés
).
Actualisation des terminaux OData
A mesure que des nouvelles tables et colonnes sont ajoutées dans l’entrepôt de données, les terminaux OData peuvent devenir obsolètes. Exécutez ou planifiez les jobs suivants dans l’ordre répertorié pour mettre à jour les terminaux OData avec les dernières modifications apportées à l’entrepôt de données. En appliquant cette procédure, vos rapports reflètent les plus récentes données disponibles. Pour plus d’informations sur les jobs, reportez-vous à l'article
Référence de jobs
.
  1. Chargement de l'entrepôt de données
    : exécutez ce job immédiatement après la configuration de
    PPM classique
    pour OData. Le job copie les données des tables et vues
    PPM classique
    dans le schéma de l'entrepôt de données.
  2. Chargement des droits d'accès à l'entrepôt de données
    : ce job extrait les droits d'accès pour les investissements et les ressources à partir de la base de données
    PPM classique
    et les charge dans l'entrepôt de données. Exécutez le job lors de chaque changement des droits d’accès utilisateur. Exécutez-le également après le job de chargement de l'entrepôt de données à l’aide de l'option de chargement complet.
  3. Actualiser le modèle OData de l'entrepôt de données
    : exécutez ce job uniquement en cas de changement apporté au schéma de l'entrepôt de données tels des attributs ou un objet nouveau. Le job crée les terminaux OData pour les versions v2 et v4 en fonction du schéma de l'entrepôt de données. Le connecteur OData peut utiliser les terminaux pour la création de rapports. Exécutez le job d’actualisation au moins une fois après la configuration de
    PPM classique
    pour OData.
L'accès en lecture seule à l'entrepôt de données mis à jour peut varier en fonction de la séquence des jobs de charge et d'actualisation requis. La séquence complète des mises à jour peut durer quelques minutes ou jusqu'à deux heures. Par exemple, tous les nouveaux objets personnalisés sont chargés à l’étape 1 lorsque vous exécutez le job de chargement de l'entrepôt de données. Entièrement automatisé, le job d'actualisation des droits d'accès à la base de données (Refresh Grant database) crée et met à jour les autorisations et divisions pour les nouveaux objets de base de données, figurant à présent dans l’entrepôt de données. L'exécution du job automatisé d'actualisation des droits d'accès à la base de données est prévue toutes les 2 heures. Vos nouveaux objets personnalisés ne sont pas visibles en tant que terminaux OData pour les outils de génération de rapports avant la fin du job d'actualisation des droits d'accès et de la réexécution du job d’actualisation du modèle OData de l'entrepôt de données.
Vérification de la connexion OData
Pour vérifier que vous êtes connecté au service OData, procédez comme suit.
  1. Ouvrez un navigateur Web.
  2. Selon votre version OData (v2 ou v4), copiez et collez l'URL de terminal OData que vous avez notée dans
    PPM classique
    .
  3. Entrez le nom d’utilisateur et le mot de passe pour accéder au service OData et essayez de vous connecter.
    • Si la connexion est établie, une sortie OData au format XML s'affiche.
    • Si cette sortie ne s'affiche pas, contactez le service de support CA.
Connexion de votre outil d'aide à la décision au service OData de l'entrepôt de données
En tant que développeur de rapports, connectez votre outil d'aide à la décision existant à la source de données OData. Les objets OData sont présentés et vous pouvez lancer la création de rapports pour vos utilisateurs finals.
Les procédures décrites dans cette section sont uniquement fournies à titre de recommandations. Reportez-vous à la documentation de votre outil d'aide à la décision spécifique pour consulter les instructions de configuration des tâches suivantes :
  • Connectez-vous et créez des rapports à l’aide du flux OData.
  • Récupérez uniquement les exemples de données lorsque vous établissez une connexion OData.
  • Récupérez des données limitées lors de la création de rapports pour optimiser les performances.
Collaborez avec l'administrateur de votre outils d'aide à la décision pour résoudre d'éventuels problèmes de connexion.
Conseil du support de CA
: si l’erreur suivante apparaît dans les journaux, elle indique qu'un client a tenté de récupérer un trop grand nombre d’enregistrements à la fois :
ForbiddenException: The top request exceeds the maximum entities per page limit of 10000
Par exemple, dans ce cas, une demande d’extraction de 50 000 lignes a échoué :
"GET /api/odata/test_DataSource/DWH?$top=50000 HTTP/1.1"
La limite de service ODATA est de 10 000 entités par page. Avec SSIS, si une implémentation ne transfère par le paramètre $top, la même erreur peut se produire. Par conséquent, il est préférable d’utiliser la pagination pour rester dans la limite de 10 000 enregistrements. Le support de CA a observé ce problème avec SSIS. Toutefois, la limite de pagination de 10 000 entités s’applique également lorsque vous tentez une automatisation à l'aide d’autres outils de BI.
Connexion à OData à l’aide de Power BI Desktop de Microsoft
Si vous utilisez actuellement Power BI, appliquez les étapes de haut niveau suivantes pour vous connecter à OData.
Procédez comme suit :
  1. Dans le menu principal de Power BI, sélectionnez
    Get Data
    ,
    OData Feed
    .
  2. Dans la fenêtre
    OData Feed
    , entrez l'URL de terminal OData de l'entrepôt de données (v2 ou v4) que vous avez notée dans
    PPM classique
    .
  3. Cliquez sur
    OK
    .
  4. Sélectionnez
    Basic
    .
  5. Entrez le nom d'utilisateur et mot de passe dont vous avez pris note à partir de
    PPM classique
    pour accéder au service OData.
  6. Cliquez sur
    Connect
    .
    Lorsque la connexion est établie, une liste des tables de l'entrepôt de données que vous pouvez utiliser pour créer vos rapports s'affiche.
Connexion à OData à l’aide de Microsoft Excel
Clarity
présente les OData et vous permet d'utiliser des outils tiers tels que Microsoft Excel avec OData. Cependant,
Clarity
ne prend pas officiellement en charge l'utilisation d'OData avec un outil tiers. Vous pouvez utiliser les informations fournies dans cet article de la base de connaissances pour vous connecter à OData à l'aide de Microsoft Excel.
Nous déconseillons d'utiliser Excel pour la génération de rapports. Pour créer des rapports, nous vous recommandons d'utiliser un outil de génération de rapports telles que Power BI. Power BI affiche les données plus rapidement à l’aide de la mise en cache et offre une sécurité et un contrôle améliorée des données. Excel ne permet pas de mapper facilement les utilisateurs de rapport vers les utilisateurs
PPM classique
.
Connexion à OData à l’aide de Tableau Desktop
Lorsque vous vous connectez à OData à l’aide de Tableau, vous devez spécifier chaque entité (table) Odata.
  1. Sous
    Connect
    ,
    To a Server
    , sélectionnez la source de données
    OData
    .
  2. Dans le champ Server de la fenêtre OData, entrez l'URL du terminal OData de l'entrepôt de données (v2 ou v4) que vous avez noté à partir de
    PPM classique
    . Utilisez le format suivant :
    http://<host>:<port>/api/odata/datasource/
    <entity>
    <entity>
    indique le nom de la table de l'entrepôt de données.
  3. Sélectionnez
    use a specific username and password
    . Spécifiez le nom d’utilisateur et le mot de passe pour accéder au service OData.
  4. Cliquez sur
    Sign in
    .
  5. Pour vous connecter à d'autres tables de l’entrepôt de données, répétez les étapes de cette procédure.
La version 4 du protocole OData n'est pas prise en charge par l'outil Tableau. Celui-ci supporte uniquement la version 2. Microsoft Power BI prend en charge les deux versions.
Implémentation de la sécurité de niveau ligne pour les rapports d'aide à la décision
Contactez votre service de sécurité des informations pour examiner les informations d'accès et de stockage des données suivantes. Déterminez la compatibilité des informations avec vos normes de sécurité des données : HDP n'utilise pas les utilisateurs, les groupes ou le modèle de sécurité des organigrammes organisationnels disponibles dans
PPM classique
. Votre développeur de rapports BI peut utiliser les tables de sécurité de l'entrepôt de données pour limiter les données visibles pour les utilisateurs des rapports.
Avant de permettre aux utilisateurs de générer des rapports, implémentez la sécurité de niveau ligne pour sécuriser les données. Activez la sécurité de niveau investissement et ressource dans les rapports d'aide à la décision. Seuls les ressources et investissements pertinents s'affichent pour les utilisateurs finals en fonction de leurs droits d’accès.
Exemple
: L'utilisateur A a accès aux investissements 1 et 2. L'utilisateur B a accès aux investissements 1 et 4. Lorsque l'utilisateur A se connecte à son environnement de génération de rapports, les rapports d’investissement contiennent uniquement les lignes des investissements 1 et 2. L’utilisateur B peut uniquement afficher les lignes des investissements 1 et 4.
Pour activer la sécurité de niveau ligne pour les rapports, utilisez l’attribut ID de l'utilisateur de l'aide à la décision pour mapper les utilisateurs
PPM classique
vers les utilisateurs de rapport dans votre outil d'aide à la décision. L’attribut ID de l'utilisateur de l'aide à la décision est inclus dans l’objet Ressource et installé par l’accélérateur PMO. Reportez-vous à la rubrique Installation du module d'extension Accélérateur PMO. L’attribut n’est pas configuré pour s’afficher dans les vues de ressource par défaut. De plus, l’attribut est activé pour l’entrepôt de données par défaut. Toutefois, l’option
Inclure dans l'entrepôt de données
n’est pas sélectionnée et est en lecture seule pour l’attribut Sécurité.
Configuration de la sécurité de niveau ligne dans
Clarity
En tant qu’administrateur, effectuez les opérations suivantes dans
PPM classique
:
  1. Configurez les vues de ressource pour ajouter l’attribut ID de l'utilisateur de l'aide à la décision. Pour plus d'informations, reportez-vous à la section Objets et attributs
    Clarity
    Studio
    .
  2. Renseignez la valeur de l’attribut ID de l'utilisateur de l'aide à la décision pour tous les utilisateurs de rapport avec leur valeur de connexion de sécurité liée à l'aide à la décision. Par exemple, mappez l'utilisateur
    PPM classique
    (A) vers la valeur ID de l'utilisateur de l'aide à la décision, [email protected]<nom_société>.org.
Configuration de la sécurité de niveau ligne dans votre outil d'aide à la décisio
  1. Les développeurs de rapport utilisant un outil d'aide à la décision peuvent utiliser la sécurité de l’entrepôt de données pour implémenter la sécurité de niveau ligne tel que spécifié par leurs fournisseurs. La procédure suivante décrit les étapes génériques de haut niveau intégrant l’aide à la décision à titre d'exemple. Pour en savoir plus sur l’implémentation de la sécurité de niveau ligne dans l’outil d'aide à la décision, reportez-vous à la documentation de votre outil. Par exemple, consultez la documentation Microsoft Power BI pour en savoir plus sur l’implémentation de la sécurité de niveau ligne dans l'aide à la décision pour limiter l’accès aux données de rapports.
  2. Pour remplir l'ID d'utilisateur BI pour DWH_INV_SECURITY_V et DWH_RES_SECURITY_V, exécutez le job de chargement des droits d'accès à l'entrepôt de données.
Procédez comme suit :
  1. Chargez les tables suivantes dans Power BI Desktop pour remplir les données de rapport :
    • DWH_INV_INVESTMENT : si vous générez un rapport sur les investissements, la table affichera les données d’investissement. Cette table est généralement utilisée avec la sécurité de niveau investissement. En fonction du cas d’utilisation, vous pouvez également utiliser d'autres tables contenant la clé d'investissement.
    • DWH_RES_RESOURCE : Si vous générez un rapport sur les ressources, la table affichera les données de ressource. Cette table est généralement utilisée avec la sécurité de niveau ressource. En fonction du cas d’utilisation, vous pouvez également utiliser d'autres tables contenant la clé de resource.
    • DWH_INV_SECURITY_V : la vue affiche les informations sur les droits d’accès aux investissements. La vue inclut la colonne BI_User_ID, qui correspond à l’ID d'utilisateur de votre outil d'aide à la décision et reflète la valeur renseignée dans
      PPM classique
      .
    • DWH_RES_SECURITY_V :lLa vue affiche les informations sur les droits d’accès aux ressources. La vue inclut la colonne BI_User_ID, qui correspond à l’ID d'utilisateur de votre outil d'aide à la décision et reflète la valeur renseignée dans
      PPM classique
      .
  2. Créez des relations entre les tables et les vues.
  3. Définissez une condition Where pour limiter les données à un utilisateur spécifique.
    Par exemple, dans Power BI, accédez à Modélisation, Gérer les rôles, Créer un rôle et créez une expression DAX sur l’attribut ID de l'utilisateur de l'aide à la décision comme illustré ci-dessous :
    [ID_UTILISATEUR_AIDE_DÉCISION] = NOM_UTILISATEUR()
  4. Enregistrez et publiez le rapport.
Fonctions prises en charge pour l'entrepôt de données
Clarity
Les fonctions d'entrepôt de données ci-dessous sont prises en charge dans la version 4 du service 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
Les fonctions de la version 4 du service OData sont prises en charge, avec les exceptions suivantes :
  • importations de fonction
  • fonctions qui renvoient des types primitifs
  • fonctions qui renvoient des types ou entités complexes
  • fonctions liées aux entités
  • fonctions avec paramètres OUT ou INOUT
  • fonctions avec alias de paramètre
  • fonctions appelées par les options $filter, $select, ou $orderby du service Odata
  • fonctions appelées par les valeurs de paramètre, y compris les paramètres de requête d'URL
  • fonctions intégrées
  • fonctions surchargées
  • fonctions indépendantes (opérations statiques)
Les vues RU telles que DWH_INV_TEAM_RU_PER_FACTS_M_V ne sont pas présentées en tant que vues OData.
Certaines fonctions ne sont pas prises en charge par le service OData v2, notamment les fonctions d'entrepôt de données.