Exécution, planification et partage de rapports

ccppmop1571
Le comportement des rapports est similaire à celui des jobs dans l'interface utilisateur classique. Comme pour les jobs, vous pouvez exécuter un rapport Jaspersoft immédiatement ou le planifier pour une exécution ultérieure avec des options de récurrence.
Droits d'accès au rapport
La sécurité des rapports est à trois niveaux. Le tableau ci-dessous décrit chaque niveau d'accès. L'administrateur
Clarity PPM
vous accorde des droits d'accès à des fonctionnalités spécifiques.
Niveau d'accès
Description
Affichage des rapports
  • Le droit d'accès
    Rapports - Accès
    permet d'ouvrir la page Rapports disponibles.
  • Le droit d'accès
    Rapports - Afficher la sortie - Tout
    permet d'afficher toutes les sorties de rapport.
  • Vous avez également besoin de droits d’instance sur un ou plusieurs projets, investissements et ressources.
Exécuter des rapports
Ces droits d'accès vous permettent d'exécuter des rapports. Toutefois, ils ne vous permettent pas de définir les paramètres qui filtrent les informations dans un rapport.
  • Le droit d'accès de niveau instance
    Rapport - Exécuter
    permet d'exécuter un rapport spécifique et de visualiser afficher la sortie.
  • Le droit d'accès global
    Rapports - Exécuter - Tout
    permet aux utilisateurs d'exécuter tous les rapports.
  • Au moins un droit d'accès à la génération de rapports avancés.
  • Vous devez avoir été ajouté à l'un des groupes de génération de rapports avancés CA PPM PMO ou un groupe CA PPM. L'inclusion de groupes gère l’affectation de rôle Jaspersoft requise.
Définition des paramètres des rapports
Ces droits d'accès vous permettent de modifier une définition de rapport spécifique (de niveau instance) ou tous les rapports (au niveau global). Vous pouvez modifier les paramètres de rapport pour filtrer les informations qui apparaissent dans un rapport.
  • Le droit d'accès
    Rapports et jobs - Créer une définition
    permet de définir les paramètres de rapport ou de job.
  • Le droit d'accès
    Rapports et jobs - Modifier une définition
    permet de modifier les paramètres de rapport ou de job.
Sécurité de niveau ligne dans un rapport
Ce niveau d'accès vous permet d'accéder aux informations fournies si vous êtes autorisé à afficher ces informations. Lorsque ce niveau de sécurité est utilisé, les données qui s'affichent dans les lignes des rapports dépendent des droits d'accès spécifiques dont vous bénéficiez pour les différents éléments que ces derniers contiennent. Par exemple, si vous exécutez un rapport répertoriant les données de plusieurs projets, vous pourrez uniquement consulter les données des projets pour lesquels vous disposez de droits.
Un rapport partagé peut fournir au destinataire une visibilité et un accès aux données du projet plus étendus que ceux dont il dispose en temps normal. Par exemple, un utilisateur A a accès à 100 projets et l'utilisateur B a accès à 20 projets. L’utilisateur A partage un rapport sur 100 projets avec l'utilisateur B. L'utilisateur B peut alors afficher les 100 projets.
Pour pouvoir exécuter ou planifier des rapports, votre compte d'utilisateur doit être mappé vers un utilisateur Jaspersoft disposant d'un ou de plusieurs rôles. En tant qu'administrateur, exécutez les jobs
Créer et mettre à jour les utilisateurs Jaspersoft
et
Synchroniser les rôles Jaspersoft
. Reportez-vous à la section
Référence de jobs
.
Activation des rapports
En tant qu’administrateur, vous configurez l’accès utilisateur aux rapports prédéfinis et personnalisés que votre organisation décide de rendre accessibles aux autres utilisateurs.
  1. Connectez-vous à l'interface utilisateur classique en tant qu'administrateur disposant des droits d'accès suivants :
    • Rapports et jobs - Accès de l'administrateur
    • Rapports et jobs - Créer une définition
      (pour définir les paramètres de rapport ou de job)
    • Rapports et jobs - Modifier une définition
      (pour modifier les paramètres de rapport ou de job)
  2. Sélectionnez
    Administration
    ,
    Administration des données
    ,
    Rapports et jobs
    .
  3. Définissez le champ
    Type d'exécutable
    sur
    Rapport
    et cliquez sur
    Filtrer
    .
  4. Sélectionnez un ou plusieurs rapports en cochant la case correspondante et cliquez sur
    Activer
    .
    Les rapports s'affichent sur la page
    Rapports disponibles
    pour que d'autres utilisateurs puisent les exécuter, les planifier, les afficher ou les partager.
  5. Pour masquer un rapport pour d'autres utilisateurs, cliquez sur
    Désactiver
    ou ouvrez le rapport et désélectionnez la case à cocher
    Actif
    .
Ajout de rapports au portlet Mes rapports
Vous pouvez ajouter les rapports fréquemment utilisés au portlet Mes rapports. Vous pouvez ajouter des rapports à Mes portlets de deux façons :
A partir de la liste des rapports disponibles
  1. Connectez-vous à l'interface utilisateur classique.
  2. Sélectionnez
    Accueil
    ,
    Personnel
    ,
    Rapports et jobs
    .
  3. Sélectionnez un ou plusieurs rapports en cochant la case correspondante et cliquez sur
    Ajouter à mes rapports
    .
  4. Sélectionnez
    Accueil
    ,
    Personnel
    ,
    Général
    .
  5. Vos rapports favoris s'affichent dans le portlet
    Mes rapports
    sur la page
    Présentation : Général
    .
  6. Pour ajouter d'autres rapports, cliquez sur
    Plus
    .
  7. Pour supprimer des rapports dans le portlet
    Mes rapports
    , sélectionnez un ou plusieurs rapports en cochant la case correspondante et cliquez sur
    Supprimer
    .
A partir de la page Propriétés du rapport
  1. Connectez-vous à l'interface utilisateur classique.
  2. Sélectionnez
    Accueil
    ,
    Personnel
    ,
    Rapports et jobs
    .
  3. Cliquez sur le rapport souhaité et accédez à la page Propriétés du rapport.
  4. Dans la section Paramètres, cliquez sur
    Enregistrer les paramètres
    .
  5. Entrez le nom dans
    Nom des paramètres enregistrés
    et cochez la case
    Ajouter à mes rapports
    . Le nom saisi dans Nom des paramètres enregistrés s’affiche en tant que nom du rapport sous Mes portlets.
  6. Cliquez sur
    Enregistrer et revenir
    .
Exécution ou planification d'un rapport
La page Rapports disponibles répertorie les rapports Jaspersoft Studio auxquels vous avez accès et pouvant être exécutés immédiatement ou planifiés pour une exécution ultérieure. Dans cette vue, vous pouvez sélectionner un rapport et en définir les paramètres.
Si vous avez personnalisé la page
Présentation
pour afficher le portlet Mes rapports, vous pouvez ajouter et exécuter les rapports disponibles de votre choix à partir de ce portlet.
Procédez comme suit :
  1. Sélectionnez
    Accueil
    ,
    Personnel
    ,
    Rapports et jobs
    .
  2. Spécifiez les critères de filtrage ou cliquez sur
    Tout afficher
    pour afficher une liste de tous les rapports disponibles.
  3. Cliquez sur un rapport.
  4. Définissez les options de la section Général :
    1. Nom du rapport
      : Dans le cas d'une série de rapports planifiés, vous pouvez modifier le nom pour distinguer chaque instance de rapport. Par exemple, si le nom initial du rapport est Banque de détail - Extraction de taux, lors de sa planification hebdomadaire, renommez-le Banque de détail -
      Hebdomadaire
      - Extraction fréquence. Renommez les rapports de planification mensuelle Banque de détail - rapport
      Mensuel
      Extraction de taux.
    2. Format
      : sélectionnez l'un des formats de fichier suivants de sortie de rapport. Par défaut, le format PDF est sélectionné.
      • PDF
        : Adobe Acrobat PDF
      • PPTX :
        Microsoft PowerPoint
      • XLSX :
        Microsoft Excel
  5. Remplissez la section
    Paramètres
    . Procédez comme suit :
    1. Les paramètres varient en fonction du rapport. Cliquez sur
      Enregistrer les paramètres
      pour enregistrer l'ensemble des paramètres défini en vue de les réutiliser. Lors de l'enregistrement des paramètres, vous pouvez également ajouter un rapport au portlet Mes rapports.
    2. Les paramètres enregistrés apparaissent dans la page
      Rapports disponibles
      en retrait sous le rapport d’origine.
  6. Remplissez la section
    Quand
    pour spécifier si vous souhaitez exécuter le rapport immédiatement ou si vous souhaitez le planifier.
    1. Pour exécuter un rapport planifié et en définir la récurrence, cliquez sur le lien
      Définir la récurrence
      . Vous pouvez également définir la récurrence d'un rapport planifié à l'aide du format Crontab.
      Pour plus d'informations sur le format Crontab et sur l'utilisation de caractères spéciaux, consultez la documentation Oracle.
    2. Pour utiliser le format crontab, sélectionnez
      Format de saisie crontab (UNIX)
      et spécifiez une planification. Par exemple, l'instruction suivante indique que le rapport doit s'exécuter à minuit les 1er et 15e du mois. 0 0 1,15 * * . Vous pouvez utiliser l'option crontab sur les systèmes d'exploitation Linux et UNIX sur lesquels
      Clarity PPM
      est en cours d'exécution. Lorsque vous activez cette option, la configuration planifiée utilise l'heure du serveur sur lequel
      Clarity PPM
      est en cours d'exécution.
  7. Notifier
    : cette
    section vous permet de spécifier les ressources et les groupes à avertir lorsque le rapport s'exécute ou échoue.
    Pour recevoir des notifications, le destinataire doit avoir activé les notifications
    Rapports et jobs
    . Pour activer les notifications, sélectionnez
    Accueil, Personnel, Paramètres du compte, Notifications
    .
    Pour savoir qui reçoit les notifications en cas d’échec du job, regardez cette vidéo :

  8. Partage :
    cette section permet de spécifier les ressources et groupes avec lesquels la sortie du rapport doit être partagée. Vous pouvez uniquement partager des rapports planifiés.
    Le destinataire de la sortie du rapport doit disposer du droit
    Rapport - Accès
    pour pouvoir afficher la page
    Rapports et jobs
    . Lorsque vous partagez un rapport, l’application lui attribue automatiquement le droit d’accès
    Rapport - Vue - Sortie
    pour les utilisateurs et groupes destinataires.
  9. Cliquez sur
    Soumettre
    .
    1. Votre rapport
      immédiat
      s’affiche dans votre dossier de téléchargement du navigateur Web.
    2. Les rapports
      planifiés
      s'affichent dans la page
      Rapports planifiés
      .
    3. Une fois le rapport exécuté, vous pouvez afficher sa sortie dans la
      bibliothèque de rapports
      .
Modification des propriétés d'un rapport planifié
Les propriétés d'exécution de rapports incluent des informations de planification et de notification, ainsi que vos éventuels paramètres personnalisés. La page Rapports planifiés répertorie les heures et les statuts d'exécution des rapports planifiés créés par un utilisateur ou un administrateur. De nombreuses exécutions planifiées peuvent exister pour un même rapport. Toutes les exécutions de rapports planifiés (sauf les rapports supprimés) s'affichent dans la liste indépendamment de leur statut.
La page Propriétés du rapport vous permet de modifier les propriétés d'une exécution planifiée de rapport, à condition toutefois que le statut de l'exécution soit
Annulé(e)
ou
Terminé(e)
. Si d'autres statuts apparaissent, ces propriétés sont uniquement disponibles pour affichage.
  • Pause ou reprise d'un rapport planifié :
    la suspension de l'exécution d'un rapport planifié interrompt momentanément son exécution. Lorsque l'exécution d'un rapport est suspendue, vous devez activer l'option Reprendre pour relancer l'exécution de ce rapport. Le processus interrompu reprend alors à la prochaine heure d'exécution planifiée. Vous pouvez suspendre les rapports dont le statut est
    Planifié(e)
    .
  • Annulation d'une instance de rapport planifié
    : l'annulation des exécutions planifiées interrompt l'exécution immédiatement et annule toute future exécution. L'exécution annulée reste affichée dans la page Rapports planifiés et est identifiée au moyen du statut
    Annulé(e)
    . Une fois annulée, vous ne pouvez plus modifier le statut ni les propriétés d'une exécution.
  • Suppression d'une instance de rapport planifié :
    vous pouvez supprimer des exécutions planifiées dont le statut est
    Annulé(e)
    ou
    Terminé(e)
    . La suppression d'une exécution planifiée n'entraîne pas la suppression du type de rapport correspondant ou des rapports générés et terminés indiqués dans la
    bibliothèque des rapports
    .
Un rapport planifié peut présenter l'un des statuts suivants :
  • Annulé(e) : le rapport planifié et toutes les éventuelles instances récurrentes planifiées sont annulées définitivement.
  • Terminé(e) : le rapport planifié et non récurrent est terminé et sa sortie est disponible.
    Le statut
    Terminé(e)
    ne s'applique jamais aux instances de rapport planifié récurrent.
  • Suspendu(e) : l'instance de rapport planifié suivante est momentanément interrompue.
  • En cours d'exécution/Traitement : l'instance de rapport planifié est en cours de traitement.
  • Planifié(e) : la prochaine instance du rapport est dans la file d'attente. L'instance suivante du rapport est planifiée pour s'exécuter à la date et l'heure définies.
  • En attente : le rapport planifié ne peut pas démarrer tant qu'un rapport ou job incompatible n'est pas terminé.
  • Echec : l'instance du rapport planifié a échoué. Si un rapport échoue, vérifiez le statut des autres instances planifiées ou contactez l'administrateur.
Si vous planifiez un rapport pour qu'il soit exécuté une seule fois, vous pouvez modifier ses propriétés uniquement avant l'heure de son exécution planifiée.
Procédez comme suit :
  1. Sélectionnez
    Accueil
    ,
    Personnel
    ,
    Rapports et jobs
    .
  2. Cliquez sur l'onglet
    Rapports
    et sélectionnez
    Rapports planifiés
    .
  3. Cochez la case située en regard d’un ou plusieurs rapports planifiés et cliquez sur Pause, Reprendre, Annuler le job ou Supprimer le job. (Le mot
    job
    apparaît ici, car les rapports planifiés sont traités comme des jobs par le système.)
  4. Cliquez sur un lien Nom du rapport.
  5. Modifiez toute autre propriété du rapport. Pour les entrées de rapport planifié, les champs
    ID du job
    et
    Statut du job
    s'affichent en lecture seule.
  6. Cliquez sur
    Soumettre
    .
Affichage de la sortie du rapport généré
La page
Bibliothèque de rapports
répertorie la totalité de la sortie du rapport généré. Si le rapport planifié est récurrent, une instance du journal des rapports est générée pour chaque récurrence. Par exemple, si un rapport est planifié pour s'exécuter tous les mois, une instance de ce rapport est créée chaque mois.
Pour afficher les rapports, Adobe Acrobat Reader doit être installé sur votre ordinateur.
L'affichage des rapports qui s'exécutent immédiatement est instantané. Vous pouvez également enregistrer le rapport et l'afficher ultérieurement à partir de la page
Bibliothèque de rapports
.
Procédez comme suit :
  1. Sélectionnez
    Accueil
    ,
    Personnel
    ,
    Rapports et jobs
    .
  2. Cliquez sur l'onglet
    Rapports
    et sélectionnez
    Bibliothèque de rapports
    .
  3. Cliquez sur l'icône
    Ouvrir le rapport
    située en regard du rapport.
  4. (Facultatif) Pour afficher ses paramètres prédéfinis, des entrées de journal et d’autres propriétés planifiées, cliquez sur le lien du Nom du rapport.
  5. Si vous y avez accès, le lien s'ouvre et vous pouvez afficher le rapport. Si vous n'y avez pas accès, le message d'erreur du système de gestion des documents suivant s'affiche : DMS-05100 : Vous n'êtes pas autorisé à accéder à ce document. Contactez le propriétaire du document pour pouvoir y accéder. Selon votre stratégie de sécurité de données, demandez à l’utilisateur de partager le rapport à l'aide d'une autre méthode. Pour demander des droits d’accès, contactez l'administrateur.
Suppression de rapports générés
Vous pouvez supprimer la sortie du rapport généré. Vous pouvez également supprimer régulièrement les rapports obsolètes dans la bibliothèque de rapports, par le biais de la planification d'un job
Supprimer les entrées de journaux des jobs et de bibliothèques des rapports
.
Procédez comme suit :
  1. Sélectionnez
    Accueil
    ,
    Personnel
    ,
    Rapports et jobs
    .
  2. Ouvrez le menu
    Rapports
    et cliquez sur
    Bibliothèque de rapports
    .
  3. Cochez la case à côté du rapport et cliquez sur
    Supprimer
    .
Jobs affectant les informations des rapports
En fonction de votre rapport, certains jobs peuvent affecter directement la qualité des données. Tous les rapports Jaspersoft Studio, accessibles à partir de la version classique de CA PPM, reposent sur le job de chargement de l'entrepôt de données pour les nouvelles données. Les administrateurs doivent également exécuter les jobs Créer et mettre à jour les utilisateurs Jaspersoft et Synchroniser les rôles Jaspersoft. Les jobs doivent être exécutés dans cet ordre :
  1. Job de chargement de l'entrepôt de données
  2. Job de droits d'accès pour le chargement de l'entrepôt de données
  3. Job de création et de mise à jour des utilisateurs Jaspersoft
  4. Job de synchronisation des rôles Jaspersoft
Les autres jobs populaires ci-après peuvent également influencer vos données de rapport :
  • Enregistrer les feuilles de temps
  • Division en créneaux
  • Mettre à jour le pourcentage d'achèvement
  • Mettre à jour une tendance dans l'entrepôt de données
  • Mettre à jour les totaux des valeurs d'en-cours et des coûts
Si ces jobs échouent, ils peuvent nuire à la qualité de vos rapports. Des informations de rapport peuvent être obsolètes ou manquantes. Pour plus d'informations, contactez votre administrateur.
Exécution ou planification de rapports Jaspersoft dans CA PPM classique
Vous pouvez exécuter, planifier, partager, vérifier le statut et consulter des rapports Jaspersoft Studio dans CA PPM. Le menu Accueil inclut l'option Rapports et jobs. En cliquant dessus, vous pouvez afficher une page intuitive à deux onglets qui permet de planifier facilement des rapports et jobs. Vous disposez d'un accès préconfiguré par les administrateurs qui vous permet d'enregistrer vos propres paramètres de rapport. Vous pouvez uniquement consulter vos propres rapports planifiés ou ceux partagés par d'autres utilisateurs.
Dans la section Génération de rapports avancés, certains contrôles d'entrée possèdent une valeur par défaut lorsqu'ils apparaissent en haut de la liste. Dans CA PPM, ces mêmes filtres apparaissent correctement et n’ont pas de valeurs par défaut. Les filtres Période et Devise en sont des exemples.
Planification de rapports avec des filtres de date
Dans la génération de rapports avancés, vous pouvez utiliser la fonctionnalité Jaspersoft de date relative pour planifier ou exécuter des rapports qui ont des filtres de date, tels que les filtres Date de début, Date de fin, etc. Vous pouvez filtrer les informations dans un rapport en fonction d'une plage de dates relative à la date système actuelle. Utilisez les filtres de date et entrez une expression de texte décrivant la date relative ou la plage de dates que vous souhaitez afficher. Les filtres de date utilisent la fonctionnalité Jaspersoft de date relative et des dates normales.
Pour les dates relatives, utilisez le format
<Keyword>
+/-
<Number>
,
dans lequel :
  • <Keyword>
    indique l’intervalle que vous souhaitez utiliser. Les options incluent : DAY, WEEK, MONTH, QUARTER, SEMI et YEAR.
  • + ou - indique si la période est avant ou après la date que vous avez sélectionnée.
  • <Number>
    indique le nombre de périodes que vous souhaitez inclure dans le filtre.
Exemples
:
Pour inclure les données du mois précédent dans le rapport, utilisez l’expression suivante :
MONTH-1
Pour inclure les données du mois suivant dans le rapport, utilisez l’expression suivante :
MONTH+1
Informations complémentaires :
  • Jobs Reference
    dans la version anglaise de la documentation.