====== Interactivity > Decision Tree ======

This page can be used to create a branching scenario in which the learners are taken on a pathway (one of many possible pathways) through the activity, depending on their responses to questions at key points on the pathway. On some of the Steps in the pathway information is presented; at other Steps a multiple-choice or slider question is presented, which determines which Step the learner is taken to. Feedback on progress through the pathway can also be delivered.

It can therefore be used to create a kind of maze (with one target destination), or branching scenarios, for example to illustrate processes with several possible outcomes.  To use this page type you need to plan all the possible pathways, with decision nodes, before working in Xerte. The demo below has links to two examples of plans for a Decision Tree activity; one an e-plan and the other produced with pen and paper.

You give each Step a Unique ID, and you create the links between these Steps using the ideas.

===== Example demo =====

{{url>https://xot.xerte.org.uk/xapi_launch.php?template_id=116&group=xertepagetypes#decisiontree 98%, 660px noborder}}

or view at [[https://xot.xerte.org.uk/xapi_launch.php?template_id=116&group=xertepagetypes#decisiontree| Xerte Page Types > Interactivity: Decision Tree]] (opens in new tab).


===== Editor Interface =====

{{:xerte-inter-decisiontree-editor.jpg?600&direct}}

==== Core Properties (Top Level) ====

^ Property ^ Description ^ Type ^ Additional information ^
| Page Title | Text that appears in header of published page | Text |   |
| Intro Text | Static content that appears in the left panel (or at the top of the page if you select Full from the Panel Width option); the right panel displays the steps through the pathway | Text+ | Use this to give the context or instructions for the task.  Other content (e.g. images, audio, video) can be embedded here. |
| Panel Width | Sets the width of the panel in which the Instructions appear { Small / **Medium **/ Large / Full } | Drop-down |   |
| First Step ID | Identifies the starting step, referring to Labels you give to the different steps in the project.  | Text |   |
| Show Final Overview | Hides or displays an overview of all the steps the learner has taken on the pathway | Tick box |   |

==== Language Options (Top Level) ====

^ Property ^ Description ^ Type ^ Additional information ^
| %%Refresh Button%% | Text on a tooltip which appears on mouseover of the Refresh icon. | Text  | Default - "Restart"  |
| Overview Button | Text on a button that shows what steps the learner has taken up to the point at which they have "arrived at the end of a cul-de-sac". |   | Default - "Overview%%"%% |
| Back Button | Text on a tooltip which appears on mouseover of the < icon. | Text | Default - "Previous Step"  |
| Forward Button | Text on a tooltip which appears on mouseover of the > icon. | Text | Default - "Next Step" |
| Copy Button | Text on a button which allows you to copy the Overview feedback (You have to add and enable Copy Overview from the Optional Properties) | Text  | Default - "Copy Overview" |
| Copy Instructions | Text that is displayed after the Copy Overview button is clicked on | Text  | Default - "Press Ctrl+C to copy" |
| Other Answers Label | This is a title which is displayed above other possible answers  | Text  | Default - "Other possible answers" |
| Slider Range Label | The title which is displayed above the range of points on the slider  | Text  | Default - "From Range" |
| Solution Label | The heading which is displayed above the solution, when the learner clicks on the Overview button  | Text  | Default - "Result" |
| Final Instruction | Text that is displayed on the button for "More Information". If you have not added text in the More Information box, this button will not appear.  | Text  | Default - "More information"  |
| Overview Label | The title displayed above the Overview, when the learner clicks on the Overview button |   | Default - "Overview" |
| Question Help Label | Text on a button which can added from Optional Properties to reveal a pop-up with additional information |   | Default - "More information" |
| Next Button Label | Text on the button at the bottom of an Information step |   | Default - "Next" |

==== Optional Properties (Top Level) ====

^ Property ^ Description ^ Type ^ Additional information ^
| Copy Overview Options | Adds a button to the overview screen  that presents learners with an easy-to-copy version of their answers and results  | Tick box  |   |
| Question Numbering | Displays the question/step numbers | Tick box |   |

=== General ===

See [[:optional_properties#General optional properties|General Optional Properties]]


==== Add Steps ====

After you have created the overall settings for the activity, you need to add steps.

{{ :xerte-inter-decisiontree-steps.jpg?400 }}

Here are explanations of these steps, and the link for each one will take you to a page explaining their core and optional properties.

| **Step**  | **Description**  |
| [[decisiontree_newmcq|New Multiple Choice Question...]]  | A decision mode presented as a multiple choice question  |
| [[decisiontree_newmslider|New Slider Question...]] | A decision node presented as a Likert scale with a slider the learner uses to select the answer |
| [[decisiontree_newinformation|New Information Step...]] | Displays new information, with a Next button to pass on to the next step |
| [[decisiontree_newresult|New Result...]] | This is always the last Step for the pathway the learner has followed |

{{tag>pagetype interactivity}}