1. Administrator's Guide
  2. Generating HTML DE and PDR Templates for Existing DCI Form Versions
  3. Running the Upgrade Utility in Incremental Mode

Running the Upgrade Utility in Incremental Mode

By default, the Upgrade utility will always generate the HTML data entry forms and the PDR templates for all DCI Form Versions in the study that have PDF data entry forms generated.

There may be times when you have problems with the form or template generation. For example, perhaps some images used in the form layout are no longer in the correct location so the Upgrade utility does not generate a few of the DCI Form versions. For such cases, you can temporarily change the utility to run in incremental mode. In incremental mode, the Upgrade utility only creates the HTML data entry forms and the PDR templates if they do not already exist.

After upgrading to Release 5.2 or later, you must run the Upgrade utility for all DCIs in all studies to add hyperlinks in generated PDRs. Otherwise, if you do not run the Upgrade utility for some DCIs, the fields in the documents entered for those DCIs would be rendered blank in the generated PDR. Also, you must regenerate the Form Versions. Otherwise, you would not be able to open Data Entry Window using Microsoft Edge Browser.

To configure the Upgrade utility to run in incremental mode:

  1. Open Oracle Clinical.
  2. Navigate to Admin, Reference Codelists, and then select Local Codelists.
  3. Query for the OCL_STATE reference codelist.
    1. Enter OCL_STATE in the Name field.
    2. Press F8 to execute the query.
  4. Scroll down to the UPD_FV_INCREM short value.
  5. Set the long value to Y. Note that:
    • Y — Forces the Upgrade utility to run in incremental mode. In incremental mode, the utility will not regenerate HTML data entry forms and PDR templates for form versions that already exist.
    • N (default) — Forces the Upgrade utility to generate all form versions.

    This setting applies only to running the Upgrade utility for existing DCI Form versions.

Note:

Running the Upgrade utility in incremental mode is for resolving problems. Oracle recommends that you do not continue to run the utility in incremental mode. Be sure to change the UPD_FV_INCREM value back to N after you generate the forms you need.

Parent topic: Generating HTML DE and PDR Templates for Existing DCI Form Versions