Skip to content

Commit be0673a

Browse files
committed
update source constrains examples
1 parent 716a5fa commit be0673a

1 file changed

Lines changed: 7 additions & 11 deletions

File tree

‎ImplementationGuidance/Specifications/query_specification.md‎

Lines changed: 7 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -90,7 +90,7 @@ The terms MUST, SHOULD, MAY are used as defined in RFC 2119 https://tools.ietf.
9090
large (e.g., if the client specified `MONDO:0000001: disease or disorder`), the server SHOULD
9191
return a runtime error gracefully.
9292

93-
## Specifying permitted and excluded KPs to an ARA
93+
## Specifying permitted and excluded sources to an ARA
9494
- The proper syntax for specifying or excluding specific knowledge sources (infores CURIEs) to an ARA MUST be done
9595
via a `sources` constraint on a QEdge within the `constraints` object. The following is a complete Query example that disallows the
9696
use of SemMedDB:
@@ -136,33 +136,29 @@ The terms MUST, SHOULD, MAY are used as defined in RFC 2119 https://tools.ietf.
136136
}
137137
```
138138

139-
A general "allowlist" SHOULD look like this:
139+
An allowlist with `behavior` set to "ALLOW" requires at least one of the specified infores CURIEs to be present in the sources of bound edges:
140140
```
141141
"constraints": {
142142
"sources": {
143143
"behavior": "ALLOW",
144144
"values": [
145-
"infores:rtx-kg2",
146-
"infores:biothings-explorer"
145+
"infores:chembl",
146+
"infores:chebi"
147147
]
148148
}
149149
},
150150
```
151151

152-
(when `behavior` is set to "ALLOW", ANY (at least 1) of the given infores CURIEs MUST be present in the sources of bound edges)
153-
154-
Here is what a general "denylist" should look like:
152+
A denylist with `behavior` set to "DENY" excludes all of the specified infores CURIEs from the sources of bound edges:
155153
```
156154
"constraints": {
157155
"sources": {
158156
"behavior": "DENY",
159157
"values": [
160-
"infores:rtx-kg2",
161-
"infores:biothings-explorer"
158+
"infores:ctd",
159+
"infores:reactome"
162160
]
163161
}
164162
},
165163
```
166164

167-
(when `behavior` is set to "DENY", ALL of the given infores CURIEs MUST NOT be present in the sources of bound edges)
168-

0 commit comments

Comments
 (0)