Getting started

You can try the Aidbox Forms module, edit test forms, create new ones, see how the data will be saved to the database and extracted, for this you need to run Getting started. At the same time, you can run Getting started.

Run Aidbox Forms in Aidbox Sandbox

Create a license on Aidbox portal

• Sign up on Aidbox portal
• Create a license: licence typeproductionordevelopment, hostingin Cloud (for free)

Start playing with Aidbox Forms

• Go to Aidbox portal, find your license in the "Personal project licenses" list. Click on your new license and navigate to the "URL" link in the "Hosting" box.
• Press the button Forms in the Aidbox console in browser
• Play with forms

Run Aidbox Forms locally

Create a license on Aidbox portal

• Sign up on Aidbox portal
• Create a license: licence typedevelopment, hostingselfhosted
• Copy and save a license key

Configure Aidbox project

1. You need to have the following software installed:

• docker
• dockercompose
• text editor with color highlighting (recommended VSCode editor with zenlsp plugin)
• any modern webbrowser
• git
• make
• npm

2\. Run Aidbox locally

3\. Clone aidbox-zen-sdc repository

4\. Configure project with a license. You need to create .env file in the root of repository (by copying from .env.tpl) and update AIDBOX\_LICENSE with the generated license key that you saved

5\. Run make init to initialize project

6\. Run in the terminal make up in the root of repository

7\. Open Aidbox console in browser http://localhost:8080/ , using login / password - admin / password

8\. Go to forms by pressing the button Forms (or by visiting http://localhost:8080/ui/sdc )

9\. To finish development you can run make down to shutdown all services.

Start form designing

You have three options how to design form

• Design form locally (in your familiar editor)deprecated
• Design form in Aidbox Code Editor (in browser)deprecated
• Design form in Aidbox UI Builder

Enable Audit log

Aidbox Forms support Audit.

To enable Audit logging with Aidbox project, edit the zrc/sdc-box.edn file:

Find the following code:

 box
 {:zen/tags #{aidbox/system}
  :zen/desc "test server"
  :config   config
  :services {:seed-fixtures seed-fixtures
             :seed-questionnaires seed-questionnaires
             :sdc sdc-service}}

Add the following pair:

  :audit {:storage "AuditEvent"}

So the result is

 box
 {:zen/tags #{aidbox/system}
  :zen/desc "test server"
  :config   config
  :audit {:storage "AuditEvent"}
  :services {:seed-fixtures seed-fixtures
             :seed-questionnaires seed-questionnaires
             :sdc sdc-service}}

Restart Aidbox. Aidbox will start recording audit logs and you can see them in the Audit log viewer or access via FHIR API.

Learn more about Audit logs:

Disable SDC operations

In case you have conflicts with your own implementation, you can easily disable SDC operations by setting environment variable:

AIDBOX_SDC_ENABLED=false