Used documentation
General information
In the figure below, we present a logical view about the relationship between the three basic services of the ehealth platform that are the WS Consent, the Therapeutic link WS, and the Therapeutic exclusion services. A Therapeutic link can be managed by the following end-users:
- Health Care (HC) parties: a physician, nurse, dentist, midwife, a pharmacy (it is noteworthy that there is no difference between pharmacy and a pharmacist), authorized organization.
- Citizen: a patient, a parent of a patient, a mandatary
...
- The "PutTherapeuticExlusion" method allows an end-user to declare a therapeutic exclusion.
- The "RevokeTherapeuticExlusion" method enables an end-user to revoke an active therapeutic exclusion.
- The "GetTherapeuticExlusionj'ai" method allows an end-user to consult the active therapeutic exclusions.
Basic flow
1415-BF |
Use case name | Consult the therapeutic exclusions of a patient |
Actors | |
HC party |
Short Description | In order to consult the therapeutic |
links exclusions of a patient using the SOA-based version, it is important to use the Token exchange service in order to convert a JWT message into a SAML one (and vice versa). |
Priority | 1 (High) Must have: The system must implement this goal/ assumption to be accepted. |
Pre-Conditions | - The user is already logged in via the Token exchange service
- Information about the request (request identifier, end-user identifier, date and time of the request
|
, the number of the therapeutic links to consult (=<1000))A set of criteria relative to the therapeutic links - )
- Information about the therapeutic exclusion:
- The identification the concerned patient
- Optionally, the first and last name of the patient
- Optionally, the identification of the excluded HCP
|
SSIN of the concerned patient Optionally, identification of the concerned HCPif the SSIN number - (11 digits), category of the HCP
|
category- *, the first and last name of the HCP
- if
|
the - HCP is an organization: NIHII
|
number - * (8 digits), category of the HCP
|
category organizationOptionally, the list of therapeutic link typeOptionally, the time period [begin date - end date]Optionally, the status of the consulted therapeutic link: active, inactive, allInformation about the evidence (Mandatory if the consultation is referral or historic)- Type of the proof
- only if the type of proof is the reading of the eID card with PIN code entering, the binary proof including the encryption method (mandatory) and the binary value (mandatory).
Post-Conditions | Information about the response (response identifier, end-user identifier, data and time of the response, initial request)
An acknowledgement about the request completion (status of the completion, errors if exist)A list of the therapeutic links fulfilling the criteria:- if the HCP is provided in the request
- if the HCP is a professional identified by his/her SSIN and his/her category: all the therapeutic links containing the given SSIN - category are returned;
- if the HCP is a professional identified by his/her NIHII and his/her category: all the therapeutic links containing the given NIHII - category are returned;
- if the HCP is a professional identified by his/her SSIN, his/her NIHII and his/her category: all therapeutic links containing the given SSIN - NIHII - category category are returned;
- if the HCP is an organization identified by its NIHII and its category: all the therapeutic links containing the given NIHII - category are returned.
- if the HCP is not provided in the request
- if the proof is not given
- if the end-user of the request acts as a HC professional: the therapeutic links of the concerned patient and the concerned author are returned;
- if the end-user of the request acts for an organization: the therapeutic links of the concerned patient and the concerned HC organization of the end-user are returned.
- if the proof is given
- if the end-user of the request acts as a HC professional: the therapeutic links of the concerned patient and the concerned end-user, the therapeutic links of the concerned patient and other concerned HCP are returned;
- if the end-user of the request acts for a HC organization: the therapeutic links of the concerned patient and the concerned organization, the therapeutic links of the concerned patient and other concerned HC parties are returned.
If a (list of) therapeutic link type is provided: the therapeutic link(s) matching this (these) type(s) are returned If a time period is provided: the list of therapeutic links found over this given time periodIf a status (i.e. ‘active’, ‘inactive’, ‘all’) is provided: the therapeutic link matching the provided status are returned.The client sends a GetTherapeuticLink request The IAM connect sends the request to the Therapeutic link WS | The Therapeutic link WS finds information about the therapeutic link(s) of a patient | The Therapeutic link WS sends a SAML-based response to the IAM The IAM connect receives the response and sends it to the client using a JWT format by interacting with the token exchange service | The client receives information about the therapeutic link(s) of the patient |
|
Exceptions (exception flows) |
|
| - Every time the end-user wants to consult the therapeutic link(s) of a given patient
|