| Table of Contents |
|---|
Resources
Jira server ONAP JIRA serverId 425b2b0a-557c-3c0c-b515-579789cceedb key CPS-235 - https://www.softwaretestinghelp.com/xpath-writing-cheat-sheet-tutorial-examples/
- https://www.freeformatter.com/xpath-tester.html
...
| Incorrect | Correct | Bookstore XML extract for testing xPath Queries online | |||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
Open Issues & Decision
| # | Slogan | Notes | Answer |
|---|---|---|---|
| 1 | Is there and xPath expression to 'include or exclude all descendants' | Alternatively client can pass an enum option | Need to use output option additional to the cpsPath (xpath) expression! Although xpath has many options to include or exclude children from filters (conditions) it does NOT control what is being returned. |
Queries
Scope of queries
- The assumes scope for all below Queries is one Dataspace and oen Anchor.
- It will be relatively easy to extend the scope to multiple anchors in a later user story.
- There is no need to extend the scope beyond one Dataspace
xpath functions
| Slogan | cpsPath | Jira | Notes | Priority / When do we need this? | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | get (list element) by xpath | /bookstore/categories[@code='01'] |
| This is not really a query as code is the key attributes and this xpath is stored with the target fragment | Already implemented | ||||||||
| 2 | filter list element by other (then key) leaf value | /bookstore/categories[@name='SciFi'] |
| Compare to #1, notice how from a cpsPath perspective it is not clear which is a get and which is a query. The customer might not know either! See issue #1 | Required for E2E Slicing see CPS-200 study | ||||||||
| 3 | xpath ending (with possible refernce to list key) |
| Client ignore/does not care/does not know the preceding xpath | Investigate if needed for E2E Slicing. | |||||||||
| 4 | xpath ending combined with leafvalue filter | //categories[@name='SciFi'] | |||||||||||
| 5 | filter on leaf value without any path | //*[@name='Chapters'] | This will return anything with that name, might be useful when working with small models | ||||||||||
| 6 | allow any element from list ie. find something under any possible list entry | /bookstore/categories/books/book[@name='Chapters'] | Not obvious but since /categories is not indexed (no key defined using [@...] notation) it will return a book from any categories | ||||||||||
| 7 | partial xpath, wildcard in the middle of the path . Could be seen as combination of starts-with and end-with | /bookstore/categories//book[@name='Chapters'] | using // in the middle of a path is like a wildcard for any containers or lists between /categories and /book | ||||||||||
| 8 | combining several leaf values (and, or etc.) Can bee seen too for composite list-keys and does work in scenario #1 above (but is order dependent) | [@id1 = x and @id2 = y] | just for illustration purposes | ||||||||||
| 9 | (string) leave value contains something | [contains()] | just for illustration purposes | ||||||||||
| 10 | get direct ancestor | //*[child::book[@name='Chapters']] //book[@name="Chapters"]/.. | |||||||||||
| 11 | get ancestor by type | <query>/ancestor::bookstore e.g //book[@name="Chapters"]/ancestor::bookstore | Required for end to end API call #1 |
...
Note 2. At the start the cpsPath can probably be examined using regular expression to distinguish between the queries. But at some stage we might need to write a more advanced parsing using tools like Antlr. There might also be existing utilities breaking down xpaths?
Updates
...
| Jira | ||||||||
|---|---|---|---|---|---|---|---|---|
|
...
should be possible to add node with just the data for the new node (which includes a full xpath so that the parent an be identified)
further descendant can easily be included (should not require additional work ie. separate user story)
question: should the xpath for the list entry be generated (using the model and keyfield(s) data) or included in the dat provided by the client
...