Sharable link: https://crucialdatasolutions.atlassian.net/servicedesk/customer/kb/view/222363758
Table of Contents
| Table of Contents |
|---|
Overview
The TrialKit mobile app takes a clinical trial beyond the computer screen. When building forms and surveys for a study, as a form builder, it's tough to create a form that looks good on the various screen sizes that might view it down the road. After all, one size does not fit all.
...
Due to the complexity of case report forms in clinical trials, TrialKit provides an automated tool for study builders to take a form they've built and rapidly set it up for multiple devices, and still maintain a streamlined dataset single set of data in the end.
The steps below outline how to target form layout for multiple devices. These steps only apply to study builders.
Device Dictionary
Ensure you have access to the Device Dictionary within the Host Configuration level role security menu on the app. If you don't see it, contact support@trialkit.com to have it enabled.I
...
2. Setup the device target Targeted Device sizes or PDFs that will be needed in the study.
It's okay if you are not sure about which screen sizes to target, especially for ePRO studies where subjects use their own devices. Having 3-5 targeted sizes for a range of devices is sufficient.
| Info |
|---|
Suggested List:
|
When defining the screen width value of different devices, TrialKit uses what is called UIKit sizes (or points), based on pixel mapping used by iOS. You can read more here on that.
...
If the system does not have the next smallest device being targeted, it will open the main form size, and the user will need to scroll horizontally to see the entire form if the form was built wider than the screen of the device it's being viewed on. Read more below about the main form.
Language Targeting
Language-specific devices can also be targeted, whereby the form will open based on the user's device-level language settings (on the app), or browser language settings (on the web). For example, If a French user has their device settings in the French language, and the study they are doing data entry on has a form targeted to French, the user will see that version of the form. Any data variable queries will also be presented in the device language, but the query text itself in the queries report will be stored in English.whatever language edit checks are created in.
To create targeted language forms, continue reading below.
PDF Targeting
Lastly, the device type "PDF" can be used to create paper versions of the electronic forms. This version will never be displayed to end-users. Instead, it's specifically a tool for form builders to create paper CRFs for printing.
...
Now you have a list of targeted device sizes
How to Create Targeted Forms from the Device Dictionary
After defining your target device sizes and languages that can be used on any study within the hosting account.host:
In
...
the Form Builder
...
, open a form that you would like to target for various screen sizes. Then open the form properties for that form (highlighted below).
| Note |
|---|
Important Point: The form you are opening is referred to as the Parent form. It's best if this form is originally built on the web so that the web version of the form displays well on that platform and remains untouched by the more expanded functions the TrialKit builder provides. |
In this step, you are merely taking that parent form and creating a mobile/child form from it , which you will use to make layout and field size changesin order to setup a different layout of the same form.
...
Notice in the form above, it was set with a width of 1400. This is likely because other tabs on the form include content that takes up more width on a screen and is designed to be completed on the website.
Scroll to the bottom of the form properties and select a device to target. The list of options is the one from step 2 above. There is also an option to force the layout into a single column if desired. Depending on the screen width and current form layout, this may happen anyway.
Then tap the Build Device Form button.
...
In the background, the system will instantaneously re-arrange the form layout to fit the device width being targeted. The new form referred to as a child (targeted) form, that was created can be accessed in the Form Manager screen. It will have the same name as the parent form followed by a number. You will also see a description of the device it's targeted for, based on how you defined devices in the device dictionary.
If a different language was targeted, this process will also use Google’s Translate API to interpret all the text and labels on the form. Further revisions to the translations can be made as needed.
...
Open the child form in the forms list
...
Review the layout that was generated by the system,
...
change the layout or item sizes as desired, and save the changes.
| Note |
|---|
Important: Do not change any of the fields, add fields, add new or delete fields on a child form. If a change must be made to something other than the layout form variables or field sizeslogic, make the change on the parent form and then re-create the targeted form so the form . |
At any time, you can open the form manager's list of forms and easily differentiate between parent and child forms.
Child forms are simply a re-arranged version of the main/parent form.
...
| Note |
|---|
If changes need to be made to the content of a form - such as adding edit checks, or changing questions, delete the child forms associated with that form, make the changes in the parent form, and repeat the steps above to quickly re-create the child forms. |
...
variables and behavior match. Form Targeting should only be used to alter the layout of forms for different presentation. |
Text labels and text within choice fields can be updated in batch, as applicable when doing form translations for different languages. This is done in the Form Properties.
Testing for language forms
When testing to make sure a targeted language is opening, its important to have your device language or browser language set to the same language which the form(s) have been targeted to. If the system continues opening the parent form, its either because the language doesn’t match the device or the form width can’t be used.
| Tip |
|---|
To display targeted language forms on the web, set the device dictionary width to 300. |
Related articles
| Filter by label (Content by label) | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Page Properties | ||
|---|---|---|
| ||
|