Table of Contents | |
---|---|
|
This page is meant to provide a step by step instruction, on how to create a form within Form Designer. The example form used, is a Daily Observation form with general discrepancy tracking. This form is only one example of many ways to capture data and work performed. The values within this fields are completely configurable, and simply used as placeholders to demonstrate practice.
...
A great practice to designing a form, is to have multiple windows or tabs open on your browser, having one view in Admin, while the other in Field. This will allow you to work within Admin > Form Designer and, quickly view the changes that you've made from the Field user's perspective in the Field module. You will need to refresh your screen each time you view.
Tip |
---|
We recommend that after every couple of fields that are added to your form, navigate to the Field module using a separate tab or window to test it out. This becomes more critical when you apply visualization, calculation, and validation rules to fields. |
Step | Label | Field Type | Settings / Options Applied Settings are Options are added but using the Green "Add" button. Some fields do not allow for options to be added, and only Settings. | Visualization Rule | Notes | Field within a Parent Data grid? | Screenshot | |||
---|---|---|---|---|---|---|---|---|---|---|
1 | Mileage | Number | Settings applied:
No Options applied. | Helper text is displayed near the label to further guide the Field user. | No | |||||
2 | Hours on Site | Number | Settings applied:
No Options applied | Limiting decimals to 2, will raise validation for the field if a user tries to enter a value with 3 or more decimals. Helper text is displayed near the label to further guide the Field user. | No | |||||
3 | Inspector Certification Number | Text Box | None | No | ||||||
4 | Weather | Multiple Choice | Options Applied:
No Settings Applied | No | 5 | After adding this field, it might be useful to navigate to the Field module using a separate tab or window to see what your form looks like so far, from the field user's perspective. | No | |||
5 | Weather (Other) | Text Box | None |
NOTE: See Tip below for help with adding visualization rules | This applied rule make the system display this field, only if Other is chosen from Step 4 above. | No | 6 | Location | Pick List | |
| ||||||||||
6 | Location | Pick List | Settings
No Options applied | The settings applied will have the system lookup values from Admin > General > Locations. All records that have Activity enabled, will display on this list. | No | |||||
7 | Temperature (F) | Number | None | No | ||||||
8 | Work Performed | Pick List | Add the following as options. (You will see there is an options grid to work with, and a Settings grid. Each grid has it's own green Add button):
No Settings applied
No Settings applied | After adding this field, it might be useful to navigate to the Field module using a separate tab or window to see what your form looks like so far, from the field user's perspective. | No | |||||
9 | Work Performed if Other | Text Box | None |
| This applied rule make the system display this field, only if Other is chosen from Step 8 aboveis chosen from Step 8 above. Because you've added a visualization rule to this field, it might be useful to check how it behaves in the field module. Make sure the workflow is designed how you want to behave for the field users. | No | ||||
10 | Anchor Inspection Remarks | Text Area | Settings:
No options applied |
| This applied rule make the system display this field, only if Anchor Inspection is chosen from Step 8 above This applied rule make the system display this field, only if Anchor Inspection is chosen from Step 8 above. Because you've added a visualization rule to this field, it might be useful to check how it behaves in the field module. Make sure the workflow is designed how you want to behave for the field users. | No | ||||
11 | Concrete Placement Remarks | Text Area | Settings:
No options applied |
| This applied rule make the system display this field, only if Concrete Placement is chosen from Step 8 aboveis chosen from Step 8 above. Because you've added a visualization rule to this field, it might be useful to check how it behaves in the field module. Make sure the workflow is designed how you want to behave for the field users. | No | ||||
12 | Fireproofing Remarks | Text Area | Settings:
No options applied |
| This applied rule make the system display this field, only if Fireproofing is chosen from Step 8 aboveapplied rule make the system display this field, only if Fireproofing is chosen from Step 8 above. Because you've added a visualization rule to this field, it might be useful to check how it behaves in the field module. Make sure the workflow is designed how you want to behave for the field users. | No | ||||
13 | Discrepancies Observed | Yes/No | None | This Yes/No field is designed to ask the field user if they have observed any discrepancies. If yes, they will be brought to the data grid found in step 14. | No | |||||
14 | Discrepancies | Data Grid You can add fields within this data grid (fields within a table) by selecting the row that represents the data grid with your cursor. Once selected, you will see a similar looking table appear below with the same functionality. Click Add Field to add fields within your new data grid. See screenshot. | None |
| This applied rule make the system display this field, only if Yes is chosen from Step 13 above. Essentially, saying Yes to step 13 above, will open this data grid to track multiple discrepancies within one activity record, will open this data grid to track multiple discrepancies within one activity record. Because you've added a visualization rule to this field, it might be useful to check how it behaves in the field module. Make sure the workflow is designed how you want to behave for the field users. | No but, this field is a data grid, and fields will be added within. | ||||
15 | Discrepancy | Yes/No | Settings applied:
No options applied | The system needs the discrepancy indicator setting applied, to flag a record as a true discrepancy in the system. This will trigger counts on the Dashboard, Pending Field Actions, and display on the Discrepancy Report. | Yes - Add this field within the data grid from step 14. | |||||
16 | Discrepancy Number | Number | Settings applied:
No options applied | The settings applies here are needed to appropriately assign a unique ID to a single flagged discrepancy.
| Yes - Add this field within the data grid from step 14. | |||||
17 | Status | Pick List | We first need to add a label for a status of a discrepancy. You can add these labels by selecting the Add button under Options. Most often, the following labels are used:
Next, we need to associate our labels (Open/Closed) with the system's indicator for each label. This can be done under Settings by selecting the other Add button. You will see two options:
When each is selected, you will have the ability to link each indicator with a label that you've provided above. Make sure to link the correct indicator with the right label. (i.e. Discrepancy Status Close Indicator is linked to your Closed label) | These settings provide the ability for the system to know whether a discrepancy has been resolved or not. If the status remains as open, the system will keep the "flags" open to the PM , Scheduler, and it will remain as open on the report, Scheduler, and it will remain as open on the report. After adding this field, it might be useful to navigate to the Field module using a separate tab or window to see what your form looks like so far, from the field user's perspective. | Yes - Add this field within the data grid from step 14. | |||||
18 | Discrepancy Description | Text Area | None | Yes - Add this field within the data grid from step 14. | ||||||
19 | Resolution Date | Date | Settings Applied
No Options applied |
| This field will only display if the status of the discrepancy is set to closed from step 17 above. When close, the system will remove the flag to the PM, Scheduler, and will now display as closed on the reportthe flag to the PM, Scheduler, and will now display as closed on the report. Because you've added a visualization rule to this field, it might be useful to check how it behaves in the field module. Make sure the workflow is designed how you want to behave for the field users. | Yes - Add this field within the data grid from step 14. | ||||
20 | Resolution Description | Text Area | None |
| This field will only display if the status of the discrepancy is set to closed from step 17 above. When close, the system will remove the flag to the PM, Scheduler, and will now display as closed on the reportas closed on the report. Because you've added a visualization rule to this field, it might be useful to check how it behaves in the field module. Make sure the workflow is designed how you want to behave for the field users. | Yes - Add this field within the data grid from step 14. | ||||
21 | Resolution Technician | Pick List | Settings applied:
No Options applied |
| This field will only display if the status of the discrepancy is set to closed from step 17 above. When close, the system will remove the flag to the PM, Scheduler, and will now display as closed on the reportthe flag to the PM, Scheduler, and will now display as closed on the report. Because you've added a visualization rule to this field, it might be useful to check how it behaves in the field module. Make sure the workflow is designed how you want to behave for the field users. | Yes - Add this field within the data grid from step 14. | ||||
22 | Images | Data Grid You can add fields within this data grid (fields within a table) by selecting the row that represents the data grid with your cursor. Once selected, you will see a similar looking table appear below with the same functionality. Click Add Field to add fields within your new data grid. See screenshot. | None | Setting up an images data grid, allows the user to capture multiple images within one activity record. | No but, this field is a data grid, and fields will be added within. | |||||
23 | Image | File Upload | None | Yes - Add this field within the data grid from step 22. | ||||||
24 | Image Date | Date | Settings applied:
No Options applied | These settings will default today's date into the date field. | Yes - Add this field within the data grid from step 22. | |||||
25 | Photographer | Pick List | Settings applied:
No Options applied | These settings will default the current user, working on the record into the field. | Yes - Add this field within the data grid from step 22. | |||||
26 | General Remarks | Text Area | None | No | ||||||
27 | Attachment | File Upload | None | After adding this field, it might be useful to navigate to the Field module using a separate tab or window to see what your form looks like so far, from the field user's perspective. | No |
Once you've created a form, you may want to consider adding ways to view and filter for the fields that you've created. Below, you'll find a few examples of how to do this. All steps below, begin in Admin > Activity > Search / Results Display. This area is a very powerful tool. We encourage you to review more areas within the Help pages, should you have any questions beyond what is covered below at: Activity - Search / Results Display
...
Often times, fields that you create are necessary for field technicians to view, when readdressing existing records within Field > Activity > Manage Activities. These fields allow the user to view high level information, without actually opening the entire record. To add more fields to this view, follow the steps below.
Step | Instruction | Screenshot |
---|---|---|
1 | Navigate to Admin > Activity > Search Results / Display | |
2 | On the Area grid, find and select Field Search Results. You will notice that when you select this row, there will be an Area Fields grid that pops up below. The fields displayed on the Area Fields grid, are the fields that display on the within Field > Activity > Manage Activities. | |
3 | To add a field to the Manage Activities area, select the Add Field button on the Area Fields grid, within Admin > Activity > Search / Results Display. | |
4 | Search for the field by System Name. A System Name is the way the database identifies uniqueness for a field within a form. Most often, it's the same as the label given in Form Designer. Once you've found the system name, you can provide any label that you desire. In this example, we will search for the Discrepancy Number field. This field is the same field that was configured when designing the form, in step 16 above. Select save when complete. | |
5 | To verify that you've added this field successfully, navigate to Field > Activity > Manage Activities. See that there is now a Discrepancy Number field on each record. |
Adding Filters to the Manage Activities View for Field Users
Step | Instruction | Screenshot |
---|---|---|
1 | Navigate to Admin > Activity > Search Results / Display | |
2 | On the Area grid, find and select Field Manage Activities Filter. You will notice that when you select this row, there will be an Area Fields grid that pops up below. The fields displayed on the Area Fields grid, are the filters that display on the within Field > Activity > Manage Activities. | |
3 | To add a filter to the Manage Activities area, select the Add Field button on the Area Fields grid, within Admin > Activity > Search / Results Display | |
4 | You will first need to search for a field type. Again, we will use the Discrepancy Number field from step 16, when we created a form. The field type for the field, is a Number field. Next, search for the system name, DiscrepancyNumber, and then add a label as Discrepancy Number. When complete, select save. | |
5 | To verify that you've added this field successfully, navigate to Field > Activity > Manage Activities. See that there is now a Discrepancy Number filter at the top, allowing a field tech to search for a specific record, based on a discrepancy number. |