FTSnext

Appearance

TCA Cohort Selector Clinical Domain Agent Since 5.0 ​

The TCA based implementation uses the connection to the TCA to select patient identifiers 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 and policySystem fields should reference valid FHIR systems.
  • When defining policies, ensure they align with the consent requirements of your organization.