Results
# Intro to Results
After you have [added questions to an application](https://eval-knowledge-hub.readme.io/docs/questions), you are now ready to add results.
Results can represent a numerical computation and/or a set of recommendations. Results will display at the end of an application based on how you (as the application builder) automate a result using low-code or no-code (LCNC) tools. You will have access to tools within each result, such as visibility rules and spreadsheet-based formula expressions, that will convert data gathered from questions into actionable information or computations. Finally, you can create automated test scenarios to validate the accuracy of each result. Navigate to the [Logic Best Practices](https://eval-knowledge-hub.readme.io/docs/development-best-practices-logic) and [Design Best Practices](https://eval-knowledge-hub.readme.io/docs/development-best-practices-design) pages for tips and examples.
The EVAL platform serves as a methodical and logical scaffolding for a citizen developer, using LCNC tools, to construct and validate an application. The EVAL graphical user interface (GUI) is designed to promote clarity and transparency in the creation of an application. The primary responsibility of a citizen developer is the transformation of raw data into actionable insights that conform to a coherent data and logic model using development best practices. To foster trust across the community of users, all users with *Player* access will have read-only access to the *Builder* to inspect the developer's work. Edit rights within an application can only be granted by the account administrator or the application author.
***
# Navigating to Results
<Image align="center" src="https://files.readme.io/0001febebb1fbaba041e914849c7eed0b12202a19df7ced0dd928a0d0cb0c49c-Navigating_to_Results_-_Initial_State.png" />
To start adding results to your application, you can either:
1. Click *New Result* in the *Outline Pane* OR
2. Click *New Result* in the *Results* tab of the *Details Pane*
<br />
The *Details Pane* opens to the following:
<Image align="center" className="border" src="https://files.readme.io/d0c01a6c264e187598f325fbf6cf8878fc7b74f364506dc85b76a28d06236c6d-Navigating_to_Results_-_New_Result.png" />
<br />
***
# Results Tab User Interface
## Result
**Title**
Provide a title for your result. This field is required. Every result title should be unique and stand apart from titles of questions and answers. When using LCNC tools to create visibility rules and keywords, you will be able to search a library of questions, answers, and results that you have created. It is important to be able to differentiate these options for traceability and accuracy. Navigate to the [Data Best Practices](https://eval-knowledge-hub.readme.io/docs/development-best-practices-data) page for more tips.
<br />
**Format**
Identify the format of the result. This field is required. Options for this field include:
* **Formula** - When you want to display a numeric result based on a formula. Most spreadsheet functions are supported.
* *Example*: The user enters numeric values for height and weight in *Player* to trigger a numeric result for body mass index.
* *Example*: The user selects from multiple choice answers in *Player*. Each answer is assigned a point value. The result will display the total score (points) and targeted information for a given range.
* **Information** - When you want to display a result that provides information
* *Example*: The citizen developer creates visibility rules (criteria) for a result that provides targeted information based on how the user selects answers in *Player*
Navigate to the [Use Cases: Calcium Correction & Injury Severity Score](#real-life-examples) section of this page for examples of applications that use formulas and information in the result section.
<br />
**Description**
Provide information for your result. This field is required and will display along with the result title. You can use various formatting features including: bold, italic, font color, links, bullet list, numbered list, tables, and special characters with the ability to expand the description box to a larger view for editing and un-doing/re-doing changes as needed.
<br />
***
## Formula
This section displays when *Format* is *Formula*.
<Image align="center" className="border" src="https://files.readme.io/f2de909d386c7b13ac6967cbfcb226a4acf258e9965f677fc069395f43378b5f-Formula_-_Initial_State.png" />
<br />
**Expression**
Provide a spreadsheet-based formula or expression to calculate the result.
<br />
Click the *Expression* box and the following displays in the *Details Pane*:
<Image align="center" className="border" src="https://files.readme.io/2b00656620330a42c5860ea2b1629f50a753f7ea0c11f5c3d4cc4985b67afe37-Formula_-_Formula_Editor_Highlighted.png" />
The *Formula Editor* is highlighted above. Navigate to the [Formula Editor](formula-editor) page for more details on each of these components. As you provide the *Expression*, *Keywords*, and *Named Expressions*, the content is saved from *Formula Editor* and applied to the result.
> 🚧 A formula expression uses spreadsheet-based inputs and cannot have invalid characters, formatting, or variables
<br />
After creating the formula and returning back to the result in the Results tab, the formula you just created displays back in the *Details Pane*:
<Image align="center" className="border" src="https://files.readme.io/09503f988bdf7987a2e415c7d80555d3175d25f918368065bab28701b1694a61-Formula_-_Details_Pane_after_Save.png" />
<br />
**Unit of Measure**
Optionally add a unit of measure to the outcome of the formula. For example: If the formula calculated a dosage, the unit of measure may be "mcg".
<br />
***
## Media
You can add images and YouTube video to the results by clicking *New Media*. Navigate to the [Media](https://eval-knowledge-hub.readme.io/docs/add-media) page to learn how to add new media.
<Image align="center" className="border" src="https://files.readme.io/3a15f99f807a6020bab5fb643b3f5df4e7b9cc56cf6fd3663b9751b700e163f1-Media_-_Section_Highlighted.png" />
<br />
***
## Scenario Tests
After you have added a result to an application, you can create a scenario test to ensure accuracy of the expected outcome.
<br />
### Initiate Scenario Test
In the *Results* tab, a section displays for *Scenario Tests* as shown below.
<Image align="center" className="border" src="https://files.readme.io/f801aa8e0e0cb959509ecf9cb87207b274538599e55a2dc7544b937afb3154a4-Scenario_Tests_-_Section_Highlighted.png" />
<br />
### Run Scenario Test
Click *New Test*. The following displays:
<Image align="center" className="border" src="https://files.readme.io/c5633f7d678bd5ea78dc1fb83c4b1f71c37f47a65ea3071ae8af888f34e5d3d6-Scenario_Tests_-_New_Test.png" />
<br />
**Scenario Title**
Provide a title for your test scenario (e.g. "BMI Test: Weight 150 lbs; Height 70 in = 21"). Navigate to the [Design Best Practices](https://eval-knowledge-hub.readme.io/docs/development-best-practices-design) page for tips on creating test scenarios.
<br />
**`<Section Name>` Section**
Each section for the result will be displayed here along with the listing of questions in each section. If you have multiple units of measure, you will be able to toggle between them here.
Provide a response to each question.
<br />
**Expected**
Provide a value for the expected result.
<br />
**Actual**
The actual result will be calculated based on what you provided as answers to each question.
<br />
**Errors**
This section will display if you have any errors (i.e. the expected results do not match the actual results)
<Image align="center" src="https://files.readme.io/0f2991c-LibraryBuilderResultsTabScenarioTestsResultsDoNotMatch.png" />
In this case, you should go back and review your formulas to make any adjustments.
Note that the Errors tab will also display these failures.
If the expected results and actual results **match**, this Errors section will be replaced with:
<Image align="center" src="https://files.readme.io/96f0d1b-LibraryBuilderResultsTabScenarioTestsResultsMatch.png" />
<br />
**Results Triggered**
This section displays the specific results that were triggered when the *Expected* matches the *Actual*.
<br />
**Danger Zone (for Scenario Test)**
If you no longer want to have this scenario test in your application, click *Delete this Test* and confirm the prompt to delete. This action cannot be undone.
<br />
### Sample Scenario Test
Following is an example of a completed scenario test for a simple *BMI Calculator*:
<Image align="center" className="border" src="https://files.readme.io/d9eb9acdabad928b29d421913bada4ffd1a796a5dc3448bc5fc13d9cb1036142-Scenario_Tests_-_Sample_Scenario_Test.png" />
<br />
### Viewing scenario test in Details Pane
Returning back to the *Details Pane* for the result, the following now displays in the *Scenario Tests* section:
<Image align="center" className="border" src="https://files.readme.io/d3aa1061be095e759a3e83722a5193cb3349fe5fa5b30687351cb2cf0596334c-Scenario_Tests_-_Final_State_in_Details_Pane.png" />
<br />
***
## Visible When
Set visibility rules around when the result displays. By default, it will always display. Navigate to the [Visibility Rules](https://eval-knowledge-hub.readme.io/docs/add-visibility-rules) page to learn how to add visibility rules.
<Image align="center" className="border" src="https://files.readme.io/5d2c446b470b27e1ed4da0bd024fa1b1b656d717ea94a629d918c269fcfc8962-Visible_When.png" />
<br />
***
## Danger Zone
If you no longer want to have this choice in your application, click *Delete this Result* and confirm the prompt to delete. This action cannot be undone.
<br />
***
# View New Results in Outline Pane
After clicking *Apply*, the *Outline Pane* will be populated with your new result where you can add additional results directly from within it. Alternatively, you can navigate to the *Results* tab in the *Details Pane* and alternatively add there.
<Image align="center" className="border" src="https://files.readme.io/dc77450b6decea949a1be451597c269d1706cedf05b5c3493af33fa2646cd660-View_New_Results_Outline_Pane.png" />
<br />
***
# Change Order of Results
By default, results will be in the same order as you create them. To change the order, simply click on the 9-dot icon to the right of the result you want moved, and then drag and drop it to the desired location in the list of results. (This screenshot shows only one result so ordering does not yet apply.)
<Image align="center" className="border" src="https://files.readme.io/ffbbe336eb77d321c04a13972a0134ac6b6f0f1423edfbfff3b6062f61818e99-Change_Order_of_Results.png" />
<br />
***
# Duplicate Result
To duplicate an existing result, click on the 3 horizontal docs to the right of the 9-dot icon shown below:
<Image align="center" className="border" src="https://files.readme.io/b7b45844c805cd1acb0f16b9a252d110e52c17b752d74878c267b9afd2160bff-Duplicate_Result_-_in_Menu.png" />
An option displays to duplicate the result. Click *Duplicate*.
<br />
The page displays the duplicated result in *Edit* mode.
<Image align="center" className="border" src="https://files.readme.io/a57fb93d9afddeeffa83427ee88b35c01e7ee946c0f933de27f51d1bce2cb1c1-Duplicate_Result_-_After_Clicked_in_Menu.png" />
Change the title to your desired name.
<br />
***
# Use Cases: Calcium Correction & Injury Severity Score
Following are examples of applications that feature the different types of results.
## Formula-Based Calculation: Numerical Entry
The *[Calcium Correct for Hypoalbuminemia](https://eval.health/calcium-correction-for-hypoalbuminemia/r1)* application prompts for three numerical input values, calculates corrected calcium, and then displays that numeric result along with some supporting information.
The following shows what this application looks like in *Builder*:
<Image align="center" className="border" src="https://files.readme.io/1b379618f5f17b90966bd0b5e87fe3746e8e9b58cf12c61ca478430f007afa9d-Real_Life_Example_-_Calcium_Correction_-_Builder.png" />
<br />
The following shows what this same application looks like in *Player*:
<Image align="center" className="border" src="https://files.readme.io/91be7f7c1344948da41a2c2e8ee70ff74f1891529e8bc58f5e1fc5139feddf1a-Real_Life_Example_-_Calcium_Correction_-_Player.png" />
<br />
***
## Formula-Based Calculation: Assigning Points to Choices
The *[Injury Severity Score](https://eval.health/injury-severity-score-iss-2/r2)* application includes six multiple choice questions. Each choice is assigned points in *Builder*. Upon completion of the application, the points for each of the questions are added up and displayed in the result.
The following shows what this application looks like in *Builder*:
<Image align="center" className="border" src="https://files.readme.io/81c8f7413dada3b48df1f61bde79e0d45a24dab9f5065a84ef12f933e034b931-Real_Life_Examples_-_Injury_Severity_Score_-_Builder.png" />
<br />
The following shows what this same application looks like in *Player*:
<Image align="center" src="https://files.readme.io/12dea9dce77904bc3783aecb948922540ab53142e71f1becbd200fed839c1ab5-Real_Life_Example_-_Injury_Severity_Score_-_Player.png" />Updated 3 months ago