CSPro ⇄ JSON Conversions: Document Object

A CSPro Document object is represented as a JSON object with "metadata" and "content" properties. Based on JSON serialization options—defined as an application property or dynamically—the value of the logic object or dictionary item can be serialized either as a data URL or as a localhost URL.

When using Document.getJson on a Document specified as a dictionary item, additional properties, "item" and "occurrences", give information about the dictionary item's properties as well as details about the item's occurrences.

For example, serializing a Document dictionary item, CHEST_XRAY, to JSON using the default way of representing the binary data as a localhost URL, may look like:

CHEST_XRAY.getJson()	CHEST_XRAY.getValueJson()
{ "name": "CHEST_XRAY", "type": "Document", "item": { "name": "CHEST_XRAY", "labels": [ { "text": "Chest X-ray" } ], "contentType": "Document", "start": 5, "length": 1 }, "occurrences": { "record": 1, "item": 1 }, "value": { "metadata": { "filename": "85-43-44-hans-stueben-chest.dcm" }, "content": { "url": "http://localhost:59787/vf/1/85-43-44-hans-stueben-chest.dcm" } } }	{ "metadata": { "filename": "85-43-44-hans-stueben-chest.dcm" }, "content": { "url": "http://localhost:59787/vf/1/85-43-44-hans-stueben-chest.dcm" } }

To modify a Document's value from JSON using Document.setValueFromJson, CSPro can parse binary data as a data URL or can read a file from the disk. An exception occurs if the value is not defined properly. For more information, see details on how to specify binary data for JSON deserialization.