Tip: Always create a question and allowed answers for Decisions. Don’t neglect this step when building diagrams as failing to capture this information degrades the quality of your model rapidly – questions are the best way to make sure everyone really agrees on what a Decision is.
Select the Determine Refund Eligibility decision on the diagram and click the Edit Object button on the toolbar and the Decision editing tab for that Decision will open. (A short video is also available)
Tip: You can also double-click a node to open its edit tab
As we have created objects in this tutorial we have only entered a few properties for each. The full set of properties for each object is documented in the descriptions of those objects. This tutorial will spend some time showing you how to access them.
The Decision editing page, like all object editing pages, has three columns:
- A Jump to list
- The properties and associations that can be edited
- Search and update history
Tip: The jump will bring the relevant section to the top of the column unless there is insufficient content below the jump point to fill the available space in which case the jump will display the bottom of the central column and you will find what you are looking for in the middle of the page.
Questions are a powerful tool for explaining a decision. For each Decision, determine the question that must be answered to make it. Be precise and detailed in your questions – be clear about the subject of the decision, about timing and about the scope or limits. Avoid questions that start “How” or use I/We.
Each question implies a set of allowed answers. The allowed answers, the options from which the decision is selecting, should be documented for each question. The allowed answers are specified using one of the radio buttons under Answer Type – Yes/No (for binary or true false Decisions), Value from explicit list (where you will specify the possible answers), Value from database (where the list of answers is in a system somewhere), a number (possibly in a specific range) or something else (a block of text or a structure with multiple fields). In addition, any answer may come with supporting information such as messages or explanatory text that can be specified in the Support Information field. Make sure the allowed answers follow from the question - that all answers are reasonable given the question.
In this case the question is “Is this customer eligible for a refund on this specific billing item?” and the allowed answers are Yes/No so simply select that option. That’s enough to create this object so you can save it using the save button and then close the tab.
Repeat this sequence with the other three decisions:
|Calculate Price||What is the total final price for this order?||Number in range|
|Determine Return Eligibility||Is this customer eligible to return this product?||Yes/No|
|Select Marketing Offer||What marketing offer should be made to this customer at this time?||Value from database|
Tip Notice that the Answer section changes as you pick options. This allows you to add explicit values, minimum or maximum values or note related to the values in a database for instance. Use these fields to fully quality your answer when you can.
Keep the last one open and we will consider some of the other properties of the core objects.
<Previous> <Tutorial Overview> <Next>