Aktivera och visa transaktionsrapporter för AEM Forms i JEE transaction-reports-overview

Funktionen för transaktionsrapportering introduceras för AEM Forms på JEE från AEM Forms 6.5.20.0. Den här funktionen är inaktiverad som standard och kan aktiveras från administratörsgränssnittet.

Med transaktionsrapporter i AEM Forms på JEE kan du räkna med alla transaktioner som utförs i din AEM Forms-distribution. Målet är att tillhandahålla information om produktanvändning och hjälpa företagsintressenter att förstå sina digitala bearbetningsvolymer. Exempel på transaktioner:

Mer information om vad som betraktas som en transaktion finns i Fakturerbara API:er.

Aktivera transaktionsrapportering enable-transaction-reporting

Som standard är transaktionsregistrering inaktiverad. Så här aktiverar du transaktionsrapportering:

Visa transaktionsrapport view-transaction-report

När du aktiverar transaktionsrapportering blir informationen om antalet transaktioner tillgänglig via transaktionsrapporten via kontrollpanelen och en detaljerad transaktionsrapport via loggfilen. Båda förklaras nedan:

Transaktionsrapport via kontrollpanelen transaction-report-dashboard

Transaktionsrapport via kontrollpanelen ger totalt antal transaktioner för varje typ av transaktion. Du kan t.ex. få information om det totala antalet formulär som återges, konverteras och skickas enligt bilden. Så här hämtar du transaktionsrapporten:

Transaktionsrapport via loggfil transaction-report-logfile

Transaktionsrapport via loggfil innehåller detaljerad information om varje transaktion. Om du vill få åtkomst till transaktionsloggar följer du kontextsökvägen i förhållande till serverns start. Transaktioner hämtas som standard i en separat loggfil transaction_log.log. filsökvägen är relativ till serverns startkontext. Standardsökvägen för olika servrar anges nedan:

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"

Exempel på en exempeltransaktion:
[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}

Transaktionspost transaction-record-structure-jee

Transaktionsloggens struktur definierar hur varje transaktion registreras med hjälp av dess olika parametrar, till exempel service, operation, transaktionstyp och andra. Dessa ges i detalj nedan. Transaktionspostens struktur är följande:

TransactionRecord
{
    service='...',
    operation='...',
    internalService='...',
    internalOperation='...',
    transactionOperationType='...',
    transactionCount=...,
    elapsedTime=...,
    transactionDate=...
}

Exempel på transaktionslogg:

[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
}

Inspelningsfrekvens för transaktioner transaction-recording-frequency

Frekvensen för registrering av transaktioner bestäms av uppdateringsåtgärderna på servern för varje formulär som har skickats, återgetts eller konverterats.

Relaterade artiklar related-articles