Appearance
Change your rules
You change your scoring rules by making a new version: copy the version in use to a draft, change the draft, test it, and activate it. Nothing is scored with a draft, so you can take your time. When you activate it, new applications use it and the version before is archived. Read How rulesets work first if versions are new to you.
Steps
Open SAWScore → Rulesets. Versions are grouped by name, newest first, with their status: Draft, Active or Archived.
On the row of the version to start from (usually the active one), open the ⋮ menu and select Clone to a new draft. Under What will change, and why, write a line for your colleagues, then select Create the draft. The draft opens in the editor with the next version number.
To start from a ruleset under Global rulesets, select Copy to our rulesets on its ⋮ menu instead, give the copy a name and select Make our draft. A global ruleset itself cannot be changed: its editor is read-only and says who maintains it.
- 1The status of each version
- 2Edit opens a draft; Open shows an active or archived version
- 3Clone, Activate, Archive, Delete and Compare
The editor opens in the Blocks view: every part of the ruleset as a card on one page (see the table below). Change a label, a key or a number right where it stands. The pencil on a field's row opens everything else about that field. The label Unsaved changes shows until you select Save. Revert drops everything since the last save, in every part of the ruleset. These buttons are in the toolbar at the top, which stays in view while you scroll.
- 1Switch between the Blocks, JSON and Graph views.
- 2Save your changes; Activate puts the version in use.
- 3Go to jumps to a card.
- 4The sandbox: try answers and see the grade and decision at once.
To change the order of sections, fields, choices, grade bands, ladder rules or PTI rows, drag the grip (≡) at the start of the row and let go where the line shows. A field can be dragged into another section. The arrow buttons on each row, and the up and down arrow keys while a grip has the focus, do the same.
Select Validate. "The definition is valid: the server accepts it." may be followed by "Worth a look:" and a list, for example a range of scores that no grade band covers. Select a line to jump to that part.
Test your changes in the sandbox. Select Sandbox beside the editor (or Sandbox in a window) and fill in answers as on a real application, or select Fill in the suggested values. The grade, the total score and the decision are worked out again a moment after every answer and after every change you make to the rules, saved or not. Under How the score comes about you see the section totals, each decision and the payment. Nothing is saved. Try answers just below and just above each limit you changed.
Go back to All rulesets. On your draft's ⋮ menu select Compare with… to see every difference from the version it was copied from, in words, with the old and the new value.
To see the effect on real deals before you commit, run the What-if report with the draft: see Dashboard and reports.
Select Activate (in the editor, or on the row's ⋮ menu), add a Change reason (optional), and confirm with Activate. The button is unavailable while you have unsaved changes.
The three views
The buttons Blocks, JSON and Graph above the editor show the same ruleset in three ways. You can switch at any time; unsaved changes come along.
| View | Use it to |
|---|---|
| Blocks | Change the ruleset card by card. This is where most work is done. |
| JSON | See the whole ruleset as text, Download it, or Load a file. For people who know the format. |
| Graph | See the ruleset as a map and change it from there. |
What each card of the Blocks view is for
The buttons after Go to jump to a card. Select a card's title to fold it away or open it again.
| Card | Use it to |
|---|---|
| Details | Name the ruleset, write the change reason, description and notes, and see when it was created, activated and archived. It starts folded. |
| Sections & fields | Add, reorder, archive or remove the sections and questions of the application form, set each answer's points, and give each section its colour. |
| Grades | Set the score at which each grade starts and ends, and the fallback grade. |
| Adjustments | Add or take off points when conditions hold. |
| Co-buyer | Choose how two sets of answers are combined, and how much of a co-buyer's income counts. |
| Decisions | Edit the rule lists for rate, term, down payment, rollover and repeat customers, and the texts of the decision lines. |
| Income & payment | Set pay-frequency multipliers, the share of income a payment may take per grade, and the highest payment. |
In Sections & fields, each section is a block with its fields in a table. The coloured square at the start of a section sets its colour: select it to pick one, or type a colour code such as #0079b8 in the box beside the key. The choices of a choice list stand under its field, each with its points.
The Graph view
The map shows the ruleset from left to right, in the order an application is scored: the sections, the total score, the grade, the decision ladders and the decision lines. A wire between two boxes means the box on the right reads the one on the left. The wires follow your rules: when a ladder rule starts to test the grade, a wire from Grade to that ladder appears.
- 1A box: select it to change that part.
- 2The panel with the same form as the card in Blocks.
- 3Show the whole map shrinks it until every box is in view.
- Select a box to change that part in the panel beside the map. It is the same form as on the card in Blocks.
- Drag a box to arrange the map. Where the boxes sit is saved with the ruleset when you select Save. On a version you cannot change, the arrangement is kept in your browser only.
- Show the whole map shrinks the map until every box is in view. Put the boxes back in order undoes your arrangement.
- Add a section adds a new, empty section and opens it.
- The figures on the boxes are the score of the answers in the sandbox. Score the sandbox answers works them out again.
What happens next
- New applications are scored with the activated version. The version of the same name that was active is archived at that moment.
- Applications already scored keep their version and their grade until someone selects Re-evaluate on them.
- Archive (on the ⋮ menu) retires a version without a replacement. If you archive the only active version, nobody can create applications until you activate another.
- Delete removes a version for good. It works only for a version nothing was ever scored with.
Editing the active version
An organization administrator can switch on Allow editing an active ruleset (see Settings). The active version can then be changed in place, and "what you save applies to the next application that is scored". There is no draft to test and no earlier version to compare with, so keep this for small fixes.
If something goes wrong
| You see | It means | Do this |
|---|---|---|
| "This version is active, and your organization does not allow changing an active ruleset…" | The version is read-only. | Select Clone to a new draft and change the draft. |
| "Not saved: Only a draft can be changed. Clone the active ruleset to a new version." | Someone activated this version while you were editing. | Clone it to a new draft and make your changes there. |
| "Not saved: An archived ruleset cannot be changed. Clone it to a new version." | The version was archived. | Clone it to a new draft. |
| "Not saved. The definition is not valid:" and a list | A rule is incomplete, for example two fields with the same key. | Select each line to jump to the problem, fix it, save again. |
| "You can fill in the form, but scoring needs the permission to score applications." | The sandbox shows the form, but you may not score. | Ask an administrator of your organization for the permission to score applications. |
| "Only a draft can be activated" | The version is already active or archived. | Clone it and activate the clone. |
| "This ruleset was used to score applications. Archive it instead of removing it." | You tried to delete a version that applications or their saved revisions use. | Select Archive instead. |
| "Another ruleset has that name and version" | You renamed a draft to a name that already has this version number. | Choose another name. |
| "You can look at every part of this ruleset. Changing rulesets needs the permission to edit, activate and archive rulesets." | You can read rulesets but not change them. | Ask an administrator of your organization. |