Open APIs

In context of Event Management (including the notification model in each TMF API), the Event object contains the target entity value at the moment of the event; so in the Event model we have information about the target entity only as event consequence, but we don't have the previous values of the entity.

E.g:  as you can see in the screenshot below (example from the user guide v.4.0.0), you have the target entity "alarm" defined with the values as consequence of the event occurred, but in case of eventType like AttributeValueChangeEvent there is not the possibility to pass,as part of event model, the previous attributes values (the  "alarm" values before that the event occurred).

Based on what we understood should be eventually the consumer of this event to have stored the previous entity state (the previous entity attribute values) and we can't support a stateless consumer that will process an event in case of "AttributeValueChangeEvent" or  "StateChangeEvent".

Are our assumption right and did you discuss how to handle in event model the previous status/values of the entity?

Thanks and regards,

Luca

------------------------------
Luca Icardi
Accenture
------------------------------

Hi Luca

There has been some discussion on this in the Open API team. The current guidance is that the PATCH Merge syntax should be used (which allows the payload in the event schema to be the entity schema itself). At least in v5, we are trying to ensure that the examples (embedded in the swagger and in the user guide) align to this guidance.

Hope it helps

------------------------------
Jonathan Goldberg
Amdocs Management Limited
Any opinions and statements made by me on this forum are purely personal, and do not necessarily reflect the position of the TM Forum or my employer.
------------------------------

Hi Jonathan, 

thank you for your answer!

May I kindly ask you if there is already a draft of the v5 that I could use as reference?

Thanks and regards,

Luca

------------------------------
Luca Icardi
Accenture
------------------------------

Original Message:
Sent: Aug 01, 2023 02:26
From: Jonathan Goldberg
Subject: TMF688 Event Management - Event entity previous value

Hi Luca

There has been some discussion on this in the Open API team. The current guidance is that the PATCH Merge syntax should be used (which allows the payload in the event schema to be the entity schema itself). At least in v5, we are trying to ensure that the examples (embedded in the swagger and in the user guide) align to this guidance.

Hope it helps

------------------------------
Jonathan Goldberg
Amdocs Management Limited
Any opinions and statements made by me on this forum are purely personal, and do not necessarily reflect the position of the TM Forum or my employer.
------------------------------