Clarity : Configuration des plans pour les investissements et objets personnalisés

ccppmop1592
HID_newux_custom_blueprints
En tant qu'administrateur de l'application ou que concepteur de contenu PMO, vous pouvez utiliser des plans pour configurer des dispositions pour différents objets principaux et investissements personnalisés. Vous pouvez utiliser les plans pour aligner les dispositions des différents types d'investissements personnalisés sur vos objectifs organisationnels.
Lorsque vous créez un investissement personnalisé ou un objet principal personnalisé, un plan est automatiquement créé dans
Clarity
. Vous pouvez créer une copie du plan et le modifier en fonction de vos objectifs. Par exemple, un plan marketing peut différer considérablement d'un plan d'ingénierie.
Voici les étapes clés que vous devez suivre lors de la modification de plans :
  1. Créez une copie du plan standard, renommez-le et configurez la disposition des détails (sections et champs).
  2. Ajoutez les modules appropriés au plan.
  3. Publiez le plan.
  4. Marquez un plan comme plan par défaut pour les éléments d'investissement et objets principaux personnalisés pertinents.
2
Modification des détails d'un plan
Vous pouvez ajouter différents attributs prédéfinis et personnalisés associés à des éléments d'investissement et objets principaux personnalisés dans le module Propriétés d'un plan.
Procédez comme suit :
  1. Dans la liste des plans, cliquez sur le nom du plan que vous souhaitez modifier.
  2. Dans la page de détails qui présente la disposition du plan actuellement publié, cliquez sur
    Modifier
    .
  3. Modifiez les détails du plan :
    • Effectuez un glisser-déposer des champs disponibles de la liste Champs vers une section existante dans le plan. Utilisez la fonction de recherche pour rechercher des champs spécifiques par nom d’étiquette. Utilisez le triangle grisé qui s’affiche dans le coin inférieur droit des champs dans la disposition pour les redimensionner.
    • Déplacez des champs à l'aide de la fonction glisser-déposer à partir d’une section de disposition du plan vers une autre section.
    • Déplacez des champs à l'aide de la fonction glisser-déposer à partir des sections de disposition du plan vers la liste des champs. Vous pouvez également cliquer sur la croix dans un champ d'une section pour le supprimer. Le champ redevient disponible.
    • Supprimez une section avec ou sans champs. Tous les champs de cette section seront supprimés de la disposition et pourront être à nouveau sélectionnés dans le panneau Champs.
    • Pour réorganiser les sections, déplacez une section existante par glissement vers le haut ou le bas dans le plan. Tous les champs contenus dans cette section seront également déplacés vers le nouvel emplacement.
    • Ajoutez une section en cliquant sur Ajouter une section ou déplacez le bouton Ajouter une section à l'aide de la fonction glisser-déposer vers l'emplacement où vous voulez ajouter une section.
      Vous pouvez ajouter un attribut personnalisé à un plan uniquement si la prise en charge d'API est activée.
  4. Si vous n'êtes pas sûr des modifications, vous pouvez les ignorer. Les modifications seront alors supprimées et la version actuellement publiée de la vue de détails du plan sera rétablie.
  5. Cliquez sur
    Publier
    pour enregistrer vos modifications et rendre la nouvelle disposition disponible.
Ajout de modules à des plans
Les différents sous-objets associés à un investissement personnalisé ou à un objet principal personnalisé sont disponibles en tant que modules. Vous pouvez ajouter ces modules au plan pour les mettre à la disposition de vos utilisateurs.
Procédez comme suit :
  1. Dans la liste des plans, cliquez sur le nom du plan que vous souhaitez modifier.
  2. Dans la page de détails qui présente la disposition du plan actuellement publié, cliquez sur
    Modifier
    .
  3. Sélectionnez l'onglet
    Modules
    .
  4. Déplacez par une opération de glisser-déposer les modules appropriés vers les zones vides pour les ajouter au plan.
    • Seuls les sous-objets personnalisés pour lesquels la prise en charge d'API est activée s'affichent.
    • Les sous-objets personnalisés de premier niveau s'affichent en tant que modules. Les sous-objets de deuxième niveau pour lesquels la prise en charge d'API est activée sont automatiquement ajoutés au panneau Détails du sous-objet de premier niveau.
    • Le plan d'un objet peut inclure 50 modules maximum, incluant des modules par défaut, des sous-objets personnalisés et des canaux. Si vous atteignez la limite de 50, vous ne pourrez plus ajouter de modules au plan. Lorsque cela arrive, envisagez de supprimer ou de combiner les modules les moins utilisés.
  5. Cliquez sur
    Publier
    pour enregistrer vos modifications et les mettre à la disposition disponible des utilisateurs.
Association d'un plan à un élément d'investissement ou à un objet principal personnalisé
Vous pouvez accéder à la page Investissements personnalisés ou Objets personnalisés et ajouter l'attribut Plan à la grille. Puis, vous pouvez sélectionner le plan approprié à appliquer.
Création et exécution des règles métier
Les administrateurs peuvent créer des règles métier dans les plans pour contrôler les modules ou sections affichés par les utilisateurs finals. Les règles métier s'appliquent aux projets, aux investissements personnalisés, aux idées et aux objets principaux personnalisés. Imaginons, par exemple, que l'administrateur souhaite afficher la section Résumé décisionnel dans le module Propriétés uniquement lorsque les conditions suivantes sont remplies :
  • L'utilisateur est membre du groupe de gestionnaires de portefeuilles PMO.
  • Le RSI est supérieur à 200 %.
  • La priorité au niveau de l'entreprise est élevée.
  • L'investissement est actif.
Lorsque vous définissez des règles métier, vous devez effectuer trois étapes clés :
  1. Définition d'une condition : utilisez le filtre générique pour définir toutes les conditions déclenchant la règle métier. Dans cette version, vous pouvez spécifier des conditions basées sur les éléments suivants :
    1. Groupes d'accès : vous pouvez spécifier qu'un module ou une section doivent être masqué uniquement pour les membres :
      1. des groupes sélectionnés ;
      2. de tous les groupes, excepté du groupe sélectionné.
        Dans notre exemple, nous indiquerons la condition selon laquelle le groupe d'accès ne doit pas être égale au gestionnaire de portefeuilles PMO.
    2. Attributs : vous pouvez spécifier une valeur pour un ou plusieurs attributs Clarity. Dans notre exemple, nous spécifierons les conditions pertinentes pour les attributs RSI, Priorité au niveau de l'entreprise et Actif.
      Vous pouvez utiliser les options "Faire tout correspondre" ou "Faire correspondre un élément" pour créer des conditions composées qui incluent plusieurs groupes et attributs. Pour en savoir plus sur l'utilisation des filtres et des options de recherche génériques, consultez la section Composants communs. Dans notre exemple, nous utiliserons l'option Faire tout correspondre.
  2. Définition des actions : dans cette version de Clarity, les actions permettent de masquer des modules et des sections. Les actions s'exécutent uniquement lorsque la condition est déclenchée. Dans notre exemple, nous utiliserons l'action Masquer les sections.
  3. Définition des cibles d'action : les cibles d'action spécifient les modules ou sections que vous pouvez masquer lorsque la condition est déclenchée. Dans notre exemple, nous sélectionnerons la section Résumé décisionnel en vue de son masquage.
Dans notre exemple, nous masquerons la section Résumé décisionnel pour tous les groupes, excepté du groupe Gestionnaire de portefeuilles PMO. Les membres de ce groupe verront la section uniquement lorsque le RSI dépassera à 200 % et que la priorité aua niveau de l'entreprise sera définie sur Elevé(e).
Procédez comme suit :
  1. Connectez-vous à Clarity.
  2. Cliquez sur
    Administration
    et sélectionnez
    Plans
    .
  3. Sélectionnez le plan approprié pour l'ouvrir et cliquez sur
    Modifier
    .
  4. Accédez à l'onglet
    Règles
    et sélectionnez
    Nouvelle règle
    .
  5. Dans la fenêtre Nouvelle règle, entrez le nom et la description de la règle.
  6. Dans la section Conditions, utilisez la liste déroulante pour spécifier la condition qui déclencherait la règle.
  7. Pour finaliser la condition, utilisez l'option "Faire tout correspondre" ou "Faire correspondre un élément".
  8. Dans la section Actions, sélectionnez l'action appropriée.
  9. Définissez les cibles d'action en spécifiant les sections et modules que vous souhaitez masquer.
  10. Cliquez sur
    Créer
    . Si la syntaxe de la règle est correcte, la règle est activée une fois que vous avez cliqué sur Créer.
  11. Dans l'onglet Règles, assurez-vous que la règle est activée afin qu'elle soit appliquée à tous les investissements associés au plan.
  12. Pour mettre à jour les modifications apportées au plan, cliquez sur
    Publier
    .
Voici quelques cas de figure dans lesquels des messages d'erreur ou d'avertissement s'affichent pour les règles métier :
  • Vous avez défini une seule action et la cible d'action est manquante.
  • Vous avez défini une seule condition et la valeur de condition est manquante.
  • Un administrateur supprime ou désactive un attribut utilisé dans une règle.
  • Les règles métier s'appliquent aux projets, aux investissements personnalisés, aux idées et aux objets principaux personnalisés.
  • Lorsque vous sélectionnez un attribut dans la section Conditions, les attributs suivants sont disponibles :
    • Eléments de recherche à valeur unique (statiques et dynamiques)
    • Booléen
    • Chaînes
    • Nombre
    • Eléments de recherche dépendants statiques
    • Eléments de recherche paramétrés
  • Vous pouvez configurer des actions uniquement pour les modules actifs associés au plan.
  • Après avoir modifié une règle, vous devez la publier de nouveau pour l'activer pour l'utilisateur final.
  • Les informations du plan sont mises en cache pour la session d'utilisateur. Vos utilisateurs finals devront peut-être se connecter et se déconnecter ou actualiser leur navigateur pour pouvoir voir toutes les modifications de règle métier publiées.
  • L'exécution par l'utilisateur final de la règle n'actualise pas dynamiquement l'interface utilisateur immédiatement après le déclenchement de la règle. Les utilisateurs devront quitter le navigateur et y revenir ou l'actualiser pour pouvoir consulter le module ou la section masqués. Nous examinerons s'il est possible de fournir une fonction d'actualisation dynamique une fois la règle déclenchée dans une version future.
  • Si vous avez implémenté la sécurité de niveau champ
    • Les champs seront disponibles pour l'administrateur configurant les règles métier.
    • La règle sera appliquée, mais la sécurité de niveau champ sera examinée à l'exécution de la règle.
  • Lorsqu'une section, un module, un groupe Clarity ou des attributs personnalisés sont désactivés ou supprimés, l'administrateur doit passer en revue toutes les règles pour s'assurer que la règle continue de fonctionner comme prévu.
Utilisation de canaux à des fins d'intégration de contenu externe
Utilisez des canaux pour intégrer le contenu d'une autre source, tel qu'un site externe, une application ou des rapports d'investissement contextuels PPM classique dans Clarity. Vous pouvez interagir avec le contenu et prendre des décisions commerciales avisées sans quitter un investissement dans Clarity.
En tant qu'administrateur, vous pouvez ajouter un canal au plan et configurer quinze (15) canaux maximum. Après avoir créé un canal, il s'affiche dans le panneau Modules. Une fois le plan publié, le canal tout juste créé s'affiche sous forme de page à onglets dans l'investissement (Projet, Investissement personnalisé, Idées) et les objets personnalisés.
Après avoir ajouté un canal, il n'est
pas
nécessaire de le glisser-déposer dans la section de disposition du plan ; il y sera automatiquement ajouté.
Lorsque vous créez 15 canaux, le bouton Nouveau canal ne s'affiche plus.
Cette page contient les sections suivantes :
Configuration d'un canal
Découvrez comment ajouter un canal et intégrer le contenu d'une autre source dans Clarity.
  1. Accédez au
    plan
    et cliquez sur
    Modifier
    .
  2. Dans l'onglet
    Modules
    , cliquez sur
    Nouveau canal
    .
  3. Entrez les informations dans les champs ci-après :
    1. Nom du canal
       : entrez le nom du canal.
    2. URL du canal
       : entrez l'URL du canal.
    3. URL du référent :
      entrez une ou plusieurs URL de référent séparées par des virgules. Utilisez les URL de référent lorsque votre URL de canal vous redirige vers un autre lien d'authentification.
      Par exemple, si l'URL de votre canal requiert une connexion par authentification unique, spécifiez l'URL d'authentification dans l'URL du référent.
  4. Cliquez sur
    Aperçu
    pour tester le canal.
    Notez que seuls les liens concrets peuvent être prévisualisés.
  5. Cliquez sur
    Publier
    pour publier le plan.
    Votre canal est créé. Demandez à vos utilisateurs d'actualiser la session du navigateur pour afficher le nouveau canal sous forme de page à onglets dans l'investissement.
Paramètres dynamiques pour les canaux
  • Vous pouvez utiliser les paramètres suivants pour créer du contenu dynamique dans vos canaux.
    • ID de projet : ${internalID}
    • Code du projet : ${code}
    • Nom du projet : ${name}
    • Chef de projets : ${manager}
    • Utilisateur connecté : ${_userId}
  • Les canaux prennent également en charge les attributs personnalisés comme paramètres d'entrée, à l'aide de la valeur alias de l'API d'attribut, du type d'attribut suivant :
    • Nombre
    • Chaîne
    • Elément de recherche à valeur unique (basée sur les valeurs statiques et NSQL)
Les canaux prennent également en carge le contenu contextuel avec des paramètres dynamiques. Le contenu avec des paramètres dynamiques n'est pas rendu en mode Aperçu pour les canaux dans les plans, mais les utilisateurs peuvent les afficher dans l'investissement.
Utilisation de chemins d’accès relatifs dans une URL de canal générique
Lorsque vous ajoutez un canal pour renvoyer vers PPM classique, remplacez l’URL du serveur par la syntaxe HTML point-point-barre oblique pour des références de chemins relatifs plutôt que des références de chemins absolus. Si les données sont restaurées vers un autre serveur, votre canal continue de fonctionner.
URL d’origine
URL de canal générique
http://my_clarity.ca.com/niku/nu
../../../../../niku/nu
Exemple 1
 : dans cet exemple, vous définissez un lien dans un canal dans la page Processus du projet
PPM classique
 :
../../../../../niku/nu#action:projmgr.projectProcessInstances&id=${_internalId}&object_type =project&object_id=${_internalId}&ui.page.space=mainnav.work&ui.page.template=union.appPage
Exemple 2 
: Un lien vers des investissements Rally s'affiche comme suit :
https://rally1.rallydev.com/#/investments
Exemple 3 
: l'exemple suivant présente un lien vers un rapport Jaspersoft :
https://clarityserver.ca.com/reportservice/flow.html?_flowId=viewReportFlow&reportUnit= %2Fca_ppm%2Freports%2Fproject_management%2FCSK_PRJ_ProjectStatusSummary &standAlone=true&ParentFolderUri=/ca_ppm/reports/project_management &populateProject=1&projectKey_1=${_internalId}
Canaux liant
PPM classique
au thème d'interface utilisateur Phoenix appliqué
Si vous créez un canal qui renvoie à l’interface utilisateur
PPM classique
et que le thème Phoenix facultatif est appliqué, les utilisateurs voient deux menus principaux sur le côté gauche de la page. Pour n'afficher qu’un menu principal, procédez comme suit :
  1. Modifiez le plan.
  2. Ouvrez le module de canal.
  3. Ajoutez le paramètre suivant dans le champ
    URL du canal
    :
    &puiFullscreen=on
  4. Pour masquer les éléments de menu propres aux projets, ajoutez le paramètre suivant :
    &puiHidePPMTabs=on
  5. Enregistrez et publiez le plan.
image2019-3-19_19-26-6.png
Vidéo :masquage de la barre de navigation et de la barre d’outils des canaux lorsque le thème d'interface utilisateur Phoenix est appliqué

Astuces de dépannage pour les administrateurs qui configurent des canaux
  • Avant de prévisualiser un canal, actualisez la page du navigateur.
  • Invitez les utilisateurs à actualiser leur navigateur après avoir publié un plan avec des canaux nouveaux ou modifiés.
  • Evitez les espaces, les points-virgules et les caractères spéciaux dans les URL de référent.
  • Les URL de référent doivent être séparées par des virgules.
Problèmes connus liés aux canaux
Refus dans la trame
 : vous pouvez obtenir une erreur de refus dans la trame lorsque vous cliquez sur Aperçu pour une URL de canal donnée, car elle enfreint la directive suivante de la stratégie de sécurité de contenu : "frame-src app.pendo.io cdn.pendo.iodocops.ca.com 'self' data:."
Résolution :
pour résoudre ce problème, actualisez votre navigateur. L'actualisation oblige Clarity à ajouter à la liste blanche le domaine en conformité avec la directive de la stratégie de sécurité de contenu. La nouvelle fonctionnalité de canal de plan intègre la capacité d'ajouter un domaine à la liste blanche une fois que vous l'avez définit dans le canal. Actualisez votre navigateur pour ajouter un domaine à la liste blanche avant de le prévisualiser. La définition d'une liste blanche permet à Clarity d'afficher des applications externes dans la structure Clarity, pour autant que l'autre application ne présente pas de restrictions CORS intégrées étant donné que Clarity ne peut pas écraser une stratégie de sécurité externe.
Contenus mixtes :
il se peut que vous obteniez le message d'erreur suivant si vous configurez un lien avec HTTP au sein d'un domaine qui requiert une connexion HTTPS sécurisée :
Mixed Content: The page at 'https://MY-PPM-SERVER.ondemand.ca.com/pm/#/admin/blueprints/blueprint/edit/5000043' was loaded over HTTPS, but requested an insecure resource 'http://OTHER-SITE.domain.org'. This request has been blocked; the content must be served over HTTPS.
Votre navigateur peut afficher une alerte vous invitant à fournir une confirmation avant de charger des scripts non sécurisés. Dans Chrome, une icône de bouclier de sécurité et une invite s'affichent pour vous demander de confirmer que vous souhaitez ouvrir un canal non sécurisé.
Résolution
 : pour résoudre ce problème, modifiez le canal dans le plan afin d'utiliser le protocole HTTPS, puis publiez le plan ou, si vous savez que le contenu HTTP est sûr, prévisualisez le contenu HTTP dans un autre navigateur.
Les administrateurs sur site peuvent également ajouter un domaine à la liste blanche à l'aide des options d'administration système. Reportez-vous à la section CSA : utilitaires de ligne de commande de service et d'administration au bas de cette page.