Polaris Core AppState Profile

Overview

The Polaris Core AppState profile represents application state and settings data within the Polaris ecosystem. Based on the FHIR Basic resource and following the SMART App Launch state persistence pattern, this profile enables external applications, integrations, and apps to store and retrieve configuration data, user preferences, and application-specific state information in the FHIR repository.

Key Features

• Namespaced State Management: Application-specific namespaces prevent conflicts
• Type-Safe Values: Supports string, boolean, and extensible value types
• Resource Association: Links state to specific FHIR resources (Patient, Organization, etc.)
• Standards-Based: Follows SMART App Launch v2.2.0 state persistence patterns
• Flexible Storage: Accommodates various application state requirements

Purpose and Use Cases

The AppState profile supports:

• User Preferences: Storing application-specific user settings
• Session State: Maintaining state across application sessions
• Configuration Data: Application configuration parameters
• Integration Settings: External system connection preferences
• Workflow State: Tracking multi-step process states
• Feature Flags: Application feature toggles and controls

State Management Pattern

AppState follows a structured pattern:

1. Namespace: Application-specific CodeSystem URL identifies the app
2. Type Code: Specific state type within the application namespace
3. Subject: The FHIR resource the state is associated with
4. Value: The actual state data (string, boolean, etc.)

Application Namespacing

Each application uses its own namespace:

• Pattern: https://fhir.apps.health/CodeSystem/[app-name]-app-state
• Prevents state conflicts between applications
• Enables easy filtering by application
• Supports multiple state types per application

Value Types

Currently supported value extensions:

• String Values: Text, JSON, XML, or any string data
• Boolean Values: True/false flags and toggles
• Future Extensions: Additional types can be added as needed

Clinical Integration

AppState enables:

• Personalized application experiences
• Workflow continuity across sessions
• User-specific display preferences
• Clinical decision support configurations
• Integration parameter storage

Security Considerations

Important aspects:

• State data should not contain PHI unless necessary
• Access controls follow subject resource permissions
• Applications should only access their namespaced state
• Sensitive configuration data should be encrypted

Relationships

AppState connects to:

• Patient: Patient-specific application settings
• PractitionerRole: Provider preferences and configurations
• Organization: Organization-wide application settings
• DocumentReference: Document-specific state
• Any FHIR Resource: Via subject reference

Implementation Guidelines

Best practices include:

• Use meaningful state type codes within namespaces
• Document state data structures for maintainability
• Implement cleanup for obsolete state data
• Version state schemas when structure changes
• Use appropriate value types for data

SMART App Launch Alignment

This profile aligns with:

• SMART App Launch v2.2.0 state persistence
• Experimental app state specifications
• Cross-platform state management patterns
• OAuth2 application contexts

Future Considerations

Potential enhancements being evaluated:

• Additional value types (decimal, date, complex)
• State versioning and migration support
• Bulk state operations
• State expiration and TTL
• Cross-application state sharing protocols
• State synchronization mechanisms

• Key Elements Table
• Differential Table
• Snapshot Table
• Statistics/References
• All

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Basic		0..*	Basic	Polaris App State Core
meta	Σ	0..1	Meta	Metadata about the resource
source	SΣ	0..1	uri	Identifies EMR instance & pipeline version the resource came from
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
text	S	0..1	Narrative	Narrative This profile does not constrain the narrative in regard to content, language, or traceability to data elements
extension	S	1..*	Extension	The actual state value(s) - can have an arbitrary number of state values
url	S	1..1	uri	Extension type URL
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier	SΣ	0..1	Identifier	Business identifier for app state
code	?!SΣ	1..1	CodeableConcept	Type and namespace of application state Binding: BasicResourceTypes (example): Codes for identifying types of resources not yet defined by FHIR.
coding	SΣC	1..1	Coding	Coded type of state Constraints: app-state-system-inv
system	SΣ	1..1	uri	Application-specific CodeSystem URL
code	SΣ	1..1	code	Specific state type code
display	SΣ	0..1	string	Human-readable state type name
text	SΣ	0..1	string	Plain text description of state type
subject	Σ	1..1	Reference(Polaris Patient Core | Polaris PractitionerRole Core | Polaris Organization Core)	Resource this state is associated with
reference	SΣC	0..1	string	Reference to the associated resource
type	SΣ	0..1	uri	Type of resource referenced Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model).
display	SΣ	0..1	string	Display name of referenced resource
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Basic.code	example	BasicResourceTypes http://hl7.org/fhir/ValueSet/basic-resource-type From the FHIR Standard
Basic.subject.type	extensible	ResourceType http://hl7.org/fhir/ValueSet/resource-types From the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
app-state-system-inv	error	Basic.code.coding	AppState coding.system must match Polaris CodeSystem URL rules. : system.matches('https://fhir.apps.health/CodeSystem/[a-zA-Z0-9.-]+-app-state')
dom-2	error	Basic	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Basic	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	Basic	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	Basic	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Basic	A resource should have narrative for robust management : text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both : extension.exists() != value.exists()

This structure is derived from Basic

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Basic		0..*	Basic	Polaris App State Core
meta
source	S	0..1	uri	Identifies EMR instance & pipeline version the resource came from
text	S	0..1	Narrative	Narrative
extension	S	1..*	Extension	The actual state value(s) - can have an arbitrary number of state values
url	S	1..1	uri	Extension type URL
identifier	S	0..1	Identifier	Business identifier for app state
code	S	1..1	CodeableConcept	Type and namespace of application state
coding	SC	1..1	Coding	Coded type of state Constraints: app-state-system-inv
system	S	1..1	uri	Application-specific CodeSystem URL
code	S	1..1	code	Specific state type code
display	S	0..1	string	Human-readable state type name
text	S	0..1	string	Plain text description of state type
subject		1..1	Reference(Polaris Patient Core | Polaris PractitionerRole Core | Polaris Organization Core)	Resource this state is associated with
reference	S	0..1	string	Reference to the associated resource
type	S	0..1	uri	Type of resource referenced
display	S	0..1	string	Display name of referenced resource
Documentation for this format

Constraints

Id	Grade	Path(s)	Details	Requirements
app-state-system-inv	error	Basic.code.coding	AppState coding.system must match Polaris CodeSystem URL rules. : system.matches('https://fhir.apps.health/CodeSystem/[a-zA-Z0-9.-]+-app-state')

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Basic		0..*	Basic	Polaris App State Core
id	Σ	0..1	id	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
versionId	Σ	0..1	id	Version specific identifier
lastUpdated	Σ	0..1	instant	When the resource version last changed
source	SΣ	0..1	uri	Identifies EMR instance & pipeline version the resource came from
profile	Σ	0..*	canonical(StructureDefinition)	Profiles this resource claims to conform to
security	Σ	0..*	Coding	Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
tag	Σ	0..*	Coding	Tags applied to this resource Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
language		0..1	code	Language of the resource content Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
text	S	0..1	Narrative	Narrative This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained		0..*	Resource	Contained, inline Resources
extension	S	1..*	Extension	The actual state value(s) - can have an arbitrary number of state values
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
url	S	1..1	uri	Extension type URL
value[x]		0..1		Value of extension
valueBase64Binary			base64Binary
valueBoolean			boolean
valueCanonical			canonical(Any)
valueCode			code
valueDate			date
valueDateTime			dateTime
valueDecimal			decimal
valueId			id
valueInstant			instant
valueInteger			integer
valueMarkdown			markdown
valueOid			oid
valuePositiveInt			positiveInt
valueString			string
valueTime			time
valueUnsignedInt			unsignedInt
valueUri			uri
valueUrl			url
valueUuid			uuid
valueAddress			Address
valueAge			Age
valueAnnotation			Annotation
valueAttachment			Attachment
valueCodeableConcept			CodeableConcept
valueCoding			Coding
valueContactPoint			ContactPoint
valueCount			Count
valueDistance			Distance
valueDuration			Duration
valueHumanName			HumanName
valueIdentifier			Identifier
valueMoney			Money
valuePeriod			Period
valueQuantity			Quantity
valueRange			Range
valueRatio			Ratio
valueReference			Reference(Any)
valueSampledData			SampledData
valueSignature			Signature
valueTiming			Timing
valueContactDetail			ContactDetail
valueContributor			Contributor
valueDataRequirement			DataRequirement
valueExpression			Expression
valueParameterDefinition			ParameterDefinition
valueRelatedArtifact			RelatedArtifact
valueTriggerDefinition			TriggerDefinition
valueUsageContext			UsageContext
valueDosage			Dosage
valueMeta			Meta
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier	SΣ	0..1	Identifier	Business identifier for app state
code	?!SΣ	1..1	CodeableConcept	Type and namespace of application state Binding: BasicResourceTypes (example): Codes for identifying types of resources not yet defined by FHIR.
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
coding	SΣC	1..1	Coding	Coded type of state Constraints: app-state-system-inv
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	SΣ	1..1	uri	Application-specific CodeSystem URL
version	Σ	0..1	string	Version of the system - if relevant
code	SΣ	1..1	code	Specific state type code
display	SΣ	0..1	string	Human-readable state type name
userSelected	Σ	0..1	boolean	If this coding was chosen directly by the user
text	SΣ	0..1	string	Plain text description of state type
subject	Σ	1..1	Reference(Polaris Patient Core | Polaris PractitionerRole Core | Polaris Organization Core)	Resource this state is associated with
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
reference	SΣC	0..1	string	Reference to the associated resource
type	SΣ	0..1	uri	Type of resource referenced Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model).
identifier	Σ	0..1	Identifier	Logical reference, when literal reference is not known
display	SΣ	0..1	string	Display name of referenced resource
created	Σ	0..1	date	When created
author	Σ	0..1	Reference(Practitioner | PractitionerRole | Patient | RelatedPerson | Organization)	Who created
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Basic.meta.security	extensible	All Security Labels http://hl7.org/fhir/ValueSet/security-labels From the FHIR Standard
Basic.meta.tag	example	CommonTags http://hl7.org/fhir/ValueSet/common-tags From the FHIR Standard
Basic.language	preferred	CommonLanguages http://hl7.org/fhir/ValueSet/languages From the FHIR Standard Additional Bindings Purpose AllLanguages Max Binding
Basic.code	example	BasicResourceTypes http://hl7.org/fhir/ValueSet/basic-resource-type From the FHIR Standard
Basic.subject.type	extensible	ResourceType http://hl7.org/fhir/ValueSet/resource-types From the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
app-state-system-inv	error	Basic.code.coding	AppState coding.system must match Polaris CodeSystem URL rules. : system.matches('https://fhir.apps.health/CodeSystem/[a-zA-Z0-9.-]+-app-state')
dom-2	error	Basic	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Basic	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	Basic	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	Basic	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Basic	A resource should have narrative for robust management : text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both : extension.exists() != value.exists()

Key Elements View

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Basic		0..*	Basic	Polaris App State Core
meta	Σ	0..1	Meta	Metadata about the resource
source	SΣ	0..1	uri	Identifies EMR instance & pipeline version the resource came from
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
text	S	0..1	Narrative	Narrative This profile does not constrain the narrative in regard to content, language, or traceability to data elements
extension	S	1..*	Extension	The actual state value(s) - can have an arbitrary number of state values
url	S	1..1	uri	Extension type URL
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier	SΣ	0..1	Identifier	Business identifier for app state
code	?!SΣ	1..1	CodeableConcept	Type and namespace of application state Binding: BasicResourceTypes (example): Codes for identifying types of resources not yet defined by FHIR.
coding	SΣC	1..1	Coding	Coded type of state Constraints: app-state-system-inv
system	SΣ	1..1	uri	Application-specific CodeSystem URL
code	SΣ	1..1	code	Specific state type code
display	SΣ	0..1	string	Human-readable state type name
text	SΣ	0..1	string	Plain text description of state type
subject	Σ	1..1	Reference(Polaris Patient Core | Polaris PractitionerRole Core | Polaris Organization Core)	Resource this state is associated with
reference	SΣC	0..1	string	Reference to the associated resource
type	SΣ	0..1	uri	Type of resource referenced Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model).
display	SΣ	0..1	string	Display name of referenced resource
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Basic.code	example	BasicResourceTypes http://hl7.org/fhir/ValueSet/basic-resource-type From the FHIR Standard
Basic.subject.type	extensible	ResourceType http://hl7.org/fhir/ValueSet/resource-types From the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
app-state-system-inv	error	Basic.code.coding	AppState coding.system must match Polaris CodeSystem URL rules. : system.matches('https://fhir.apps.health/CodeSystem/[a-zA-Z0-9.-]+-app-state')
dom-2	error	Basic	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Basic	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	Basic	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	Basic	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Basic	A resource should have narrative for robust management : text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both : extension.exists() != value.exists()

Differential View

This structure is derived from Basic

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Basic		0..*	Basic	Polaris App State Core
meta
source	S	0..1	uri	Identifies EMR instance & pipeline version the resource came from
text	S	0..1	Narrative	Narrative
extension	S	1..*	Extension	The actual state value(s) - can have an arbitrary number of state values
url	S	1..1	uri	Extension type URL
identifier	S	0..1	Identifier	Business identifier for app state
code	S	1..1	CodeableConcept	Type and namespace of application state
coding	SC	1..1	Coding	Coded type of state Constraints: app-state-system-inv
system	S	1..1	uri	Application-specific CodeSystem URL
code	S	1..1	code	Specific state type code
display	S	0..1	string	Human-readable state type name
text	S	0..1	string	Plain text description of state type
subject		1..1	Reference(Polaris Patient Core | Polaris PractitionerRole Core | Polaris Organization Core)	Resource this state is associated with
reference	S	0..1	string	Reference to the associated resource
type	S	0..1	uri	Type of resource referenced
display	S	0..1	string	Display name of referenced resource
Documentation for this format

Constraints

Id	Grade	Path(s)	Details	Requirements
app-state-system-inv	error	Basic.code.coding	AppState coding.system must match Polaris CodeSystem URL rules. : system.matches('https://fhir.apps.health/CodeSystem/[a-zA-Z0-9.-]+-app-state')

Snapshot View

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
Basic		0..*	Basic	Polaris App State Core
id	Σ	0..1	id	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
versionId	Σ	0..1	id	Version specific identifier
lastUpdated	Σ	0..1	instant	When the resource version last changed
source	SΣ	0..1	uri	Identifies EMR instance & pipeline version the resource came from
profile	Σ	0..*	canonical(StructureDefinition)	Profiles this resource claims to conform to
security	Σ	0..*	Coding	Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
tag	Σ	0..*	Coding	Tags applied to this resource Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
language		0..1	code	Language of the resource content Binding: CommonLanguages (preferred): A human language. Additional Bindings Purpose AllLanguages Max Binding
text	S	0..1	Narrative	Narrative This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained		0..*	Resource	Contained, inline Resources
extension	S	1..*	Extension	The actual state value(s) - can have an arbitrary number of state values
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
url	S	1..1	uri	Extension type URL
value[x]		0..1		Value of extension
valueBase64Binary			base64Binary
valueBoolean			boolean
valueCanonical			canonical(Any)
valueCode			code
valueDate			date
valueDateTime			dateTime
valueDecimal			decimal
valueId			id
valueInstant			instant
valueInteger			integer
valueMarkdown			markdown
valueOid			oid
valuePositiveInt			positiveInt
valueString			string
valueTime			time
valueUnsignedInt			unsignedInt
valueUri			uri
valueUrl			url
valueUuid			uuid
valueAddress			Address
valueAge			Age
valueAnnotation			Annotation
valueAttachment			Attachment
valueCodeableConcept			CodeableConcept
valueCoding			Coding
valueContactPoint			ContactPoint
valueCount			Count
valueDistance			Distance
valueDuration			Duration
valueHumanName			HumanName
valueIdentifier			Identifier
valueMoney			Money
valuePeriod			Period
valueQuantity			Quantity
valueRange			Range
valueRatio			Ratio
valueReference			Reference(Any)
valueSampledData			SampledData
valueSignature			Signature
valueTiming			Timing
valueContactDetail			ContactDetail
valueContributor			Contributor
valueDataRequirement			DataRequirement
valueExpression			Expression
valueParameterDefinition			ParameterDefinition
valueRelatedArtifact			RelatedArtifact
valueTriggerDefinition			TriggerDefinition
valueUsageContext			UsageContext
valueDosage			Dosage
valueMeta			Meta
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier	SΣ	0..1	Identifier	Business identifier for app state
code	?!SΣ	1..1	CodeableConcept	Type and namespace of application state Binding: BasicResourceTypes (example): Codes for identifying types of resources not yet defined by FHIR.
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
coding	SΣC	1..1	Coding	Coded type of state Constraints: app-state-system-inv
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
system	SΣ	1..1	uri	Application-specific CodeSystem URL
version	Σ	0..1	string	Version of the system - if relevant
code	SΣ	1..1	code	Specific state type code
display	SΣ	0..1	string	Human-readable state type name
userSelected	Σ	0..1	boolean	If this coding was chosen directly by the user
text	SΣ	0..1	string	Plain text description of state type
subject	Σ	1..1	Reference(Polaris Patient Core | Polaris PractitionerRole Core | Polaris Organization Core)	Resource this state is associated with
id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
reference	SΣC	0..1	string	Reference to the associated resource
type	SΣ	0..1	uri	Type of resource referenced Binding: ResourceType (extensible): Aa resource (or, for logical models, the URI of the logical model).
identifier	Σ	0..1	Identifier	Logical reference, when literal reference is not known
display	SΣ	0..1	string	Display name of referenced resource
created	Σ	0..1	date	When created
author	Σ	0..1	Reference(Practitioner | PractitionerRole | Patient | RelatedPerson | Organization)	Who created
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet	URI
Basic.meta.security	extensible	All Security Labels http://hl7.org/fhir/ValueSet/security-labels From the FHIR Standard
Basic.meta.tag	example	CommonTags http://hl7.org/fhir/ValueSet/common-tags From the FHIR Standard
Basic.language	preferred	CommonLanguages http://hl7.org/fhir/ValueSet/languages From the FHIR Standard Additional Bindings Purpose AllLanguages Max Binding
Basic.code	example	BasicResourceTypes http://hl7.org/fhir/ValueSet/basic-resource-type From the FHIR Standard
Basic.subject.type	extensible	ResourceType http://hl7.org/fhir/ValueSet/resource-types From the FHIR Standard

Constraints

Id	Grade	Path(s)	Details	Requirements
app-state-system-inv	error	Basic.code.coding	AppState coding.system must match Polaris CodeSystem URL rules. : system.matches('https://fhir.apps.health/CodeSystem/[a-zA-Z0-9.-]+-app-state')
dom-2	error	Basic	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-3	error	Basic	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	Basic	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5	error	Basic	If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty()
dom-6	best practice	Basic	A resource should have narrative for robust management : text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both : extension.exists() != value.exists()

This structure is derived from Basic

Summary

Mandatory: 5 elements
Must-Support: 14 elements

Structures

This structure refers to these other structures:

• Polaris Patient Core (https://fhir.apps.health/StructureDefinition/polaris-core-patient)
• Polaris PractitionerRole Core (https://fhir.apps.health/StructureDefinition/polaris-core-practitionerrole)
• Polaris Organization Core (https://fhir.apps.health/StructureDefinition/polaris-core-organization)