@frontlinesystems/rason-mcp-server 2026.5.0

package/examples/calculation/DecisionTables/DT Loan Strategy Model and Predictive CSV-XML.json

@@ -0,0 +1,219 @@
+{
+  "modelName": "DTLoanStrategyPredictiveCSVXML",
+  "modelDescription": "RASON Decision Table Example: Loan Strategy Example importing data using CSV and XML files: The difference between this example and the DTLoanStrategyPredictive exammple is that this example imports the predictive model from within the datasources section. The predictive model is then used to score new data.  The output from the scoring is used as an input to a decision table.",
+  "modelType": "calculation",
+  "datasources": {
+    "comment": "Use this section to import data from an outside source.",
+    "score_src": {
+      "comment": "This data source contains the new data that will be scored by the predictive model. ",
+      "type": "csv",
+      "connection": "score_src.txt",
+      "colIndex": "score_h",
+      "direction": "import"
+    },
+    "pmml_src": {
+      "comment": "This data source contains the predictive model that will be used to score the new data, imported above.",
+      "type": "xml",
+      "connection": "pmml_src.xml",
+      "content": "pmml-model",
+      "direction": "import"
+    }
+  },
+  "decisionTables": {
+    "comment": "There are 8 decision tables in the decisionTables section.  Outputs from some tables will be used as inputs for other tables.",
+    "tblAppRiskScore": {
+      "comment": "This decision table accepts 3 inputs, customer age, marital status and employment status, and returns a partial risk score. The collection of results will be added together to create the partial score.  Note that the inputValues property limits the age to be 18 to 120, inclusive, the marital status to be s for single or m for married, the employment status as unemployed, employed, selfEmployed or student.  A 40 yo single self employed person would be assigned a partialScore = 43 (rule 4) + 25 (rule 6) +  45 (rule 10) = 113.",
+      "inputs": [ "cust age", "marital status", "employment status" ],
+      "outputs": [ "partial score" ],
+      "refTypes": [ "", "", "", "" ],
+      "inputValues": [
+        [ "[18..120]", "s", "unemployed" ],
+        [ "", "m", "employed" ],
+        [ "", "", "selfemployed" ],
+        [ "", "", "student" ]
+      ],
+      "rules": [
+        [ "[18..21]", "-", "-", 32 ],
+        [ "(21..25]", "-", "-", 35 ],
+        [ "(25..35]", "-", "-", 40 ],
+        [ "(35..49]", "-", "-", 43 ],
+        [ ">49", "-", "-", 48 ],
+        [ "-", "s", "-", 25 ],
+        [ "-", "m", "-", 45 ],
+        [ "-", "-", "unemployed", 15 ],
+        [ "-", "-", "student", 18 ],
+        [ "-", "-", "employed", 45 ],
+        [ "-", "-", "selfemployed", 36 ]
+      ],
+      "hitPolicy": "C+"
+    },
+    "tblBureauRiskCat": {
+      "comment": "This decision table accepts 2 inputs, cust Exist (true if customer already has at least 1 more loans) and app Risk Score (partial score from tblAppRiskScore). With a hit policy of 'unique', only 1 rule, with a unique result, may be returned. ",
+      "inputs": [ "cust exist", "app risk score" ],
+      "outputs": [ "bureau risk cat" ],
+      "inputTypes": [ "", "" ],
+      "outputTypes": [ "" ],
+      "rules": [
+        [ false, "<100", "high" ],
+        [ false, "[100..120]", "medium" ],
+        [ false, "[120..130]", "low" ],
+        [ false, ">130", "veryLow" ],
+        [ true, "<80", "decline" ],
+        [ true, "[80..90]", "high" ],
+        [ true, "[90..110]", "medium" ],
+        [ true, ">110", "low" ]
+      ],
+      "hitPolicy": "U"
+    },
+    "tblBureauCallType": {
+      "comment": "This decision table accepts 1 input, bureau Risk Cat, which is the output of the tblBureauRiskCat decision table.",
+      "inputs": [ "bureau risk cat" ],
+      "outputs": [ "bureau call type" ],
+      "rules": [
+        [ "high, medium", "full" ],
+        [ "low", "mini" ],
+        [ "veryLow, decline", "none" ]
+      ],
+      "hitPolicy": "U"
+    },
+    "tblEligibility": {
+      "comment": "This decision table accepts 3 inputs, bureau Risk Cat (which is the output of the tblAppriskScore decision table), bureau afford (a statistic calculated in the formulas section) and the customer's age.  The customer's eligibility will be returned in the result.  Note that there are only two outputs: 'ineligible' or 'eligible' as given in the outputValues property.",
+      "inputs": [ "bureau risk cat", "bureau afford", "cust age" ],
+      "outputs": [ "eligibility" ],
+      "refTypes": [ "", "", "", "" ],
+      "outputValues": [ "ineligible", "eligible" ],
+      "rules": [
+        [ "decline", "-", "-", "ineligible" ],
+        [ "-", false, "-", "ineligible" ],
+        [ "-", "-", "<18", "ineligible" ],
+        [ "-", "-", "-", "eligible" ]
+      ],
+      "hitPolicy": "P"
+    },
+    "tblStrategy": {
+      "comment": "This decision table accepts 2 inputs, eligibility and bureau Call Type. The strategy will be returned in the result.",
+      "inputs": [ "eligibility", "bureau call type" ],
+      "outputs": [ "strategy" ],
+      "rules": [
+        [ "ineligible", "-", "decline" ],
+        [ "eligible", "full, mini", "bureau" ],
+        [ "eligible", "none", "through" ]
+      ],
+      "hitPolicy": "U"
+    },
+    "tblCreditContFactor": {
+      "comment": "This decision table accepts 1 input, bureau Risk Cat, and returns the credit Cont Factor.",
+      "inputs": [ "bureau risk cat" ],
+      "outputs": [ "credit cont factor" ],
+      "rules": [
+        [ "high, decline", 0.6 ],
+        [ "medium", 0.7 ],
+        [ "low, veryLow", 0.8 ]
+      ],
+      "hitPolicy": "U"
+    }
+  },
+  "data": {
+    "comment": "Use this section to organize all constant data parameters in the RASON model.",
+    "scoreData": {
+      "comment": "Binds the score_src dataSource (importing the new data) to this data parameter.",
+      "binding": "score_src"
+    },
+    "pmodel": {
+      "binding": "pmml_src",
+      "comment": "Binds the pmml_src dataSource to pmodel data parameter."
+    },
+    "custAge": {
+      "value": 40,
+      "comment": "Applicant's age"
+    },
+    "maritalStatus": {
+      "value": "s",
+      "comment": "The marital statis of the applicant."
+    },
+    "employmentStatus": {
+      "value": "selfemployed",
+      "comment": "The employment status of the applicant."
+    },
+    "custExist": {
+      "value": false,
+      "comment": "true is the applicant is an existing customer, false otherwise."
+    },
+    "monthIncome": {
+      "value": 2500,
+      "comment": "applicant's monthly income"
+    },
+    "loanRate": {
+      "value": 5,
+      "comment": "loan's interest rate"
+    },
+    "loanTerm": {
+      "value": 30,
+      "comment": "term of the loan, in months"
+    },
+    "loanAmnt": {
+      "value": 100000,
+      "comment": "Amount of the loan, in US dollars"
+    },
+    "monthExpenses": {
+      "value": 1000,
+      "comment": "Applicant's monthly expenses"
+    },
+    "loanType": {
+      "value": "standard",
+      "comment": "The type of loan being applied for."
+    }
+  },
+  "formulas": {
+    "appRiskScore": {
+      "formula": "MIN(PsiPredict(pmodel, scoreData),tblAppRiskScore(, , custAge, maritalStatus, employmentStatus))",
+      "comment": "Calls the tblAppRiskScore decision table to compute the applicant's risk score.",
+      "finalValue": []
+    },
+    "bureauRiskCat": {
+      "formula": "tblBureauRiskCat(, , custExist, appRiskScore)",
+      "comment": "Calls the tblBureauRiskCat decision table. Note that output from the tblAppRiskScore decision table, appRiskScore, is an input to this decision table.",
+      "finalValue": []
+    },
+    "bureauCallType": {
+      "formula": "tblBureauCallType(, , bureauRiskCat)",
+      "comment": "Calls the tblBureauCallType decision table to compute the bureau's risk category.",
+      "finalValue": []
+    },
+    "monthRepay": {
+      "formula": "-PMT(loanRate%/12, loanTerm*12, loanAmnt)",
+      "comment": "computes the portion of the monthly installment attributable to the loan."
+    },
+    "disposIncome": {
+      "formula": "monthIncome - (monthRepay + monthExpenses)",
+      "comment": "Computes the applicant's disposable income."
+    },
+    "monthFee": {
+      "formula": "IF(loanType = 'standard', 20, IF(loanType = 'special', 25, 0))",
+      "comment": "Computes the fee assoicated with the loan."
+    },
+    "monthInstall": {
+      "formula": "monthRepay +  monthFee",
+      "comment": "Computes the total installment payment including loan replayment and fee portions."
+    },
+    "bureauAfford": {
+      "formula": "IF(disposIncome * creditContFactor > monthInstall, TRUE, FALSE)",
+      "comment": "Determines if the applicant will be able to afford the monthly installment payment."
+    },
+    "eligibility": {
+      "formula": "tblEligibility(, , bureauRiskCat, bureauAfford, custAge)",
+      "comment": "Determines if the applicant is eligibile to receive a loan from the institution.",
+      "finalValue": []
+    },
+    "strategy": {
+      "formula": "tblStrategy(, , eligibility, bureauCallType)",
+      "comment": "Uses outputs from the tblEligibility and tblBureauCallType tables to determine the best strategy for the applicant.",
+      "finalValue": []
+    },
+    "creditContFactor": {
+      "formula": "tblCreditContFactor(, , bureauRiskCat)",
+      "comment": "Calls the tblCreditContFactor table using the output from the tblBureauRiskCat decision table. ",
+      "finalValue": []
+    }
+  }
+}

package/examples/calculation/DecisionTables/DT Loan Strategy model and Datasource.json

@@ -0,0 +1,286 @@
+{
+  "modelName": "DTLoanStrategyExamplewDatasource",
+  "modelDescription": "RASON Decision Table Example: Loan Strategy model with imported data sources:  The difference between this example and the original DTLoanStrategyModel, is that this example imports the customer data and loan data from an outside data source, in this example two CVS files:  customers.txt and loans.txt.",
+  "modelType": "calculation",
+  "datasources": {
+    "comment": "This section is used to import data from outside sources. To download these files, click Download RASON Example Data on the Editor tab ribbon. All data files related to all RASON examples will be downloaded.  To solve this model, click Choose Files from the Properties pane on the right, browse to the location of the downloaded files and select customer.txt and loans.txt, then click Open. In the previous example, DTLoanStrategyModel, all data used in the model was simply passed as constants in the file. This example, however, demonstrates how to import this same data from an external data file using a parametric selection criteria. A Parametric Selection allows a single record to be selected from an external datasource file as an input. Parametric selection in data-sources is universal, it is critical to decision tables, which expect a single record for their inputs. All supported data types may be used with this feature.",
+    "cust_data": {
+      "comment": "The datasource, cust_data, binds to the customers.txt csv file. This file contains five input parameters, age, maritalStatus, employmentStatus, creditScore and bankrupt. Inside of the cust_data datasource, we see the connection argument passing the CSV file, 'connection': 'customers.txt' (screenshot above). The selection argument selects the 'CustID' column , from the customers.txt file, and replaces 'custID = ?' with 'custID = cuID'; the parameters argument binds 'cuID' to 'c1'. In addition, indexCols is set to 'cust ID' and valueCols are set to 'age', 'maritalStatus', 'employmentStatus', 'creditScore' and 'bankrupt'. This means that cust ID is the index column and 'age', 'maritalStatus', 'employmentStatus', 'creditScore' and 'bankrupt' are the value columns.",
+      "type": "csv",
+      "connection": "customers_dt.txt",
+      "selection": "custID = ?",
+      "parameters": {
+        "cuID": {
+          "binding": "get",
+          "value": "c1"
+        }
+      },
+      "indexCols": [ "custID" ],
+      "valueCols": [ "age", "maritalStatus", "employmentStatus", "creditScore", "bankrupt" ],
+      "direction": "import"
+    },
+    "loan_data": {
+      "comment": "Inside of the loan_data datasource, we see the connection argument passing the CSV file, connection: 'loans.txt' (screenshot above). The selection argument selects the 'loanID' column , from the loans.txt file, and replaces 'loanID = ?' with 'loanID = loID'; the parameters argument binds 'loID' to 'l1'. In addition, indexCols is set to 'loanID' and valueCols are set to 'type', 'rate' and 'term'. This means that loanID is the index column and 'type', 'rate' and 'term' are the value columns.",
+      "type": "csv",
+      "connection": "loans.txt",
+      "selection": "loanID = ?",
+      "parameters": {
+        "loID": {
+          "binding": "get",
+          "value": "l1"
+        }
+      },
+      "indexCols": [ "loanID" ],
+      "valueCols": [ "type", "rate", "term" ],
+      "direction": "import"
+    }
+  },
+  "data": {
+    "comment": "Use the data section to organize constant data parameters in the RASON model.",
+    "custExist": {
+      "comment": "True if the applicant is an existing customer; false if not.",
+      "value": false
+    },
+    "custAge": {
+      "comment": "Binds the age column from cust_data datasource to data parameter, custAge.",
+      "value": 40,
+      "binding": "cust_data",
+      "valueCol": "age"
+    },
+    "maritalStatus": {
+      "comment": "Binds the maritalStatus column from cust_data datasource to data parameter, maritalStatus.",
+      "value": "s",
+      "binding": "cust_data",
+      "valueCol": "maritalStatus"
+    },
+    "employmentStatus": {
+      "comment": "Binds the employmentStatus column from cust_data datasource to data parameter,employmentStatus ",
+      "value": "selfEmployed",
+      "binding": "cust_data",
+      "valueCol": "employmentStatus"
+    },
+    "creditScore": {
+      "comment": "Binds the creditScore column from cust_data datasource to data parameter, creditScore.",
+      "value": 610,
+      "binding": "cust_data",
+      "valueCol": "creditScore"
+    },
+    "bankrupt": {
+      "comment": "Binds the creditScore column from cust_data datasource to data parameter, creditScore.",
+      "value": false,
+      "binding": "cust_data",
+      "valueCol": "bankrupt"
+    },
+    "monthIncome": {
+      "comment": "Applicant's monthly income.  Note the 'binding':'get' property.  This property allows access to this parameter outside of the RASON model environment.",
+      "value": 2500,
+      "binding": "get"
+    },
+    "monthExpenses": {
+      "comment": "Applicant's monthly expenses. Note the 'binding':'get' property.  This property allows access to this parameter outside of the RASON model environment.",
+      "value": 1000,
+      "binding": "get"
+    },
+    "loanType": {
+      "comment": "Binds the type column from loan_data datasource to data parameter, loanType.",
+      "value": "standard",
+      "binding": "loan_data",
+      "valueCol": "type"
+    },
+    "loanRate": {
+      "comment": "Binds the rate column from loan_data datasource to data parameter, loanRate.",
+      "value": 5.0,
+      "binding": "loan_data",
+      "valueCol": "rate"
+    },
+    "loanTerm": {
+      "comment": "Binds the term column from loan_data datasource to data parameter, loanTerm.",
+      "value": 30,
+      "binding": "loan_data",
+      "valueCol": "term"
+    },
+    "loanAmnt": {
+      "comment": "The prospective loan amount. Note the 'binding':'get' property.  This property allows access to this parameter outside of the RASON model environment.",
+      "value": 100000.0,
+      "binding": "get"
+    }
+  },
+  "decisionTables": {
+    "comment": "There are 8 decision tables in the model.",
+    "tblAppRiskScore": {
+      "comment": "This decision table accepts 3 inputs, customer age, marital status and employment status, and returns a partial risk score. The collection of results will be added together to create the partial score.  Note that the inputValues property limits the age to be 18 to 120, inclusive, the marital status to be s for single or m for married, the employment status as unemployed, employed, selfEmployed or student.  A 40 yo single self employed person would be assigned a partialScore = 43 (rule 4) + 25 (rule 6) +  45 (rule 10) = 113.",
+      "inputs": [ "custAge", "maritalStatus", "employmentStatus" ],
+      "outputs": [ "partialScore" ],
+      "inputValues": [
+        [ "[18..120]", "s", "unemployed" ],
+        [ null, "m", "employed" ],
+        [ null, null, "selfEmployed" ],
+        [ null, null, "student" ]
+      ],
+      "rules": [
+        [ "[18..21]", "-", "-", 32 ],
+        [ "(21..25]", "-", "-", 35 ],
+        [ "(25..35]", "-", "-", 40 ],
+        [ "(35..49]", "-", "-", 43 ],
+        [ ">49", "-", "-", 48 ],
+        [ "-", "s", "-", 25 ],
+        [ "-", "m", "-", 45 ],
+        [ "-", "-", "unemployed", 15 ],
+        [ "-", "-", "student", 18 ],
+        [ "-", "-", "employed", 45 ],
+        [ "-", "-", "selfEmployed", 36 ]
+      ],
+      "hitPolicy": "collect+"
+    },
+    "tblBureauRiskCat": {
+      "comment": "This decision table accepts 2 inputs, custExist (true if customer already has at least 1 more loans) and appRiskScore (partial score from tblAppRiskScore). With a hit policy of 'unique', only 1 rule, with a unique result, may be returned. ",
+      "inputs": [ "custExist", "appRiskScore" ],
+      "outputs": [ "bureauRiskCat" ],
+      "rules": [
+        [ false, "<100", "high" ],
+        [ false, "[100..120)", "medium" ],
+        [ false, "[120..130]", "low" ],
+        [ false, ">130", "veryLow" ],
+        [ true, "<80", "decline" ],
+        [ true, "[80..90)", "high" ],
+        [ true, "[90..110]", "medium" ],
+        [ true, ">110", "low" ]
+      ],
+      "hitPolicy": "unique"
+    },
+    "tblBureauCallType": {
+      "comment": "This decision table accepts 1 input, bureauRiskCat, which is the output of the tblBureauRiskCat decision table.",
+      "inputs": [ "bureauRiskCat" ],
+      "outputs": [ "bureauCallType" ],
+      "rules": [
+        [ "high,medium", "full" ],
+        [ "low", "mini" ],
+        [ "veryLow,decline", "none" ]
+      ],
+      "hitPolicy": "unique"
+    },
+    "tblEligibility": {
+      "comment": "This decision table accepts 3 inputs, bureauRiskCat (which is the output of the tblAppriskScore decision table), bureauAfford (a statistic calculated in the formula's section) and the customer's age.  The customer's eligibility will be returned in the result.  Note that there are only two outputs: 'ineligible' or 'eligible' as given in the outputValues property.",
+      "inputs": [ "bureauRiskCat", "bureauAfford", "custAge" ],
+      "outputs": [ "eligibility" ],
+      "outputValues": [ "ineligible", "eligible" ],
+      "rules": [
+        [ "decline", "-", "-", "ineligible" ],
+        [ "-", false, "-", "ineligible" ],
+        [ "-", "-", "<18", "ineligible" ],
+        [ "-", "-", "-", "eligible" ]
+      ],
+      "hitPolicy": "priority"
+    },
+    "tblCreditContFactor": {
+      "comment": "This decision table accepts 1 input, bureauRiskCat, and returns the creditContFactor.",
+      "inputs": [ "bureauRiskCat" ],
+      "outputs": [ "creditContFactor" ],
+      "rules": [
+        [ "high,decline", 0.6 ],
+        [ "medium", 0.7 ],
+        [ "low,veryLow", 0.8 ]
+      ],
+      "hitPolicy": "unique"
+    },
+    "tblStrategy": {
+      "comment": "This decision table accepts 2 inputs, eligibility and bureauCallType. The strategy will be returned in the result.",
+      "inputs": [ "eligibility", "bureauCallType" ],
+      "outputs": [ "strategy" ],
+      "rules": [
+        [ "ineligible", "-", "decline" ],
+        [ "eligible", "full,mini", "bureau" ],
+        [ "eligible", "none", "through" ]
+      ],
+      "hitPolicy": "unique"
+    },
+    "tblPostBureauRiskCat": {
+      "comment": "This decision table accepts 3 inputs, custExist, appRiskScore (which is the output of the tblBureauRiskCat decision table) and creditScore.  The customer's credit factor will be returned in the result.",
+      "inputs": [ "custExist", "appRiskScore", "creditScore" ],
+      "outputs": [ "postBureauRiskCat" ],
+      "rules": [
+        [ false, "<120", "<590", "high" ],
+        [ false, "<120", "[590..610]", "medium" ],
+        [ false, "<120", ">610", "low" ],
+        [ false, "[120..130]", "<600", "high" ],
+        [ false, "[120..130]", "[600..625]", "medium" ],
+        [ false, "[120..130]", ">625", "low" ],
+        [ false, ">130", "-", "veryLow" ],
+        [ true, "<=100", "<580", "high" ],
+        [ true, "<=100", "[580..600]", "medium" ],
+        [ true, "<=100", ">600", "low" ],
+        [ true, ">100", "<590", "high" ],
+        [ true, ">100", "[590..615]", "medium" ],
+        [ true, ">100", ">615", "low" ]
+      ],
+      "hitPolicy": "unique"
+    },
+    "tblRouting": {
+      "comment": "This decision table accepts 4 inputs: postBureauRiskCat, postBureauAfford, bankrupt and creditScore.  The application routing number will be returned in the result.",
+      "inputs": [ "postBureauRiskCat", "postBureauAfford", "bankrupt", "creditScore" ],
+      "outputs": [ "routing" ],
+      "inputValues": [
+        [ null, null, true, "[0..999]" ],
+        [ null, null, false, null ]
+      ],
+      "outputValues": [ "decline", "refer", "accept" ],
+      "rules": [
+        [ "-", false, "-", "-", "decline" ],
+        [ "-", "-", true, "-", "decline" ],
+        [ "high", "-", "-", "-", "refer" ],
+        [ "-", "-", "-", "<580", "refer" ],
+        [ "-", "-", "-", "-", "accept" ]
+      ],
+      "hitPolicy": "priority"
+    }
+  },
+  "formulas": {
+    "comment": "Use the formulas section to calculate the decision tables.",
+    "monthFee": {
+      "comment": "Determines the monthly fees for each loanType, standard or special.",
+      "formula": "IF(loanType[1] = 'standard', 20, IF(loanType[1] = 'special', 25, 0))"
+    },
+    "monthRepay": {
+      "comment": "Determines the portion of the installment payment attributable to principal replayment.",
+      "formula": "-PMT(loanRate[1]%/12, loanTerm[1]*12, loanAmnt)"
+    },
+    "monthInstall": {
+      "comment": "Calculates the total installment payment.",
+      "formula": "monthRepay + monthFee"
+    },
+    "disposIncome": {
+      "comment": "Calculates the applicant's disposeable income.",
+      "formula": "monthIncome - (monthRepay + monthExpenses)"
+    },
+    "appRiskScore": {
+      "comment": "Calls the tblAppRiskScore decision table.",
+      "formula": "tblAppRiskScore(,, custAge[1], maritalStatus[1], employmentStatus[1])"
+    },
+    "bureauRiskCat": {
+      "comment": "Calls the tblBureauRiskCat decision table.",
+      "formula": "tblBureauRiskCat(,, custExist, appRiskScore)"
+    },
+    "bureauAfford": {
+      "comment": "Calculates if the applicant can afford the loan repayment by calling the tblCreditContFactor decision table.",
+      "formula": "IF(disposIncome * tblCreditContFactor(,, bureauRiskCat) > monthInstall, true, false)"
+    },
+    "strategy": {
+      "comment": "Calls the tblsStrategy decision table. Note that the final value for this formula will be included in the results due to the exitence of the finalValue property.",
+      "formula": "tblStrategy(,, tblEligibility(,, bureauRiskCat, bureauAfford, custAge[1]), tblBureauCallType(,, bureauRiskCat))",
+      "finalValue": []
+    },
+    "postBureauRiskCat": {
+      "comment": "Calls the tblPostBureauRiskCat decision table.",
+      "formula": "tblPostBureauRiskCat(,, custExist, appRiskScore, creditScore[1])"
+    },
+    "postBureauAfford": {
+      "comment": "Multiples disposable income by the outcome of a call to the tblCreditContFactor decision table.",
+      "formula": "IF(disposIncome * tblCreditContFactor(,, postBureauRiskCat) > monthInstall, true, false)"
+    },
+    "routing": {
+      "comment": "Calls the tblRouting decsion table to determine how the application should be accepted or not. Note that the final value for this formula will be included in the results due to the exitence of the finalValue property.",
+      "formula": "tblRouting(,, postBureauRiskCat, postBureauAfford, bankrupt[1], creditScore[1])",
+      "finalValue": []
+    }
+  }
+}