Got feedback or spotted a mistake?

Leave a comment at the end of this page or email contact@krishagni.com

Create/Edit Forms

Who can create?

By default, super admins or institute admins can manage forms. Select the 'Manage Forms?' checkbox on the 'Create User' page to give this privilege to other users.

Create

If you have the “Manage Forms?“ privilege, you can create forms for your site, study, and so on.

  • Click on 'Forms' from the navigation menu or the home screen.

  • Click on '+Create' to create a new form.

  • Add the “Title“ of the form and click on “Save“.

Add Controls

You can add multiple fields to a form using different controls as per your requirements.

  • To add new controls/fields to the form, click on “+ Add Field“.

  • Select the control type.

  • Once you have added all the fields, you can click on “Done“.

Different Control Types

You can add a text field or text area field to your form to add URLs. URLs will be visible as hyperlinks on the overview pages upon data entry.

Control Type

Description

Control Type

Description

Text Field

Maximum size: 255 charactersaddresses

Text Area

Add long text like comments, address, etc. Maximum size limit: are 65,635 characters.

Number Field

Supports adding numeric values like age, number of days, etc.

Radio Button

Single select radio buttons. Ideal for less than 5-6 values. If more, use dropdowns.

Checkbox

Multi-select checkbox. Ideal for less than 5-6 values. If more, use the multi-select dropdown.

Yes/No Checkbox

The field to checka /uncheck a single value.

Dropdown

Select single value in a dropdown.

Multiselect Dropdown

Select multiple values in a dropdown.

Date Picker

Supports date and time.

File Upload

Supports any file type. Note: if files are >5MB, it is ideal not to upload them in OpenSpecimen and instead use an external file server.

Signature

To collect eSignature.

Note

This is NOadd “information notes” for the user dd “information notes” for the user in between fields or sections.

User

Displays users in the system in a dropdown.

Permissible Value

Displays the PV values from the Dropdown Manager.

Site

Displays sites in the system in a dropdown.

Storage Container

Displays container in the system in a dropdown.

Subform

The field to add subform within the main form. Sub-form is a table-like structure used for 1:many association with the main form. E.g., a patient can have many Addresses. The Address can be designed as a sub-form with its own fields like city, street name, etc.

 

 

Note

  1. MySQL DB restricts the number of fields supported in a table, so don’t create too long forms.

  2. The number of fields supported depends on the data type of the fields. E.g., You can have 25-30 number fields in place of a single text field.

  3. If the form is a mix of control types, please restrict it to not more than 75 fields.

Field Properties

Properties

Description

Validations

Properties

Description

Validations

Title

Title of the form

 

Name

System generated name

Please do not change this or blank it out.

Type

Control type (Read-only)

 

Display Label

Display name of the form field

 

Variable Name

The attribute name of the form field.

Ensure the variable name is unique within the form.

Special characters and spaces are not allowed.

Tooltip

Pop up displayed when you move the mouse over the field. Useful to set descriptions or guidelines about the field.

 

Default Value

Default Value set for the field.

The default value can be set within the 'Permissible values' section for enumerated field types like dropdowns, radio buttons, or list boxes.

PHI

Button to make any field as ‘Protected health information’. This value will be hidden from users who do not have access to PHI.

 

Required (Mandatory)

To set the form field as required.

 

Show in Grid

For the forms attached at the ‘Specimen Event’ level, this attribute is shown in the events list under each specimen.

This is used for ‘User’ and ‘Date and Time’ type fields, and must have the variable names ‘user’ and ‘time’ respectively. For further information, please refer to https://openspecimen.atlassian.net/wiki/spaces/CAT/pages/1768554509#SpecimenEvents-CreateNewEvent.

Rows

The number of rows to be shown in the text area.

Only applicable to Text Area

Number of Fraction Digits

The number of digits to show after the decimal

Set this to zero if you want only whole numbers like for ‘Age’.

Only applicable to Number Field

Range

Minimum and Maximum values to be restricted for the field

Only applicable to Number Field

Permissible Values Ordering

The sorting order of the values to be displayed.

Ascending
Descending
None

Only applicable to enumerated field types like radio button, dropdown, etc.

Options Per Row

Values to be shown per row of the field

Only applicable to radio button and checkbox.

Default Checked

Checkbox to make field checked by default

Only applicable to Yes/No Checkbox.

Format

The format of the date field

Date Only
Date and Time

Only applicable to Date Picker.

Default Date

Default date

None
Current Date

Only applicable to Date Picker.

Display on the same row as the last field (v8.1)

Adds the field in the same row as the last field

 

Numeric Value

Enabled only for PV dropdown and dropdown has integer values like 122, 2, 700 etc

 

Add Permissible Values (Manually)

For fields like dropdown, radio button, multi-select dropdown, and checkbox controls, you can manually add the permissible values or upload the text or CSV file containing the permissible values. Follow the below steps to upload PVs:

  • Create text or CSV file of the permissible values to be added.

  • Click on the “Edit“ icon of the field that you want to upload PVs for.

  • Click on “Add Option“ to manually add values or click “+ Upload Options“ to add PVs using a CSV file.

 

  • Upload the file of PVs and save.

When you export a form, the dropdown values are exported as separate CSV only if it has more than 15 values.

Add Permissible Values (From Dropdown Manager)

 

Advantages of adding PVs using dropdown manager

 

Edit

You can edit any form field such as changing the display name, add more options to enumerated fields like dropdown, radio button, etc.

Rearrange Fields

You can drag the fields by clicking on the six dots and dropping them to the required position.

Preview

You can preview the form by clicking on the “Preview“ button present on the top right corner of the screen. The link will open in a new tab.

 

Change Control Type (v8.1)

Below edits are supported from v8.1 for changing control types:

  1. Radio button to dropdown and text field.

  2. Dropdown to radio button and text field.

  3. Checkbox to the multi-select dropdown.

  4. Multiselect dropdown to the checkbox.

Display Fields on Same Row (v8.1)

You can display similar fields on the same row like ‘Abdominal pain’ and ‘Pain location’ or ‘Do you smoke?' and 'How many times in a day?’.

 

Delete field

You can delete any  form field if not required any more.



 

 

Got feedback or spotted a mistake?

Leave a comment at the end of this page or email contact@krishagni.com