Aan de slag met Process Reporting

LET OP

AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.

De Rapportering van het proces geeft de gebruikers van AEM Forms de capaciteit om informatie over de processen van AEM Forms te vragen die momenteel in de implementatie van AEM Forms worden bepaald. Procesrapportage heeft echter niet rechtstreeks toegang tot gegevens van de AEM Forms-opslagplaats. De gegevens worden voor het eerst gepubliceerd naar de Process Reporting repository (door de ProcessDataPublisher & ProcessDataStorage-service s). De rapporten en vragen in de Rapportering van het Proces worden dan geproduceerd uit het Proces Meldend gegevens die aan de bewaarplaats worden gepubliceerd. De Rapportering van het proces is geïnstalleerd als deel van de module van de Forms Workflow.

In dit artikel worden de stappen beschreven die het publiceren van AEM Forms-gegevens naar de Process Reporting repository mogelijk maken. Daarna, zult u het Rapport van het Proces kunnen gebruiken om rapporten en vragen in werking te stellen. Het artikel behandelt ook de opties beschikbaar om de diensten van de Rapportering van het Proces te vormen.

Voorwaarden voor procesrapportage

Niet-essentiële processen zuiveren

Als u momenteel Forms Workflow gebruikt, kan de AEM Forms-database mogelijk een grote hoeveelheid gegevens bevatten

De publicatieservices voor Process Reporting publiceren alle AEM Forms-gegevens die momenteel in de database beschikbaar zijn. Dit houdt in dat als de database verouderde gegevens bevat waarop u geen rapporten en query's wilt uitvoeren, alle gegevens ook naar de gegevensopslagruimte worden gepubliceerd, ook al is dit niet vereist voor rapportage. U wordt aangeraden deze gegevens te wissen voordat u de services uitvoert om de gegevens naar de Process Reporting-opslagplaats te publiceren. Dit zal de prestaties van zowel de uitgeversdienst als de dienst verbeteren die de gegevens voor rapportering vraagt.

Voor meer informatie over het wissen van AEM Forms-procesgegevens raadpleegt u Procesgegevens wissen.

OPMERKING

Raadpleeg het Adobe Developer Connection-artikel over het gebruik van het gereedschap Leegmaken voor de tips en trucs van het hulpprogramma Leegmaken en banen.

Services voor Process Reporting configureren

Publiceren van procesgegevens plannen

De Process Reporting Services publiceren op geregelde basis gegevens van de AEM Forms-database naar de Process Reporting repository.

Deze bewerking kan bronintensief zijn en de prestaties van de AEM Forms-servers beïnvloeden. U wordt aangeraden dit buiten de bezige tijdsleuven van de AEM Forms-server te plannen.

Door gebrek, is het publiceren van gegevens planning om elke dag om 2:00 uur in werking te stellen.

Voer de volgende stappen uit om het publicatieschema te wijzigen:

OPMERKING

Als u uw AEM Forms-implementatie uitvoert in een cluster, voert u de volgende stappen uit op elk knooppunt van de cluster.

JBoss-toepassingsserver

  1. Stop de AEM Forms-serverinstantie.

    • (Voor Windows) Open het dialoogvenster [*JBoss root*]/bin/run.conf.bat in een editor.
    • (Voor Linux, AIX en Solaris) [*JBoss root*]/bin/run.conf.sh in een editor.

  2. Het JVM-argument toevoegen -Dreporting.publisher.cron = <expression>.

    Voorbeeld: Met de volgende uitsnijdexpressie worden bij Process Reporting om de vijf uur AEM Forms-gegevens naar de Process Reporting-opslagplaats gepubliceerd:

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

  3. Sla het bestand op en sluit het run.conf.bat bestand.

  4. Start de AEM Forms-serverinstantie opnieuw.

WebSphere-toepassingsserver

  1. Stop de AEM Forms-serverinstantie.

  2. Meld u aan bij de beheerconsole van WebSphere. Klik in de navigatiestructuur op Servers > Toepassingsservers en klik vervolgens in het rechterdeelvenster op de servernaam.

  3. Klik onder Serverinfrastructuur op Java en Process Management > Procesdefinitie.

  4. Klik onder Extra eigenschappen op Java Virtual Machine.

    Voeg het argument toe in het vak Generic JVM-argumenten -Dreporting.publisher.cron = <expression>.

    Voorbeeld: Met de volgende uitsnijdexpressie worden bij Process Reporting om de vijf uur AEM Forms-gegevens naar de Process Reporting-opslagplaats gepubliceerd:

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

  5. Klikken Toepassen, klikt u op OK en vervolgens op Direct opslaan in de master configuratie.

  6. Start de AEM Forms-serverinstantie opnieuw.

WebLogic-toepassingsserver

  1. Stop de AEM Forms-serverinstantie.

  2. Meld u aan bij de WebLogic-beheerconsole. Het standaardadres van de WebLogic-beheerconsole is https://[hostname]:[port]/console.

  3. Klik onder Wijzigen in midden op Vergrendelen en bewerken.

  4. Klik onder Domeinstructuur op Omgeving > Servers en klik in het rechterdeelvenster op de naam van de beheerde server.

  5. Klik in het volgende scherm op de knop Configuratie tab > Start server tab.

  6. Voeg in het vak Argumenten het JVM-argument toe -Dreporting.publisher.cron = <expression>.

    Voorbeeld: Met de volgende uitsnijdexpressie worden bij Process Reporting om de vijf uur AEM Forms-gegevens naar de Process Reporting-opslagplaats gepubliceerd:

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

  7. Klikken Opslaan en klik vervolgens op Wijzigingen activeren.

  8. Start de AEM Forms-serverinstantie opnieuw.

processdatapublisherservice

ProcessDataStorage-service

De dienst ProcessDataStorageProvider ontvangt procesgegevens van de dienst ProcessDataPublisher en bewaart de gegevens aan de bewaarplaats van de Rapportering van het Proces.

Bij elke publicatiecyclus worden de gegevens opgeslagen in submappen van een vooraf gedefinieerde hoofdmap.

U kunt de console van het Beleid gebruiken om de wortel te vormen (default: /content/reporting/pm) locatie en submap (default: /yyyy/mm/dd/hh/mi/ss) hiërarchieopmaak waarin de procesgegevens worden opgeslagen.

De locaties van de Process Reporting repository configureren

  1. Aanmelden bij Beheerconsole met beheerdersreferenties. De standaard-URL van de beheerconsole is https://[server]:[port]/adminui

  2. Navigeren naar Home > Services > Toepassingen en services > Servicebeheer en opent u de ProcessDataStorageProvider service.

    process-data-storage-service

    RootFolder

    De CRX-locatie waarin de procesgegevens worden opgeslagen voor rapportage.

    Default: /content/reporting/pm

    Maphiërarchie

    De mappenhiërarchie waarin de procesgegevens worden opgeslagen op basis van de aanmaaktijd van het proces.

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

  3. Klikken Opslaan.

ReportConfiguration-service

De dienst ReportConfiguration wordt gebruikt door Proces dat voor het vormen van het proces meldt de vraagdienst.

Om de dienst te vormen ReportingConfiguration

  1. Aanmelden bij Configuratiebeheer met CRX-beheerdersreferenties. De standaard-URL van Configuration Manager is https://[*server*]:[*port*]/lc/system/console/configMgr

  2. Open de ReportingConfiguration service.

  3. Aantal records

    Wanneer het runnen van een vraag op de bewaarplaats, kan een resultaat een groot aantal verslagen potentieel bevatten. Als de resultaatreeks groot is, kan de vraaguitvoering servermiddelen verbruiken.

    Om grote resultaatsets te behandelen, splitst de dienst ReportConfiguration de vraagverwerking in partijen verslagen. Hierdoor wordt de systeembelasting verminderd.

    Default: 1000

    CRX-opslagpad

    De CRX-locatie waarin de procesgegevens moeten worden opgeslagen voor rapportage.

    Default: /content/reporting/pm

    OPMERKING

    Dit is dezelfde locatie als opgegeven in de configuratieoptie ProcessDataStorage Hoofdmap.

    Als u de optie van de Omslag van de Wortel in de configuratie ProcessDataStorage bijwerkt, moet u de plaats van de Weg van de Opslag CRX in de dienst ReportConfiguration bijwerken.

  4. Klikken Opslaan en sluiten Configuratiebeheer CQ.

ProcessDataPublisher-service

De service ProcessDataPublisher importeert procesgegevens uit de AEM Forms-database en publiceert de gegevens naar de ProcessDataStorageProvider-service voor opslag.

De service ProcessDataPublisher configureren  

  1. Aanmelden bij Beheerconsole met beheerdersreferenties.

    De standaard-URL is https://[server]:port]/adminui/.

  2. Navigeren naar Home > Services > Toepassingen en services > Servicebeheer en opent u de ProcessDataPublisher service.

processdatapublisherservice-1

Gegevens publiceren

Schakel deze optie in om te beginnen met het publiceren van procesgegevens. De optie is standaard uitgeschakeld.

Schakel Process Reporting alleen in als alle configuraties met betrekking tot Process Reporting-componenten op de juiste wijze zijn ingesteld.

U kunt deze optie ook gebruiken om het publiceren van procesgegevens uit te schakelen wanneer dit niet langer verplicht is.

Default: Off

Batchinterval (sec)

Telkens als de dienst ProcessDataPublisher loopt, verdeelt de dienst eerst de tijd sinds de laatste looppas van de dienst door het Interval van de Partij. De dienst verwerkt dan elk interval van de gegevens van AEM Forms afzonderlijk.

Zo kunt u de grootte bepalen van de gegevens die de uitgever verwerkt tijdens elke uitvoering (batch) binnen een cyclus.

Bijvoorbeeld, als de uitgever elke dag in werking stelt, dan in plaats van het verwerken van de volledige gegevens één dag in één enkele looppas, door gebrek, wordt het de verwerking in 24 partijen van elk één uur verdeeld.

Default: 3600

Unit: Seconds

Time-out vergrendelen (sec)

De uitgeversservice verkrijgt een vergrendeling wanneer de verwerking van gegevens wordt gestart, zodat meerdere exemplaren van de uitgever niet gelijktijdig met het uitvoeren en verwerken van gegevens beginnen.

Als een uitgeversdienst die een slot heeft verworven, nutteloos voor het aantal seconden is die door de waarde van de Onderbreking van het Slot wordt bepaald, dan wordt zijn slot vrijgegeven zodat andere instanties van de uitgeversdienst kunnen blijven verwerken.

Default: 3600

Unit: Seconds

Gegevens publiceren vanuit

De AEM Forms-omgeving bevat gegevens uit de tijd dat de omgeving werd ingesteld.

Standaard importeert de ProcessDataPublisher-service alle gegevens uit de AEM Forms-database.

Afhankelijk van uw rapporteringsbehoeften, als u van plan bent om rapporten en vragen over gegevens na een bepaalde datum en een tijd in werking te stellen, adviseert men dat u de datum en de tijd specificeert. De publicatieservice publiceert vervolgens de datum vanaf die datum.

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

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

Toegang tot de gebruikersinterface Process Reporting

De gebruikersinterface voor Process Reporting is browsergebaseerd.

Nadat u Procesrapportage hebt ingesteld, kunt u beginnen te werken met Process Reporting op de volgende locatie in uw AEM Forms-installatie:

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

Aanmelden bij procesrapportage

Wanneer u naar de URL voor procesrapportage navigeert (https://<server>:<port>/lc/pr), wordt het aanmeldingsscherm weergegeven.

Specificeer uw geloofsbrieven aan login aan de module van de Rapportering van het Proces.

OPMERKING

Als u zich wilt aanmelden bij de gebruikersinterface Process Reporting, hebt u de volgende AEM Forms-machtiging nodig:

PERM_PROCESS_REPORTING_USER

vastleggen

Wanneer u zich bij het Proces meldt, Home weergegeven.

Process Reporting Home-scherm

proces-reporting-home-screen

De mening van de boom van de Rapportering van het proces: De boomstructuurweergave aan de linkerkant van het Homescherm bevat de items voor de modules Procesrapportage.

De boomstructuurweergave bestaat uit de volgende items op hoofdniveau:

Rapporten: Dit item bevat de out-of-the-box rapporten die worden verzonden met Process Reporting.

Voor meer informatie over de vooraf gedefinieerde rapporten raadpleegt u Vooraf gedefinieerde rapporten in procesrapportage.

Adhoc-query's: Dit item bevat opties voor het uitvoeren van op filters gebaseerde zoekopdrachten naar processen en taken.

Voor meer informatie over ad-hocquery's raadpleegt u Ad hoc Vragen in Proces het Melden.

Aangepast: Het knooppunt Aangepast geeft aangepaste rapporten weer die u maakt.

Voor de procedure om douanerapporten tot stand te brengen en te tonen, zie Aangepaste rapporten in procesrapportage.

Procesrapportage, titelbalk: De de titelbar van de Rapportering van het Proces bevat sommige generische opties die u wanneer het werken in het gebruikersinterface kunt gebruiken.

Titel van procesrapportage: De titel Procesrapportage wordt in de linkerhoek van de titelbalk weergegeven.

Klik op de titel om terug te keren naar het scherm Home.

Tijd laatste update: De procesgegevens worden op een geplande basis gepubliceerd van de AEM Forms-database naar de Process Reporting repository.

De laatste tijd van de Update toont de laatste datum en de tijd tot waarvan de gegevensupdates aan de bewaarplaats van de Rapportering van het Proces werden geduwd.

Voor meer informatie over de service voor het publiceren van gegevens en hoe u deze service wilt plannen, raadpleegt u Publiceren van procesgegevens plannen in het artikel Aan de slag met Process Reporting.

Gebruiker voor procesrapportage: De aangemelde gebruikersnaam wordt rechts van de laatste update weergegeven.

Verwerking van vervolgkeuzelijst titelbalk rapportage: De vervolgkeuzelijst in de rechterhoek van de titelbalk van Procesrapportage bevat de volgende opties:

  • Sync: Synchroniseer de ingesloten Process Reporting-opslagplaats met de AEM Forms-database.
  • Help: Raadpleeg de Help-documentatie bij Process Reporting.
  • Logout: Afmelden bij procesrapportage

Op deze pagina