NCPI File

Introduction

Files are a common research product. In this straightforward representation, we provide basic details of the file and how to access it. Details about what is contained in the file or how the content was generated should be described with other entities, such as data dictionaries, summaries, or assays.

File Definitions

File contains basic file metadata about the file location and contents. Files are typically associated with one or more participants, though they can also include general study documents. The file content may have different access control restrictions when compared to this entity, which is only the file metadata.

There can be multiple file location references, for example DRS and cloud storage references, though the access approaches for those locations should be reasonably apparent through the Access Policy for the file content.

Example

If a data file is ONLY accessible through DRS, the underlying bucket locations should not be included here as no user would be able to access them directly. However, if there are multiple Access Policies that provide routes to access the data through different URIs, those can be included. Controlled access release via DRS with a consortium access model permitting direct bucket access could both be stated here to permit consistent reference to the File irrespective of the access mechanism.

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

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
SharedDataModelFile		0..*	Base	Shared Data Model for File
participantID		0..1	VSReference(5.2.0)	The participant(s) for whom this file contains data
fileExternalID		0..1	string	A related identifier of this file
format		1..1	code	The file format used
location	C	1..*	List	List of locations where this data can be accessed Constraints: lst-1, lst-2, lst-3
id	Σ	0..1	string	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
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		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained		0..*	Resource	Contained, inline Resources
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier		0..*	Identifier	Business identifier
status	?!Σ	1..1	code	current | retired | entered-in-error Binding: ListStatus (required): The current state of the list.
mode	?!Σ	1..1	code	working | snapshot | changes Binding: ListMode (required): The processing mode that applies to this list.
title	Σ	0..1	string	Descriptive name for the list Example General: Dr. Jane's Patients
code	Σ	0..1	CodeableConcept	What the purpose of this list is Binding: ExampleUseCodesForList (example): What the purpose of a list is.
subject	Σ	0..1	Reference(Patient | Group | Device | Location)	If all resources have the same subject
encounter		0..1	Reference(Encounter)	Context in which list created
date	Σ	0..1	dateTime	When the list was prepared
source	Σ	0..1	Reference(Practitioner | PractitionerRole | Patient | Device)	Who and/or what defined the list contents (aka Author)
orderedBy		0..1	CodeableConcept	What order the list has Binding: ListOrderCodes (preferred): What order applies to the items in a list.
note		0..*	Annotation	Comments about the list
entry	C	0..*	BackboneElement	Entries in the list
@id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
flag		0..1	CodeableConcept	Status/Workflow information about this item Binding: PatientMedicineChangeTypes (example): Codes that provide further information about the reason and meaning of the item in the list.
deleted	?!C	0..1	boolean	If this item is actually marked as deleted
date		0..1	dateTime	When item added to list
item		1..1	Reference(Resource)	Actual entry
emptyReason	C	0..1	CodeableConcept	Why list is empty Binding: ListEmptyReasons (preferred): If a list is empty, why it is empty.
uri		1..1	uri	The URI at which this data can be accessed
accessPolicy		0..*	VSReference(5.2.0)	If present, only those under the specific Access Policy can access the file in this location.
fileSize		1..1	Quantity	The size of the file, e.g., in bytes.
hash	C	0..*	List	Provides a list of hashes for confirming file transfers Constraints: lst-1, lst-2, lst-3
id	Σ	0..1	string	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
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		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained		0..*	Resource	Contained, inline Resources
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier		0..*	Identifier	Business identifier
status	?!Σ	1..1	code	current | retired | entered-in-error Binding: ListStatus (required): The current state of the list.
mode	?!Σ	1..1	code	working | snapshot | changes Binding: ListMode (required): The processing mode that applies to this list.
title	Σ	0..1	string	Descriptive name for the list Example General: Dr. Jane's Patients
code	Σ	0..1	CodeableConcept	What the purpose of this list is Binding: ExampleUseCodesForList (example): What the purpose of a list is.
subject	Σ	0..1	Reference(Patient | Group | Device | Location)	If all resources have the same subject
encounter		0..1	Reference(Encounter)	Context in which list created
date	Σ	0..1	dateTime	When the list was prepared
source	Σ	0..1	Reference(Practitioner | PractitionerRole | Patient | Device)	Who and/or what defined the list contents (aka Author)
orderedBy		0..1	CodeableConcept	What order the list has Binding: ListOrderCodes (preferred): What order applies to the items in a list.
note		0..*	Annotation	Comments about the list
entry	C	0..*	BackboneElement	Entries in the list
@id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
flag		0..1	CodeableConcept	Status/Workflow information about this item Binding: PatientMedicineChangeTypes (example): Codes that provide further information about the reason and meaning of the item in the list.
deleted	?!C	0..1	boolean	If this item is actually marked as deleted
date		0..1	dateTime	When item added to list
item		1..1	Reference(Resource)	Actual entry
emptyReason	C	0..1	CodeableConcept	Why list is empty Binding: ListEmptyReasons (preferred): If a list is empty, why it is empty.
type		1..1	code	Algorithm used to calculate the hash (and size, where applicable)
value		1..1	string	Value of hashing the file
contentVersion		0..1	string	Version of the file content
description		0..1	string	A description of the file
type		1..1	code	The type of data contained in this file. Should be as detailed as possible, e.g., Whole Exome Variant Calls.
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
SharedDataModelFile.​location.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.status	Base	required	ListStatus	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.mode	Base	required	ListMode	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.code	Base	example	Example Use Codes for List	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.orderedBy	Base	preferred	List Order Codes	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.entry.flag	Base	example	Patient Medicine Change Types	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.emptyReason	Base	preferred	List Empty Reasons	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.status	Base	required	ListStatus	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.mode	Base	required	ListMode	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.code	Base	example	Example Use Codes for List	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.orderedBy	Base	preferred	List Order Codes	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.entry.flag	Base	example	Patient Medicine Change Types	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.emptyReason	Base	preferred	List Empty Reasons	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	SharedDataModelFile.location, SharedDataModelFile.hash	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	SharedDataModelFile.location, SharedDataModelFile.hash	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	SharedDataModelFile.location, SharedDataModelFile.hash	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	SharedDataModelFile.location, SharedDataModelFile.hash	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	SharedDataModelFile.location, SharedDataModelFile.hash	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()
lst-1	error	SharedDataModelFile.location, SharedDataModelFile.hash	A list can only have an emptyReason if it is empty	emptyReason.empty() or entry.empty()
lst-2	error	SharedDataModelFile.location, SharedDataModelFile.hash	The deleted flag can only be used if the mode of the list is "changes"	mode = 'changes' or entry.deleted.empty()
lst-3	error	SharedDataModelFile.location, SharedDataModelFile.hash	An entry date can only be used if the mode of the list is "working"	mode = 'working' or entry.date.empty()

This structure is derived from Base

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
SharedDataModelFile		0..*	Base	Shared Data Model for File
participantID		0..1	VSReference(5.2.0)	The participant(s) for whom this file contains data
fileExternalID		0..1	string	A related identifier of this file
format		1..1	code	The file format used
location		1..*	List	List of locations where this data can be accessed
uri		1..1	uri	The URI at which this data can be accessed
accessPolicy		0..*	VSReference(5.2.0)	If present, only those under the specific Access Policy can access the file in this location.
fileSize		1..1	Quantity	The size of the file, e.g., in bytes.
hash		0..*	List	Provides a list of hashes for confirming file transfers
type		1..1	code	Algorithm used to calculate the hash (and size, where applicable)
value		1..1	string	Value of hashing the file
contentVersion		0..1	string	Version of the file content
description		0..1	string	A description of the file
type		1..1	code	The type of data contained in this file. Should be as detailed as possible, e.g., Whole Exome Variant Calls.
Documentation for this format

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
SharedDataModelFile		0..*	Base	Shared Data Model for File
participantID		0..1	VSReference(5.2.0)	The participant(s) for whom this file contains data
fileExternalID		0..1	string	A related identifier of this file
format		1..1	code	The file format used
location	C	1..*	List	List of locations where this data can be accessed Constraints: lst-1, lst-2, lst-3
id	Σ	0..1	string	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
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		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained		0..*	Resource	Contained, inline Resources
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier		0..*	Identifier	Business identifier
status	?!Σ	1..1	code	current | retired | entered-in-error Binding: ListStatus (required): The current state of the list.
mode	?!Σ	1..1	code	working | snapshot | changes Binding: ListMode (required): The processing mode that applies to this list.
title	Σ	0..1	string	Descriptive name for the list Example General: Dr. Jane's Patients
code	Σ	0..1	CodeableConcept	What the purpose of this list is Binding: ExampleUseCodesForList (example): What the purpose of a list is.
subject	Σ	0..1	Reference(Patient | Group | Device | Location)	If all resources have the same subject
encounter		0..1	Reference(Encounter)	Context in which list created
date	Σ	0..1	dateTime	When the list was prepared
source	Σ	0..1	Reference(Practitioner | PractitionerRole | Patient | Device)	Who and/or what defined the list contents (aka Author)
orderedBy		0..1	CodeableConcept	What order the list has Binding: ListOrderCodes (preferred): What order applies to the items in a list.
note		0..*	Annotation	Comments about the list
entry	C	0..*	BackboneElement	Entries in the list
@id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
flag		0..1	CodeableConcept	Status/Workflow information about this item Binding: PatientMedicineChangeTypes (example): Codes that provide further information about the reason and meaning of the item in the list.
deleted	?!C	0..1	boolean	If this item is actually marked as deleted
date		0..1	dateTime	When item added to list
item		1..1	Reference(Resource)	Actual entry
emptyReason	C	0..1	CodeableConcept	Why list is empty Binding: ListEmptyReasons (preferred): If a list is empty, why it is empty.
uri		1..1	uri	The URI at which this data can be accessed
accessPolicy		0..*	VSReference(5.2.0)	If present, only those under the specific Access Policy can access the file in this location.
fileSize		1..1	Quantity	The size of the file, e.g., in bytes.
hash	C	0..*	List	Provides a list of hashes for confirming file transfers Constraints: lst-1, lst-2, lst-3
id	Σ	0..1	string	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
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		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained		0..*	Resource	Contained, inline Resources
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier		0..*	Identifier	Business identifier
status	?!Σ	1..1	code	current | retired | entered-in-error Binding: ListStatus (required): The current state of the list.
mode	?!Σ	1..1	code	working | snapshot | changes Binding: ListMode (required): The processing mode that applies to this list.
title	Σ	0..1	string	Descriptive name for the list Example General: Dr. Jane's Patients
code	Σ	0..1	CodeableConcept	What the purpose of this list is Binding: ExampleUseCodesForList (example): What the purpose of a list is.
subject	Σ	0..1	Reference(Patient | Group | Device | Location)	If all resources have the same subject
encounter		0..1	Reference(Encounter)	Context in which list created
date	Σ	0..1	dateTime	When the list was prepared
source	Σ	0..1	Reference(Practitioner | PractitionerRole | Patient | Device)	Who and/or what defined the list contents (aka Author)
orderedBy		0..1	CodeableConcept	What order the list has Binding: ListOrderCodes (preferred): What order applies to the items in a list.
note		0..*	Annotation	Comments about the list
entry	C	0..*	BackboneElement	Entries in the list
@id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
flag		0..1	CodeableConcept	Status/Workflow information about this item Binding: PatientMedicineChangeTypes (example): Codes that provide further information about the reason and meaning of the item in the list.
deleted	?!C	0..1	boolean	If this item is actually marked as deleted
date		0..1	dateTime	When item added to list
item		1..1	Reference(Resource)	Actual entry
emptyReason	C	0..1	CodeableConcept	Why list is empty Binding: ListEmptyReasons (preferred): If a list is empty, why it is empty.
type		1..1	code	Algorithm used to calculate the hash (and size, where applicable)
value		1..1	string	Value of hashing the file
contentVersion		0..1	string	Version of the file content
description		0..1	string	A description of the file
type		1..1	code	The type of data contained in this file. Should be as detailed as possible, e.g., Whole Exome Variant Calls.
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
SharedDataModelFile.​location.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.status	Base	required	ListStatus	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.mode	Base	required	ListMode	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.code	Base	example	Example Use Codes for List	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.orderedBy	Base	preferred	List Order Codes	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.entry.flag	Base	example	Patient Medicine Change Types	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.emptyReason	Base	preferred	List Empty Reasons	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.status	Base	required	ListStatus	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.mode	Base	required	ListMode	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.code	Base	example	Example Use Codes for List	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.orderedBy	Base	preferred	List Order Codes	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.entry.flag	Base	example	Patient Medicine Change Types	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.emptyReason	Base	preferred	List Empty Reasons	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	SharedDataModelFile.location, SharedDataModelFile.hash	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	SharedDataModelFile.location, SharedDataModelFile.hash	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	SharedDataModelFile.location, SharedDataModelFile.hash	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	SharedDataModelFile.location, SharedDataModelFile.hash	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	SharedDataModelFile.location, SharedDataModelFile.hash	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()
lst-1	error	SharedDataModelFile.location, SharedDataModelFile.hash	A list can only have an emptyReason if it is empty	emptyReason.empty() or entry.empty()
lst-2	error	SharedDataModelFile.location, SharedDataModelFile.hash	The deleted flag can only be used if the mode of the list is "changes"	mode = 'changes' or entry.deleted.empty()
lst-3	error	SharedDataModelFile.location, SharedDataModelFile.hash	An entry date can only be used if the mode of the list is "working"	mode = 'working' or entry.date.empty()

Key Elements View

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
SharedDataModelFile		0..*	Base	Shared Data Model for File
participantID		0..1	VSReference(5.2.0)	The participant(s) for whom this file contains data
fileExternalID		0..1	string	A related identifier of this file
format		1..1	code	The file format used
location	C	1..*	List	List of locations where this data can be accessed Constraints: lst-1, lst-2, lst-3
id	Σ	0..1	string	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
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		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained		0..*	Resource	Contained, inline Resources
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier		0..*	Identifier	Business identifier
status	?!Σ	1..1	code	current | retired | entered-in-error Binding: ListStatus (required): The current state of the list.
mode	?!Σ	1..1	code	working | snapshot | changes Binding: ListMode (required): The processing mode that applies to this list.
title	Σ	0..1	string	Descriptive name for the list Example General: Dr. Jane's Patients
code	Σ	0..1	CodeableConcept	What the purpose of this list is Binding: ExampleUseCodesForList (example): What the purpose of a list is.
subject	Σ	0..1	Reference(Patient | Group | Device | Location)	If all resources have the same subject
encounter		0..1	Reference(Encounter)	Context in which list created
date	Σ	0..1	dateTime	When the list was prepared
source	Σ	0..1	Reference(Practitioner | PractitionerRole | Patient | Device)	Who and/or what defined the list contents (aka Author)
orderedBy		0..1	CodeableConcept	What order the list has Binding: ListOrderCodes (preferred): What order applies to the items in a list.
note		0..*	Annotation	Comments about the list
entry	C	0..*	BackboneElement	Entries in the list
@id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
flag		0..1	CodeableConcept	Status/Workflow information about this item Binding: PatientMedicineChangeTypes (example): Codes that provide further information about the reason and meaning of the item in the list.
deleted	?!C	0..1	boolean	If this item is actually marked as deleted
date		0..1	dateTime	When item added to list
item		1..1	Reference(Resource)	Actual entry
emptyReason	C	0..1	CodeableConcept	Why list is empty Binding: ListEmptyReasons (preferred): If a list is empty, why it is empty.
uri		1..1	uri	The URI at which this data can be accessed
accessPolicy		0..*	VSReference(5.2.0)	If present, only those under the specific Access Policy can access the file in this location.
fileSize		1..1	Quantity	The size of the file, e.g., in bytes.
hash	C	0..*	List	Provides a list of hashes for confirming file transfers Constraints: lst-1, lst-2, lst-3
id	Σ	0..1	string	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
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		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained		0..*	Resource	Contained, inline Resources
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier		0..*	Identifier	Business identifier
status	?!Σ	1..1	code	current | retired | entered-in-error Binding: ListStatus (required): The current state of the list.
mode	?!Σ	1..1	code	working | snapshot | changes Binding: ListMode (required): The processing mode that applies to this list.
title	Σ	0..1	string	Descriptive name for the list Example General: Dr. Jane's Patients
code	Σ	0..1	CodeableConcept	What the purpose of this list is Binding: ExampleUseCodesForList (example): What the purpose of a list is.
subject	Σ	0..1	Reference(Patient | Group | Device | Location)	If all resources have the same subject
encounter		0..1	Reference(Encounter)	Context in which list created
date	Σ	0..1	dateTime	When the list was prepared
source	Σ	0..1	Reference(Practitioner | PractitionerRole | Patient | Device)	Who and/or what defined the list contents (aka Author)
orderedBy		0..1	CodeableConcept	What order the list has Binding: ListOrderCodes (preferred): What order applies to the items in a list.
note		0..*	Annotation	Comments about the list
entry	C	0..*	BackboneElement	Entries in the list
@id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
flag		0..1	CodeableConcept	Status/Workflow information about this item Binding: PatientMedicineChangeTypes (example): Codes that provide further information about the reason and meaning of the item in the list.
deleted	?!C	0..1	boolean	If this item is actually marked as deleted
date		0..1	dateTime	When item added to list
item		1..1	Reference(Resource)	Actual entry
emptyReason	C	0..1	CodeableConcept	Why list is empty Binding: ListEmptyReasons (preferred): If a list is empty, why it is empty.
type		1..1	code	Algorithm used to calculate the hash (and size, where applicable)
value		1..1	string	Value of hashing the file
contentVersion		0..1	string	Version of the file content
description		0..1	string	A description of the file
type		1..1	code	The type of data contained in this file. Should be as detailed as possible, e.g., Whole Exome Variant Calls.
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
SharedDataModelFile.​location.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.status	Base	required	ListStatus	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.mode	Base	required	ListMode	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.code	Base	example	Example Use Codes for List	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.orderedBy	Base	preferred	List Order Codes	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.entry.flag	Base	example	Patient Medicine Change Types	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.emptyReason	Base	preferred	List Empty Reasons	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.status	Base	required	ListStatus	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.mode	Base	required	ListMode	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.code	Base	example	Example Use Codes for List	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.orderedBy	Base	preferred	List Order Codes	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.entry.flag	Base	example	Patient Medicine Change Types	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.emptyReason	Base	preferred	List Empty Reasons	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	SharedDataModelFile.location, SharedDataModelFile.hash	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	SharedDataModelFile.location, SharedDataModelFile.hash	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	SharedDataModelFile.location, SharedDataModelFile.hash	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	SharedDataModelFile.location, SharedDataModelFile.hash	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	SharedDataModelFile.location, SharedDataModelFile.hash	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()
lst-1	error	SharedDataModelFile.location, SharedDataModelFile.hash	A list can only have an emptyReason if it is empty	emptyReason.empty() or entry.empty()
lst-2	error	SharedDataModelFile.location, SharedDataModelFile.hash	The deleted flag can only be used if the mode of the list is "changes"	mode = 'changes' or entry.deleted.empty()
lst-3	error	SharedDataModelFile.location, SharedDataModelFile.hash	An entry date can only be used if the mode of the list is "working"	mode = 'working' or entry.date.empty()

Differential View

This structure is derived from Base

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
SharedDataModelFile		0..*	Base	Shared Data Model for File
participantID		0..1	VSReference(5.2.0)	The participant(s) for whom this file contains data
fileExternalID		0..1	string	A related identifier of this file
format		1..1	code	The file format used
location		1..*	List	List of locations where this data can be accessed
uri		1..1	uri	The URI at which this data can be accessed
accessPolicy		0..*	VSReference(5.2.0)	If present, only those under the specific Access Policy can access the file in this location.
fileSize		1..1	Quantity	The size of the file, e.g., in bytes.
hash		0..*	List	Provides a list of hashes for confirming file transfers
type		1..1	code	Algorithm used to calculate the hash (and size, where applicable)
value		1..1	string	Value of hashing the file
contentVersion		0..1	string	Version of the file content
description		0..1	string	A description of the file
type		1..1	code	The type of data contained in this file. Should be as detailed as possible, e.g., Whole Exome Variant Calls.
Documentation for this format

Snapshot View

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
SharedDataModelFile		0..*	Base	Shared Data Model for File
participantID		0..1	VSReference(5.2.0)	The participant(s) for whom this file contains data
fileExternalID		0..1	string	A related identifier of this file
format		1..1	code	The file format used
location	C	1..*	List	List of locations where this data can be accessed Constraints: lst-1, lst-2, lst-3
id	Σ	0..1	string	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
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		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained		0..*	Resource	Contained, inline Resources
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier		0..*	Identifier	Business identifier
status	?!Σ	1..1	code	current | retired | entered-in-error Binding: ListStatus (required): The current state of the list.
mode	?!Σ	1..1	code	working | snapshot | changes Binding: ListMode (required): The processing mode that applies to this list.
title	Σ	0..1	string	Descriptive name for the list Example General: Dr. Jane's Patients
code	Σ	0..1	CodeableConcept	What the purpose of this list is Binding: ExampleUseCodesForList (example): What the purpose of a list is.
subject	Σ	0..1	Reference(Patient | Group | Device | Location)	If all resources have the same subject
encounter		0..1	Reference(Encounter)	Context in which list created
date	Σ	0..1	dateTime	When the list was prepared
source	Σ	0..1	Reference(Practitioner | PractitionerRole | Patient | Device)	Who and/or what defined the list contents (aka Author)
orderedBy		0..1	CodeableConcept	What order the list has Binding: ListOrderCodes (preferred): What order applies to the items in a list.
note		0..*	Annotation	Comments about the list
entry	C	0..*	BackboneElement	Entries in the list
@id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
flag		0..1	CodeableConcept	Status/Workflow information about this item Binding: PatientMedicineChangeTypes (example): Codes that provide further information about the reason and meaning of the item in the list.
deleted	?!C	0..1	boolean	If this item is actually marked as deleted
date		0..1	dateTime	When item added to list
item		1..1	Reference(Resource)	Actual entry
emptyReason	C	0..1	CodeableConcept	Why list is empty Binding: ListEmptyReasons (preferred): If a list is empty, why it is empty.
uri		1..1	uri	The URI at which this data can be accessed
accessPolicy		0..*	VSReference(5.2.0)	If present, only those under the specific Access Policy can access the file in this location.
fileSize		1..1	Quantity	The size of the file, e.g., in bytes.
hash	C	0..*	List	Provides a list of hashes for confirming file transfers Constraints: lst-1, lst-2, lst-3
id	Σ	0..1	string	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
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		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained		0..*	Resource	Contained, inline Resources
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier		0..*	Identifier	Business identifier
status	?!Σ	1..1	code	current | retired | entered-in-error Binding: ListStatus (required): The current state of the list.
mode	?!Σ	1..1	code	working | snapshot | changes Binding: ListMode (required): The processing mode that applies to this list.
title	Σ	0..1	string	Descriptive name for the list Example General: Dr. Jane's Patients
code	Σ	0..1	CodeableConcept	What the purpose of this list is Binding: ExampleUseCodesForList (example): What the purpose of a list is.
subject	Σ	0..1	Reference(Patient | Group | Device | Location)	If all resources have the same subject
encounter		0..1	Reference(Encounter)	Context in which list created
date	Σ	0..1	dateTime	When the list was prepared
source	Σ	0..1	Reference(Practitioner | PractitionerRole | Patient | Device)	Who and/or what defined the list contents (aka Author)
orderedBy		0..1	CodeableConcept	What order the list has Binding: ListOrderCodes (preferred): What order applies to the items in a list.
note		0..*	Annotation	Comments about the list
entry	C	0..*	BackboneElement	Entries in the list
@id		0..1	string	Unique id for inter-element referencing
extension		0..*	Extension	Additional content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored even if unrecognized
flag		0..1	CodeableConcept	Status/Workflow information about this item Binding: PatientMedicineChangeTypes (example): Codes that provide further information about the reason and meaning of the item in the list.
deleted	?!C	0..1	boolean	If this item is actually marked as deleted
date		0..1	dateTime	When item added to list
item		1..1	Reference(Resource)	Actual entry
emptyReason	C	0..1	CodeableConcept	Why list is empty Binding: ListEmptyReasons (preferred): If a list is empty, why it is empty.
type		1..1	code	Algorithm used to calculate the hash (and size, where applicable)
value		1..1	string	Value of hashing the file
contentVersion		0..1	string	Version of the file content
description		0..1	string	A description of the file
type		1..1	code	The type of data contained in this file. Should be as detailed as possible, e.g., Whole Exome Variant Calls.
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
SharedDataModelFile.​location.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.status	Base	required	ListStatus	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.mode	Base	required	ListMode	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.code	Base	example	Example Use Codes for List	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.orderedBy	Base	preferred	List Order Codes	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.entry.flag	Base	example	Patient Medicine Change Types	📍4.0.1	FHIR Std.
SharedDataModelFile.​location.emptyReason	Base	preferred	List Empty Reasons	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.status	Base	required	ListStatus	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.mode	Base	required	ListMode	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.code	Base	example	Example Use Codes for List	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.orderedBy	Base	preferred	List Order Codes	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.entry.flag	Base	example	Patient Medicine Change Types	📍4.0.1	FHIR Std.
SharedDataModelFile.​hash.emptyReason	Base	preferred	List Empty Reasons	📍4.0.1	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
dom-2	error	SharedDataModelFile.location, SharedDataModelFile.hash	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	SharedDataModelFile.location, SharedDataModelFile.hash	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	SharedDataModelFile.location, SharedDataModelFile.hash	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	SharedDataModelFile.location, SharedDataModelFile.hash	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	SharedDataModelFile.location, SharedDataModelFile.hash	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()
lst-1	error	SharedDataModelFile.location, SharedDataModelFile.hash	A list can only have an emptyReason if it is empty	emptyReason.empty() or entry.empty()
lst-2	error	SharedDataModelFile.location, SharedDataModelFile.hash	The deleted flag can only be used if the mode of the list is "changes"	mode = 'changes' or entry.deleted.empty()
lst-3	error	SharedDataModelFile.location, SharedDataModelFile.hash	An entry date can only be used if the mode of the list is "working"	mode = 'working' or entry.date.empty()

This structure is derived from Base

Summary

Mandatory: 0 element(7 nested mandatory elements)

Structures

This structure refers to these other structures:

• ValueSet Reference (http://hl7.org/fhir/StructureDefinition/valueset-reference)