From 05316071752c98620a4aa77fa13998a654546cd5 Mon Sep 17 00:00:00 2001 From: "puthuparambil.aditya" Date: Fri, 23 Apr 2021 12:52:09 +0100 Subject: [PATCH] Documents update for multiple attributes support in Get Descendent API Issue-ID: CPS-309 Signed-off-by: puthuparambil.aditya Change-Id: Iceb62b784e3e5281d8a8ab443c4ece45fa121dc2 --- docs/cps-path.rst | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/docs/cps-path.rst b/docs/cps-path.rst index 91bfdcb43..160aa9389 100644 --- a/docs/cps-path.rst +++ b/docs/cps-path.rst @@ -74,7 +74,7 @@ Get List Elements by Any Attribute Value - Only string and integer values are supported (boolean and float values are not supported). **Notes** - - For performance reasons it does not make sense to query the list key leaf. If the key value is known it is better to execute a get request with the complete xpath. + - For performance reasons it does not make sense to query using key leaf as attribute. If the key value is known it is better to execute a get request with the complete xpath. Get Any Descendant ------------------ @@ -93,13 +93,13 @@ Get Any Descendant - List elements can only be addressed using the list key leaf. Get Any Descendant by Any Attribute Value ------------------------------------------- +----------------------------------------- **Syntax**: ``//[@=]`` - ``direct-ancestors``: Optional path to direct ancestors of the target node. This can contain zero to many ancestor nodes separated by a /. - ``target-node``: The name of the (list) node which elements will queried. - - ``leaf-name``: The name of the leaf which value needs to be compared. - - ``leaf-value``: The required value of the leaf. + - ``leaf1-name .. leafN-name:``: One or more leaves whose value needs to be compared. + - ``leaf1-value .. leafN-value:``: One or more required leaf values (multiple condition can be combined using the 'and' keyword). **Examples** - ``//categories[@name='Kids']`` @@ -107,5 +107,4 @@ Get Any Descendant by Any Attribute Value **Limitations** - Only string and integer values are supported (boolean and float values are not supported). - - Multiple attributes should be separated by 'and'. - - Trailing 'and' is ignored in the yang list. \ No newline at end of file + - Multiple attributes can only be combined using 'and'. 'or' and bracketing is not supported. \ No newline at end of file -- 2.16.6