FHIR © HL7.org  |  FHIRsmith 4.0.1  |  Server Home  |  XIG Home  |  XIG Stats  | 

FHIR IG analytics

Packageihe.iti.vhl
Resource TypeCapabilityStatement
IdCapabilityStatement-VHLReceiverCapabilityStatement.json
FHIR VersionR4
Sourcehttps://build.fhir.org/ig/IHE/ITI.VHL/CapabilityStatement-VHLReceiverCapabilityStatement.html
URLhttp://profiles.ihe.net/ITI/VHL/CapabilityStatement/vhl-receiver-client
Version0.0.2-current
Statusactive
Date2024-01-15
NameVHLReceiverCapabilityStatement
TitleVHL Receiver Client Capability Statement
Realmuv
Authorityihe
DescriptionCapability Statement for a VHL Receiver implementing the Retrieve Manifest [ITI-YY5] transaction as a client. This client searches for List resources using VHL-authorized manifest URLs and can request inclusion of DocumentReference resources via the _include parameter.
Kindrequirements

Resources that use this resource

No resources found


Resources that this resource uses

No resources found


Narrative

Note: links and images are rebased to the (stated) source

Generated Narrative: CapabilityStatement VHLReceiverCapabilityStatement

VHL Receiver Client Capability Statement

  • Implementation Guide Version: 0.0.2-current
  • FHIR Version: 4.0.1
  • Supported Formats: application/fhir+json, application/fhir+xml
  • Published on: 2024-01-15
  • Published by: IHE IT Infrastructure Technical Committee

Note to Implementers: FHIR Capabilities

Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

FHIR RESTful Capabilities

Mode: client

VHL Receiver retrieves document manifests (List resources) and optionally DocumentReference resources from VHL Sharers using VHL-authorized manifest URLs. The client extracts the manifest URL from the VHL payload (obtained via ITI-YY4 Provide VHL) and performs a FHIR search with mandatory parameters.

Security

Implementations SHALL support ATNA Authenticate Node [ITI-19] for mutual TLS authentication. The VHL Receiver SHALL provide the VHL authorization token (folder ID) and MAY provide additional authentication tokens (OAuth 2.0, JWS signatures).

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

  • The relevant profiles (if any)
  • The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any).
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
Resource TypeProfileRSUCSearches_include_revincludeOperations
Listhttp://hl7.org/fhir/StructureDefinition/Listy_id, code, status, patientList:item
DocumentReferencehttp://hl7.org/fhir/StructureDefinition/DocumentReferenceyy

Resource Conformance: supported List

Base System Profile
List
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports
    search-type

    Search for List resources using manifest URL from VHL payload. The VHL Receiver SHALL support searching with _id, code, and status parameters, and SHALL support chained search on the patient parameter (patient.identifier=system|value) to identify the patient. The VHL Receiver SHALL support the _include=List:item parameter to retrieve DocumentReference resources in a single request.

Documentation

The VHL Receiver searches for List resources using the manifest URL extracted from the VHL payload. The search SHALL include mandatory parameters: _id (folder ID), code, and status, and SHALL include the patient identifier using FHIR chained search on the patient parameter (i.e., patient.identifier=system|value). The VHL Receiver MAY request inclusion of DocumentReference resources via the _include parameter.

Search Parameters
ConformanceParameterTypeDocumentation
SHALL_idtoken

Folder ID from VHL payload. This is the primary authorization mechanism. SHALL be supported and SHALL be included in every manifest retrieval request.

SHALLcodetoken

List type, typically 'folder'. SHALL be supported and SHALL be included in manifest URL from VHL payload.

SHALLstatustoken

List status, typically 'current'. SHALL be supported and SHALL be included in manifest URL from VHL payload.

SHALLpatientreference

Patient reference search parameter. SHALL be supported with FHIR chained search (patient.identifier=system|value) to identify the patient by identifier without requiring a direct Patient resource reference. SHALL be included in the manifest URL from the VHL payload.

 

Resource Conformance: supported DocumentReference

Base System Profile
DocumentReference
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports
    read

    Read individual DocumentReference resources by ID. Used when _include is not supported by the VHL Sharer or when retrieving updated metadata after the initial manifest retrieval.

    search-type

    Search for DocumentReference resources. MAY be used to retrieve individual DocumentReferences when _include is not available or to apply additional filters after manifest retrieval.

Documentation

DocumentReference resources MAY be returned as included resources when _include=List:item is used in the List search. The VHL Receiver SHALL be capable of processing DocumentReference resources returned with search.mode='include' in the searchset Bundle.


Source1

{
  "resourceType": "CapabilityStatement",
  "id": "VHLReceiverCapabilityStatement",
  "text": {
    "status": "extensions",
    "div": "<!-- snip (see above) -->"
  },
  "url": "http://profiles.ihe.net/ITI/VHL/CapabilityStatement/vhl-receiver-client",
  "version": "0.0.2-current",
  "name": "VHLReceiverCapabilityStatement",
  "title": "VHL Receiver Client Capability Statement",
  "status": "active",
  "experimental": false,
  "date": "2024-01-15",
  "publisher": "IHE IT Infrastructure Technical Committee",
  "contact": [
    {
      "telecom": [
        {
          "system": "url",
          "value": "https://www.ihe.net/ihe_domains/it_infrastructure/"
        }
      ]
    },
    {
      "telecom": [
        {
          "system": "email",
          "value": "iti@ihe.net"
        }
      ]
    },
    {
      "name": "IHE IT Infrastructure Technical Committee",
      "telecom": [
        {
          "system": "email",
          "value": "iti@ihe.net"
        }
      ]
    }
  ],
  "description": "Capability Statement for a VHL Receiver implementing the Retrieve Manifest [ITI-YY5] transaction as a client. This client searches for List resources using VHL-authorized manifest URLs and can request inclusion of DocumentReference resources via the _include parameter.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "http://unstats.un.org/unsd/methods/m49/m49.htm",
          "code": "001"
        }
      ]
    }
  ],
  "kind": "requirements",
  "fhirVersion": "4.0.1",
  "format": [
    "application/fhir+json",
    "application/fhir+xml"
  ],
  "rest": [
    {
      "mode": "client",
      "documentation": "VHL Receiver retrieves document manifests (List resources) and optionally DocumentReference resources from VHL Sharers using VHL-authorized manifest URLs. The client extracts the manifest URL from the VHL payload (obtained via ITI-YY4 Provide VHL) and performs a FHIR search with mandatory parameters.",
      "security": {
        "description": "Implementations SHALL support ATNA Authenticate Node [ITI-19] for mutual TLS authentication. The VHL Receiver SHALL provide the VHL authorization token (folder ID) and MAY provide additional authentication tokens (OAuth 2.0, JWS signatures)."
      },
      "resource": [
        {
          "type": "List",
          "profile": "http://hl7.org/fhir/StructureDefinition/List",
          "documentation": "The VHL Receiver searches for List resources using the manifest URL extracted from the VHL payload. The search SHALL include mandatory parameters: _id (folder ID), code, and status, and SHALL include the patient identifier using FHIR chained search on the patient parameter (i.e., patient.identifier=system|value). The VHL Receiver MAY request inclusion of DocumentReference resources via the _include parameter.",
          "interaction": [
            {
              "code": "search-type",
              "documentation": "Search for List resources using manifest URL from VHL payload. The VHL Receiver SHALL support searching with _id, code, and status parameters, and SHALL support chained search on the patient parameter (patient.identifier=system|value) to identify the patient. The VHL Receiver SHALL support the _include=List:item parameter to retrieve DocumentReference resources in a single request."
            }
          ],
          "searchInclude": [
            "List:item"
          ],
          "searchParam": [
            {
              "name": "_id",
              "definition": "http://hl7.org/fhir/SearchParameter/Resource-id",
              "type": "token",
              "documentation": "Folder ID from VHL payload. This is the primary authorization mechanism. SHALL be supported and SHALL be included in every manifest retrieval request."
            },
            {
              "name": "code",
              "definition": "http://hl7.org/fhir/SearchParameter/List-code",
              "type": "token",
              "documentation": "List type, typically 'folder'. SHALL be supported and SHALL be included in manifest URL from VHL payload."
            },
            {
              "name": "status",
              "definition": "http://hl7.org/fhir/SearchParameter/List-status",
              "type": "token",
              "documentation": "List status, typically 'current'. SHALL be supported and SHALL be included in manifest URL from VHL payload."
            },
            {
              "name": "patient",
              "definition": "http://hl7.org/fhir/SearchParameter/List-patient",
              "type": "reference",
              "documentation": "Patient reference search parameter. SHALL be supported with FHIR chained search (patient.identifier=system|value) to identify the patient by identifier without requiring a direct Patient resource reference. SHALL be included in the manifest URL from the VHL payload."
            }
          ]
        },
        {
          "type": "DocumentReference",
          "profile": "http://hl7.org/fhir/StructureDefinition/DocumentReference",
          "documentation": "DocumentReference resources MAY be returned as included resources when _include=List:item is used in the List search. The VHL Receiver SHALL be capable of processing DocumentReference resources returned with search.mode='include' in the searchset Bundle.",
          "interaction": [
            {
              "code": "read",
              "documentation": "Read individual DocumentReference resources by ID. Used when _include is not supported by the VHL Sharer or when retrieving updated metadata after the initial manifest retrieval."
            },
            {
              "code": "search-type",
              "documentation": "Search for DocumentReference resources. MAY be used to retrieve individual DocumentReferences when _include is not available or to apply additional filters after manifest retrieval."
            }
          ]
        }
      ]
    }
  ]
}