Monitoring Composite Forms

You can monitor the status and processing of composite forms by enabling the tracing capability of the GP Monitor. If you encounter a problem, you can enable the tracer to track the number of instances (traces) for a particular composite form template. The GP Monitor displays the methods invoked on the form instances during their lifetime, so that you can reproduce the problem and disable the tracer.

You can:

• Check the status of installed adapters
• Enable or disable forms tracer
• Clear trace entries
• View detailed trace information
• Delete traces

To monitor the status of composite forms, open the Composite Forms tab page.

Checking the Status of Adapters

You conduct a basic test to check whether the installed adapters are properly working. To do this, select an adapter from the dropdown box and choose Test Adapter. The result of the test can be the following:

• Adapter test finished successfully - the adapter has successfully extracted data from the form and used it in creating a form template
• Exception - there is an error in data extraction or the adapter was not configured properly

More information: Configuring Adapters

Enabling or Disabling Forms Tracer

You can trace all instances of a composite form in order to reproduce an existing problem. To change the tracer status choose:

• Enable to enable tracing
• Disable to disable tracing
  Note

  This option is set to Disable by default. The reason is that the forms tracer generates a considerable amount of information, which is not usually necessary unless you are trying to track down and reproduce an existing problem. Experienced developers deal with this extensive information.

Clearing Trace Entries

You can clear trace entries from the memory or database in order to filter the latest traces from older ones. To do this, select one of the following options:

• Clear all cached traces - entries that were previously searched for and cached in memory
• Clear all stored traces - entries stored in the database
• Clear all traces before - entries stored before a specified date. Enter the date in the text field below.

Choose an option and select Clear.

Viewing Trace Information

You can view the trace (instance) list organized by:

• Folder
• Status

To do this:

1. Select a location from the Folder dropdown box
2. Select the relevant form status from the Status dropdown box

   The system displays all templates that match your criteria. You can see relevant details of each template as well as how many traces (instances) are available for it.

3. Select a template from the Traces list and choose one of the following:
   • View Traces

     All traces of a composite form.

   • View Mail Traces

     Shows how a template is processed.

   Each trace is displayed in a separate node that can be expanded.

4. Expand the trace node you need to view.

   You can see a list of all logged actions (methods) performed on the form instance. You can also view information about input and output parameter values for each method that exposes them.

   Note

   This step is mainly executed by developers in case they recognize a problem in the processing of a composite form. The reason is that the system generates a considerable amount of information which is not normally helpful for the end user.

5. Select a method or a parameter from the tree structure.

   Under Details, you can view more detailed information about the selected entry, for example a method message or an attribute value.

Deleting Traces

You can delete traces from the database or memory in order to clear valuable disk space. To do this, perform one of the following:

• In the Traces list, choose Delete Traces.
• Choose View Traces and make sure you want to delete the trace. Choose Delete Trace.

Integrating Offline and Form-Based Activities