Prise en main de la création de rapports de processus

La création de rapports de processus permet aux utilisateurs d’AEM Forms d’interroger des informations sur les processus AEM Forms actuellement définis dans la mise en oeuvre d’AEM Forms. Toutefois, les rapports de processus n’accèdent pas directement aux données à partir du référentiel AEM Forms. Les données sont d’abord publiées dans le référentiel Process Reporting sur une base planifiée (par le service ProcessDataPublisher et ProcessDataStorage s). Les rapports et requêtes des rapports de processus sont ensuite générés à partir des données des rapports de processus publiées dans le référentiel. Process Reporting est installé dans le cadre du module Forms Workflow.

Cet article décrit les étapes à suivre pour activer la publication des données AEM Forms dans le référentiel Process Reporting. Ensuite, vous pourrez utiliser Process Reporting pour exécuter des rapports et des requêtes. L’article couvre également les options disponibles pour configurer les services Process Reporting.

Conditions préalables pour les rapports de processus

Purge des processus non essentiels

Si vous utilisez actuellement Forms Workflow, la base de données AEM Forms peut contenir une grande quantité de données.

Les services de publication Process Reporting publieront toutes les données AEM Forms actuellement disponibles dans la base de données. Cela signifie que si la base de données contient des données héritées sur lesquelles vous ne souhaitez pas exécuter de rapports et de requêtes, toutes ces données seront également publiées dans le référentiel, même si elles ne sont pas requises pour la création de rapports. Il est recommandé de purger ces données avant d’exécuter les services pour publier les données dans le référentiel Process Reporting. Cela améliore les performances du service d’éditeur et du service qui interroge les données pour la création de rapports.

Pour plus d’informations sur la purge des données de processus AEM Forms, voir Purge des données de processus.

REMARQUE

Pour obtenir des conseils et astuces sur l’utilitaire de purge, reportez-vous à l’article Adobe Developer Connection sur Purge des processus et des tâches.

Configuration des services Process Reporting

Planification de la publication des données de processus

Les services Process Reporting publient les données de la base de données AEM Forms vers le référentiel Process Reporting selon un calendrier précis.

Cette opération peut nécessiter de nombreuses ressources et avoir un impact sur les performances des serveurs AEM Forms. Il est recommandé de planifier cette opération en dehors des créneaux horaires occupés de votre serveur AEM Forms.

Par défaut, la publication des données est planifiée tous les jours à 02h00.

Effectuez les étapes suivantes pour modifier le planning de publication :

REMARQUE

Si vous exécutez l’implémentation d’AEM Forms sur une grappe, effectuez les étapes suivantes sur chaque noeud de la grappe.

JBoss Application Server 

  1. Arrêtez l’instance du serveur AEM Forms.

    • (Pour Windows) Ouvrez le fichier [*JBoss root*]/bin/run.conf.bat dans un éditeur.
    • (Pour Linux, AIX et Solaris) Fichier [*JBoss root*]/bin/run.conf.sh dans un éditeur.
  2. Ajoutez l’argument JVM -Dreporting.publisher.cron = <expression>.

    Exemple : L’expression cron suivante entraîne la création de rapports de processus à publier des données AEM Forms dans le référentiel de création de rapports de processus toutes les 5 heures :

    • -Dreporting.publisher.cron = 0_0_0/5_*_*_?
  3. Enregistrez et fermez le fichier run.conf.bat.

  4. Redémarrez l’instance du serveur AEM Forms.

WebSphere Application Server

  1. Arrêtez l’instance du serveur AEM Forms.

  2. Connectez-vous à la console d’administration WebSphere. Dans l’arborescence de navigation, cliquez sur Servers > Application servers, puis, dans le volet de droite, cliquez sur le nom du serveur.

  3. Sous Server Infrastructure, cliquez sur Java and Process Management> Process Definition.

  4. Sous Additional Properties, cliquez sur Java Virtual Machine.

    Dans la zone Generic JVM arguments , ajoutez l’argument -Dreporting.publisher.cron = <expression>.

    Exemple : L’expression cron suivante entraîne la création de rapports de processus à publier des données AEM Forms dans le référentiel de création de rapports de processus toutes les 5 heures :

    • -Dreporting.publisher.cron = 0_0_0/5_*_*_?
  5. Cliquez sur Appliquer, cliquez sur OK, puis sur Enregistrer directement dans la configuration principale.

  6. Redémarrez l’instance du serveur AEM Forms.

WebLogic Application Server

  1. Arrêtez l’instance du serveur AEM Forms.

  2. Connectez-vous à WebLogic Administration Console. L’adresse par défaut de WebLogic Administration Console est https://[hostname]:[port]/console.

  3. Sous Change Center, cliquez sur Lock & Edit.

  4. Sous Domain Structure, cliquez sur Environment > Servers et, dans le volet de droite, cliquez sur le nom du serveur géré.

  5. Dans l’écran suivant, cliquez sur les onglets Configuration > Server Start.

  6. Dans la zone Arguments , ajoutez l’argument JVM -Dreporting.publisher.cron = <expression>.

    Exemple : L’expression cron suivante entraîne la création de rapports de processus à publier des données AEM Forms dans le référentiel de création de rapports de processus toutes les 5 heures :

    -Dreporting.publisher.cron = 0_0_0/5_*_*_?

  7. Cliquez sur Save, puis sur Activate Changes.

  8. Redémarrez l’instance du serveur AEM Forms.

processdatapublisherservice

Service ProcessDataStorage

Le service ProcessDataStorageProvider reçoit les données de processus du service ProcessDataPublisher et enregistre les données dans le référentiel Process Reporting.

À chaque cycle de publication, les données sont enregistrées dans des sous-dossiers d’un dossier racine prédéfini.

Vous pouvez utiliser la console d’administration pour configurer la racine (default) : /content/reporting/pm) emplacement et sous-dossier (default : /yyyy/mm/dd/hh/mi/ss) format de hiérarchie où les données de processus seraient stockées.

Pour configurer les emplacements du référentiel de création de rapports de processus

  1. Connectez-vous à Administration Console à l’aide des informations d’identification de l’administrateur. L’URL par défaut d’Administration Console est https://[server]:[port]/adminui

  2. Accédez à Accueil > Services > Applications et services > Gestion des services et ouvrez le service ProcessDataStorageProvider.

    process-data-storage-service

    RootFolder

    Emplacement CRX à l’intérieur duquel les données de processus seraient stockées pour la création de rapports.

    Default: /content/reporting/pm

    Hiérarchie des dossiers

    Hiérarchie de dossiers à l’intérieur de laquelle les données de processus sont stockées en fonction de l’heure de création du processus.

    Default: /yyyy/mm/dd/hh/mi/ss

  3. Cliquez sur Enregistrer.

Service ReportConfiguration

Le service ReportConfiguration est utilisé par Process Reporting pour configurer le service de requête de création de rapports de processus.

Pour configurer le service ReportingConfiguration

  1. Connectez-vous à Configuration Manager à l’aide des informations d’identification d’administrateur CRX. L’URL par défaut de Configuration Manager est https://[*server*]:[*port*]/lc/system/console/configMgr

  2. Ouvrez le service ReportingConfiguration .

  3. Nombre d’enregistrements

    Lors de l’exécution d’une requête sur le référentiel, un résultat peut potentiellement contenir un grand nombre d’enregistrements. Si le jeu de résultats est volumineux, l’exécution de la requête peut consommer des ressources du serveur.

    Pour gérer les jeux de résultats volumineux, le service ReportConfiguration divise le traitement des requêtes en lots d’enregistrements. Cela réduit la charge du système.

    Default: 1000

    Chemin de stockage CRX

    Emplacement CRX à l’intérieur duquel les données de processus doivent être stockées pour la création de rapports.

    Default: /content/reporting/pm

    REMARQUE

    Il s’agit du même emplacement que celui spécifié dans l’option de configuration ProcessDataStorage Root Folder.

    Si vous mettez à jour l’option Root Folder dans la configuration ProcessDataStorage, vous devez mettre à jour l’emplacement CRX Storage Path dans le service ReportConfiguration.

  4. Cliquez sur Enregistrer et fermez CQ Configuration Manager.

Service ProcessDataPublisher

Le service ProcessDataPublisher importe les données de processus de la base de données AEM Forms et les publie dans le service ProcessDataStorageProvider pour le stockage.

Pour configurer le service ProcessDataPublisher  

  1. Connectez-vous à Administration Console à l’aide des informations d’identification de l’administrateur.

    L’URL par défaut est https://[server]:port]/adminui/.

  2. Accédez à Accueil > Services > Applications et services > Gestion des services et ouvrez le service ProcessDataPublisher.

processdatapublisherservice-1

Publier les données

Activez cette option pour lancer la publication des données de processus. Par défaut, l’option est désactivée.

Activez la création de rapports de processus uniquement lorsque toutes les configurations liées aux composants Process Reporting sont configurées de manière appropriée.

Vous pouvez également utiliser cette option pour désactiver la publication des données de processus lorsqu’elle n’est plus nécessaire.

Default: Off

Intervalle de lot (sec)

Chaque fois que le service ProcessDataPublisher s’exécute, le service divise d’abord le temps depuis la dernière exécution du service par l’intervalle de lot. Le service traite ensuite séparément chaque intervalle de données AEM Forms.

Cela permet de contrôler la taille des données que les processus de l’éditeur se terminent au cours de chaque exécution (lot) au cours d’un cycle.

Par exemple, si l’éditeur s’exécute tous les jours, au lieu de traiter l’ensemble des données pendant un jour au cours d’une seule exécution, il divise par défaut le traitement en 24 lots d’une heure chacun.

Default: 3600

Unit: Seconds

Verrouiller le délai d’expiration (s)

Le service d’éditeur acquiert un verrou lorsqu’il démarre le traitement des données, de sorte que plusieurs instances de l’éditeur ne commencent pas à exécuter et à traiter les données simultanément.

Si un service d’éditeur qui a acquis un verrou est inactif pendant le nombre de secondes défini par la valeur Délai d’expiration du verrou, son verrou est libéré afin que d’autres instances de service d’éditeur puissent continuer le traitement.

Default: 3600

Unit: Seconds

Publier les données à partir de

L’environnement AEM Forms contient les données du moment où l’environnement a été configuré.

Par défaut, le service ProcessDataPublisher importe toutes les données de la base de données AEM Forms.

En fonction de vos besoins de création de rapports, si vous prévoyez d’exécuter des rapports et des requêtes sur des données après une certaine date et heure, il est recommandé de spécifier la date et l’heure. Le service de publication publiera alors la date à partir de cette date.

Default: 01-01-1970 00:00:00

Format: dd-MM-yyyy HH:mm:ss

Accès à l’interface utilisateur de Process Reporting

L’interface utilisateur de Process Reporting est basée sur un navigateur.

Une fois que vous avez configuré Process Reporting, vous pouvez commencer à utiliser Process Reporting à l’emplacement suivant dans votre installation AEM Forms :

https://<server>:<port>/lc/pr

Connexion aux rapports de processus

Lorsque vous accédez à l’URL Process Reporting (https://<server>:<port>/lc/pr), l’écran de connexion s’affiche.

Indiquez vos informations d’identification pour vous connecter au module Process Reporting.

REMARQUE

Pour vous connecter à l’interface utilisateur Process Reporting, vous devez disposer de l’autorisation AEM Forms suivante :

PERM_PROCESS_REPORTING_USER

capture

Lorsque vous vous connectez à Process Reporting, l’écran Home s’affiche.

Écran d’accueil des rapports de processus

process-reporting-home-screen

Arborescence des rapports de processus : l’arborescence du côté gauche de l’écran d’accueil contient les éléments des modules de rapports de processus.

L’arborescence est composée des éléments de niveau supérieur suivants :

Rapports : cet élément contient les rapports d’usine fournis avec Process Reporting.

Pour plus d’informations sur les rapports prédéfinis, voir Rapports prédéfinis dans Process Reporting.

Requêtes ad hoc : cet élément contient des options permettant d’effectuer une recherche basée sur des filtres pour les processus et les tâches.

Pour plus d’informations sur les requêtes ad hoc, voir Requêtes ad hoc dans les rapports de processus.

Personnalisé : le noeud Personnalisé affiche les rapports personnalisés que vous créez.

Pour connaître la procédure de création et d’affichage de rapports personnalisés, voir Rapports personnalisés dans Process Reporting.

Barre de titre Process Reporting : la barre de titre Process Reporting contient des options génériques que vous pouvez utiliser lorsque vous travaillez dans l’interface utilisateur.

Titre des rapports de processus : le titre des rapports de processus s’affiche dans le coin gauche de la barre de titre.

Cliquez sur le titre à tout moment pour revenir à l’écran d’accueil.

Dernière heure de mise à jour : les données de processus sont publiées de la base de données AEM Forms vers le référentiel Process Reporting selon un calendrier précis.

L’heure de la dernière mise à jour affiche la date et l’heure auxquelles les mises à jour de données ont été transmises au référentiel Process Reporting.

Pour plus d’informations sur le service de publication de données et sur la planification de ce service, voir Planification de la publication des données de processus dans l’article Prise en main des rapports de processus.

Utilisateur Process Reporting : le nom d’utilisateur connecté s’affiche à droite de l’heure de la dernière mise à jour.

Liste déroulante de la barre de titre des rapports de processus : la liste déroulante située dans le coin droit de la barre de titre des rapports de processus contient les options suivantes :

  • Synchronisation : Synchronisez le référentiel Process Reporting incorporé avec la base de données AEM Forms.
  • Aide : Consultez la documentation d’aide sur les rapports de processus.
  • Déconnexion : Déconnexion des rapports de processus

Sur cette page