TCA Cohort Selector Clinical Domain Agent Since 5.0
The TCA based implementation uses the connection to the TCA to select patient IDs for transfer.
Example Configuration
yaml
trustCenterAgent:
server:
baseUrl: http://tc-agent:8080
auth: [ ... ]
ssl: [ ... ]
domain: MII
patientIdentifierSystem: "http://fts.smith.care"
# e.g.: https://simplifier.net/medizininformatikinitiative-modulconsent/2.16.840.1.113883.3.1937.777.24.5.3--20210423105554
policySystem: "urn:oid:2.16.840.1.113883.3.1937.777.24.5.3" # MII CS Consent Policy
policies:
- 2.16.840.1.113883.3.1937.777.24.5.3.2 # IDAT erheben
- 2.16.840.1.113883.3.1937.777.24.5.3.3 # IDAT speichern, verarbeiten
- 2.16.840.1.113883.3.1937.777.24.5.3.6 # MDAT erheben
- 2.16.840.1.113883.3.1937.777.24.5.3.7 # MDAT speichern, verarbeiten
signerIdType: "Pseudonym"
Fields
server
Since 5.0
- Description: Specifies connection settings for the Trust Center Agent server.
- Type:
HttpClientConfig
- Example:yaml
server: baseUrl: http://custom-agent:9000 auth: [ ... ] ssl: [ ... ]
domain
Since 5.0
- Description: Defines the domain to search for consent, serving as a namespace for data segregation.
- Type: String
- Example:yaml
domain: ResearchDomain
- Important: This domain must already exist in gICS before FTSnext can use it. FTSnext cannot create or alter domains through the FHIR gateway.
patientIdentifierSystem
Since 5.0
- Description: Adds the identifier system to the patients, regardless of the system in gICS.
- Type: String
- Example:yaml
patientIdentifierSystem: "https://example.org/fhir/identifiers/Patient"
policySystem
Since 5.0
- Description: Filters policies based on their system identifier. Only policies from this system will be considered valid.
- Type: String
- Example:yaml
policySystem: "urn:oid:2.16.840.1.113883.3.1937.777.24.5.3" # MII CS Consent Policy
policies
Since 5.0
- Description: Specifies a list of required policies. Consent must explicitly include approval for all these policies to qualify.
- Type: Array of Strings
- Example:yaml
policies: - 2.16.840.1.113883.3.1937.777.24.5.3.2 # IDAT erheben
signerIdType
Optional Since 5.4.1
- Description: Specifies the type of identifier used for consent signing in the Trust Center Agent. This field is used to construct the GICS identifier system URL for patient identification.
- Type: String
- Default: "Pseudonym"
- Example:yaml
signerIdType: "Pseudonym"
Notes
- The
domain
field should be chosen carefully to avoid overlapping data between namespaces. - Ensure that
domain
is correctly configured in the trust center. - The
patientIdentifierSystem
andpolicySystem
fields should reference valid FHIR systems. - When defining policies, ensure they align with the consent requirements of your organization.