Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

...

Expand
titleLCM Event Details

Current LCM Event Object

FieldTypeDescriptionKafka HeaderEvent Payload FieldNotes (M=Mandatory, O=Optional)CloudEvents Mapping
eventIDstringThe unique id identifying the eventx
Mstandard (id)
eventCorrelationIdstringThe id identifying the event.  In LCMEvent this is always a cmhandleIdx
O ( extension fields will be optional now )extension(correlationid)
eventTimestringThe timestamp when original event occurredx
Mstandard ( time )
eventSourcestringThe source of the eventx
Mstandard ( source )
eventTypestringThe type of the eventx
Mstandard ( type )
eventSchemastringThe schema that this event adheres to. x

M
E.g. cps:org.onap.ncmp.cmhandle.lcm-event:1.0.0

standard (dataschema)
eventSchemaVersionstring

The version of the schema that this event adheres to

x

M

e.g v1.0

N/A included in 'datascemadataschema'
eventEventThe payload of an event

Mstandard ( data )

Type:Event (cps:org.onap.ncmp.cmhandle.lcm-event:v1)

FieldTypeDescriptionKafka HeaderEvent Payload FieldNotes
cmHandleIdstringcmHandle id
x
oldValuesValues

Values that represents the state of a cmHandle


xDefined by values object below
newValuesValuesValues that represents the state of a cmHandle
xDefined by values object below

Type:Values

FieldTypeDescriptionKafka HeaderEvent Payload FieldNotes
dataSyncEnabledstringcmHandle id
x
cmHandleStatestring

State of cmHandle


xEnum: 

["ADVISED", "READY", "LOCKED", "DELETING", "DELETED"]

cmHandlePropertiesobjectcmHandle properties
xList of Java <String, String> Maps


...

Expand
titleDMI Data AVC Event

AVC Event Object

FieldTypeDescriptionKafka HeaderEvent Payload FieldNotes (M=Mandatory, O=Optional)CloudEvents Mapping
eventIDstringThe unique id identifying the eventx
Mstandard (id)
eventCorrelationIdstringThe id identifying the eventxMeventTime
Oextension(correlationid)
eventTimestringThe timestamp when original event occurredx
Ostandard (time)
eventSourcestringThe source of the eventx
O Needs clarification, see issue #8standard (source)
eventTypestringThe type of the eventx
M (e.g. cps:org.onap.cps.ncmp.events:avc-event)standard (type)
eventSchemastringThe schema that this event adheres tox
M (e.g. cps:org.onap.cps.ncmp.events:avc-event-schema)standard (dataschema)
eventSchemaVersionstring

The version of the schema that this event adheres to

x
M (e.g. v1.0 orv2.0)N/A included in 'dataschema'
eventEventThe payload of an event

Mstandard (data)

Type: Event (cps:org.onap.cps.ncmp.events:avc-event-schema:v1)

FieldTypeDescriptionKafka HeaderEvent Payload FieldNotes

No Properties defined (entire event treated as single object) See open issue #1
Priyank Maheshwari  This is how the event will look like.

CPS-1065 Spike: CM data notifications from NCMP to applications including subscriptions#EventPayloadExample


...

AVC Subscription Event  (External Clients Apps  → NCMP) : ON HOLD - kieran mccarthy to analyze further

Priyank Maheshwari  We need to revisit this schema and include the cloud events fields. ( At the moment this doesnt have proper fields ) 

Expand
titleAVC Subscription Event

Subscription Event Object

FieldTypeDescriptionKafka HeaderEvent Payload FieldNotesCloudEvents Mapping
versionstringThe event type version

ekiemcc : What is this version?  This should be covered in the header now?
eventTypestring

The event type



ekiemcc : This is now covered by the header?  Is this needed any longer in the body?

Enum: 

["CREATE"]

standard ( type )
eventEventThe payload for an event

Defined by event object belowstandard ( data ) 

Event Object (cps:org.onap.cps.ncmp.events:avc-subscription-event:v1)

FieldTypeDescriptionKafka HeaderEvent Payload FieldNotes
subscriptionSubscriptionThe subscription details
xDefined by subscription object below
dataTypeDataType

The datatype content


xDefined by dataType object below
predicatesPredicates

Additional values to be added into the subscription


xDefined by predicates object below

Type: Subscription

FieldTypeDescriptionKafka HeaderEvent Payload FieldNotes
clientIDstring

The client ID


x
namestring

The name of the subscription


x
isTaggedboolean

optional parameter, default is false


xdefault: false

Type: DataType

FieldTypeDescriptionKafka HeaderEvent Payload FieldNotes
dataspacestring

The dataspace name


x
dataCategorystring

The category type of the data


x
dataProviderstring

The provider name of the data


x
schemaNamestring

The name of the schema


x
schemaVersionstring

The version of the schema


x

Type: Predicates

FieldTypeDescriptionKafka HeaderEvent Payload FieldNotes
targetsarray

CM Handles to be targeted by the subscription


x
datastorestring

datastore which is to be used by the subscription


x
xpath-filterstring

filter to be applied to the CM Handles through this event


x


...

Expand
titleDMI Async Request Response Event

DmiAsyncRequestResponse Event Object

FieldTypeDescriptionKafka HeaderEvent Payload FieldNotesCloudEvents Mapping
eventIDstringThe unique id identifying the event generated by DMIx

standard ( id ) 
eventCorrelationIdstring

The request id passed by NCMP

x

extensions ( correlationid )
eventTimestringThe timestamp when original event occurredx

standard ( time) 
eventTargetstringThe target of the eventx

extensions ( target )
eventTypestringThe type of the eventx

standard ( type ) 
eventSchemastring

The event schema for async request response events

x

standard ( dataschema ) 
eventSchemaVersionstring

The event schema version for async request response events

x

N/A included in 'dataschema'
eventSourcestringThe source of the eventx

standard ( source ) 
eventContentEventContentThe payload of an event

The name of this fields is inconsistent with all other event schemas, see issue #6

standard ( data ) 

Type: EventContent (cps:org.onap.cps.ncmp.events:dmi-async-request-response-event-schema:v1)

FieldTypeDescriptionKafka HeaderEvent Payload FieldNotes
repsonse-data-schemastring

The schema of response data


x
response-statusstring

The status of the response


x
response-codestring

The code of the response


x
response-dataobjectThe data payload
xcontains payload of type object


...

Expand
titleNCMP Async Request Response Event

NcmpAsyncRequestResponse Event Object

FieldTypeDescriptionKafka HeaderEvent Payload FieldNotes
eventIDstringThe unique id identifying the event generated by DMIx

eventCorrelationIdstring

The request id passed by NCMP

x

eventTimestringThe timestamp when original event occurredx

eventTargetstringThe target of the eventx

eventTypestringThe type of the eventx

eventSchemastring

The event schema for async request response events

x

eventSchemaVersionstring

The event schema version for async request response events

x

eventEventThe payload of an event

Defined by event object below
forwardedEventForwardedEventThe payload of a forwarded event

Relation to Event field unclear, do we need 2 events at all see issue #7

Type: Event (cps:org.onap.cps.ncmp.events:ncmp-async-request-response-event-schema:v1)

FieldTypeDescriptionKafka HeaderEvent Payload FieldNotes
eventIDstringThe unique id identifying the event generated by DMI
xOnly in payload in v1 of the payload schema.  To be removed in v2 version (will be in the header only)
eventCorrelationIdstring

The request id passed by NCMP


xas above
eventTimestringThe timestamp when original event occurred
xas above
eventTargetstringThe target of the event
xas above
eventTypestringThe type of the event
xas above
eventSchemastring

The event schema for async request response events


xas above
eventSourcestring

The source of the event


x
response-data-schemastring

The received schema of response data


x
response-statusstring

The received status of the response


x


response-codestring

The received code of the response


x
response-dataobject

The data payload


xcontains payload of type object

Type: forwardedEvent (cps:org.onap.cps.ncmp.events:ncmp-async-request-response-event-schema:v1)

FieldTypeDescriptionKafka HeaderEvent Payload FieldNotes
eventIDstringThe unique id identifying the event generated by DMI
?Can NCMP put these in the header and remove them from the 'forwardedEvent'
eventCorrelationIdstring

The request id passed by NCMP


?as above
eventTimestringThe timestamp when original event occurred
?as above
eventTargetstringThe target of the event
?as above
eventTypestringThe type of the event
?as above
eventSchemastring

The event schema for async request response events


?as above
eventSchemaVersionstring

The event schema version for async request response events


?as above
eventSourcestring

The source of the event


?as above
response-data-schemastring

The received schema of response data


x
response-statusstring

The received status of the response


x


response-codestring

The received code of the response


x
response-dataobject

The data payload


xcontains payload of type object


Proposed New Schema:
Jira Legacy
serverSystem Jira
serverId4733707d-2057-3a0f-ae5e-4fd8aff50176
keyCPS-1660


FieldTypeDescriptionKafka HeaderEvent Payload FieldNotesNotesCloudEvents Mapping
eventIDstringThe unique id identifying the event generated by DMI


standard (id)
eventCorrelationIdstring

The request id passed by NCMP




extensions(correlationid)
eventTimestringThe timestamp when original event occurred


standard (time)
eventSourcestringThe source of the event

What value should contain in this? Needs clarification, see issue #8standard (source)
eventTypestringThe type of the event


standard (type)
eventSchemastring

The event schema for async request response events




standard (dataschema)
eventSchemaVersionstring

The event schema version for async request response events




N/A included in 'dataschema'
eventEventThe payload of an event

Defined by event object belowstandard (data)

Type: Event (cps:org.onap.cps.ncmp.events:ncmp-async-request-response-event-schema:v1)

FieldTypeDescriptionKafka HeaderEvent Payload FieldNotes
eventCorrelationIdstring

The request id passed by NCMP



as above @Toine asked to add this property.
responseStatusstring

The received status of the response




responseCodestring

The received code of the response




responseDataobject

The data payload



contains payload of type object



...

Before

After

CloudeEvent builder methodExample ValueNotes

eventId

id

.withId()
Mandatory

eventSource

source

.withSource()
Mandatory

N/A

specversion  (default 1.0)

.v1()1.0Mandatory  - This is the version of the cloud events

eventType

type

.withType()
Mandatory

eventTime

time

.withTime()
Optional

eventSchema

dataschema

.withDataSchema()

Optional  includes the version of the schema


datacontenttype
withDataContentType()
application/jsonOptional
eventCorrelationIdcorrelationid.withExtension()

( O ) This will be part of the extensions field in the cloud events and all the restrictions of the attribute field naming applies to it.

i.e these fields will be in the small case.

This is marked as optional as it applies to the event which has this field.

eventdata.withData(json TBC)
( M ) actual event/payload now would be under "data" field.

...