BRE Debugger

The SanteDB debugger is a tool that allows developers to interactively debug business rules, and clinical protocols before pushing these changes to a production or staging environment.

Command Line Options

Tool: sdb-dbg.exe

The following parameters are supported by the SanteDB debugger

Option	Description	Example
source	Source code file(s) for debugging	--source=myrule.js
workDir	Working directory for the debugger	--workDir=C:\users\myuser\sources
db	Attached sqlite database for loading / inserting data operations	--db=%localppdata%\sdbare\santedb.sqlite
config	Attached configuration file for debugging	--config=C:\temp\santedb.config
ref	Loads rules and script files from the referenced PAK file	--ref=org.santedb.core.sln.pak
bre	Launches the debugger in BusinessRules mode (debug JavaScript rules)	--bre
xprot	Launches the debugger in ClinicalProtocol mode (debug XProtocol files)	--xprot

Debug Shell

The debug shell provides basic common commands as well as debugger specific commands (for JavaScript or XProtocol).

Command	Name
cd	Change Directory
sn	Scope to Null
clear	Clear Screen
ds	Dump Scope
dj	Dump Scope JSON
dv	Dump Scope View Model
dx	Dump Scope XML
xs	Exchange Scope
q	Quit
?	Show Help
dbi	Database Insert
lds	List Data Services
ls	List Directory
ofs	Output Full Stack
pdq	Print Data Query
pwd	Print Working Directory
ss	Set Scope
sd	Set Scope - Database Object
sdq	Set Scope - Database Query
sfv	Set Scope - View Model File
sfj	Set Scope - JSON File
sfx	Set Scope - XML File

cd - Change Directory

Changes the working directory Example: cd C:\sources

sn - Scope to null

Sets the current scope to NULL

clear - Clear Screen

Clears the current screen

ds - Dump Scope

Dumps the current scope to the screen in .NET format

Parameters

• [path] - The object property path to be dumped

Example: Dump Scope

dbg >ds
Type: SanteDB.Core.Model.Roles.Patient
Asm:  SanteDB.Core.Model, Version=1.0.0.22772, Culture=neutral, PublicKeyToken=null
Str:  Patient (K:, V:)
Addresses                 List`1                    System.Collections.Generic.List`1[OpenIZ.Core.Model.Entities.EntityAddress]
AsSecurityUser            SecurityUser              null
ClassConcept              Concept                   null
ClassConceptKey           Nullable`1                bacd9c6f-3fa9-481e-9636-37457962804d

Example: Dump Scope with Path

dbg >ds DateOfBirth
Type: SanteDB.Core.Model.Roles.Patient
Asm:  SanteDB.Core.Model, Version=1.0.0.22772, Culture=neutral, PublicKeyToken=null
Str:  Patient (K:, V:)
Path: DateOfBirth
5/22/1986 12:00:00 AM

dj - Dump JSON

Dumps the current scope object to HDSI JSON format

Parameters

• [path] - The object property path to be dumped

Example: Dump Scope as JSON

dbg >dj
{
  "dateOfBirth": "1986-05-22",
  "language": [],
  "classConcept": "bacd9c6f-3fa9-481e-9636-37457962804d",
  "determinerConcept": "f29f08de-78a7-4a5e-aeaf-7b545ba19a09",
  "relationship": [],
  "$type": "Patient"
}

dv - Dump View Model

Dumps the current scope object as ViewModel format

Remarks: This command is useful when debugging data which is being sent to the view model in the AngularJS controllers

Example: Dump Scope as ViewModel

dbg >dv
{
  "$type": "Patient",
  "$id": "obj0",
  "dateOfBirth": "1986-05-22",
  "address": {},
  "identifier": {},
  "name": {},
  "relationship": {},
  "telecom": {},
  "creationTimeModel": "0001-01-01T00:00:00+00:00"
}

dx - Dump XML

Dumps the current scope object as IMSI XML format

Parameters:

• [path] - The path within the object which should be dumped to screen

Example: Dump Scope as XML

dbg >dx
<Patient xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://santedb.org/model">
  <version xsi:nil="true" />
  <sequence xsi:nil="true" />
  <classConcept>bacd9c6f-3fa9-481e-9636-37457962804d</classConcept>
  <determinerConcept>f29f08de-78a7-4a5e-aeaf-7b545ba19a09</determinerConcept>
  <statusConcept xsi:nil="true" />
  <dateOfBirth>1986-05-22</dateOfBirth>
  <genderConcept xsi:nil="true" />
</Patient>

xs - Exchange Scope

Exchanges the scope for a child element of the current scope.

Parameters:

• [path] - The path within the current scope object to exchange the debugging scope with

Example: Exchange Scope for Array Item

Sets scope to a query then exchanges scope to first search result:

dbg >ds
Type: System.Collections.Generic.List`1[[SanteDB.Core.Model.Roles.Patient, OpenIZ.Core.Model, Version=1.0.0.22772, Culture=neutral, PublicKeyToken=null]]
Asm:  mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
Str:  System.Collections.Generic.List`1[SanteDB.Core.Model.Roles.Patient]
Count:10
[0] Patient (K:16f27afe-4966-4c85-956c-90dfaba62446, V:bf3deb9e-29e9-4146-8ada-4ba7871d12e6)
[1] Patient (K:55080b7a-3da6-4992-96bb-a6d20bf17b13, V:be2396ec-1786-46f3-8beb-8f203bae3941)
[2] Patient (K:e45fcadf-e3af-43e7-953e-4a8125f2d6a0, V:0fc264e5-addd-4103-9c40-d23f2d9f703b)
[3] Patient (K:df5dde4a-a33b-4abe-95fd-63d58e1b96f0, V:6b10fb8c-295f-4f6e-b11b-48e40198c935)
[4] Patient (K:be6420ac-6ba8-4faa-98f6-7d9efdcd04a0, V:1c0749f3-bcdf-42af-a36a-03f702adc336)
[5] Patient (K:7f649985-0d97-4d04-a6a1-502c67c35327, V:ed255f0a-8617-4639-a4af-de3e272bb862)
[6] Patient (K:8289fa5e-7c08-4075-9a91-8e79bebaca3f, V:88965abd-32b8-4b29-8d4d-060417c6187e)
[7] Patient (K:cd1c6592-fec0-4a7b-ab0a-4ca51fce801c, V:c8d267cf-9845-4a8c-a6fd-1563ab204971)
[8] Patient (K:10abe6c3-22d5-4804-9090-164098a1eb65, V:27a04a6c-96ef-4b95-aac3-d43efa810485)
[9] Patient (K:f82e9145-2aa0-416a-bbda-41656b7e8eff, V:5044a736-5c07-439c-8f17-5d04d3460dac)
dbg >xs [0]
Path: [0]
dbg >ds
Type: SanteDB.Core.Model.Roles.Patient
Asm:  SanteDB.Core.Model, Version=1.0.0.22772, Culture=neutral, PublicKeyToken=null

q - Quit

Exits the debugger

? - Show Help

Shows a complete list of commands for the current debugger

dbi - Database Insert

Inserts the current scope object into the database, setting the scope variable to the inserted instance.

lds - List Data Services

Lists all loaded services in the debugger environment

ls - List Directory

Lists the current working directory contents

Parameters:

• [dir] - The subdirectory to list contents of

ofs - Output Full Stack

Output full stack traces instead of the summarized stack traces.

pdq - Print Data Query

Executes a database query against the attached database, however does not set the scope.

Remarks: This is useful when you want to query the database but do not want to set the scope (i.e. finding a record you will later set the scope to)

Parameters

• [type] - The type of resource being queried

• [qry] - The HDSI format query to be executed

• [skip] - Skips the number of records

• [take] - Takes the specified number of records from the dataset

• [path] - The sub-path within the query result to show

Valid Uses:

• pdq [type] [qry] - Simple query

• pdq [type] [qry] [path] - Simple query, printing path

• pdq [type] [qry] [skip] [take] - Query with result control limits

• pdq [type] [qry] [skip] [take] [path] - Query with control limits, output selected path

Example: Query for patients with name Justin and show the first result's address

dbg >pdq Patient name.component.value=Justin [0].Addresses
INF: Patient where o => o.Names.Any(name => name.Component.Any(component => (component.Value == "Justin"))) (0..)
Path: [0].Addresses
Count:1
[0] SanteDB.Core.Model.Entities.EntityAddress

pwd - Print Working Directory

Prints the current working directory to the screen.

ss - Set Scope

Sets the scope to the specified simple object

Parameters:

• [scope] - The simple object to set to scope

• [type] - The type of resource to set scope to

• [data] - The JSON formatted data to set the typed scope to (can only be used with type)

Valid Uses:

• ss [scope] - Simple Data

• ss [type] [data] - Complex data from JSON

Example: Set scope to 'hello world!'

dbg >ss 'Hello World!'
dbg >ds
Type: System.String
Asm:  mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
Str:  Hello World!
Hello World!

Example: Set scope to a patient with date of birth of March 1, 2017

dbg >ss Patient '{"dateOfBirth":"2018-03-17"}'
dbg >ds
Type: SanteDB.Core.Model.Roles.Patient
Asm:  SanteDB.Core.Model, Version=1.0.0.22772, Culture=neutral, PublicKeyToken=null
Str:  Patient (K:, V:)
Addresses                 List`1                    System.Collections.Generic.List`1[OpenIZ.Core.Model.Entities.EntityAddress]
AsSecurityUser            SecurityUser              null
ClassConcept              Concept                   null
ClassConceptKey           Nullable`1                bacd9c6f-3fa9-481e-9636-37457962804d
CreatedBy                 SecurityUser              null
CreatedByKey              Nullable`1                null
CreationAct               Act                       null
CreationActKey            Nullable`1                null
CreationTime              DateTimeOffset            1/1/0001 12:00:00 AM +00:00
CreationTimeXml           String                    null
DateOfBirth               Nullable`1                3/17/2018 12:00:00 AM

sd - Set Database Scope

Sets the current scope from the specified database object.

Remarks: This command is useful when reproducing bugs with a known patient identifier.

Parameters:

• [type] - The resource type of data to load

• [id] - The identifier of the data to be loaded

Example: Load patient with ID be6420ac-6ba8-4faa-98f6-7d9efdcd04a0 to scope

dbg >sd Patient be6420ac-6ba8-4faa-98f6-7d9efdcd04a0
dbg >ds
Type: SanteDB.Core.Model.Roles.Patient
Asm:  SanteDB.Core.Model, Version=1.0.0.22772, Culture=neutral, PublicKeyToken=null
Str:  Patient (K:be6420ac-6ba8-4faa-98f6-7d9efdcd04a0, V:1c0749f3-bcdf-42af-a36a-03f702adc336)
...

sdq - Set Database Scope Query

Sets the current scope to the result of a query with optional controls

Remarks: This operation is useful when you don't know the key of the data in a database to reproduce an issue, however you know attributes of the data.

Parameters:

• [type] - The type of data to be queried

• [qry] - The query to be executed

• [skip] - The number of results to skip in the result set

• [take] - The number of results to take

Valid Uses:

• sdq [type] [qry] - Set scope to results of query

• sdq [type] [qry] [skip] [take] - Set scope to results of query with result control

Example: Set scope to all Patients having an external identifier of 1234567890

dbg >sdq Patient identifier.value=1234567890
INF: Patient where o => o.Identifiers.Any(identifier => (identifier.Value == "1234567890")) (0..)
INF: 1 set to scope

Example: Set scope to first 10 patients with name containing 'a'*

dbg >sdq Patient name.component.value=~*a* 0 10
INF: Patient where o => o.Names.Any(name => name.Component.Any(component => (component.Value.Contains("*a*") == True))) (0..10)
INF: 15 result (0..10 set to scope)

sfv - Set File (View Model)

Sets the current scope to the contents of a JSON file formatted in ViewModel format

Parameters:

• [type] - The type of data the JSON View Model file contains

• [file] - The name of the file to load

sfj - Set File JSON

Sets the current scope to the contents of a IMSI JSON file.

Remarks: The JSON file must carry a valid "$type" property.

Parameters:

• [file] - The file to be loaded

sfx - Set File XML

Sets the current scope to the contents of an IMSI XML file

Parameters:

• [type] - The type of resource the file contains

• [file] - The path to the XML file to load