Activation et affichage des rapports de transaction pour AEM Forms on JEE transaction-reports-overview
Activation des rapports de transaction enable-transaction-reporting
Par défaut, l’enregistrement de transaction est désactivé. Pour activer le reporting des transactions, procédez comme suit :
-
Accédez à
/adminuisur votre instance AEM Forms on JEE, par exemplehttp://10.14.18.10:8080/adminui. -
Connectez-vous en tant qu’ administrateur.
-
Accédez à Paramètres > Paramètres de Core System > Configurations.
-
Cochez la case pour Activer le reporting de transaction et Enregistrer les paramètres.
-
Redémarrez le serveur.
-
Outre les modifications apportées au serveur, côté client, vous devez mettre à jour le fichier
adobe-livecycle-client.jarde votre projet, si vous utilisez le même.
Affichage du rapport de transaction view-transaction-report
Lorsque vous activez la création de rapports de transaction, les informations sur le nombre de transactions sont accessibles via le rapport de transaction via le tableau de bord et un rapport de transaction détaillé via le fichier journal. Les deux sont expliquées ci-dessous :
Rapport des transactions via un tableau de bord transaction-report-dashboard
Le rapport sur les transactions, accessible par le biais d’un tableau de bord, indique le nombre total de transactions pour chaque type de transaction. Par exemple, vous obtenez des informations sur le nombre total de formulaires rendus, convertis et envoyés, comme illustré dans l’image. Pour obtenir le rapport de transaction :
- Accédez à
/adminuisur votre instance AEM Forms on JEE, par exemple :http://10.13.15.08:8080/adminui. - Connectez-vous en tant qu’ administrateur.
- Cliquez sur Health Monitor.
- Accédez à l’onglet Transaction Reporter, cliquez sur Calculate Total Transactions, et vous voyez maintenant qu’un graphique circulaire représente le nombre de PDF forms - envoyés, rendus ou convertis.
Rapport de transaction via un fichier journal transaction-report-logfile
Le rapport des transactions via un fichier journal fournit des informations détaillées sur chaque transaction. Pour accéder aux journaux des transactions, suivez le chemin du contexte relatif au démarrage du serveur. Par défaut, les transactions sont capturées dans un fichier journal distinct transaction_log.log. Le chemin d’accès au fichier est relatif au contexte de démarrage du serveur. Le chemin par défaut des différents serveurs est indiqué ci-dessous :
For Jboss Turnkey:
"<AEM_Forms_Installation>/jboss/bin/transaction_log.log"
For IBM Websphere:
"<IBM_WAS_Profile_path>/transaction_log.log"
For Oracle Weblogic:
"<Weblogic_Domain_path>/transaction_log.log"
For Jboss Cluster:
"<Jboss home>/transaction_log.log"
Exemple d'enregistrement de transaction d'exemple :[2024-02-28 06:11:27] [INFO] TransactionRecord{service='GeneratePDFService', operation='HtmlFileToPDF', internalService='GeneratePDFService', internalOperation='HtmlFileToPDF', transactionOperationType='CONVERT', transactionCount=1, elapsedTime=1906, transactionDate=Wed Feb 28 06:11:25 UTC 2024}
Enregistrement de transaction transaction-record-structure-jee
La structure du journal des transactions définit la manière dont chaque transaction est enregistrée au moyen de ses différents paramètres, tels que le service, l’opération, le type de transaction, etc. Chacun d'eux est présenté en détail ci-dessous. La structure de l'enregistrement de transaction est la suivante :
TransactionRecord
{
service='...',
operation='...',
internalService='...',
internalOperation='...',
transactionOperationType='...',
transactionCount=...,
elapsedTime=...,
transactionDate=...
}
- service : nom du service.
- operation : nom de l’opération.
- internalService : nom de l’appel en cas d’appel interne, sinon identique au nom du service.
- internalOperation : le nom de l’appel est présent dans un appel interne, sinon le même que le nom de l’opération.
- transactionOperationType : type de transaction (envoi, rendu, conversion).
- transactionCount : nombre total de transactions.
- elapsedTime : temps entre le lancement de l’appel et la réponse reçue.
- transactionDate : horodatage indiquant quand le service a été appelé.
Exemple de journal de transaction :
[2024-02-14 14:23:25] [INFO] TransactionRecord
{
service='BarcodedFormsService',
operation='decode',
internalService='BarcodedFormsService',
internalOperation='decode',
transactionOperationType='CONVERT',
transactionCount=1,
elapsedTime=47405,
transactionDate=Wed Feb 14 14:22:37 UTC 2024
}
Fréquence d’enregistrement des transactions transaction-recording-frequency
La fréquence d’enregistrement des transactions est déterminée par les opérations de mise à jour sur le serveur pour chaque formulaire qui est envoyé, rendu ou converti avec succès.
-
Dans le tableau de bord, le nombre de transactions est mis à jour régulièrement, la valeur par défaut est définie sur 1 minute. Vous pouvez mettre à jour la fréquence en définissant la propriété système à
"com.adobe.idp.dsc.transaction.recordFrequency". Par exemple, sur AEM Forms pour JEE sur JBoss®, ajoutez-Dcom.adobe.idp.dsc.transaction.recordFrequency=5dansJAVA_OPTSpour définir la fréquence de mise à jour sur 5 minutes. -
Dans les journaux des transactions, la mise à jour de chaque transaction se produit instantanément lorsqu’un formulaire est envoyé, rendu ou converti avec succès.