Generating Certification Campaign Reports

This chapter explains how to create and manage reports for a certification campaign.

About the Default Report Templates

DirX Identity provides several default report templates that you can use immediately. These are located under:

Provisioning → Domain Configuration → Reports → Default → CertificationCampaigns

Each report typically includes the following files (example: Campaign with all properties):

  • Campaign with all properties – Contains:

    • Search base and search filter for the report

    • List of all attributes to retrieve from the LDAP directory

    • Export formats (HTML, XML, RAW for XSLT transformation)

  • Settings for Producer/Selector – Defines:

    • Search filter

    • Sort criteria

    • Report name

    • Search level

    • Attributes to retrieve from LDAP

  • Settings for Templates – Includes flags to show or hide fields in the report.

  • Templates – XSLT markup for the report layout.

Producing a Report

To generate a report:

  1. Right-click on a certification campaign entry.

  2. Select Report. The Run report dialog appears, listing available reports for certification campaigns.

  3. Choose a report from the list.

At the bottom of the dialog, you’ll find: - A description of the report - Parameter fields

Leave the search base and scope as they refer to the selected campaign folder. Set Type to HTML for a user-friendly output format. Optionally: - Change the output file name - Check Output to viewer to preview the report in the dialog window.

Select XML as the output format if: - You need all available attributes and values - You plan to process the file later with an XML tool

In HTML format, some attributes may be hidden during XSLT transformation based on template settings.

Adding or Extending Reports

You can create a new report by copying and modifying an existing one.

Example: Copy Campaign with Failed.Prepare certificates and adjust it to include certifications where applying changes failed (state: FAILED.APPLY.CHANGES).

To update the search filter, modify the following line in Settings for Producer/Selector:

<var name="SearchFilter" value="(|(objectClass= dxrCertificationCampaign)(&amp;(objectClass=dxrCertificationEntry)(|(dxrState=FAILED.PREPARE)(dxrState=FINISHED))))"/>

to

<var name="SearchFilter" value="(|(objectClass= dxrCertificationCampaign)(&amp;(objectClass=dxrCertificationEntry)(dxrState=FAILED.APPLY.CHANGES))))"/>

This updated report will now include only certification tasks where changes could not be applied successfully.