{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"error"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"In case of custom fields","type":"text"}]},{"type":"paragraph","content":[{"text":"Please note: For versions 8.0 and above, you need to use 'variableName' and for those prior to v8.0, the field names would be DD1, ST2, RB3 etc.","type":"text"}]},{"type":"paragraph","content":[{"text":"You will observe that 'variableName' is used in all examples. These are field names based upon control types present in the form attached at the custom fields' level.","type":"text"}]},{"type":"paragraph","content":[{"text":"Steps to add the custom fields to the JSON:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the Forms tab → Click on the form → Click on Export → zipped file is downloaded.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Extract the zipped file and open the XML file.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For each field in XML, you can observe these names are enclosed within ' ' tag. For example: variableName","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use these names to define the fields in JSON.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ensure that the form is attached to the CP at the particular custom field level.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Below is a list of different attribute types that can be used during the SDE or RDE setup. ","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","isNumberColumnEnabled":true,"width":1800.0,"localId":"f4e53e19-6cdd-4cfd-9864-3de17cafdc3b"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Level","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Attribute Type","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"paragraph","content":[{"text":"Example JSON","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Text Custom Field","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"The custom text field is to be displayed on the participant add, edit and overview pages.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"You need to specify the 'pattern' to if you want to restrict the text input on to follow certain condition.","type":"text"}]},{"type":"paragraph","content":[{"text":"If links or URL are added to the text fields, they will be hyperlinked and clickable on the overview pages.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n\"name\": \"cpr.participant.extensionDetail.attrsMap.variableName\",\n\"caption\": \"Country\",\n\"type\": \"text\",\n\"optional\": true\n}","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Example pattern to allow only capital letters.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\"pattern\" : \"/^[A-Z]+$/\"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Date Custom Field","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"'DOB of Mother' is a field that stores date hence marked as 'date' in the property type.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n\"name\": \"cpr.participant.extensionDetail.attrsMap.variableName\",\n\"caption\": \"DOB of Mother\",\n\"type\": \"date\",\n\"dateOnly\": true,\n\"optional\": true\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Note Custom Field (v9.0)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Adds a note field. You can add multiple note fields within JSON as: \"name\": \"cpr.note1\", \"name\": \"cpr.note2\", and so on.","type":"text"}]},{"type":"paragraph","content":[{"text":"For visit: ","type":"text"},{"text":"\"name\": \"visit.note5\"","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"For specimen: ","type":"text"},{"text":"\"name\": \"specimen.note6\"","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This field will only be visible on the data entry screens.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can directly add the code in CP JSON. There is no need to create a custom form for adding notes.","type":"text"}]}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\": \"cpr.note1\",\n \"type\": \"note\",\n \"note\": \"

Participant registration details

\"\n}","type":"text"}]},{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Number Custom Field with pattern","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"When you want to validate the pattern during data-entry, use 'type': “text”.","type":"text"}]},{"type":"paragraph","content":[{"text":"Use case: The first digit of the age field should always be between 1 and 9. ","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":787,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1242,"alt":"image-20240416-165156.png","id":"100ad43c-892b-4dd3-803a-0f21172178dd","collection":"contentId-101187680","type":"file","height":171}}]},{"type":"paragraph"}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\":\"cpr.participant.extensionDetail.attrsMap.variableName\",\n \"caption\": \"Age\",\n \"type\": \"text\",\n \"optional\": true,\n \"pattern\": \"/^[1-9][0-9]*$/\"\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Number Custom Field (v11)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"When you don’t want to validate the pattern during data-entry, we use 'type': “number” (supported in v11).","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\":\"cpr.participant.extensionDetail.attrsMap.variableName\",\n \"caption\": \"Pincode\",\n \"type\": \"number\",\n \"optional\": true\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Number Custom Field (With decimal values)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"You need to specify the 'pattern' to allow decimal values.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\":\"cpr.participant.extensionDetail.attrsMap.variableName\",\n \"caption\": \"Weight\",\n \"type\": \"text\",\n \"optional\": true,\n \"pattern\": \"^-?\\\\d+(,\\\\d+)*(\\\\.\\\\d+(e\\\\d+)?)?$\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"Simple example:","type":"text"}]},{"type":"paragraph","content":[{"text":"a) Max. 2 digits before decimal point. Max. 10 digits after decimal point","type":"text"}]},{"type":"codeBlock","content":[{"text":"\"pattern\": \"/^\\d{1,2}(\\.\\d{1,10})?$/\"","type":"text"}]},{"type":"paragraph","content":[{"text":"b) Any number of digits before decimal point. Exact 2 digits after decimal point, if any","type":"text"}]},{"type":"codeBlock","content":[{"text":"\"pattern\": \"/^\\d+(\\.\\d{2,2})?$/\"","type":"text"}]},{"type":"paragraph","content":[{"text":"c) Same as b) but allow negative fractions as well","type":"text"}]},{"type":"codeBlock","content":[{"text":"\"pattern\": \"/^-?\\d+(\\.\\d{2,2})?$\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Explanation:","type":"text"}]},{"type":"paragraph","content":[{"text":"a) ^ (caret) - Indicates start of string/input","type":"text"}]},{"type":"paragraph","content":[{"text":"b) $ - end of the string/input","type":"text"}]},{"type":"paragraph","content":[{"text":"c) ? - any character, group or pattern before this is optional","type":"text"}]},{"type":"paragraph","content":[{"text":"d) \\d - any digit 0-9","type":"text"}]},{"type":"paragraph","content":[{"text":"e) + - one or more occurrences of the preceding character, group, or pattern","type":"text"}]},{"type":"paragraph","content":[{"text":"f) {m, n} - specifies the preceding character, group, or pattern should match at least m times and at max n times.","type":"text"}]},{"type":"paragraph","content":[{"text":"Detailed explanation:","type":"text"}]},{"type":"paragraph","content":[{"text":"^-?: minus sign should appear at the start of the string/input. The minus sign is optional.","type":"text"}]},{"type":"paragraph","content":[{"text":"^-?\\d+: An optional minus sign can appear at the start of the string/input. Followed by that, at least one digit (0, 9) should occur in the input string.","type":"text"}]},{"type":"paragraph","content":[{"text":"^-?","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4c9aff"}}]},{"text":"\\d+","type":"text","marks":[{"type":"textColor","attrs":{"color":"#36b37e"}}]},{"text":"(\\.\\d{2,5})?","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff5630"}}]},{"text":"$","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]},{"text":": ","type":"text"},{"text":"An optional minus sign can appear at the start of the input string","type":"text","marks":[{"type":"textColor","attrs":{"color":"#4c9aff"}}]},{"text":". ","type":"text"},{"text":"Followed by that, at least one digit. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#36b37e"}}]},{"text":"An optional dot and at least 2 digits, at max 5 digits after the dot can appear. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#ff5630"}}]},{"text":"After this, no more characters can appear in the string.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#6554c0"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"DropDown Custom Field","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"A dropdown field from the custom form 'JSONTParticipantExtention' named 'Select Any Option' is fetched here.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\": \"cpr.participant.extensionDetail.attrsMap.variableName\",\n \"caption\": \"Select Any Option\",\n \"type\": \"dropdown\",\n \"optional\": true,\n \"listSource\": {\n\t\"apiUrl\": \"forms/permissible-values\",\n\t\"selectProp\": \"value\",\n\t\"displayProp\": \"value\",\n\t\"queryParams\": {\n\t\"dynamic\": {},\n\t\"static\": {\n\t\t\"formName\": \"JSONTParticipantExtention\",\n\t\t\"controlName\": \"variableName\"\n\t\t}\n\t}\n\t}\n}\n","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Text area Custom Field","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"The custom text area field is to be displayed on the participant overview page/create participant page.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n\"name\" : \"cpr.participant.extensionDetail.attrsMap.variableName\",\n\"caption\" : \"Address\",\n\"type\" : \"textarea\",\n\"optional\" : true\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Radio Button Custom Field","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"The field 'Is participant Allergic?' is mapped to a field, and the options are 'Yes'/'No'.","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"You can also specify a default value to be populated for the field using the property 'defaultValue'.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Note ","type":"text"},{"text":"At present, the radio button works with only inline options.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n\"name\": \"cpr.participant.extensionDetail.attrsMap.variableName\",\n\"caption\": \"Is participant Allergic?\",\n\"type\": \"radio\",\n\"optional\": true,\n\"options\": [\"Yes\",\"No\"],\n\"defaultValue\": \"Yes\"\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Dropdown Multiselect Custom Field","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Multiple select dropdown fields from the custom form 'JSONTParticipantExtention' named Diagnosis Subtype' are fetched here. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the code, the value against 'multiple' needs to be set to 'true'.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Multi-select dropdown fields do not support the \"defaultValue\" option.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n\"name\": \"cpr.participant.extensionDetail.attrsMap.variableName\",\n\"caption\": \"Diagnosis Subtype\",\n\"type\": \"dropdown\",\n\"multiple\": true,\n\"optional\": true,\n\"listSource\": {\n\t\"apiUrl\": \"forms/permissible-values\",\n\t\"selectProp\": \"value\",\n\t\"displayProp\": \"value\",\n\t\"queryParams\": {\n\t\"dynamic\": {},\n\t\"static\": {\n\t\t\"formName\": \"JSONTParticipantExtention\",\n\t\t\"controlName\": \"variableName\"\n\t\t}\n\t\t}\n\t}\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Text","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"The field specimen label will be displayed only if the specimen label format is not specified or manual input for the specimen label field is allowed.","type":"text"}]},{"type":"paragraph","content":[{"text":"This is the 'showif' condition added in the example JSON.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\": \"specimen.label\",\n \"caption\": \"Specimen Label\",\n \"type\": \"text\",\n \"optional\": true,\n \"showIf\": {\n \"op\": \"OR\",\n \"rules\": [{\n \"field\": \"specimen.labelFmt\",\n \"op\": \"not_exist\"\n }, {\n \"field\": \"cp.manualSpecLabelEnabled\",\n \"op\": \"exists\"\n }\n ]\n }\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Text","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Additional Label","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\" : \"specimen.additionalLabel\",\n \"caption\" : \"Additional Label\",\n \"type\" : \"text\",\n \"optional\" : true,\n \"showIf\" : {\n \"op\" : \"OR\",\n \"rules\" : [ {\n \"field\" : \"specimen.labelFmt\",\n \"op\" : \"not_exist\"\n }, {\n \"field\" : \"cp.manualSpecLabelEnabled\",\n \"op\" : \"exists\"\n } ]\n }\n }","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Number","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"When adding a numeric field user can specify the 'pattern', which will allow only specific numbers.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\": \"specimen.freezeThawCycles\",\n \"caption\": \"Freeze Thaw Cycles\",\n \"type\": \"text\",\n \"optional\": true,\n \"pattern\": \"/^[1-9][0-9]*$/\"\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Dropdown (OS standard field)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"To retrieve the standard values from the OpenSpecimen dropdown, you must specify the type as 'pvs'.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\": \"cpr.participant.gender\",\n \"caption\": \"Gender\",\n \"type\": \"pvs\",\n \"attr\": \"gender\",\n \"optional\": \"true\",\n \"defaultValue\": \"Female\"\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Dropdown (custom field)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"A dropdown field from the custom form 'SpecimenAdditionalFields' named 'Method' is fetched here. ","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Note","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For visit level custom field add: \"visit.extensionDetail.attrsMap.variableName\"","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Participant level: \"cpr.participant.extensionDetail.attrsMap.variableName\"","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\": \"specimen.extensionDetail.attrsMap.variableName\",\n \"caption\": \"Method\",\n \"type\": \"dropdown\",\n \"optional\": true,\n \"listSource\": {\n \"apiUrl\": \"forms/permissible-values\",\n \"selectProp\": \"value\",\n \"displayProp\": \"value\",\n \"queryParams\": {\n \"dynamic\": {},\n \"static\": {\n \"formName\": \"SpecimenAdditionalFields\",\n \"controlName\": \"variableName\"\n }\n }\n }\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Dropdown (custom field) with the ","type":"text"},{"text":"selection of multiple options.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"A dropdown field from the custom form 'lCPHExtension' named 'Diagnosis Subtype' is fetched here.","type":"text"}]},{"type":"paragraph","content":[{"text":"All the values will be populated from the control name 'variableName'.","type":"text"}]},{"type":"paragraph","content":[{"text":"It supports the selection of multiple options from the dropdown","type":"text"},{"text":". In the code, the value against 'multiple' needs to be set to 'true'.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\":\"cpr.participant.extensionDetail.attrsMap.variableName\",\n \"caption\": \"Diagnosis Subtype\",\n \"type\": \"dropdown\",\n \"optional\": true,\n \"multiple\": true,\n \"listSource\": {\n \"apiUrl\": \"forms/permissible-values\",\n \"selectProp\": \"value\",\n \"displayProp\": \"value\",\n \"queryParams\": {\n \"dynamic\": {},\n \"static\":{ \n\t\t\t\"formName\": \"lCPHExtension\", \t\t\t \n \t\t\t\"controlName\": \"variableName\" \n\t\t\t}\n }\n }\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Radiobutton","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"The field 'Medical database' is mapped to a field with a control name as 'variableName', and the options are 'Yes' / 'No'.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can also specify a default value to be populated for the field using the property 'defaultValue'.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\": \"specimen.extensionDetail.attrsMap.variableName\",\n \"caption\": \"Medical database\",\n \"type\": \"radio\",\n \"optional\": true,\n \"options\": [\"Yes\",\"No\"],\n \"defaultValue\": \"Yes\"\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Checkbox","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"While adding a checkbox, you need to use the type 'radio' and specify the value by casting them into Yes/No.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\": \"specimen.incrParentFreezeThaw\",\n \"caption\": \"Increment parent specimen's Freeze/Thaw cycles?\",\n \"type\": \"radio\",\n \"optional\": true,\n \"displayExpr\" : \"sspecimen.incrParentFreezeThaw == '1' ? 'Yes' : 'No' \",\n \"options\": [\n {\n \"caption\": \"Yes\",\n \"value\": 1\n },\n {\n \"caption\": \"No\",\n \"value\": 0\n }\n ]\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Date only field","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"To mark a field to store the only date, use the property 'dateOnly'.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\": \"cpr.participant.birthDate\",\n \"caption\": \"Birth Date\",\n \"type\": \"date\",\n \"dateOnly\": true,\n \"optional\": true\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Phone Number","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Default Phone number field for participant level.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{ \n \"name\" : \"cpr.participant.phoneNumber\", \n \"caption\" : \"Phone Number\", \n \"type\" : \"text\", \n \"optional\" : true \n },","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Received SMS(eConsent)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Received SMS checkbox, used for eConsent","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\" : \"cpr.participant.textOptIn\",\n \"caption\" : \"Receive SMSes\",\n \"showInOverviewIf\" : \"useShowIf\",\n \"showIf\" : {\n \"op\" : \"AND\",\n \"rules\" : [ {\n \"field\" : \"cpr.participant.phoneNumber\",\n \"op\" : \"exists\"\n } ]\n },\n \"type\" : \"toggle-checkbox\",\n \"values\" : {\n \"trueValue\" : true,\n \"falseValue\" : false\n },\n \"displayExpr\" : \"cpr.participant.textOptIn == '1' ? 'Yes' : 'No' \"\n },","type":"text"}]},{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Email","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Email Address Field","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\" : \"cpr.participant.emailAddress\",\n \"caption\" : \"Email Address\",\n \"type\" : \"text\",\n \"optional\" : false,\n \"metainfo\" : {\n \"phi\" : \"true\"\n }\n },\n ","type":"text"}]},{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Received Email","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Received Email checkbox, used for eConsent","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\" : \"cpr.participant.emailOptIn\",\n \"caption\" : \"Receive Emails\",\n \"showInOverviewIf\" : \"useShowIf\",\n \"showIf\" : {\n \"op\" : \"AND\",\n \"rules\" : [ {\n \"field\" : \"cpr.participant.emailAddress\",\n \"op\" : \"exists\"\n } ]\n },\n \"type\" : \"toggle-checkbox\",\n \"values\" : {\n \"trueValue\" : true,\n \"falseValue\" : false\n },\n \"displayExpr\" : \"cpr.participant.emailOptIn == '1' ? 'Yes' : 'No' \"\n },\n ","type":"text"}]},{"type":"paragraph"}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Subform(OS standard field)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"The MRN and site fields are displayed in a subform section. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Add the property 'search' helps in retrieving values in larger dropdowns. If this is not added, then only the first 100 values will be populated.","type":"text"}]},{"type":"paragraph","content":[{"text":"The 'listAll' property shows all the sites for users who have access to CP, irrespective of which site they have access to. If you don't add this property, you will only see those sites you have access to. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#222222"}}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Add a caption to the subform field in v11 onwards to display it on the add/edit/overview pages. Without the caption, only the '+Add' sign will be visible","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Explanation of the Site Code:","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"apiUrl\": \"collection-protocols/40/sites\"","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Pulls the sites associated with the CP that has an ID = 40.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"apiUrl\": \"collection-protocols/{{cp.id}}/sites\"","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Dynamically pulls the sites specific to the configured CP.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"apiUrl\": \"sites\"","type":"text","marks":[{"type":"code"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Pulls all the user specific sites.","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Details","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"apiUrl","type":"text","marks":[{"type":"strong"}]},{"text":": The API endpoint that provides data for the dropdown list.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"displayProp","type":"text","marks":[{"type":"strong"}]},{"text":": The field from the API response shown in the dropdown.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"selectProp","type":"text","marks":[{"type":"strong"}]},{"text":": The field from the API response stored when a user selects an option.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"queryParams","type":"text","marks":[{"type":"strong"}]},{"text":": Extra parameters sent to the API request.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"dynamic","type":"text","marks":[{"type":"strong"}]},{"text":": Parameters that change based on user input or other conditions.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"static","type":"text","marks":[{"type":"strong"}]},{"text":": Fixed parameters that do not change.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"search","type":"text","marks":[{"type":"strong"}]},{"text":": The API field used for searching dropdown options.","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\": \"cpr.participant.pmis\",\n \"caption\": \"MRNs\",\n \"formatType\": \"mrnText\",\n \"type\": \"collection\",\n \"fields\": [\n {\n \"name\": \"siteName\",\n \"caption\": \"Site\",\n \"type\": \"dropdown\",\n \"multiple\": false,\n \"optional\": false,\n \"listSource\": {\n \"apiUrl\": \"sites\",\n \"displayProp\": \"name\",\n \"selectProp\": \"name\",\n \"queryParams\": {\n \"dynamic\": {},\n \"static\": {\n \"listAll\": true\n },\n \"search\": \"name\"\n }\n }\n },\n {\n \"name\": \"mrn\",\n \"caption\": \"MRN\",\n \"type\": \"text\",\n \"optional\": \"true\"\n }\n ]\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Subform (custom field)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"A subform with two attributes - dropdown and radio button- will be displayed on the participant overview page.","type":"text"}]},{"type":"paragraph","content":[{"text":"The subform name is SF6 which can be found in the exported form XML file.","type":"text"}]},{"type":"paragraph","content":[{"text":"The names of the fields under the subform are specified without extensions like DD7 or RB8, for example. ","type":"text"}]},{"type":"paragraph","content":[{"text":"While specifying the control name for the dropdown fields under the subform, you must include the subform name, such as SF6.DD7.","type":"text"}]},{"type":"paragraph","content":[{"text":"The \"type\": \"Collection\" configuration is used explicitly for subform fields. If you remove the “type”: \"collection\" syntax and configure the field only as “type”: “pvs” the field will be displayed as a normal dropdown and not the subform field for multiple data entries. For any field type apart from the site, user, and storage container, you need to define the type as a collection to be configured as a subform field.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Add a caption to the subform field in v11 onwards to display it on the add/edit/overview pages. Without the caption, only the '+Add' sign will be visible","type":"text"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\": \"cpr.participant.extensionDetail.attrsMap.subform_variableName\",\n \"caption\": \"Field_name\",\n \"type\": \"collection\",\n \"fields\": [\n {\n \"name\": \"variableName\",\n \"caption\": \"Drug name\",\n \"type\": \"dropdown\",\n \"optional\": true,\n \"listSource\": {\n \"apiUrl\": \"forms/permissible-values\",\n \"selectProp\": \"value\",\n \"displayProp\": \"value\",\n \"queryParams\": {\n \"dynamic\": {},\n \"static\": {\n \"formName\": \"sVHParticipantDetails\",\n \"controlName\": \"subform_variableName.variableName\"\n }\n }\n }\n },\n {\n \"name\": \"variableName\",\n \"caption\": \"Treated with drug\",\n \"type\": \"dropdown\",\n \"optional\": true,\n \"listSource\": {\n \"options\": [\"Yes\",\"No\"]\n }\n }\n ]\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Date & time field","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"'Created On' is a field that stores date and time hence marked as 'datetime' in the property type.","type":"text"}]},{"type":"paragraph","content":[{"text":"Since this field is available only for the child samples, a skip logic is added to edit this field only when the lineage is not 'New'.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\": \"specimen.createdOn\",\n \"caption\": \"Created On\",\n \"type\": \"datetime\",\n \"optional\": false,\n \"defaultValue\": \"current_date\",\n \"showInOverviewIf\" : \"useShowIf\",\n \"showIf\": {\n \"op\": \"AND\",\n \"rules\": [\n {\n \"field\": \"specimen.lineage\",\n \"op\": \"!=\",\n \"value\": \"'New'\"\n }\n ]\n }\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Visit","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Dropdown","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Add the Visit Cohort field with the PV dropdown values.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":" {\n \"name\" : \"visit.cohort\",\n \"caption\" : \"Cohort\",\n \"type\" : \"pvs\",\n \"attr\" : \"cohort\",\n \"optional\" : true,\n \"showIf\" : {\n \"op\" : \"AND\",\n \"rules\" : [ {\n \"field\" : \"visit.status\",\n \"op\" : \"!=\",\n \"value\" : \"'Missed Collection'\"\n } ]\n }\n }","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Visit","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Event","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Add Event field in dictionary","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\" : \"visit.eventId\",\n \"caption\" : \"Event Label\",\n \"type\" : \"cpe-list\",\n \"entity\" : \"visit\",\n \"optional\" : false,\n \"listSource\" : {\n \"selectProp\" : \"id\",\n \"queryParams\" : {\n \"dynamic\" : {\n \"cpId\" : \"visit.cpId\"\n }\n }\n },\n \"showIf\" : {\n \"op\" : \"AND\",\n \"rules\" : [ {\n \"field\" : \"visit.id\",\n \"op\" : \"not_exist\"\n } ]\n },\n \"showInOverviewIf\": \"false\"\n }","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Participant","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Permissible Value Field","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Site Dropdown: ","type":"text","marks":[{"type":"strong"}]},{"text":"The example is stated for the participant-level site dropdown. ","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n\"name\":\"cpr.participant.extensionDetail.attrsMap.variableName\",\n \"caption\" : \"Site\",\n \"type\" : \"dropdown\",\n \"multiple\" : false,\n \"optional\" : false,\n \"listSource\" : {\n \"apiUrl\" : \"sites\",\n \"displayProp\" : \"name\",\n \"selectProp\" : \"name\",\n \"queryParams\" : {\n \"dynamic\" : {\n \"operation\" : \"op\"\n },\n \"static\": {\n \"listAll\": true\n },\n \"search\" : \"name\"\n }\n }\n }","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Visit","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Permissible Value Field","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"PV dropdown values can be used in the custom field using the control type as Permissible Value.","type":"text"}]},{"type":"paragraph","content":[{"text":"While adding the fancy control for the PV dropdown, use the unique id of the dropdown in the tag \"attr\": \"unique_id\". This appears enclosed in brackets when the user clicks a particular dropdown","type":"text"},{"type":"hardBreak"},{"text":"(See ","type":"text"},{"text":"dropdown manager wiki","type":"text","marks":[{"type":"link","attrs":{"href":"https://openspecimen.atlassian.net/wiki/spaces/CAT/pages/63209581"}}]},{"text":" for more details)","type":"text"}]},{"type":"paragraph","content":[{"text":"For setting the default value to a PV dropdown fancy control, use ","type":"text"},{"text":"\"defaultValue\": \"\"","type":"text","marks":[{"type":"strong"}]},{"text":". Replace with the value to be set as default.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\" : \"visit.extensionDetail.attrsMap.variableName\",\n \"caption\" : \"State\",\n \"type\" : \"pvs\",\n \"attr\" : \"state\",\n\t \"selectProp\":\"name\", // to display the value of the dropdown\n\t \"defaultValue\" : \"Queensland\",\n \"optional\" : true\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Permissible Value Field","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"There are two types of fancy controls 'User' and 'Site'.","type":"text"}]},{"type":"paragraph","content":[{"text":"While adding the fancy control for the user, add the property \"selectProp\": \"id\".","type":"text"}]},{"type":"paragraph","content":[{"text":"From v6.0, the ability to exclude contact users from the user list by adding \"excludeType\": \"CONTACT\" in the code block.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Adding 'Storage Container' in JSON workflow is not supported.","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n\"name\": \"specimen.extensionDetail.attrsMap.variableName\",\n\"caption\": \"Surgeon\",\n\"type\": \"user\",\n\"defaultValue\": \"current_user\",\n\"selectProp\": \"id\",\n \"listSource\": {\n \"queryParams\": {\n \"static\": {\n \"excludeType\": \"CONTACT\"\n }\n }\n }\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Visit","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Multi-select checkbox","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"The field will be displayed as a multi-select dropdown.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\": \"visit.extensionDetail.attrsMap.DM_liecba\",\n \"label\": \"Liečba\",\n \"type\": \"checkbox\",\n \"optional\": true,\n \"optionsPerRow\": 2,\n \"options\": [\n {\n \"caption\": \"len diéta\",\n \"value\": \"len diéta\"\n }\n {\n \"caption\": \"PAD\",\n \"value\": \"PAD\"\n },\n {\n \"caption\": \"inzulín\",\n \"value\": \"inzulín\"\n }\n ]\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"File upload","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Using the File upload control, you can upload any file.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n\"name\" : \"specimen.extensionDetail.attrsMap.variableName\",\n\"caption\" : \"Image\",\n\"type\" : \"file\",\n\"optional\" : true\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Hyperlink Field","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Use hyperlink control for easy navigation from one page to another. e.g., Hyperlink the parent specimen labels for easy navigation to the specimen page.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n\"name\": \"specimen.parent.label\",\n\"caption\": \"Parent Specimen\",\n\"type\": \"span\",\n\"url\": \"specimen({specimenId: specimen.parent.id})\"\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Collection Status Field","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"The value will be shown as read-only.","type":"text"}]},{"type":"paragraph","content":[{"text":"To make the customized view look like the default view for showing distribution status, use this code in your workflow JSON.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n\"name\": \"calcSpecimen.status\",\n\"caption\": \"Collection Status\",\n\"type\": \"span\",\n\"displayExpr\": \"fns.ifNotNull(specimen.distributionStatus, specimen.distributionStatus, specimen.status)\"\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen Requirement Label","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"How to add the specimen requirement label in the JSON nth step?","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Note","type":"text"}]},{"type":"paragraph","content":[{"text":"Add the same code in the dictionary and the specimenCollection section.","type":"text"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n\"name\" : \"specimen.reqLabel\",\n\"baseField\" : \"specimen.reqLabel\",\n\"type\" : \"span\"\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Yes/No Checkbox","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"For Participant Level: ","type":"text","marks":[{"type":"strong"}]},{"text":"Use the below code","type":"text"}]},{"type":"paragraph","content":[{"text":"\"name\":\"cpr.participant.extensionDetail.attrsMap.variableName\"","type":"text"}]},{"type":"paragraph","content":[{"text":"For Visit level:","type":"text","marks":[{"type":"strong"}]},{"text":" Use the below code","type":"text"}]},{"type":"paragraph","content":[{"text":"\"name\" : \"visit.extensionDetail.attrsMap.variableName\"","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\" : \"specimen.extensionDetail.attrsMap.variableName\",\n \"caption\" : \"Missed Collection\",\n \"type\" : \"toggle-checkbox\",\n \"values\" : {\n \"trueValue\" : true,\n \"falseValue\" : false\n },\n \"displayExpr\" : \"specimen.extensionDetail.attrsMap.variableName == '1' ? 'Yes' : 'No' \"\n }","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Visit","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Event Label","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Adds Event Label field on the visit page.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"field\" : \"visit.eventLabel\",\n \"name\" : \"visit.eventLabel\",\n \"caption\" : \"Event Label\",\n \"type\" : \"text\",\n \"optional\" : false\n }","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Parent Custom Field","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Adds parent custom field on the create derivative/aliquots page.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n\"name\": \"specimen.parent.extensionDetail.attrsMap.variableName\",\n\"caption\" : \"Parent Part\",\n\"type\" : \"span\"\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Create aliquots","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Add a create aliquots checkbox on the create the unplanned derivative page.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\": \"specimen.createAliquots\",\n \"caption\": \"Create Aliquots?\",\n \"icon\": \"fa fa-share-alt\",\n \"type\": \"toggle-checkbox\",\n \"width\": \"30px\"\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Parent Specimen Qty Unit (v8.2)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Add parent specimen quantity unit on the create derivative/aliquots page.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\" : \"specimen.parent.availableQty\",\n \"caption\" : \"Parent Quantity\",\n \"type\" : \"span\",\n \"width\" : \"120px\",\n \"formatType\" : \"specimen-quantity\",\n \"specimen\" : \"specimen.parent\",\n \"measure\" : \"quantity\"\n }","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Parent Specimen Conc Unit (v8.2)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Add parent specimen concentration unit on the create derivative/aliquots page.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\" : \"specimen.parent.concentration\",\n \"caption\" : \"Concentration\",\n \"type\" : \"span\",\n \"width\" : \"120px\",\n \"formatType\": \"specimen-quantity\",\n \"specimen\": \"specimen.parent\",\n \"measure\": \"concentration\"\n }","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"General","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Tooltip (v9.0)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Adds a tooltip to fields","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This field will only be visible on the data entry screens.","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\": \"cpr.ppid\",\n \"caption\": \"PPID\",\n \"type\": \"text\",\n \"tooltip\": \"Unique patient registration ID within the study\"\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Received By","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Adds received user field on the specimen page","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\" : \"specimen.receivedEvent.user\",\n \"caption\" : \"Received By\",\n \"optional\" : false,\n \"type\" : \"user\",\n \"showIf\" : {\n \"op\" : \"AND\",\n \"rules\" : [ {\n \"field\" : \"specimen.lineage\",\n \"op\" : \"==\",\n \"value\" : \"'New'\"\n }, {\n \"field\" : \"specimen.reqId\",\n \"op\" : \"not_exist\"\n } ]\n },\n \"showInOverviewIf\" : \"useShowIf\",\n \"subFields\" : [ {\n \"name\" : \"emailAddress\",\n \"caption\" : \"Collector Email Address\"\n } ]\n }","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"General","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Image (v9.0)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Adds an image. You can add multiple images within JSON as:","type":"text"}]},{"type":"paragraph","content":[{"text":"\"name\": \"cpr.note1\", \"name\": \"cpr.note2\", and so on.","type":"text"}]},{"type":"paragraph","content":[{"text":"For visit: ","type":"text"},{"text":"\"name\": \"visit.note5\"","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"For participant: ","type":"text"},{"text":"\"name\": \"cpr.note1\"","type":"text","marks":[{"type":"strong"},{"type":"em"}]}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The image must be hosted on public sites where there are no CAPTCHA checks","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"This field will only be visible on the data entry screens.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can directly add the code in CP JSON. There is no need to create a custom form for adding notes.","type":"text"}]}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\" : \"specimen.note7\",\n \"type\" : \"note\",\n \"note\" : \"

$\\\"RPE$

\"\n }","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Close parent after child creation","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"Closes parent specimens after the creation of child specimens in the nth step.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Need to be added at the parent level in the nth step","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\" : \"specimen.closeAfterChildrenCreation\",\n \"caption\" : \"Close Specimen\",\n \"type\" : \"toggle-checkbox\",\n \"values\" : {\n \"trueValue\" : \"true\",\n \"falseValue\" : \"false\"\n }\n}","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen custom event","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"A specimen, custom event of dropdown type. Similarly, for any other type of field to be configured at specimen event level, the above attributes can be used with extension as below","type":"text"}]},{"type":"paragraph","content":[{"text":"\"name\":\"specimen.events.form name.variable name\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Note: This is an example to include the events fields in a dictionary. This will not show the fields on the overview page. After adding the event field in the dictionary, these fields can be used in the nth step to collect the events during specimen collection.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","content":[{"text":"{\n \"name\" : \"specimen.events.tissuePreanalyticalVariables.variableName\",\n \"caption\" : \"Cold Ischemia Temperature\",\n \"type\" : \"dropdown\",\n \"optional\" : true,\n \"defaultValue\" : \"2 to 10°C\",\n \"listSource\" : {\n \"apiUrl\" : \"forms/permissible-values\",\n \"selectProp\" : \"value\",\n \"displayProp\" : \"value\",\n \"queryParams\" : {\n \"dynamic\" : { },\n \"static\" : {\n \"formName\" : \"tissuePreanalyticalVariables\",\n \"controlName\" : \"variableName\"\n }\n }\n }\n }","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[98.0]},"content":[{"type":"paragraph","content":[{"text":"Specimen","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[109.0]},"content":[{"type":"paragraph","content":[{"text":"Subform with PVS field(custom field)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[601.0]},"content":[{"type":"paragraph","content":[{"text":"A subform with a PVs field will be displayed on the specimen overview page.","type":"text"}]},{"type":"paragraph","content":[{"text":"Consider below example:","type":"text"}]},{"type":"paragraph","content":[{"text":"The subform variable name is ‘histological_details’ which can be found in the exported form XML file. ","type":"text"}]},{"type":"paragraph","content":[{"text":"The name of the PVs field under the subform is specified without extensions like ‘histological_qualityy’","type":"text"}]},{"type":"paragraph","content":[{"text":"While adding the fancy control for the PV dropdown, use the unique id of the dropdown in the tag \"attr\": \"histological_quality\". This appears enclosed in brackets when the user clicks a particular dropdown","type":"text"},{"type":"hardBreak"},{"text":"(See ","type":"text"},{"text":"dropdown manager wiki","type":"text","marks":[{"type":"link","attrs":{"href":"https://openspecimen.atlassian.net/wiki/spaces/CAT/pages/63209581"}}]},{"text":" for more details)","type":"text"}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Add a caption to the subform field in v11 onwards to display it on the add/edit/overview pages. Without the caption, only the '+Add' sign will be visible","type":"text"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[494.0]},"content":[{"type":"codeBlock","attrs":{"language":"json"},"content":[{"text":" {\n \"name\" : \"specimen.extensionDetail.attrsMap.histological_details\",\n \"caption\": \"Field_name\",\n \"type\" : \"collection\",\n \"fields\" : [ {\n \"name\" : \"histological_qualityy\",\n \"caption\" : \"Histological quality\",\n \"type\" : \"pvs\",\n \"attr\" : \"histological_quality\",\n \"optional\" : true\n } ]\n }","type":"text"}]}]}]}]},{"type":"paragraph"}],"version":1}