Purpose

This WS allows to get a list of Specimens in patient context. Also, this list can be filtered using search parameters.

Specification

Key points

1. Only authenticated and authorized employee with appropriate scope can get a list of Specimen.

2. Method returns a list of Specimen that belongs to the specified patient.

3. List can be filtered by search params.

4. ABAC rules are used here

Logic

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17629118915/RC.#%D0%9E%D1%82%D1%80%D0%B8%D0%BC%D0%B0%D0%BD%D0%BD%D1%8F-%D1%96%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D1%96%D1%97-%D0%97%D1%80%D0%B0%D0%B7%D0%BA%D0%B0-%D0%BF%D1%80%D0%B8-%D0%B2%D0%B7%D0%B0%D1%94%D0%BC%D0%BE%D0%B4%D1%96%D1%97-%D0%B7-%D0%BF%D0%B0%D1%86%D1%96%D1%94%D0%BD%D1%82%D0%BE%D0%BC

Service returns all Specimens related to the patient filtered by submitted parameters:

• Get all Specimens by subject from specimens collection (MongoDB)

• Filter list above by submitted search parameters

• Render a response according to specification with a list of found Specimen entities.

Filters

Dictionaries

https://e-health-ua.atlassian.net/wiki/spaces/EH/pages/17629119370/RC.+Specimen+dictionaries+and+configurable+parameters#Dictionaries

Request structure

See on Apiary

Authorization

• Verify the validity of access token

  • in case of error - return 401 “Invalid access token” in case of validation fails

• Verify that token is not expired

  • in case of error - return 401 “Invalid access token”

• Check user and client scopes in order to perform this action (scope = 'specimen:read')

  • return 403 “Your scope does not allow to access this resource. Missing allowances: specimen:read” in case of invalid scope(s)

• Access to the resource is also managed by ABAC module

Request data validation

Validate Patient

• Get Patient identifier from the URL

• Check it exists in DB

  • Return 404 ('not found') in case of error

Search params

All search params are optional. Search with a few params executes according to the logical AND rule.

• status

  • filter list by specimen.status

• type

  • filter list by specimen.type.coding[*].code

• registered_by.

  • filter list by specimen.registered_by.identifier.value

• collected_from

  • In depend on what is set - filter by specimen.collection.collected_date_time or specimen.collection.collected_period field. Do not take time into account.

    • filter list by $.collected_from <= collected_date_time

    • filter list by $.collected_from <= collected_period.end

• collected_to

  • In depend on what is set - filter by specimen.collection.collected_date_time or specimen.collection.collected_period field. Do not take time into account.

    • filter list by $.collected_to >= collected_date_time.

    • filter list by $.collected_to >= collected_period.start

• container_identifier

  • filter list by specimen.container[*].identifier

• container_type

  • filter list by specimen.container[*].type

• parent

  • filter list by specimen.parent.identifier.value

• request

  • filter list by specimen.request[*].identifier.value

Response structure

See on Apiary

HTTP status codes