Table of contents
Used documentation
DeleteMessage
The DeleteMessage method enables the user to delete physically and definitely one or more messages from
the inbox, sent box or bin. This can be used to clean up the eHealthBox when reaching the size limit. Be
cautious when using this method. Best is to show a warning message to the user before deleting the messages.
Request
In MessageId you specify where the messages to delete from the bin or directly from the inbox or sent box. This
method can only delete 100 messages at a time; consequently, you must use it multiple times if necessary.
Response
The response contains a success status code or a business error. The business error
enables you to identify which messages where not successfully deleted, even though all other have been deleted
successfully.
Basic flow
| Flow | Specifications |
|---|
| | ID | UC404-BF | | Name | Delete one or more messages from the message list view | | Description | / | | Actor(s) | One healthcare professional | | Requirements | - At least two message in one of the message boxes.
| | Trigger | A healthcare professional wants to delete one or more messages. | | Precondition(s) | - The user is logged in.
- The user wants to delete one or more messages.
| | Flow | - See use case: login.
- The user wants to view the contents of one of his message boxes.
The user will see a list with all of his message for the specific folder he/she requested.
See use case: consultation for more information about the GetMessagesList method. - The user selects one or more messages. The user wants to delete this/these message(s).
- The user gets a confirmation screen. The user can chose to confirm (4a) or not (4b).
- The user confirms and the message(s) get(s) deleted.
A request will be sent to delete the message(s). Afterwards,
a request will be sent to update the message list. - The message(s) remain(s) the same. Nothing happens.
| | Postcondition(s) | Path 4a: - The deleted message(s) is/are no longer available.
Path 4b: - The message(s) is/are still available. Nothing has changed.
| | Test Data | GetMessagesList DeleteMessage | | Endpoint(s) | |
|
Alternative flow 1
| Flow | Specifications |
|---|
| | ID | UC404-AF01 | | Name | Delete a message from the full message view | | Description | / | | Actor(s) | One healthcare professional | | Requirements | - Atleast one message in one of the message boxes.
| | Trigger | A healthcare professional wants to delete a message. | | Precondition(s) | - The user is logged in.
- The user wants to delete a message.
| | Flow | - See use case: login.
- The user wants to view the contents of one of his message boxes.
The user will see a list with all of his message for the specific folder he/she requested.
See use case: consultation for more information about the GetMessagesList method. - The user selects one message to read. The message will be opened.
See use case: read message for more information about the GetFullMessage method. - The user moves this message to a different message box.
- The user gets automatically returned to the list view of the message box he/she was in.
The list gets updated automatically.
| | Postcondition(s) | - The message is no longer available in the message box it was consulted in.
- The message is available in the message box it was moved to.
| | Test Data | GetMessagesList GetFullMessage DeleteMessage | | Endpoint(s) | |
|
Exception flow
| Flow | Specifications |
|---|
| | ID | UC404-EF01 | | Name | Try to delete a message with an invalid message id | | Description | / | | Actor(s) | One healthcare professional | | Requirements | - Atleast two message in one of the message boxes.
| | Trigger | A healthcare professional wants to delete one or more messages. | | Precondition(s) | - The user is logged in.
- The user wants to delete one or more messages.
| | Flow | - See use case: login.
- The user wants to view the contents of one of his message boxes.
The user will see a list with all of his message for the specific folder he/she requested.
See use case: consultation for more information about the GetMessagesList method. - The user attempts the select a message with an invalid message id. The user wants to delete this message.
- The user gets a confirmation screen. The user can chose to confirm (4a) or not (4b).
- The user confirms and an error message is shown.
- The message remains the same. Nothing happens.
| | Postcondition(s) | Path 4a: - An error message is shown. Afterwards the application keeps working as intended.
Path 4b: - The message is still available. Nothing has changed.
| | Test Data | GetMessagesList DeleteMessage | | Endpoint(s) | |
|