DecisionMatrix Class

The Decision Matrix class is used to maintain information regarding the decision matrix. The following is a summary of some of the decision matrix header details which are maintained:

Name: The name of the decision matrix should be unique.
Type: The options for the decision matrix type are the same options as for the determination configuration and questionnaire (medical, screening, or needs). Note that the decision matrix type does not have to match the type of questionnaire or the type of determination configuration that it is associated with; it is informational only and thus there is no validation.
Cumulative score: When selected, this means that a total score will be calculated when the all answers given are passed through the decision matrix. For example, one of the sample family risk assessment decision matrices produces a cumulative score - the higher the score, the greater the risk.
Multiple outcomes: When selected, this means that there can be more than one outcome rendered from the decision matrix. For example, the sample family services assessment form gathers information about a family's circumstances to ascertain which services may help improve the family's current situation. Each question in the assessment has the potential to lead to an outcome (the outcomes being matched with appropriate services).
Scoring by outcomes: When selected, rather than returning a cumulative score for the matrix as a whole, a score is calculated for each outcome generated from the answers used to generate that outcome. For example, the sample family services assessment form gathers information about a family's circumstances to ascertain which services may help improve the family's current situation. Each question in the assessment has the potential to lead to an outcome (the outcomes being matched with the appropriate services), if the answer is given a high enough score. If the outcome is generated, both the outcome and score are returned.
Decision matrix version number: This is used to maintain different versions of the same decision matrix. It is also used to clone a decision matrix. More information about decision matrix versions is provided in the descriptions of the decision matrix business processes.

The following table describes the business processes that make up the DecisionMatrix class:

Table 1. Description of DecisionMatrix Business Processes
Business Process	Description
readAllLatestVersionDecisionMatrices	This method retrieves the latest decision matrices in full, i.e. the decision matrix header details and data.
readDecisionMatrixVersion	This method returns the details of a decision matrix record for the specified version key. This key is used to distinguish the different versions of the same decision matrix.
readAllDPsForDecisionMatrices	This method retrieves all the determination packages associated with the decision matrix. Only the latest version of the determination package is displayed.
readDecisionMatrixHeaderDetails	This method returns the name and ID of all of the latest decision matrix records. This is used, for example, to populate a drop-down list of the latest decision matrices.
readDecisionMatrixData	This method returns all decision matrix data (row, column, and cell data).
listOutcomesForMatrix	This method returns the list of outcome records associated with a decision matrix.
listDecisionMatrixVersionDetails	This method is intended to be used by users responsible for managing decision matrix to list all the decision matrix records of the specified version key on the system.
getQuestionnaireForMatrix	This method returns the questionnaire record selected for the decision matrix.
getQuestionsForMatrix	This method returns the questions selected from their questionnaire for the decision matrix. This method is called after the GetQuestionnaireForMatrix method.
readOutcomeScoreAssociation	This method returns the association between an outcome and a decision matrix.