OnePacs Workstation for macOS allows you to synchronize your DICOM nodes list and shared databases list with a shared document, by specifying this document's URL. The app will periodically access the URL and update the nodes lists to match the items listed in the retrieved document.
These shared documents must be in the PLIST format, and must be structured in a specific way. PLIST documents can be edited using Apple's Plist Editor software and other third party editors. PLIST files have two declinations: a binary storage version and an XML-based storage version. The app supports both. You may create a PLIST manually using any raw text editor, as long as you respect the expected PLIST XML syntax. Also, you may generate the PLIST dynamically, using your favorite scripting language.
At the root of the PLIST document, the app expects to find an array of dictionaries. Every dictionary represents a network node. The content of the dictionaries varies depending on the document.
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <array> <dict>...</dict> <dict>...</dict> </array> </plist>
DICOM Nodes List
In the DICOM nodes list, the dictionary items must contain the following key-values:
- AETitle – a string;
- Address – a string, either an IP or a host;
- Port – the node DICOM port, an integer;
- Description – a string;
- QR – a boolean representing whether or not this node should be queried;
- Send – a boolean representing whether or not this node should be sent datasets;
- Transfer Syntax – an integer value representing the preferred transfer syntax:
- 0 – Explicit Little Endian;
- 1 – Implicit Little Endian Only;
- 2 – JPEG 2000 Lossless;
- 3 – JPEG 2000 Lossy, good quality;
- 4 – JPEG 2000 Lossy, medium quality;
- 5 – JPEG 2000 Lossy, low quality;
- 6 – JPEG Lossless;
- 7 – JPEG 2000 Lossy, good quality;
- 8 – JPEG 2000 Lossy, medium quality;
- 9 – JPEG 2000 Lossy, low quality;
- 10 – RLE;
- 11 – JPEG LS Lossless;
- 12 – JPEG LS Lossy, good quality;
- 13 – JPEG LS Lossy, medium quality;
- 14 – JPEG LS Lossy, low quality.
In PLIST XML, a node would be described as follows:
<dict> <key>AETitle</key> <string>SAMPLE_AET</string> <key>Address</key> <string>sample.local</string> <key>Port</key> <integer>11121</integer> <key>Description</key> <string>This is a sample DICOM node</string> <key>QR</key> <true/> <key>Send</key> <false/> <key>Transfer Syntax</key> <integer>2</integer> </dict>
Shared Databases List
In the shared databases list, the dictionary items must contain the following key-values:
- Address – a string, either an IP or a host;
- Port – the node database sharing port, an integer;
- Description – a string;
In PLIST XML, a node would be described as follows:
<dict> <key>Address</key> <string>sample.local</string> <key>Port</key> <integer>15781</integer> <key>Description</key> <string>This is a sample database sharing node</string> </dict>