Comment on page
Installing the dCDR SDK
In order to start writing your own applets you're going to need the following environment setup:
- Linux / Mac Environments:
- Mono Framework (if running on MacOS or Linux)
- Chrome or Edge are recommended for debugging
- Optional: Setup a iCDR Server Instance
Installation on Windows Environments requires running the packaged Windows installer which will install the necessary files into
C:\Program Files\SanteSuite\SDK. You can launch a command prompt with this location on your path using the start menu shortcut.
sudo apt install mono-complete
The software requires at least mono version 5.x , so after installation you can run
mono --versionto obtain the version code:
$ mono --version
Mono JIT compiler version 126.96.36.199 (tarball Fri Sep 4 14:01:23 UTC 2020)
Copyright (C) 2002-2014 Novell, Inc, Xamarin Inc and Contributors. www.mono-project.com
GC: sgen (concurrent by default)
After the mono project is installed, you can extract the provided tarball to a directory of convenience (like /opt/santedb-sdk or /usr/local/santedb-sdk). All commands in this tutorial on Linux should be prefixed with mono, so for example:
mono /opt/santedb-sdk/sdb-ade.exe --help
Next, you'll need to configure the SDK to use a server endpoint. This endpoint is the iCDR to which your dCDR will connect. There are a variety of ways you can connect to the iCDR (such as offline mode, etc.) however we'll connect the SDK using online mode only. This means that your SDK environment will need to be connected to the internet and have contact with the remote server to function.
We'll use the elbonia.santesuite.net server for our debugging. First we should launch the sdb-ade command which is the debugging tool for the dCDR:
If you want to debug the core applets you can clone the https://github.com/santedb/applets directory and reference the solution file santedb.admin.sln.xml with --ref=<path-to-applets>/santedb.admin.sln.xml
If successful you should see the initial configuration window.
If you have a local iCDR server you would enter the details for this server now, for the Elbonia MPI the settings are:
- address => elbonia.santesuite.net
- Port => 8443
- Use TLS => True
Upon clicking the join button you'll be prompted to enter the credentials of the user which is joining your dCDR device to the domain:
For the demonstration server you can use demoadmin/@Elbonia123 .
If successful, you should receive a welcome message to the domain. You will then need to select a role, normally, when deploying the dCDR, this setting indicates the user interface and plugins that the client should download. For the SDK these settings are ignored.
After selecting the role, you must configure the synchronization settings. Using "Online Only" will allow you to get an SDK environment setup quickly that mimics the web portal installation.
There are currently known issues with the Synchronized mode setup with some community plugins (namely the reading of custom synchronization subscriptions). It is recommended, for now, using Online Only option for development.
You can continue setup by accepting the defaults for the other pages. Some configuration notes:
- Turn down logging to Errors and Warnings if you value your sanity (and you want performance similar to production)
- You can turn off optimization if you receive errors about GZIP CRC checksums (there is a known issue certain server middleware)
Upon completion you will be instructed to restart the application host. This is done by pressing CTRL+C in the sdb-ade window and restarting it.