Profiling with zen-lang

Aidbox supports an alternative yet very powerful profile validation mechanism powered by Zen language. You can just define a set (or multiple sets) of validation profiles in EDN format and let your Aidbox server know its location. Zen-lang allows Aidbox to validate resources against schemas. It can validate individual properties as well as large profiles in a composable way
Enable zen profiling in Aidbox
1.Add environment variables to the docker-compose.yaml
Env name
Sample value
Description
AIDBOX_ZEN_PATHS
url:zip:<url to zen project>
Use released project from zen-lang/fhir repo​
AIDBOX_ZEN_PATHS
path:zip:<file system path>
Mount a Zen FHIR NPM package with precompiled IGs or a custom zen project
AIDBOX_ZEN_ENTRYPOINT
hl7-fhir-us-davinci-pdex-plan-net
Main zen namespace of an IG
 2. Start Aidbox with the docker-compose
StructureDefinitions and inlined terminologies are created during startup. 
Resource examples and External (not-present) terminologies are not loaded in the storage by default
 3. Validate resources 
Use FHIR $validate operation or a CRUD request with profile URL specified in .meta.profile or in .profile query URL parameter.
Validation modes supported with zen schemas
For validation (e.g. in FHIR CRUD API) Aidbox uses zen schemas tagged with zen.fhir/base-schema or zen.fhir/profile-schema
Schemas with these tags must have :zen.fhir/type and :zen.fhir/profileUri keys specified
zen.fhir/base-schema
Schemas tagged with zen.fhir/base-schema are used to validate every resource of their type. When loaded into Aidbox such schema will be used instead of default json schema validation
zen.fhir/profile-schema
Schemas tagged with zen.fhir/profile-schema are used to validate resources that mention their :zen.fhir/profileUri in the meta.profile attribute
Zen FHIR packages
Aidbox team created an open-source tool to generate Zen FHIR packages from FHIR packages
It is distributed as a jar file available here 
Zen FHIR  package is an Aidbox project saved into zip archive
Zen FHIR Packages require AIDBOX_CORRECT_AIDBOX_FORMAT environment variable to be declared
Use Zen FHIR packages
You can enable Zen FHIR packages that contain FHIR profiles of the following implementation guides:
FHIR R4
hl7-fhir-us-core - US Core
hl7-fhir-us-davinci-pdex - Payer Data Exchange (PDex)
hl7-fhir-us-davinci-pdex-plan-net - PDEX Payer Network
hl7-fhir-us-davinci-hrex - The Da Vinci Payer Health Record exchange (HRex)
hl7-fhir-us-davinci-drug-formulary - DaVinci Payer Data Exchange US Drug Formulary
hl7-fhir-us-carin-bb - CARIN Consumer Directed Payer Data Exchange (CARIN IG for Blue Button®)
hl7-fhir-us-mcode - mCODE™ (short for Minimal Common Oncology Data Elements)
FHIR STU 3
nictiz-fhir-nl-stu3-zib2017 - Nictiz NL, including MedMij and HL7 NL
Zen FHIR packages are distributed as npm packages or as zen-lang standalone Aidbox projects
Existing Zen FHIR packages are available as:
​npm FHIR R4 
​npm FHIR STU 3​
​standalone Aidbox projects​
Example configuration
1
AIDBOX_CORRECT_AIDBOX_FORMAT=true
2
AIDBOX_ZEN_PATHS="url:zip:https://github.com/zen-lang/fhir/releases/latest/download/hl7-fhir-us-core.zip
3
                 ,url:zip:https://github.com/zen-lang/fhir/releases/latest/download/hl7-fhir-us-carin-bb.zip
4
                 ,url:zip:https://github.com/zen-lang/fhir/releases/latest/download/hl7-fhir-us-davinci-pdex.zip
5
                 ,url:zip:https://github.com/zen-lang/fhir/releases/latest/download/hl7-fhir-us-davinci-drug-formulary.zip
6
                 ,url:zip:https://github.com/zen-lang/fhir/releases/latest/download/hl7-fhir-us-davinci-pdex-plan-net.zip"
7
AIDBOX_ZEN_LOAD="{ns project
8
                  import #{hl7-fhir-us-core
9
                           hl7-fhir-us-carin-bb
10
                           hl7-fhir-us-davinci-pdex
11
                           hl7-fhir-us-davinci-drug-formulary
12
                           hl7-fhir-us-davinci-pdex-plan-net}}"
13
AIDBOX_ZEN_ENTRYPOINT=project
Copied!
Convert custom FHIR profiles to Zen FHIR package
Using this tool you can generate zen-lang schemas and use them in your Aidbox projects.
Create custom Zen FHIR package based on existing Zen FHIR packages
You can use existing Zen FHIR packages as a foundation for your custom Zen FHIR package. Check out Profiling with Zen-lang guide.