JDM Standard

JDM (JSON Decision Model) is the file format used by GoRules to represent decision graphs. It’s a human-readable JSON structure that captures nodes, edges, and configuration in a portable format.

Why JDM?

Benefit	Description
Portable	Works across all GoRules SDKs and tools
Version controllable	Store in Git alongside your code
Human readable	Review and diff changes easily
Extensible	Add custom metadata without breaking compatibility

File structure

A JDM file contains three main sections:

{
  "nodes": [...],
  "edges": [...],
  "metadata": {...}
}

Nodes

Each node represents a processing step in the decision:

{
  "id": "node-1",
  "type": "decisionTableNode",
  "name": "Customer Discount",
  "position": { "x": 200, "y": 100 },
  "content": {
    // Node-specific configuration
  }
}

Edges

Edges define connections between nodes:

{
  "id": "edge-1",
  "sourceId": "input-node",
  "targetId": "decision-table-node",
  "sourceHandle": "output",
  "targetHandle": "input"
}

Metadata

Optional metadata about the decision:

{
  "metadata": {
    "version": "1.0.0",
    "author": "team@example.com",
    "description": "Customer discount calculation",
    "tags": ["pricing", "discounts"]
  }
}

Loading JDM files

Load and evaluate JDM files using any GoRules SDK:

Validating structure

The @gorules/jdm-editor package exports a Zod schema for validating JDM files:

import { decisionModelSchema } from '@gorules/jdm-editor/dist/schema';

const content = JSON.parse(await file.text());
const result = decisionModelSchema.safeParse(content);

if (!result.success) {
  console.error('Invalid JDM:', result.error.issues);
}

Version control best practices

File organization

rules

pricing

customer-discount.json

volume-discount.json

eligibility

loan-qualification.json

README.md

Meaningful commits

git commit -m "Add enterprise tier discount (20% for orders > $10k)"

Review diffs

JDM’s JSON format makes diffs readable:

  "rules": [
    {
      "inputEntries": [{ "value": "\"gold\"" }],
-     "outputEntries": [{ "value": "0.15" }]
+     "outputEntries": [{ "value": "0.20" }]
    }
  ]

Exporting from BRMS

The GoRules BRMS exports decisions in JDM format:

Open the decision in BRMS
Click Export in the toolbar
Choose JSON Decision Model (.json)
Save to your repository

Schema reference

The complete JSON Schema for JDM files is available in the zen repository.

Overview

AI & Tools

Deployment

Platform Guides

SDKs

Big Data

JDM

Why JDM?

File structure

Nodes

Edges

Metadata

Loading JDM files

Validating structure

Version control best practices

File organization

Meaningful commits

Review diffs

Exporting from BRMS

Schema reference

​Why JDM?

​File structure

​Nodes

​Edges

​Metadata

​Loading JDM files

​Validating structure

​Version control best practices

​File organization

​Meaningful commits

​Review diffs

​Exporting from BRMS

​Schema reference

Why JDM?

File structure

Nodes

Edges

Metadata

Loading JDM files

Validating structure

Version control best practices

File organization

Meaningful commits

Review diffs

Exporting from BRMS

Schema reference