diff --git a/md/clause-7.md b/md/clause-7.md index 901fa73fc014b672b9564e19fee70347474b59ee..ce597642cd966e5a8dc90674002c0bfaa11af6c7 100644 --- a/md/clause-7.md +++ b/md/clause-7.md @@ -1992,6 +1992,20 @@ Broker]{.HTML-Keyboard}. An example of this representation can be found in annex C, clause C.2.2.1.3. +### 7.7.4 Depth of retrieval + +When retrieving [Linked Entities]{.HTML-Keyboard}, the [Linking +Entity]{.HTML-Keyboard} may contain _Relationships_ to [Linked +Entities]{.HTML-Keyboard} which in turn may contain _Relationships_, to further +[Linked Entities]{.HTML-Keyboard}. Complete traversal of a chain of linked +Entities could result in payloads of an excessive length. Therefore to mitigate +this, the default depth of retrieval (or _`joinLevel`_) shall be set to one, +meaning that only one level of _Relationships_ are traversed, though this may be +overridden on request. Furthermore, to avoid unnecessary duplication, whenever a +[Linked Entity]{.HTML-Keyboard} has already been previously encountered during graph +traversal at a shallower depth, its [Linked Entities]{.HTML-Keyboard} shall not undergo +further expansion for a second time. + ## 7.8 Tenants #### 7.8.1 Introduction