Resources for configuration and management Aidbox SDC module.

Overview

SDC module includes the following resource types:

  • QuestionnaireTheme
  • SDCAddendum
  • SDCConfig
  • SDCDocument
  • SDCFormMetadata
  • SDCFormVersion
  • SDCPrintTemplate
  • SDCWorkflow
  • SDCWorkflowVersion

QuestionnaireTheme

Path Card. Type Description
background0..1Background styles
background.main-color0..1stringMain background color (RBG hex)
background.form-color0..1stringBackground color for form (RBG hex)
background.toolbar-color0..1stringBackground color for toolbar that displays below the form (with submit button) (RGB hex)
base-font-size0..1numberMinimal text size (px)
brand-image0..1Brand images
brand-image.top-right0..1
brand-image.top-right.url0..1stringWeb link to top-right image
brand-image.bottom-left0..1
brand-image.bottom-left.url0..1stringWeb link to bottom-left image
button0..1Button styles
button.amend-text-color0..1string
button.print-color0..1stringBackground color for "Print" button
button._amend-text0..1Object
button._submit-text0..1Object
button.redirect-color0..1stringBackground color for "Save & Close" button
button._redirect-text0..1Object
button.submit-text0..1string
button.print-text-color0..1stringText color for "Print" button
button.print-text0..1string
button.redirect-text-color0..1stringText color for "Save & Close" button
button._print-text0..1Object
button.amend-color0..1string
button.text-color0..1string
button.submit-color0..1stringBackground color for "Submit" button
button.redirect-text0..1string
button.amend-text0..1string
button.submit-text-color0..1stringText color for "Submit" button
button.accent-color0..1stringBackground color for filled buttons border color for outlined buttons (deprecated)
font-family0..1stringFont-Family

Allowed values: Product Sans | Metropolis | Inter

input0..1Input styles
input.accent-color0..1stringMain color for inputs (border color for text inputs background for checkbox etc in RGB hex)
input.text-color0..1stringtext color (RGB hex)
input.background-color0..1stringBackground color (RGB hex)
input.font-size0..1numberInput font size (px)
language0..1codeTheme Language
main-color0..1stringMain Accent color (RBG hex)
theme-name0..1stringTheme Title

SDCAddendum

Addednum Resource. Contains additional information abount SDCDocument/SDCWorkflow

Path Card. Type Description
date1..1dateTime
target1..1
target.id0..1string
target.resourceType0..1string
target.display0..1string
type1..1string
user1..1
user.id0..1string
user.resourceType0..1string
user.display0..1string

SDCConfig

Path Card. Type Description
builder0..1
builder.hide-extraction0..1booleanHide extraction tab in debug instruments
builder.highlight-download-button0..1booleanHighlight download button in the builder's debugger panel
builder.translation-languages0..*stringList of languages that will be used for translation
builder.hide-back-button0..1booleanHide back button in builder
builder.hide-save0..1booleanHide save button
builder.hide-publish0..1booleanHide Publish button in builder
builder.collapse-debugger0..1booleanCollapse debugger by default in builder
builder.disable-submit-button0..1booleanDisable submit button in the builder's form preview footer
builder.hide-add-theme0..1booleanHide add theme button
builder.disable-use-blank-form0..1booleanDisable initializing the builder with a sample form when no form is provided
builder.enable-share0..1booleanMake share button visible in the builder and enable accepting a serialized questionnaire from query param
builder.hide-population0..1booleanHide population tab in debug instruments
builder.custom-renderers0..*MapCustom renderers that can be used to preview form in Form Builder
builder.custom-renderers.name0..1stringWebcomponent tag name
builder.custom-renderers.source0..1urlWebcomponent source url
builder.custom-renderers.title0..1stringTitle in Builder
builder.custom-renderers.default0..1booleanIf this default renderer for form preview
builder.hide-save-theme0..1booleanHide save theme
builder.disable-save0..1booleanDisable save
builder.disable-publish0..1booleanDisable publish button
builder.form-url-prefix0..1urlURL prefix that used in url generation of new forms
builder.disable-load-fhir-version0..1booleanDisable loading of FHIR version from the server. Deprecated: not used anymore and has no effect
builder.hide-edit-theme0..1booleanHide edit theme button
data-store0..1
data-store.endpoint0..1urlFHIR Server that will be used for storing/getting reponses populate data from and extract to (if not set - use Aidbox)
data-store.headers0..1ObjectHeaders (with credentials) for accessing Service (optional)
default0..1booleanSet's config as default for system/tenant
description0..1stringHuman readable config description
form0..1
form.app-name0..1stringApp name that will be mentioned in AuditEvent logs
form.hide-print-button0..1booleanHide print button from the form
form.enable-amend-button0..1booleanEnable amend button
form.read-only0..1booleanShould form be read-only
form.hide-language-selector0..1booleanHide language selector in the builder
form.hide-footer0..1booleanHide the footer in the renderer altogether
form.default-max-width0..1stringDefault max width of the form
form.hide-download-attachment-button0..1booleanHide download button in attachment widget
form.non-sticky-footer0..1booleanNon-sticky footer in the form
form.redirect-on-save0..1urlRedirect URI that used on form save/close button
form.redirect-on-submit0..1urlRedirect URI that used on form sign/amend
form.enable-save-button0..1booleanEnable close button
form.hide-title0..1booleanHide title in the form
form-store0..1
form-store.endpoint0..1urlFHIR Server that will be used for storing/getting Questionnaire (if not set - use Aidbox)
form-store.headers0..1ObjectHeaders with credentials (optional)
language0..1codeDefault language for UI
name1..1stringMachine readable config name
storage0..1Link to storage to store attachments
storage.account0..1ReferenceStorage Account

Allowed references: AwsAccount, GcpServiceAccount, AzureContainer

storage.bucket0..1stringStorage bucket (required for GCP and S3)
term-server0..1
term-server.endpoint0..1urlFHIR Server that stores Terminology (ValueSet/expand$) (if not set - use Aidbox)
term-server.headers0..1ObjectHeaders (with credentials) for accessing Service (optional)
theme0..1ReferenceDefault theme

Allowed references: QuestionnaireTheme

translations0..1ObjectCustom translations strings for UI

SDCDocument

Base schema for questionnaire(document) definition. Also a resource in DB - SDCDocument

Path Card. Type Description
author0..1Reference to user which create document
author.id0..1string
author.resourceType0..1string
author.display0..1string
based-on0..1Request led to creation of this Document
based-on.id0..1string
based-on.resourceType0..1string
based-on.display0..1string
encounter0..1Reference to encounter
encounter.id0..1string
encounter.resourceType0..1string
encounter.display0..1string
form1..1
form.form0..1stringFull name of form, with which document was captured
form.version0..1numberUsed Form version
patient0..1The subject of the question
patient.id0..1string
patient.resourceType0..1string
patient.display0..1string
source0..1The person who answered the questions
source.id0..1string
source.resourceType0..1string
source.display0..1string
status0..1stringStatus of the document

Allowed values: draft | in-progress | canceled | completed | in-amendment | amended

type0..1stringName/version of form, with which document was captured
unit-system0..1stringWhat unit system was used in this document at launch

SDCFormMetadata

Path Card. Type Description
properties0..1Object

SDCFormVersion

Form Metadata that can be used for Dynamic updates

Path Card. Type Description
form0..1string
hash0..1numberHash of snapshot with injected document/layout/rules
snapshot0..1string
version0..1numberIncremental number of form version.

SDCPrintTemplate

Path Card. Type Description
content0..1stringTemplate for SDC print

SDCWorkflow

Path Card. Type Description
cancel-reason0..1stringDefine why workfow is canceled
ctx0..1Workflow context, which can be used from tasks as well
ctx.encounter0..1
ctx.encounter.id0..1string
ctx.encounter.resourceType0..1string
ctx.encounter.display0..1string
ctx.patient0..1
ctx.patient.id0..1string
ctx.patient.resourceType0..1string
ctx.patient.display0..1string
ctx.user0..1
ctx.user.id0..1string
ctx.user.resourceType0..1string
ctx.user.display0..1string
items0..1ObjectWorkflow items
order0..*stringOrder of items (array of item keys)
params0..1ObjectWorkflow params schema definition
status0..1stringStatus of WF lifecycle. Should be changed via rpc: `cancel-wf`, `complete-wf` `cancel-task`, `complete-task`

Allowed values: new | in-progress | canceled | completed | in-amendment | amended

title0..1stringTitle of the workflow
version0..1numberWorkflow version
workflow0..1stringWorkflow symbolic name for storing in DB

SDCWorkflowVersion

Snapshotted workflow template with incremental versioning.

Path Card. Type Description
hash1..1numberHash of snapshot with injected document/layout/rules
snapshot1..1string
version1..1numberIncremental number of workflow version.
workflow1..1string

Last updated 2025-08-19T13:51:26Z