Change Risk Assessments

as part of it changes it is often a requirement to calculate risk based on a questionnaire to allow for this, servicely provides the ability to create multiple risk assessments to allow you to create a set of questions, with specific weightings based on your requirements to allow for this, it leverages a similar tool set to the catalog item functionality, ensuring that similar concepts / knowledge can be carried over to calculate risk how to create a risk assessment to create a risk assessment you will need to start off by going to “risk assessment items” table we provide an example out of box (which you can make inactive), but you can use this as inspiration to create your own creating questions and answers are largely the same as creating a catalog item (which you can see more information here docid\ lk1tek46wcoiyxr6qaswq ), with a few differences and requirements noting that this will not show up in the catalog and will be triggered / run another way you will want to make sure the key is something that makes sense from a script perspective, as it will be used to show the risk assessment via a button you will want to ensure the table is “risk assessment answers” in the record generation script (in the advanced tab), you will want to include something very similar to the following (which you can copy from the out of box risk assessment example) // variables are current, sourcerecord, questions let sourcerecordid = sourcerecord id(); let sourcerecordtablename = sourcerecord tableclass(); let genericreferenceid = sourcerecordid + " " + sourcerecordtablename; let questionsandanswers = questions asjson(); // calculate the risk let risk = riskassessmentutil calculaterisk("change risk assessment", questionsandanswers); // put on the source record table(sourcerecordtablename, sourcerecordid) risk(risk) update(); // put on the riskassessmentanswers record, this will be automaticlly updated current record(genericreferenceid); current risk(risk); once you have created the risk assessment item and its questions, you will want to flag it as such, which you can do via the “change risk assessments” menu item, which allows you to give it a name and provide any notes about it at this point you will have the questions and records being generated from a “visible” perspective, however, to allow you to calculate risk from it, there are more records that need to be generated to allow for it to do what you require thresholds and weighting to allow risk assessments to calculate risk in a useful method, servicely allows you to set different weighting to different questions / answers to provide you the most accurate look on your risk what this means is that different questions may have a different weighting against a overall score, with every answers having a different score against it such as if you have 2 questions, this will come up to a different score based on the score / weighting an example is as per below has this changed happened before? (weighting 5) yes (score 1) no (score 5) how long does it take to back out? (weighting 2) instantly (score 1) less than 1 hour (score 3) more than 1 hour (score 5) if i pick the following answers, i would get the following scores (examples below) 1a and 2b 1x5 + 3 2 = 11 3b and 2a 5 5 + 5 2 = 35 1a and 2a 1 5 + 1 2 = 7 with these total scores then, this will then look at the thresholds to understand the risk an example is where we might say the following thresholds for each risk level low 0 medium 10 high 20 critical 30 in the above example, it would then be medium, critical and low risk respectively as 11 is more than 10, but less than 20, 35 is above 35, and 7 is less than 10 to set these up, there are a few related records to deal with this to accomplish this there are a few different records you need to create to make this possible risk assessment questions the risk assessment questions table allows you define the question’s weighting from a basic level, you simply need to relate a question and risk assessment together, as well as giving it a name and weighting (more than 0) this will seem similar to the step of creating the questions initially, but this is just to tie things together in the background to ensure a weighting can be given against a question risk assessment question answers this is the table that allows you to record the score of a specific answer sometime selects these answers need to match the answers on the question itself such as for the choice questions, it needs to be the choice key, for booleans, “yes” and “no” risk assessment thresholds this table holds the thresholds for the risk assessment to determine the level of risk the risk needs to be the same values as the risk on the change the threshold is the lowest total score for a record to meet that risk presently you can only have one set of thresholds that are used for all assessments, so plan your scores and weighting accordingly triggers and usage to trigger a risk assessment, you can do so via a client side script out the box, we provide a table operation called “change risk assessment” which can be disabled in case you want to make your own version the important element of this (which is why it can be used in other client side scripts) is an on before script this is where you can define what risk assessment should be called (and you can make use of other apis or fields in the system to do what you require) we have highlighted below with a comment (line 27) which property should be updated, to match the risk assessment key defined earlier // we need to find the risk assessment record we created last time we ran this so that we can find the answers let q = table("riskassessmentanswers") equal("record", id + " " + tablename) query(); let recordid = q hasnext() ? q next() id() null; return new promise((resolve, reject) => { // context contains the id of the generated riskassessmentanswers record let closecallback = (closereason, context) => { resolve(true); }; let questionitemparams = { recordid recordid, recordtable null, sourcerec { tableclass tablename, id id }, sourceisnewrecord current isnewrecord() }; let modaloptions = { showcloseicon true, showclosebutton false, closecallback closecallback, title "risk assessment" }; navigate showquestionmodal({ questionitem 'riskassessment', // < this is where you can define a different risk assessment questionitemparams questionitemparams, modaloptions modaloptions }); });