Update a Form

The contents of a form is controlled by JSON in the oat-forms project.
This assumes you’ve got it cloned and pulled any recent updates.

Update the JSON source

Edit the source for the form in question (changes) or create a new file for a new form. Review Form Definitions for more info.

Load the changes

The bin directory in the oat-forms project contains the following scripts:

• archiveForms.sh: Used to archive forms after decisions have been made. It retains the information just in case, but those forms will no longer appear in the admin pages in OAT.
• updateForms.sh: Used to make minor adjustments to an existing form such as dates for it to accept submissions, minor wording changes, etc.
• newVersion.sh: Used to make major changes to a form or introduce a new form. Major changes include adding or removing questions, changing the available answers, changing the expressions for displaying answers, etc. Major changes should only be done when no form submissions are “in process”.

Notes:

• There was an archive function in the UI at one point. I think it no longer works.
• Form users can update the start and stop dates using the UI. Be careful to update the appropriate fields in the form definition before updating a form or those dates will be lost.