Troubleshooting Parse Parameters plug-in issues


Use the Parse Parameters plug-in to parse parameters utilized by out-of-the-box Business Intelligence Reporting Tool (BIRT) reports. This plug-in is called when you create or modify a BIRT report.

Plug-in type

Parse Parameters is a Java-based Filter API plug-in.

AR System server connectivity

AR System server interacts with the Parse Parameters plug-in by using the AR System Java API. This plug-in requires BIRT Runtime, which is installed during the AR System server installation in the <ARInstallationFolder>\pluginsvr\birtruntime folder.

The plug-in arreportVerNum.jar and arreportingapiVerNum.jar ( — VerNum represents the release version number) are installed in the <ARInstallationFolder>\pluginsvr folder.

Configuration information

The configuration information of the Parse Parameters plug-in is available in the AR System Administration: Plugin Server Configuration form.

Parse Parameters plug-in.png

The AR System Administration: AR System Configuration Generic UI form includes the Server-Plugin-Alias parameter setting that points to the correct plug-in server alias.
Server-Plugin-Alias: ARSYS.ARF.PARSEPARAMETERS ARSYS.ARF.PARSEPARAMETERS myServer:9999

See Updating-configuration-settings-by-using-the-AR-System-Configuration-Generic-UI-form, Configuring Java plug-in servers and Setting-plug-in-server-configuration-options.

To troubleshoot Parse Parameters plug-in issues

  1. Verify the Parse Parameters plug-in configuration.
  2. Troubleshoot common plug-in related issues.
    For more information, see General-approach-for-troubleshooting-plug-in-issues.
  3. To further investigate the issue, enable the following logs:
    • Server side logs. For more information, see Enabling-server-side-AR-System-logs.
    • Plug-in specific logs. For more information, see To enable logs for the Parse Parameters plug-in.

To enable logs for the Parse Parameters plug-in

  1. In a browser, open the AR System Administration Console, and select System > General > Plugin Server Configuration.
  2. On the Plugin Server Configuration form, from the Plugin Server Instance list, select the instance for which you want to enable logs.
  3. Go to the Plugin Server Configuration tab.
  4. In the Logging Configurations area, from the Log Level list, select DEBUG.
  5. Click Apply
    The arjavaplugin.log file generates the debug logs for the Parse Parameters plug-in.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*