Guida introduttiva ai report sui processi

La funzione di reporting sui processi consente agli utenti di AEM Forms di eseguire query sulle informazioni sui processi di AEM Forms attualmente definiti nell’implementazione di AEM Forms. Tuttavia, il reporting dei processi non accede ai dati direttamente dall’archivio di AEM Forms. I dati vengono pubblicati per la prima volta nell'archivio di report dei processi su base pianificata (dal servizio ProcessDataPublisher e ProcessDataStorage s). I report e le query in Process Reporting vengono quindi generati dai dati di Process Reporting pubblicati nel repository. Process Reporting viene installato come parte del modulo di Forms Workflow.

Questo articolo descrive i passaggi necessari per abilitare la pubblicazione dei dati di AEM Forms nell’archivio di Process Reporting. In seguito, sarà possibile utilizzare Report processi per eseguire report e query. Nell'articolo vengono inoltre illustrate le opzioni disponibili per configurare i servizi di report dei processi.

Prerequisiti per la generazione di rapporti sui processi

Eliminare i processi non essenziali

Se si utilizza Forms Workflow, il database di AEM Forms potrebbe contenere una grande quantità di dati

I servizi di pubblicazione di Process Reporting pubblicano tutti i dati di AEM Forms attualmente disponibili nel database. Ciò implica che se il database contiene dati legacy sui quali non desideri eseguire report e query, anche tutti i dati verranno pubblicati nell’archivio, anche se non sono necessari per il reporting. Si consiglia di eliminare questi dati prima di eseguire i servizi per pubblicare i dati nel repository di Process Reporting. In questo modo si migliorano le prestazioni sia del servizio di pubblicazione che del servizio che esegue query sui dati per il reporting.

Per informazioni dettagliate sulla rimozione dei dati di processo di AEM Forms, consulta Rimozione dati processo.

Configurazione di Process Reporting Services

Pianifica pubblicazione dati processo

I servizi di report dei processi pubblicano i dati dal database di AEM Forms all'archivio di report dei processi su base pianificata.

Questa operazione può richiedere molte risorse e può influire sulle prestazioni dei server AEM Forms. È consigliabile pianificare questa operazione all’esterno degli slot orari occupati del server AEM Forms.

Per impostazione predefinita, la pubblicazione dei dati viene pianificata per essere eseguita ogni giorno alle 02:00.

Per modificare la pianificazione di pubblicazione, effettuare le seguenti operazioni:

1. Arresta l'istanza di AEM Forms Server.

2. ​

   • (Per Windows) Apri il [JBoss root]/bin/run.conf.bat in un editor.
   • (per Linux®, AIX® e Solaris™) [JBoss root]/bin/run.conf.sh in un editor.

3. Aggiungi l’argomento JVM -Dreporting.publisher.cron = <expression>.

   Esempio: la seguente espressione cron induce Process Reporting a pubblicare i dati di AEM Forms nell’archivio di Process Reporting ogni cinque ore:

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

4. Salva e chiudi run.conf.bat file.

5. Riavvia l’istanza di AEM Forms Server.

6. Arresta l'istanza di AEM Forms Server.

7. Accedere a WebSphere® Administrative Console. Nella struttura di navigazione, fai clic su Server > Server applicazioni quindi, nel riquadro di destra, fare clic sul nome del server.

8. In Infrastruttura server fare clic su Java™ e gestione dei processi > Definizione processo.

9. In Proprietà aggiuntive, fai clic su Java™ Virtual Machine.

   Nella casella Argomenti JVM generici aggiungere l'argomento -Dreporting.publisher.cron = <expression>.

   Esempio: la seguente espressione cron induce Process Reporting a pubblicare i dati di AEM Forms nell’archivio di Process Reporting ogni cinque ore:

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

10. Clic Applica, scegliere OK e quindi fare clic su Salva direttamente nella configurazione principale.

11. Riavvia l’istanza di AEM Forms Server.

12. Arresta l'istanza di AEM Forms Server.

13. Accedere alla console di amministrazione WebLogic. L'indirizzo predefinito della console di amministrazione WebLogic è https://[hostname]:[port]/console.

14. In Cambia centro fare clic su Blocca e modifica.

15. In Struttura dominio, fai clic su Ambiente > Server nel riquadro di destra fare clic sul nome del server gestito.

16. Nella schermata successiva, fai clic su Configurazione scheda > Avvio server scheda.

17. Nella casella Argomenti aggiungere l'argomento JVM -Dreporting.publisher.cron = <expression>.

    Esempio: la seguente espressione cron induce Process Reporting a pubblicare i dati di AEM Forms nell’archivio di Process Reporting ogni cinque ore:

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

18. Clic Salva e quindi fare clic su Attiva modifiche.

19. Riavvia l’istanza di AEM Forms Server.

Servizio ProcessDataStorage

Il servizio ProcessDataStorageProvider riceve i dati di processo dal servizio ProcessDataPublisher e li salva nel repository di Process Reporting.

A ogni ciclo di pubblicazione, i dati vengono salvati nelle sottocartelle di una cartella principale predefinita.

Puoi utilizzare la console di amministrazione per configurare la directory principale (predefinito: /content/reporting/pm) posizione e sottocartella (predefinito: /yyyy/mm/dd/hh/mi/ss) formato della gerarchia in cui memorizzare i dati del processo.

Per configurare i percorsi dell'archivio di report dei processi

1. Accedi a Console di amministrazione con le credenziali di amministratore. L’URL predefinito di Administration Console è https://'[server]:[port]'/adminui

2. Accedi a Home > Servizi > Applicazioni e servizi >Gestione dei servizi e apri ProcessDataStorageProvider servizio.

   

   RootFolder

   Posizione CRX in cui memorizzare i dati del processo per il reporting.

   Default: /content/reporting/pm

   Gerarchia cartelle

   Gerarchia di cartelle in cui memorizzare i dati del processo in base all'ora di creazione del processo.

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

3. Fai clic su Salva.

Servizio ReportConfiguration

Il servizio ReportConfiguration viene utilizzato da Process Reporting per la configurazione del servizio query di report dei processi.

Per configurare il servizio ReportingConfiguration

1. Accedi a Gestione configurazione con le credenziali di amministratore CRX. L’URL predefinito di Configuration Manager è https://'[server]:[port]'/lc/system/console/configMgr

2. Apri ConfigurazioneReporting servizio.

3. Numero di record

   Quando si esegue una query nel repository, un risultato può potenzialmente contenere molti record. Se il set di risultati è grande, l’esecuzione della query può utilizzare risorse del server.

   Per gestire set di risultati di grandi dimensioni, il servizio ReportConfiguration suddivide l'elaborazione della query in batch di record. In questo modo si riduce il carico del sistema.

   Default: 1000

   Percorso di archiviazione CRX

   La posizione CRX in cui devono essere memorizzati i dati del processo a scopo di reporting.

   Default: /content/reporting/pm

   NOTA

   Questa posizione corrisponde a quella specificata nell'opzione di configurazione ProcessDataStorage Cartella principale.

   Se si aggiorna l'opzione Root Folder nella configurazione ProcessDataStorage, è necessario aggiornare il percorso di archiviazione CRX nel servizio ReportConfiguration.

4. Clic Salva e chiudi Gestione configurazione CQ.

Servizio ProcessDataPublisher

Il servizio ProcessDataPublisher importa i dati di processo dal database di AEM Forms e li pubblica nel servizio ProcessDataStorageProvider per l'archiviazione.

Per configurare il servizio ProcessDataPublisher  

1. Accedi a Console di amministrazione con le credenziali di amministratore.

   L’URL predefinito è https://'server':port]/adminui/.

2. Accedi a Home > Servizi > Applicazioni e servizi >Gestione dei servizi e apri ProcessDataPublisher servizio.

Pubblica dati

Abilita questa opzione per avviare la pubblicazione dei dati del processo. Per impostazione predefinita, l’opzione è disabilitata.

Abilitare Process Reporting solo quando tutte le configurazioni correlate ai componenti di Process Reporting sono impostate in modo appropriato.

In alternativa, utilizzare questa opzione per disabilitare la pubblicazione dei dati di processo quando non è più necessaria.

Default: Off

Intervallo batch (sec)

Ogni volta che viene eseguito il servizio ProcessDataPublisher, il servizio suddivide per l'intervallo batch il tempo trascorso dall'ultima esecuzione del servizio. Il servizio elabora quindi separatamente ogni intervallo di dati di AEM Forms per controllare la dimensione dei dati elaborati dall’editore in modalità end-to-end durante ogni esecuzione (batch) di un ciclo.

Ad esempio, se l’editore viene eseguito ogni giorno, invece di elaborare tutti i dati per un giorno in una singola esecuzione, per impostazione predefinita l’elaborazione viene suddivisa in 24 batch da un’ora ciascuno.

Default: 3600

Unit: Seconds

Timeout blocco (sec)

Il servizio di pubblicazione acquisisce un blocco quando inizia l'elaborazione dei dati in modo che più istanze dell'autore non inizino a eseguire ed elaborare i dati contemporaneamente.

Se un servizio di pubblicazione che ha acquisito un blocco è inattivo per il numero di secondi definito dal valore di Timeout blocco, il relativo blocco viene rilasciato in modo che altre istanze del servizio di pubblicazione possano continuare l'elaborazione.

Default: 3600

Unit: Seconds

Pubblica dati da

L’ambiente AEM Forms contiene i dati relativi al momento in cui è stato configurato.

Per impostazione predefinita, il servizio ProcessDataPublisher importa tutti i dati dal database di AEM Forms.

A seconda delle esigenze di reporting, se prevedi di eseguire rapporti e query sui dati dopo una certa data e ora, è consigliabile specificare la data e l’ora. Il servizio di pubblicazione pubblica quindi la data da tale data in poi.

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

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

Accesso all'interfaccia utente di Process Reporting

L'interfaccia utente di Process Reporting è basata su browser.

Dopo aver impostato Report processi, puoi iniziare a utilizzare Reporting processi nella seguente posizione nell’installazione di AEM Forms:

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

Accedi a Reporting processi

Quando si passa all'URL di Report processo (https://)<server>:<port>/lc/pr), viene visualizzata la schermata di accesso.

Per accedere al modulo Report processi, specificare le credenziali.

Quando si esegue l'accesso a Reporting processi, il Home schermo.

Schermata Home di Process Reporting

Visualizzazione struttura report processi: La struttura ad albero sul lato sinistro della schermata Home contiene gli elementi per i moduli Report di processo.

La struttura ad albero è costituita dai seguenti elementi di primo livello:

Rapporti: Questo articolo contiene i report preconfigurati forniti con Process Reporting.

Per informazioni dettagliate sui rapporti predefiniti, consulta Rapporti predefiniti nella generazione di rapporti.

Query ad hoc: Questo elemento contiene le opzioni per eseguire la ricerca di processi e attività basata su filtri.

Per informazioni dettagliate sulle query ad hoc, consulta Query ad hoc in Report di processo.

Personalizzato: Nel nodo Personalizzato vengono visualizzati i rapporti personalizzati creati dall'utente.

Per la procedura per creare e visualizzare rapporti personalizzati, consulta Rapporti personalizzati in Report di processo.

Barra del titolo Report di processo: La barra del titolo di Process Reporting contiene alcune opzioni generiche che è possibile utilizzare quando si lavora nell'interfaccia utente.

Titolo report processi: Il titolo Report di processo viene visualizzato nell'angolo sinistro della barra del titolo.

Fare clic sul titolo in qualsiasi momento per tornare alla schermata iniziale.

Ora ultimo aggiornamento: I dati del processo vengono pubblicati dal database di AEM Forms all’archivio di Process Reporting in base a una pianificazione.

Ora ultimo aggiornamento visualizza la data e l'ora dell'ultimo push degli aggiornamenti dei dati all'archivio di report dei processi.

Per informazioni dettagliate sul servizio di pubblicazione dei dati e sulla pianificazione di tale servizio, consulta Pianifica pubblicazione dati processo nell'articolo Guida introduttiva a Process Reporting.

Utente report processi: Il nome utente connesso viene visualizzato a destra dell'ora dell'ultimo aggiornamento.

Elenco a discesa della barra del titolo Processi: L'elenco a discesa nell'angolo destro della barra del titolo Report di processo contiene le opzioni seguenti:

• Sincronizza: sincronizza l’archivio di Process Reporting incorporato con il database di AEM Forms.
• Aiuto: consulta la documentazione di Aiuto su Reporting sui processi.
• Disconnetti: disconnessione da Reporting processi