16 Release Notes - OpenClinica

 OpenClinica addresses three issues discovered in 3.1.4. This is a minor maintenance release. No other changes have been made between versions 3.1.4 and For additional information on this release, including known issues, please refer to the 3.1.4 Release Notes. It is recommended that all OpenClinica users upgrade. View the complete changelog in the JIRA bug tracker here.


Changes and Fixes

Change/Fix Description 
This fix addressed an issue when the transactional annotation was removed from a piece of code for updating a rule from rule designer. This resulted in a partial transaction and the rule OID was used a null. The fix was to put the transactional annotation back, i.e treat the block as a transaction.
This is a fix for the navigation pane which is not showing on the "Enter" or "Validate" data page
Minor Print CRF fix to correctly display single-option multi-select field


  • None

Other Links

Known Issues

Below is a list of known issues in the 3.1.4 version of OpenClinica.

  • Internet Explorer V7 copies data from a previous row in a repeating group to the newly added row. There is a known issue with IE7 which we are not going to fix specifically, but for the next release we will look at what it would take for us to rewrite data entry 17301

  • User is able to upload a CRF with erroneous changes which can lead to issues in the data structure. When a user uploads a CRF version there are some changes which are acceptable (these changes are mostly around visual presentation) and some changes which the system should not allow to change between versions (these changes affect data structure, etc.) which OpenClinica should verify at the time of upload. A user should be able to change their RESPONSE_TYPE for the following scenarios:
    - radio / single-select
    - text / textarea
    - checkbox / multi-select
    The system should NOT allow a user to change from (radio/single-select) / (checkbox/multi-select). This is not currently being checked. If a user does make this change between versions it can affect the ODM and could cause issues with any ODM-dependant programs (e.g. data extractions, printed CRFs). This will be checked in a future version of OpenClinica. 
  • When Editing the Study level parameter, the site level parameter is hidden. There is a workaround in place SR-119
  • In different versions of CRFs, if QUESTION_NUMBER changes from one version to the next, it will always reflect the most recent number between versions of CRFs since it only stores one value at a time. So, if a user changed a QUESTION_NUMBER from "1" to "2" between v1 and v2 respectively, then printed v1 again, the ODM would show the v2 value. SR-95

  • Password Settings not preserved on upgrade from pre-3.1.3 version: OpenClinica now allows an administrator to configure the password policy for your OpenClinica system via a page in the user interface. However the previous settings from your datainfo.properties file for password expiration and change initial password required will not be preserved upon upgrade. You should go into the admin UI and re-set the password settings to the desired settings post-upgrade, then re-start Tomcat.
  • Hiding Fields on Items in Repeating Groups - Due to issues with the implementation of hidden fields in Repeating Groups, we do not recommend hiding individual fields within a repeating group of items in a CRF. Usage of the hidden items in repeating groups works as expected in initial data entry phase, but is problematic after a CRF is marked complete. If hidden Items in Repeating Groups do not get displayed after the CRF is completed, unexpected behavior may occur. The following issues fall under this category: 12052120581209512102121091209812074.
  • Data Entry in Repeating Groups - During the administrative editing phase; entering Discrepancy Note(s) on the last added row of a Repeating Group will cause the Discrepancy Note(s) to be saved to the first row. Also, saving data on the last row of the displayed Repeating Group that is a part of Rules target triggers an alert that prevents user from going to the next section. The following issues fall under this category: 121081209112174.
  • Population of Group-calculation Fields - Group-calculation values are not populated immediately upon saving a CRF section with the group-calculation inputs. It is not until you hit Save on the subsequent section that contains the the group-calculation field that the field updates correctly. This behavior can cause problems if you are have a rule targeted on the group-calculation item, since the rule may evaluate before the group-calculation value is populated. This issue does not exist in 3.1.2. 16551.
  • Internal CRF Navigation Broken when using RESTful URLs - If you use the RESTful URL for a multi-section CRF, then click the tab of another section after you get there, or if you use the drop down to navigate, the link is broken and you will get an error, "404: Page not found [Invalid case report form OID]". Refer to issue 16174.
  • Data Import with Partial Dates - When importing data values for items of type 'Partial Date', OpenClinica will not import partial date data values formatted in the expected manner YYYY-MM-DD. The data type must be provided as DD-MMM-YYYY format in the XML. Refer to issue 11617.    
  • Filtering on Administer Subject page - The search filter criteria (such as Person Identification Number) on the Administer Subjects page does not return Subjects that meet the requested criteria. For the time being it is recommended that users utilize column sorting on the Administer Subject page in order to locate records. Refer to issue 11966.
  • Extract Data Problems - There are a number of minor known Extract related problems. Currently, data extracts may fail if certain characters (such as "*" or "?") are included as a part of dataset name. Also, certain characters, if present as data values in a CRF, will be extracted incorrectly. Issues that fall under this classification are 11874,114091138711389. Other miscellaneous Extract-related issues include: 114191196114158 (affects OpenClinica Enterprise Datamart only), 12422.
  • Filter issues on the Subject Matrix > View by Event page - On the Subject Matrix > View by Event page, only the "initial data entry" status filter is functional. Filtering by other statuses will not work. Issue 12336.
  • Unexpected Error page for 'Go Back to Site' - When selecting 'Go Back to Site' link after editing Site information, you may get an unexpected error page. The workaround is to click "Exit" rather than "Go Back to Site List". Issue 12228
  • Duplicate Alert Message for Restore CRF - Restoring an event CRF causes a duplicate notification message. Issue 12237.
  • Leaving Data Entry Unlocks all CRFs that were locked for a User Session - The logic that unlocks a CRF when the user leaves the data entry page for a given CRF will release any other CRF locks this user may hold. Issue 13950
  • Unexpected Error page - When selecting 'Go Back to Site' link after editing Site information, you may get an unexpected error page. The workaround is to click "Exit" rather than "Go Back to Site List". Issue 12228.
  • Duplicate Alert Message for Restore CRF - Restoring an Event CRF causes a duplicate notification message. Issue 12237.
  • Outlook Emails with Links to Datasets - OpenClinica supports email notifications when data sets have completed running. The user may experience an error when clicking on the link to download the file if (a) the email is accessed in Microsoft Outlook, (b) the default browser for the user is Internet Explorer, and (c) the user is currently logged into OpenClinica. If the error is encountered, the user should navigate to the dataset from the OpenClinica home page and download the file from the application.
  • Site Unique Protocol IDs - Site Protocol IDs must be unique across a Study and can not share the Study unique protocol ID. This is neccessary to allow the web service of registering a Subject and scheduling an Event to work properly.
  • Rules / Dynamic Logic - Rules containing the absolute full target path may sometimes cause the rule to fail. This issue is mitigated by uploading the CRF Item OID instead of the full path. Refer to issue 11803 for more information. 
  • Discrepancy Note Tooltips when Viewing CRFs with Repeating Groups - There is new functionality in 3.1 for the Discrepancy Note tooltip where information about the Item name is displayed, a summary of the Discrepancy Notes on the item and whether an audit log history exists for a particular Item. This does not work 100% accurately when a Repeating Item has a Discrepancy Note assigned to it. It will not show the summary of the Discrepancy Note information or the fact an audit log exists. It will show the Item name for the Item at all times. Please refer to issue 9345 for more information.
  • Password Required to Mark CRF Complete - During the creation of an Event definition, the user can define whether the system will require a user to enter their password before marking a CRF complete. If this feature is enabled, the user will see a popup box to enter their password after choosing the Mark CRF Complete checkbox.  
    However if the user hits the 'Enter' key on their keyboard without entering a password, the form will be saved without a password being entered. Please see issue 9340 for more information.
  • Validation Messages for Calculations - If a user encounters a validation error message pointing to an Item defined as a calculation, they will not be able to click on the message to be brought to the field. Due to the fact the user can not edit calculated fields, the application will not direct them to field. Instead they must scroll down the page to find the red exclamation point (!) for the calculated value and provide the Discrepancy Note. This issue exists with OpenClinica 3.1.3 as well. Issue#: 13529 is associated with this.

For Developers


Approved for publication by Cal Collins (ccollins), Chief Executive Officer. Signed on 2014-04-01 11:25PM

Not valid unless obtained from the OpenClinica document management system on the day of use.