Versions Compared

Key

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

Addresses: 

Jira
serverONAP JIRA
serverId425b2b0a-557c-3c0c-b515-579789cceedb
keyCPS-72

Problem description

The fully qualified XPath for XML includes unique node identifiers in a format /<namespace> : <node name>[ <index> or <extra conditions> ]/
where namespace  and node name are used for unique type identification while namespace definition (mapping to known schema) isn't a part of XPath.

For YANG models we also have namespaces defined however there is additional parameter (revision) which is also a part of unique type definition.

Proposal

It makes sense to use both full namespace (not alias as in XML) and a revision to to be stored in database.

...

Code Block
themeEmacs
/* clear parent context difference */
/org:onap:sample:parentType(2020-01-01)[@attr1='value1']/org:onap:sample:childType(2020-02-02)[@attr2='value2']
/org:onap:sample:parentType(2020-02-02)[@attr1='value1']/org:onap:sample:childType(2020-02-02)[@attr2='value2']

/* unclear parent context (if only current node type is stored in database) */
/parentType[@attr1='value1']/childType[@attr2='value2']


To discuss and clarify

  • the naming convention for ease of parse/ store/ query by XPath
  • using indexes in XPAth like /node[0] if no keys defined in model
  • ordering multiple keys for composite key models on storage and requests 
  • or alternative approach for unique node type definition (in CPS XPath) with taking into account YANG models variations


Discussion results (Nov 16, 2020)

For now there is no need to store full module identifier in the xpath field. The namespace, revision, parent module context will be taken
into account using references through dedicated fields (module_id, parent_id).

...