Table of contents
Table of Contents |
---|
maxLevel | 3 |
---|
exclude | Table of contents |
---|
|
Used documentation
General information
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 | AP-UC09UC404-BF | Name | Delete a message from one message box in one or more messages from the message list view | Description | A 'message box' can be one of the following: inbox, sent box, bin inbox and bin sent box. A table of allowed combinations can be found here. | / | Actor(s) | One healthcare professional | Requirements | - Atleast one At least two message in one of the message boxes.
| Trigger | A healthcare professional wants to move a messagedelete one or more messages. | Precondition(s) | - The user is logged in.
- The user wants to move a messagedelete 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 GetMessageList GetMessagesList method. - The user selects a messageone or more messages. The user moves wants to delete this/these 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(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
in the message box it was consulted inPath 4b: available in the message box it was moved to- /are still available. Nothing has changed.
| Test Data | GetMessagesList DeleteMessage | Endpoint(s) | |
|
Alternative flow 1
Flow | Specifications |
---|
|
ID | APUC404-UC08-AF01 | Name | Move Delete a message from one message box to another message box from the full message view | Description | A 'message box' can be one of the following: inbox, sent box, bin inbox and bin sent box. A table of allowed combinations can be found here. | / | Actor(s) | One healthcare professional | Requirements | - Atleast one message in one of the message boxes.
| Trigger | A healthcare professional wants to move delete a message. | Precondition(s) | - The user is logged in.
- The user wants to move 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 GetMessageList 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) | |
|