Tech-invite3GPPspaceIETFspace
21222324252627282931323334353637384‑5x

Content for  TS 32.161  Word version:  18.0.0

Top   Top   None   None   Next
0…   5…   6…   7…   A…   B…   C…   D…

 

0  Introductionp. 6

Information can be represented in a structured way using markup languages. Well-known and widely used markup languages are for example XML and JSON.
It is often required to identify distinct portions in XML or JSON documents. For XML, XPath has been designed for that purpose. XPath is very powerful and includes capabilities for conditional node selection with predicates. XPath expressions can select one or more portions of an XML document.
JSON Pointer serves a similar purpose. However, its capabilities are limited compared to XPath. For example, JSON Pointer expressions can identify only a specific node or subtree of a JSON document and not multiple nodes or subtrees. Furthermore, conditions are not supported in the information selection process.
This calls for a notation applicable to JSON documents with more advanced features than JSON Pointer. This notation is called Jex (JSON expressions). It is inspired by and based on XPath.
Even though XPath was originally designed to select one or more nodes of an XML document, XPath expressions operate on a conceptual data model, the XPath data model. A mapping from the XML Information Set to the XPath data model is provided in Annex B of XPath 1.0 [2].
The main purpose of the Jex specification is to provide a mapping from a JSON document to the XPath data model. With this in place XPath expressions are (indirectly) applicable to JSON.
The present document will also introduce a few profiles for XPath. These profiles are designed to provide the functionality required for network and service management.
Clause 4 provides a short review of the XPath data model. Clause 6 defines the mapping of a JSON document to the XPath data model, and clause 7 introduces a few Jex profiles. Annex A demonstrates to use of Jex for network management tasks.
Readers should be familiar with XPath 1.0 [2] and JSON (IETF RFC 8259).
Up

1  Scopep. 7

The present TS introduces JSON expressions (Jex).

2  Referencesp. 7

The following documents contain provisions which, through reference in this text, constitute provisions of the present document.
  • References are either specific (identified by date of publication, edition number, version number, etc.) or non-specific.
  • For a specific reference, subsequent revisions do not apply.
  • For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same Release as the present document.
[1]
TR 21.905: "Vocabulary for 3GPP Specifications".
[2]
W3C® Recommendation 16 November 1999: "XML Path Language (XPath) Version 1.0", (https://www.w3.org/TR/xpath-10/).
[3]
W3C® Recommendation 14 December 2010: "XML Path Language (XPath) 2.0", (Link errors corrected 3 January 2011; Status updated October 2016), (https://www.w3.org/TR/xpath20/).
[4]
W3C® Recommendation 21 March 2017: "XML Path Language (XPath) 3.1", (https://www.w3.org/TR/xpath-31/).
[5]
W3C® Recommendation 21 March 2017: "XQuery and XPath Data Model 3.1", (https://www.w3.org/TR/xpath-datamodel-31/).
[6]
RFC 8259:  "The JavaScript Object Notation (JSON) Data Interchange Format".
[7]
W3C® Recommendation: "World Wide Web Consortium. Extensible Markup Language (XML) 1.0". (http://www.w3.org/TR/1998/REC-xml-19980210).
Up

3  Definitions of terms, symbols and abbreviationsp. 7

3.1  Termsp. 7

For the purposes of the present document, the terms given in TR 21.905 and the following apply. A term defined in the present document takes precedence over the definition of the same term, if any, in TR 21.905.

3.2  Symbolsp. 7

Void.

3.3  Abbreviationsp. 8

For the purposes of the present document, the abbreviations given in TR 21.905 and the following apply. An abbreviation defined in the present document takes precedence over the definition of the same abbreviation, if any, in TR 21.905.
Jex
JSON Expression

4  XPath data modelp. 8

The XPath data model is described in clause 5 of W3C Xpath1.0 specification [2]. It is a conceptual model without formal notation.
The model consists of nodes with relationships between them. There are seven types of nodes defined: root node, element node, text node, attribute node, namespace node, processing instruction node, comment node.
Note that the data model for XPath 2.0 [3] and XPath 3.1 [4] is described in XQuery and in XPath Data Model 3.1 [5]. This model is not used in the present document.
Up

Up   Top   ToC