After you create your field groups, you want to create the components for your tests. Fields is another term for the components for your tests.
Continuing with the “Body Comp. - Jackson/Pollock - Body Density (7 Site - Female)” test example, we can create the fields for this test through the Fields section.
Figure 1: This is the front-end view of what your fields will look like when you create them. These are examples of fields created for the Body Comp - Jackson/Pollock - Body Density (7 Site - Female) test. The fields in this example are number and calculated value types.
Users have the ability to create several types of fields depending on the value type they select.
- Number – users can input whole number into the field (i.e. 1, 9, 100)
- String – users can input text and numbers into the field (i.e. comments)
- Choice – users can select a choice from the choice fields (i.e. select male/female)
- Calculated – users can input formulas and the values will automatically compute
Figure 2: This is the front-end view of a custom built test. The fields in yellow are number value types where users can input the values. The calculated value type displays the computed value of the inputted values for the test.
Value types give users the option to replicate their tests on their CoachMePlus install.
Step 1: Go to the Fields section page and click +New.
Step 2: On the Fields form, users have the option to create several types of fields depending on their value types.
- Field Groups List – select the Field Group you want the field to be placed under
- Name – name of the field
- Expression name – the expression name will auto-fill if you create the exercise for the first time, leave blank.
- Value Type – select and determine the type of field you would like
- Carry Value Forward – determine if you want the latest value to become the default for future measurements
- Copy Shadow Value on Edit – enable to see shadow values copied into input form
- Choice Field – if the field is a choice value type, select the choice field
- Unit Type – determine the unit type you want to use
- Unit – input the unit you are measuring in
- Display Precision – determine how many decimal points you want displayed
- Number Expression – input a number expression if your value type is calculated
- String Expression – input a string expression based off of your number expression (if applicable)
- Roles Permitted to Calculate – input the roles that you would like to be able to perform this calculation
- Users Permitted to Calculate – input the users that you would like to be able to perform this calculation
- Save – save information
Step 3: Once the form is completed, click Save.
Step 4: The new field groups will now appear on the list.
2. Don't change the unit type of a field after creating it. Do remove the field from all field groups to hide it.
3. Don't use capital letter in an expression name. Do keep expression names all lowercase letters.
4. Don't change expression names after they are created. This will disrupt all visualizations and reports that are associated with the field.
5. Do establish a naming convention for your fields. This will help to keep you organized and able to find fields easily. For example, Vertical Jump and other performance testing fields may be named, "performance_testing_vertical_jump".