...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

...

Purpose

This WS allows deactivating existing medical programs.

Key points

1. This is a graphQl method used in the Administration panel only.

2. Only authenticated and authorized NHS employee with an appropriate scope can deactivate a Medical program.

Specification

...

Purpose

This WS  is design to update flags "is_active" for Medical Program.

APIary 

Deactivate Medical program

Input parameters 

Logic

For the medical program entity set:

1. is_active = false

2. updated_by = current user (from token)

3. updated_at = current date and time.

Preconditions

API paragraph not found

Global and configurable parameters

API paragraph not found

Input parameters

Dictionaries

• PROVIDING_CONDITION

• eHealth/clinical_impression_patient_categories

• LICENSE_TYPE

• FUNDING_SOURCE

• MEDICAL_PROGRAM_TYPE

• MR_BLANK_TYPES

API paragraph not found

GraphQL Specification

  "Deactivates a single `MedicalProgram` using its globally unique ID."
  deactivateMedicalProgram(
    input: DeactivateMedicalProgramInput!
  ): DeactivateMedicalProgramPayload

"""
Input for `deactivateMedicalProgram` mutation.
User must have a scope **medical_program:write**
"""
input DeactivateMedicalProgramInput {
  "The ID of a `MedicalProgram` to deactivate."
  id: ID!
}

"""
Return type for `deactivateMedicalProgram` mutation.
"""
type DeactivateMedicalProgramPayload {
  "Deactivated `MedicalProgram`."
  medicalProgram: MedicalProgram
}

Authorize

• 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 scopes in order to perform this action (scope = 'medical_

...

• program:write'

...

• )

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

Request data validation

Validate legal entity

• Extract client_id from token.

• Check client scopes in order to perform this action

1. In case error - generate 401 response

Validate FKs

Purpose validation: Check on active program medication. Only medical program without active program medication can't be deactivated. In case on existing active program medication error must be shown.

1. Check exist `program medication` by $.id & `is_active`=false
   1. if invalid - return 409 error (message: "There are active participants on this program. Only medical programs without participants can be deactivated.")

Validate PK Program Medications

Purpose validation: Check on existing record for Medical program

1. Check exist `Medical_program` by $.id.

   1. if invalid - return 404 error (message: "Medical program with id={id} doesn't exist.")

Validate status

Purpose validation:  Medical program should be active (is_active == TRUE) 

1. Validate `is_active` == TRUE

1. 1. if invalid  - return 409 error (message: "Medical program is not active and can't be deactivated again")

Deactivate Program Medications

Update medical program record by $.id  set values:

...

Destination

...

Source

...

FALSE

...

Prepare & return response data structure

...

• (scope = 'medical_program:write')

  • in case of error - return 403 (“Your scope does not allow to access this resource. Missing allowances: medical_program:write”).

• Check type = NHS

  • in case of error - return 403 ('You don’t have permission to access this resource').

Validate medical program ID

1. Check id exists in DB

   1. in case of error - return 404 ('not_found').

Validate related program medications

For each related program medication:

1. Check it has is_active=true

   1. in case of error - return 409 ('This program has active participants. Only medical programs without participants can be deactivated').

Processing

API paragraph not found

Response structure

API paragraph not found

Post-processing processes

API paragraph not found

HTTP status codes

Backward compatibility

API paragraph not found