Difference between revisions of "Subscription and Notification Pattern"
m |
|||
Line 29: | Line 29: | ||
A successful registration of the company or the branch of the company leads to a subscription to business events of the represented company. This is needed to assess impact of these business events on service delivery to the company or the branch. | A successful registration of the company or the branch of the company leads to a subscription to business events of the represented company. This is needed to assess impact of these business events on service delivery to the company or the branch. | ||
+ | |||
The subscription process can also be triggered for technical reasons: for instance to resend subscription requests because an error occurred at DO-side. | The subscription process can also be triggered for technical reasons: for instance to resend subscription requests because an error occurred at DO-side. | ||
+ | |||
|- | |- | ||
|'''Initiate subscription''' | |'''Initiate subscription''' | ||
Line 39: | Line 41: | ||
* Collect data and formulate subscription need: | * Collect data and formulate subscription need: | ||
− | * company | + | ** company identifier |
− | * all events of subset/type of events (specific event catalogue)? tbd | + | ** all events of subset/type of events (specific event catalogue)? tbd |
− | * type of action: subscribe | + | ** type of action: subscribe |
− | * period of subscription? tbd | + | ** period of subscription? tbd |
* Forward to Data requestor (if applicable) | * Forward to Data requestor (if applicable) | ||
+ | |||
Note: subscriber should unsubscribe and re-subscribe if participant-id changes. To be able to do so, subscriptions have to be registered at the DE. | Note: subscriber should unsubscribe and re-subscribe if participant-id changes. To be able to do so, subscriptions have to be registered at the DE. | ||
+ | |||
|- | |- | ||
|'''Trigger cancel subscription''' | |'''Trigger cancel subscription''' | ||
|eProcedure / Public service / Notification | |eProcedure / Public service / Notification | ||
|Service | |Service | ||
− | |Public service: the delivery of an public service can lead to the need to cancel the subscription (the public service has ended, e.g. a multi-year subsidy procedure, the country can decide to cancel the branch-office registration). | + | |Potential triggers to cancel a subscription are: |
+ | |||
+ | * Public service: the delivery of an public service can lead to the need to cancel the subscription (the public service has ended, e.g. a multi-year subsidy procedure, the country can decide to cancel the branch-office registration). | ||
− | eProcedure: the user can also withdraw from service and thereby initiating cancellation of the subscription? | + | * eProcedure: the user can also withdraw from service and thereby initiating cancellation of the subscription? |
− | Notification: after receiving a notification the assessment can be that the subscription is no longer needed (exception flow). | + | * Notification: after receiving a notification the assessment can be that the subscription is no longer needed (exception flow). |
− | Technical reasons: for instance an error at the DO-side could lead to the need to resend the request to cancel a subscription. | + | * Technical reasons: for instance an error at the DO-side could lead to the need to resend the request to cancel a subscription. |
|- | |- | ||
|'''Cancel subscription''' | |'''Cancel subscription''' | ||
Line 65: | Line 71: | ||
* Collect data and formulate cancel subscription need: | * Collect data and formulate cancel subscription need: | ||
− | * company | + | ** company identifier |
− | * all events of subset/type of events (specific event catalogue)? tbd | + | ** all events of subset/type of events (specific event catalogue)? tbd |
− | * type of action: cancel subscription | + | ** type of action: cancel subscription |
− | * specific end-date of the subscription? tbd | + | ** specific end-date of the subscription? tbd |
* Forward to Data requestor (if applicable) | * Forward to Data requestor (if applicable) | ||
|- | |- |
Revision as of 11:14, 6 May 2021
Introductory text
Functional Variants of the Subscription and Notification Pattern
Two distinct business requirements for Subscription and Notification Pattern: Updating of previously shared Evidence or being informed about an Event
Technically also two different approaches to Notification: Sending updated Data of a defined Evidence type or Event Notifications that contain only the identification data and the event type. Technical approach and business requirement do not relate one two one, giving rise to potential hybrid approaches.
Event The reference Architecture for the DE4A projects focusses the Subscription and Notification Pattern on Event Notification, which can be combines with the Lookup Pattern to cover the updating previously shared evidence use case. [23-04-2021: tables below still represent a hybrid approach and need rework]
Working Hypotheses
Business Process
Event Subscription
Business Process (picture)
Activity Table
Activity / UC | Role | Type* | Description |
Trigger initiate subscription | eProcedure | User | The eProcedure leads at the side of the data-evaluator to either the registration of the represented company or the registration of a branch of the represented company (the parent-company of the branch).
A successful registration of the company or the branch of the company leads to a subscription to business events of the represented company. This is needed to assess impact of these business events on service delivery to the company or the branch.
The subscription process can also be triggered for technical reasons: for instance to resend subscription requests because an error occurred at DO-side. |
Initiate subscription | DE | Service | Initiate subscription:
Note: subscriber should unsubscribe and re-subscribe if participant-id changes. To be able to do so, subscriptions have to be registered at the DE. |
Trigger cancel subscription | eProcedure / Public service / Notification | Service | Potential triggers to cancel a subscription are:
|
Cancel subscription | DE | Service | Cancel subscription:
|
Lookup event provider routing information | DR | Service | Lookup information on competent authority that facilitates subscription service (metadata tbd)
|
Inform National Coordinator that un-subscription was not successful | DR | User | In case of the cancellation of a subscription there is a slight chance the participant ID of DO has changed: a manual process deals with this (unhappy) flow. |
Send (un)subscription request | DR | Service | Send the request to subscribe or unsubscribe to the DT. |
Forward (un)subscription error | DR | Service | Forward (un)subscription error message received from DT to DE |
Investigate reason for (un)subscription error | DE | User | Analyse error and take appropriate actions (error could be on side of DE of DO) (exception so no need to model this in detail) |
Forward confirmation | DR | Service | Forward the confirmation on the (un)subscription request (received from the DT) to the DE. |
Log (un)subscription information | DE | Service | The confirmation is logged to complete the audit trail.
Note: register in a way that it is easily readable (optional: include subscription id). |
Validate (un)subscription request | DT | Service | Technical validation including forwarding to data owner. Technical exception out of scope |
Evaluate (un)subscription request | DO | Service | Functional check of request to subscribe: does company exists, are type of events/subscription supported, is DE authorized.
Functional check of request to unsubscribe: does subscription exists.
|
Prepare (un)subscription error message | DO | Service | Collect the content (mainly the link to the request and the error message) and send it to DT |
Send (un)subscription error message | DT | Service | Forward to DR |
Register (un)subscription | DO | Service | Data owner creates/ends the DE’s subscription on the company’s events.
Remarks:
|
Confirm (un)subscription | DO | Service | Create a confirmation: (un)subscription result (success), timestamp, link to (un)subscription request and send to DT (if applicable) |
Send (un)subscription confirmation | DT | Service | Send confirmation to DR
|
- A / M = Automated or Manual
Notes:
- A user centric perspective is that the user can cancel the subscription and prefers to provide the changes in company registration manually. This is out of scope.
- Separation of domains:
- BRIS domain: if a branch of a certain company type (limited company) is registered in the Business Register of MS the consequences are:
- The subscription is already covered by BRIS and legally necessary as long as branch is registered.
- User has no influence on subscription process
- SDG domain, if company is registered at DE:
- subscription and explicit request as long as eProcedure runs? tbd
- BRIS: covers some cases; check at DE if subscription is already covered by BRIS?
Event Notification
Business Process (picture)
Activity / UC | Role | Type | Description |
Trigger Change in registered company | Company representative / SP | User | A change in the company registration triggers the notification process. The change in company registration can be initiated by:
|
Change company registration | DO | User | Standard process of the Data Owner - Business Register - to process changes in company registration. |
Identify event | DO | Service | The DO matches the changes in company registration to the business event catalogue (event monitoring), identifies the business event that has taken place and determines which processes are related to the business event.
The DO triggers all process(es) related to the identified event:
Note that an event could resort under BRIS and under OOP TS regulation; e.g. a cross-border merger of a company and Bolagsverket and RVO have a subscription on this company: this leads to a BRIS notification to Bolagsverket and an OOP TS notification to RVO. |
Check subscription | DO | Service | Check the subscription registration for subscribers to the company that is the subject of the business event:
|
Extract evidence | DO | Service | Extraction of changed data to include in notification (could be part of prepare notification step). |
Prepare notification message and subscriber list | DO | Service | Make a list of the subscribers to notify and create the payload of the notification. The payload includes the changed data, so changed data is not missed when different notifications follow shortly after each other. The original value and new value of the changed elements are included and not the whole Company Registration evidence (sometimes the original value is needed (e.g. EUID). |
Resolve service metadata | DT | Service | Move from a list to single notifications (one for each subscriber) and lookup the routing information for each notification. |
Resolve subscriber participant ID and inform National Coordinator | DT | User | If address / DE participant id is not found in the metadata, manual action is needed: contact DE / MS of participant id to analyse the exception and take appropriate measures. |
Request from DE to resend event notifications | DE | User | Exception flow for missed notifications (failed or non-failed): if a DE misses notifications a resend of notifications can be requested. |
Resend past event notifications | DT | User | The resending of previously sent notifications requires a manual action at the DT. |
Send event notification | DT | Service | Send notification, receive the acknowledgement that the notification has been received by the DR and update the audit log with both the event notification and the acknowledgement. |
Validate event notification | DR | Service | DR performs a technical validation of the event notification and forward it to the DE. A technical exception flow is out of scope of this process description.
|
Determine event response | DE | Service | Check the notified business event and determine the action to be taken.
Note that every determination result is logged as a part of the audit trail or for internal reasons:
|
Request unsubscription | DE | Service | When the company cannot be identified or is no longer active. Afterwards this will have to be analysed this to find the cause of this apparently wrong subscription and to take appropriate measures. |
Dismiss event | DE | Service | The business event is not relevant for the DE and is dismissed. No further actions need to be taken. |
Update company information | DE | Service | The company data that is registered by the DE is updated, using the information in the notification. |
Identify business responses and notify responsible party | DE | User | Notify responsible party or organizational unit (that then contacts the company if needed).
Depends on process, case by case, if this can be automated or manually. |
Note:
- A functional response from DE to DO, for example to inform that appropriate actions have been taken, are out of scope of DE4A / OOP TS (it is part of BRIS requirements though). Check.
- Notifications from DE to DO (resulting from changes in the branch registration) are out of scope of DE4A / OOP TS.
Process Realization
?All on one Page or do we create sub-pages for Business Process and Process Realization?
Used by the following use cases
Application collaborations
TBD