Komma igång med processrapportering getting-started-with-process-reporting

Med Process Reporting kan AEM Forms-användare ställa frågor om AEM Forms-processer som för närvarande är definierade i AEM Forms-implementeringen. Processrapportering kommer dock inte åt data direkt från AEM Forms-databasen. Data publiceras först till Process Reporting-databasen på schemalagd basis (av tjänsten ProcessDataPublisher & ProcessDataStorage s). Rapporterna och frågorna i processrapportering genereras sedan från de processrapporteringsdata som publiceras till databasen. Processrapportering installeras som en del av modulen Forms Workflow.

I den här artikeln beskrivs stegen för hur du aktiverar publicering av AEM Forms-data i Process Reporting-databasen. Därefter kan du använda processrapportering för att köra rapporter och frågor. Artikeln innehåller även de alternativ som är tillgängliga för att konfigurera Process Reporting Services.

Krav för processrapportering process-reporting-pre-requisites

Rensa processer som inte är nödvändiga purge-non-essential-processes

Om du använder Forms Workflow kan AEM Forms-databasen innehålla en stor mängd data

Publiceringstjänsterna för processrapportering publicerar alla AEM Forms-data som för närvarande finns i databasen. Det innebär att om databasen innehåller äldre data som du inte vill köra rapporter och frågor på, kommer alla dessa data också att publiceras i databasen, även om de inte behövs för rapportering. Du rekommenderas att rensa dessa data innan du kör tjänsterna för att publicera data i Process Reporting-databasen. Om du gör det förbättras prestandan för både utgivartjänsten och tjänsten som frågar efter data för rapportering.

Mer information om att rensa AEM Forms processdata finns i Rensningsprocessdata.

NOTE
Tips och tricks för verktyget Rensa finns i Adobe Developer Connection artikel om Rensningsprocesser och -jobb.

Konfigurerar Process Reporting Services configuring-process-reporting-services

Schemalägg publicering av processdata schedule-process-data-publishing

Process Reporting Services publicerar schemalagda data från AEM Forms-databasen till Process Reporting-databasen.

Den här åtgärden kan vara resurskrävande och kan påverka prestandan för AEM Forms-servrarna. Vi rekommenderar att du schemalägger detta utanför AEM Forms Server med upptagna tidsrymder.

Som standard kommer publiceringen av data att köras varje dag kl. 02:00.

Så här ändrar du publiceringsschemat:

NOTE
Om du kör din AEM Forms-implementering på ett kluster utför du följande steg på varje nod i klustret.
  1. Stoppa AEM Forms Server-instansen.

    • (Windows) Öppna [JBoss root]/bin/run.conf.bat i en redigerare.
    • (För Linux®, AIX® och Solaris™) [JBoss root]/bin/run.conf.sh i en redigerare.
  2. Lägg till JVM-argumentet -Dreporting.publisher.cron = <expression>.

    Exempel: Följande cron-uttryck gör att Process Reporting publicerar AEM Forms-data i Process Reporting-databasen var femte timme:

    • -Dreporting.publisher.cron = 0_0_0/5_*_*_?
  3. Spara och stäng run.conf.bat -fil.

  4. Starta om AEM Forms Server-instansen.

  5. Stoppa AEM Forms Server-instansen.

  6. Logga in på administrationskonsolen för WebSphere®. Klicka i navigeringsträdet på Servrar > Programservrar och klicka sedan på servernamnet i den högra rutan.

  7. Under Serverinfrastruktur klickar du på Java™ och Process Management > Processdefinition.

  8. Klicka på under Ytterligare egenskaper Java™ Virtual Machine.

    Lägg till argumentet i rutan Allmänt om JVM-argument -Dreporting.publisher.cron = <expression>.

    Exempel: Följande cron-uttryck gör att Process Reporting publicerar AEM Forms-data i Process Reporting-databasen var femte timme:

    • -Dreporting.publisher.cron = 0_0_0/5_*_*_?
  9. Klicka Använd, klicka på OK och sedan på Spara direkt i huvudkonfigurationen.

  10. Starta om AEM Forms Server-instansen.

  11. Stoppa AEM Forms Server-instansen.

  12. Logga in på WebLogic Administration Console. Standardadressen för WebLogic Administration Console är https://[hostname]:[port]/console.

  13. Klicka på under Ändringscenter Lås och redigera.

  14. Klicka på under Domänstruktur Miljö > Servrar och klicka på namnet på den hanterade servern i den högra rutan.

  15. Klicka på knappen Konfiguration tab > Serverstart -fliken.

  16. Lägg till JVM-argumentet i rutan Argument -Dreporting.publisher.cron = <expression>.

    Exempel: Följande cron-uttryck gör att Process Reporting publicerar AEM Forms-data i Process Reporting-databasen var femte timme:

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

  17. Klicka Spara och sedan klicka Aktivera ändringar.

  18. Starta om AEM Forms Server-instansen.

procesdatapublisherservice

NOTE
Du bör använda kommandot Ctrl + C för att starta om SDK:n. Om du startar om AEM SDK med alternativa metoder, till exempel genom att stoppa Java-processer, kan det leda till inkonsekvenser i den AEM utvecklingsmiljön.

Tjänsten ProcessDataStorage processdatastorage-service

ProcessDataStorageProvider-tjänsten tar emot processdata från ProcessDataPublisher-tjänsten och sparar data i Process Reporting-databasen.

Vid varje publiceringscykel sparas data i undermappar till en fördefinierad rotmapp.

Du kan använda administrationskonsolen för att konfigurera roten (standard: /content/reporting/pm) plats och undermapp (standard: /yyyy/mm/dd/hh/mi/ss) hierarkiformat där processdata ska lagras.

Så här konfigurerar du lagringsplatser för processrapportering to-configure-the-process-reporting-repository-locations

  1. Logga in på Administration Console med administratörsuppgifter. Standardwebbadressen för administrationskonsolen är https://'[server]:[port]'/adminui

  2. Navigera till Startsida > Tjänster > Program och tjänster >Tjänsthantering och öppna ProcessDataStorageProvider service.

    process-data-storage-service

    RootFolder

    Den CRX-plats där processdata ska lagras för rapportering.

    Default: /content/reporting/pm

    Mapphierarki

    Mapphierarkin där processdata ska lagras baserat på tiden då processen skapades.

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

  3. Klicka Spara.

Tjänsten ReportConfiguration reportconfiguration-service

Tjänsten ReportConfiguration används av Process Reporting för att konfigurera frågetjänsten för processrapportering.

Så här konfigurerar du ReportingConfiguration-tjänsten to-configure-the-reportingconfiguration-service

  1. Logga in på Konfigurationshanteraren med CRX-administratörsuppgifter. Konfigurationshanterarens standardwebbadress är https://'[server]:[port]'/lc/system/console/configMgr

  2. Öppna ReportingConfiguration service.

  3. Antal poster

    När en fråga körs i databasen kan resultatet innehålla många poster. Om resultatmängden är stor kan frågekörningen ta serverresurser i anspråk.

    För att hantera stora resultatuppsättningar delar tjänsten ReportConfiguration frågebearbetningen i grupper av poster. På så sätt minskas systembelastningen.

    Default: 1000

    CRX-lagringssökväg

    Den CRX-plats där processdata ska lagras för rapportering.

    Default: /content/reporting/pm

    note note
    NOTE
    Platsen är densamma som anges i konfigurationsalternativet ProcessDataStorage Rotmapp.
    Om du uppdaterar alternativet Rotmapp i ProcessDataStorage-konfigurationen måste du uppdatera sökvägen till CRX-lagringssökvägen i tjänsten ReportConfiguration.
  4. Klicka Spara och stäng CQ Configuration Manager.

ProcessDataPublisher-tjänst processdatapublisher-service

Tjänsten ProcessDataPublisher importerar processdata från AEM Forms-databasen och publicerar data till tjänsten ProcessDataStorageProvider för lagring.

Konfigurera tjänsten ProcessDataPublisher   to-configure-processdatapublisher-service-nbsp

  1. Logga in på Administration Console med administratörsuppgifter.

    Standardwebbadressen är https://'server':port]/adminui/.

  2. Navigera till Startsida > Tjänster > Program och tjänster >Tjänsthantering och öppna ProcessDataPublisher service.

processdatapublisherservice-1

Publicera data

Aktivera det här alternativet om du vill starta publiceringen av processdata. Som standard är alternativet inaktiverat.

Aktivera bara processrapportering när alla konfigurationer som är relaterade till processrapportkomponenter har konfigurerats korrekt.

Du kan också använda det här alternativet om du vill inaktivera publicering av processdata när det inte längre behövs.

Default: Off

Gruppintervall (sek)

Varje gång tjänsten ProcessDataPublisher körs delar tjänsten först tiden sedan den senaste körningen av tjänsten via batchintervallet. Tjänsten bearbetar sedan varje intervall med AEM Forms-data separat för att styra storleken på data som utgivaren bearbetar från början till slut under varje körning (batch) inom en cykel.

Om utgivaren till exempel körs varje dag, delas bearbetningen som standard i 24 batchar om en timme vardera i stället för att bearbeta hela data för en dag i en enda omgång.

Default: 3600

Unit: Seconds

Timeout för låsning (sek)

Utgivartjänsten låser sig när den börjar bearbeta data så att flera instanser av utgivaren inte börjar köra och bearbeta data samtidigt.

Om en utgivartjänst som har låst sig är inaktiv i det antal sekunder som anges av Timeout-värdet för lås, kommer låset att släppas så att andra instanser av utgivartjänsten kan fortsätta bearbetningen.

Default: 3600

Unit: Seconds

Publicera data från

AEM Forms-miljön innehåller data från den tidpunkt då miljön konfigurerades.

Som standard importerar ProcessDataPublisher-tjänsten alla data från AEM Forms-databasen.

Om du planerar att köra rapporter och frågor på data efter ett visst datum och en viss tid, bör du ange datum och tid, beroende på dina rapporteringsbehov. Publiceringstjänsten publicerar sedan datumet från den tidpunkten och framåt.

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

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

Åtkomst till användargränssnittet för processrapportering accessing-the-process-reporting-user-interface

Användargränssnittet för Process Reporting är webbläsarbaserat.

När du har konfigurerat Process Reporting kan du börja arbeta med Process Reporting på följande plats i AEM Forms-installationen:

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

Logga in på processrapportering log-in-to-process-reporting

När du navigerar till processrapportens URL (https://)<server>:<port>/lc/pr) visas inloggningsskärmen.

Om du vill logga in i processrapporteringsmodulen anger du dina autentiseringsuppgifter.

NOTE
Om du vill logga in i användargränssnittet för Process Reporting behöver du följande AEM Forms-behörighet:
PERM_PROCESS_REPORTING_USER

Logga in på processrapportering

När du loggar in på Process Reporting Home visas.

Startskärmen för processrapportering process-reporting-home-screen

process-reporting-home-screen

Trädvy för processrapportering: Trädvyn till vänster på hemskärmen innehåller objekten för processrapportmodulerna.

Trädvyn består av följande objekt på den översta nivån:

Rapporter: Det här objektet innehåller färdiga rapporter som levereras med processrapportering.

Mer information om de fördefinierade rapporterna finns i Fördefinierade rapporter i processrapportering.

Adhoc-frågor: Det här objektet innehåller alternativ för att utföra filterbaserad sökning efter processer och uppgifter.

Mer information om ad hoc-frågor finns i Ad hoc-frågor i processrapportering.

Anpassad: Noden Anpassad visar anpassade rapporter som du skapar.

Information om hur du skapar och visar anpassade rapporter finns i Anpassade rapporter i processrapportering.

Titelfält för processrapportering: Titelfältet Processrapportering innehåller några allmänna alternativ som du kan använda när du arbetar i användargränssnittet.

Processrapporttitel: Rubriken Processrapportering visas i det vänstra hörnet av namnlisten.

Klicka på titeln när som helst för att gå tillbaka till hemskärmen.

Senaste uppdateringstid: Processdata publiceras schemalagt från AEM Forms-databasen till Process Reporting-databasen.

Senaste uppdateringstid visar det senaste datumet och den senaste tiden fram till vilket datapresentationerna överfördes till Process Reporting-databasen.

Mer information om datapubliceringstjänsten och hur du schemalägger den här tjänsten finns i Schemalägg publicering av processdata i artikeln Getting Started with Process Reporting.

Procesrapporteringsanvändare: Det inloggade användarnamnet visas till höger om tiden för senaste uppdatering.

Listruta med namnlist för Processrapportering: Listrutan till höger i namnlisten Processrapportering innehåller följande alternativ:

  • Sync: Synkronisera den inbäddade Process Reporting-databasen med AEM Forms-databasen.
  • Help: Visa hjälpdokumentationen om processrapportering.
  • Logout: Logga ut från processrapportering
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2