Guida introduttiva alla generazione dei rapporti sui processi

Process Reporting offre agli utenti di AEM Forms la possibilità di eseguire query sulle dei processi AEM Forms attualmente definiti nell'implementazione AEM Forms. Tuttavia, Process Reporting non accede direttamente ai dati dall'archivio di AEM Forms . I dati vengono pubblicati per la prima volta nell'archivio di Process Reporting su base programmata (dal servizio ProcessDataPublisher & ProcessDataStorage s). I report e le query in Process Reporting vengono quindi generati dai dati di Process Reporting pubblicati nell'archivio. Process Reporting è installato come parte del modulo di Forms Workflow.

In questo articolo vengono descritti i passaggi per abilitare la pubblicazione di dati AEM Forms nell'archivio di Process Reporting. Dopo di che, sarà possibile utilizzare Process Reporting per eseguire report e query. L'articolo descrive inoltre le opzioni disponibili per configurare i servizi Process Reporting.

Pre-richieste di reporting processo

Rimozione di processi non essenziali

Se si sta utilizzando l'Forms Workflow, il database AEM Forms può contenere una grande quantità di dati

I servizi di pubblicazione di Process Reporting pubblicheranno tutti dati AEM Forms attualmente disponibili nel database. Ciò implica che, se il database contiene dati legacy sui quali non si desidera eseguire report e query, anche tutti quei dati verrebbero pubblicati nell'archivio anche se non sono richiesti per la creazione di report. Si consiglia di eliminare questi dati prima di eseguire i servizi per pubblicare i dati nell'archivio di Process Reporting. Ciò migliorerà le prestazioni sia del servizio di pubblicazione che del servizio che invia query ai dati per la creazione di report.

Per informazioni dettagliate sulla rimozione dati del processo AEM Forms, vedere Rimozione dei dati del processo.

NOTA

Per suggerimenti e trucchi di Utilità di rimozione, consultate l'articolo Adobe Developer Connection su Processi e processi di rimozione.

Configurazione di Process Reporting Services

Pianificazione della pubblicazione dei dati del processo

Process Reporting Services pubblica i dati dal database AEM Forms all'archivio di Process Reporting su base programmata.

Questa operazione può richiedere molte risorse e può influire sulle prestazioni dei server AEM Forms . Si consiglia di pianificare questa operazione al di fuori degli slot dedicati server AEM Forms.

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

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

NOTA

Se state eseguendo l'implementazione AEM Forms su un cluster, eseguite i seguenti passaggi su ciascun nodo del cluster.

Server applicazioni JBoss

  1. Arrestate l'istanza server AEM Forms.

    • (Per Windows) Aprite il file [*JBoss root*]/bin/run.conf.bat in un editor.
    • (per Linux, AIX e Solaris) [*JBoss root*]/bin/run.conf.sh in un editor.
  2. Aggiungere l'argomento JVM -Dreporting.publisher.cron = <expression>.

    Esempio: La seguente espressione cron fa sì che Process Reporting pubblichi dati AEM Forms nell'archivio di Process Reporting ogni 5 ore:

    • -Dreporting.publisher.cron = 0_0_0/5_*_*_?
  3. Salvate e chiudete il file run.conf.bat.

  4. Riavviate l'istanza server AEM Forms.

Server applicazioni WebSphere

  1. Arrestate l'istanza server AEM Forms.

  2. Accedete alla console di amministrazione di WebSphere. Nella struttura di navigazione fare clic su Server > Application Server, quindi fare clic sul nome del server nel riquadro a destra.

  3. In Infrastruttura server, fare clic su Java and Process Management > Definizione processo.

  4. In Proprietà aggiuntive, fare clic su Java Virtual Machine.

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

    Esempio: La seguente espressione cron fa sì che Process Reporting pubblichi dati AEM Forms nell'archivio di Process Reporting ogni 5 ore:

    • -Dreporting.publisher.cron = 0_0_0/5_*_*_?
  5. Fare clic su Applica, fare clic su OK, quindi su Salva direttamente nella configurazione principale.

  6. Riavviate l'istanza server AEM Forms.

Server applicazioni WebLogic

  1. Arrestate l'istanza server AEM Forms.

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

  3. In Centro modifiche fare clic su Blocca e modifica.

  4. In Struttura dominio fare clic su Ambiente > Server e, nel riquadro a destra, fare clic sul nome del server gestito.

  5. Nella schermata successiva, fare clic sulla scheda Configuration > Server Start.

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

    Esempio: La seguente espressione cron fa sì che Process Reporting pubblichi dati AEM Forms nell'archivio di Process Reporting ogni 5 ore:

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

  7. Fare clic su Salva, quindi fare clic su Attiva modifiche.

  8. Riavviate l'istanza server AEM Forms.

processdatapublisherservice

Servizio ProcessDataStorage

Il servizio ProcessDataStorageProvider riceve i dati del processo dal servizio ProcessDataPublisher e li salva nell'archivio di Process Reporting.

In ciascun ciclo di pubblicazione, i dati vengono salvati nelle sottocartelle di una cartella principale predefinita.

È possibile utilizzare la console di amministrazione per configurare la radice (predefinita: /content/reporting/pm) posizione e sottocartella (predefinita: /yyyy/mm/dd/hh/mi/ss) formato gerarchico in cui vengono memorizzati i dati del processo.

Per configurare i percorsi del repository di Process Reporting

  1. Accedete a Console di amministrazione con le credenziali di amministratore. L'URL predefinito della console di amministrazione è https://[server]:[port]/adminui

  2. Andate a Home > Services > Applicazioni e servizi > Service Management e aprite il servizio ProcessDataStorageProvider.

    process-data-storage-service

    CartellaPrincipale

    Posizione CRX all'interno della quale i dati del processo vengono memorizzati per la generazione dei rapporti.

    Default: /content/reporting/pm

    Gerarchia cartelle

    La gerarchia di cartelle all’interno della quale i dati del processo vengono memorizzati in base al tempo 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 configurare il servizio di query di reporting del processo.

Per configurare il servizio ReportingConfiguration

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

  2. Aprire il servizio ReportingConfiguration.

  3. Numero di record

    Quando si esegue una query nell'archivio, un risultato può contenere un numero elevato di 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. Questo riduce il carico del sistema.

    Default: 1000

    Percorso di archiviazione CRX

    Posizione CRX all'interno della quale i dati del processo devono essere memorizzati per la generazione di rapporti.

    Default: /content/reporting/pm

    NOTA

    Si tratta della stessa posizione specificata nell'opzione di configurazione ProcessDataStorage Cartella principale.

    Se si aggiorna l'opzione Cartella principale nella configurazione ProcessDataStorage, è necessario aggiornare il percorso del percorso di memorizzazione CRX nel servizio ReportConfiguration.

  4. Fare clic su Save e chiudere CQ Configuration Manager.

Servizio ProcessDataPublisher

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

Per configurare il servizio ProcessDataPublisher  

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

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

  2. Andate a Home > Servizi > Applicazioni e servizi > Gestione dei servizi e aprite il servizio ProcessDataPublisher.

processdatapublisherservice-1

Pubblica dati

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

Abilita Process Reporting solo quando tutte le configurazioni relative ai componenti Process Reporting sono impostate correttamente.

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

Default: Off

Intervallo batch (sec)

Ogni volta che il servizio ProcessDataPublisher viene eseguito, il servizio suddivide per la prima volta l'ora dall'ultima esecuzione del servizio in base all'intervallo di batch. Il servizio elabora quindi ciascun intervallo di dati AEM Forms separatamente.

Questo consente di controllare le dimensioni dei dati che l'editore elabora e che terminano durante ogni esecuzione (batch) all'interno di un ciclo.

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

Default: 3600

Unit: Seconds

Timeout blocco (sec)

Il servizio di pubblicazione acquisisce un blocco quando avvia l'elaborazione dei dati in modo che più istanze dell'editore non avviino l'esecuzione e l'elaborazione dei dati contemporaneamente.

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

Default: 3600

Unit: Seconds

Pubblica dati da

ambiente AEM Forms contiene i dati dal momento in cui è stato configurato l'ambiente.

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

A seconda delle esigenze di reporting, se si prevede di eseguire rapporti e query sui dati dopo una determinata data e ora, è consigliabile specificare la data e l'ora. Il servizio di pubblicazione pubblicherà quindi la data a partire da tale data.

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

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

Accesso all'interfaccia utente di Process Reporting

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

Dopo aver configurato Process Reporting (Generazione rapporti sui processi), puoi iniziare a utilizzare Process Reporting (Generazione rapporti sui processi) nel seguente percorso nell'installazione AEM Forms:

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

Accedere a Process Reporting

Quando vi spostate sull'URL di Process Reporting (https://<server>:<porta>/lc/pr), viene visualizzata la schermata di accesso.

Specificare le credenziali per accedere al modulo Process Reporting.

NOTA

Per accedere all'interfaccia utente di Process Reporting, è necessario disporre delle seguenti autorizzazioni AEM Forms:

PERM_PROCESS_REPORTING_USER

capture

Quando si accede a Process Reporting (Generazione rapporti processo), viene visualizzata la schermata Home.

Schermata principale Report processo

process-reporting-home-screen

Visualizzazione struttura Report processo: La vista struttura a sinistra della schermata Home contiene gli elementi per i moduli Report processo.

La struttura è composta dai seguenti elementi di primo livello:

Rapporti: questo elemento contiene i report out-of-the-box forniti con Process Reporting.

Per informazioni dettagliate sui report predefiniti, vedere Report predefiniti in Process Reporting.

Query ad hoc: questo elemento contiene opzioni per eseguire ricerche basate sui filtri per processi e attività.

Per informazioni dettagliate sulle query ad hoc, vedere Query ad hoc in Process Reporting.

Personalizzato: il nodo Personalizzato visualizza i rapporti personalizzati creati dall'utente.

Per la procedura per creare e visualizzare rapporti personalizzati, vedere Report personalizzati in Process Reporting.

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

Titolo Report processo: il titolo Report processo viene visualizzato nell'angolo sinistro della barra del titolo.

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

Ora ultimo aggiornamento: i dati del processo vengono pubblicati dal database AEM Forms al repository di Process Reporting su base programmata.

L'Ora ultimo aggiornamento visualizza l'ultima data e l'ora in cui gli aggiornamenti dei dati sono stati inviati all'archivio di Process Reporting.

Per informazioni dettagliate sul servizio di pubblicazione dei dati e su come pianificare il servizio, consultare Pianificare la pubblicazione dei dati del processo nell'articolo Guida introduttiva ai rapporti sui processi.

Utente di Process Reporting: il nome utente connesso viene visualizzato a destra dell'ora dell'ultimo aggiornamento.

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

  • Sincronizzazione: Sincronizzare l'archivio di Process Reporting incorporato con il database AEM Forms .
  • Aiuto: Visualizzare la documentazione della Guida in linea su Process Reporting (Generazione rapporti sui processi).
  • Disconnessione: Disconnessione da Process Reporting

In questa pagina