DavidStables (talk | contribs) No edit summary |
DavidStables (talk | contribs) No edit summary |
||
Line 16: | Line 16: | ||
|0..1<br> | |0..1<br> | ||
|colspan="2"|textSearch | |colspan="2"|textSearch | ||
|<span title="any valid json value characters with json escapes">xsd:string</span> | |<span title="any valid json value characters with json escapes">[https://www.w3.org/TR/owl2-profiles/xsd:string]</span> | ||
|If a free text search is part of the query | |If a free text search is part of the query | ||
Line 36: | Line 36: | ||
1..1<br> | 1..1<br> | ||
|queryIri | |queryIri | ||
|<span title="international resource identifier">sh:IRI</span> | |<span title="international resource identifier">[https://www.w3.org/TR/owl2-profiles/sh:IRI]</span> | ||
|The IRI of a predefined query in the information model. i.e. request the system to run query X | |The IRI of a predefined query in the information model. i.e. request the system to run query X | ||
Line 42: | Line 42: | ||
|0..1<br> | |0..1<br> | ||
|colspan="2"|referenceDate | |colspan="2"|referenceDate | ||
|<span title="im date time format">im:DateTime</span> | |<span title="im date time format">[https://www.w3.org/TR/owl2-profiles/im:DateTime]</span> | ||
|reference date for date ranges that use reference date. Note that it could be passed in as an argeument | |reference date for date ranges that use reference date. Note that it could be passed in as an argeument | ||
Line 49: | Line 49: | ||
|1..1<br> | |1..1<br> | ||
|colspan="2"|pageNumber | |colspan="2"|pageNumber | ||
|<span title="whole number">xsd:integer</span> | |<span title="whole number">[https://www.w3.org/TR/owl2-profiles/xsd:integer]</span> | ||
|Page number (starting at 1) | |Page number (starting at 1) | ||
Line 55: | Line 55: | ||
|1..1<br> | |1..1<br> | ||
|colspan="2"|pageSize | |colspan="2"|pageSize | ||
|<span title="whole number">xsd:integer</span> | |<span title="whole number">[https://www.w3.org/TR/owl2-profiles/xsd:integer]</span> | ||
|number of entries per page | |number of entries per page | ||
Line 62: | Line 62: | ||
|1..1<br> | |1..1<br> | ||
|colspan="2"|parameter | |colspan="2"|parameter | ||
|<span title="any valid json value characters with json escapes">xsd:string</span> | |<span title="any valid json value characters with json escapes">[https://www.w3.org/TR/owl2-profiles/xsd:string]</span> | ||
|Parameter name for a function or the parameter name for an argument | |Parameter name for a function or the parameter name for an argument | ||
Line 69: | Line 69: | ||
|1..1<br> | |1..1<br> | ||
|valueData | |valueData | ||
|<span title="any valid json value characters with json escapes">xsd:string</span> | |<span title="any valid json value characters with json escapes">[https://www.w3.org/TR/owl2-profiles/xsd:string]</span> | ||
|Vaue that is a literal such as a string or number | |Vaue that is a literal such as a string or number | ||
Line 76: | Line 76: | ||
1..1<br> | 1..1<br> | ||
|valueVariable | |valueVariable | ||
|<span title="any valid json value characters with json escapes">xsd:string</span> | |<span title="any valid json value characters with json escapes">[https://www.w3.org/TR/owl2-profiles/xsd:string]</span> | ||
|argumetn value which is a variable name to be resolved at run time | |argumetn value which is a variable name to be resolved at run time | ||
Line 90: | Line 90: | ||
1..1<br> | 1..1<br> | ||
|valueIri | |valueIri | ||
|<span title="international resource identifier">sh:IRI</span> | |<span title="international resource identifier">[https://www.w3.org/TR/owl2-profiles/sh:IRI]</span> | ||
|Argument value that is an iri | |Argument value that is an iri | ||
Line 99: | Line 99: | ||
|0..1<br> | |0..1<br> | ||
|colspan="2"|resultFormat | |colspan="2"|resultFormat | ||
|<span title="any valid json value characters with json escapes">xsd:string</span> | |<span title="any valid json value characters with json escapes">[https://www.w3.org/TR/owl2-profiles/xsd:string]</span> | ||
|Whether the result set is required flat select style json or a nested graphql json object style 'RELATIONAL' or 'OBJECT. Default is OBJECT | |Whether the result set is required flat select style json or a nested graphql json object style 'RELATIONAL' or 'OBJECT. Default is OBJECT | ||
Line 105: | Line 105: | ||
|0..1<br> | |0..1<br> | ||
|colspan="2"|usePrefixes | |colspan="2"|usePrefixes | ||
|<span title="">xsd:boolean</span> | |<span title="">[https://www.w3.org/TR/owl2-profiles/xsd:boolean]</span> | ||
|true if you want the results to use IRI prefixes | |true if you want the results to use IRI prefixes | ||
Line 111: | Line 111: | ||
|0..1<br> | |0..1<br> | ||
|colspan="2"|activeOnly | |colspan="2"|activeOnly | ||
|<span title="">xsd:boolean</span> | |<span title="">[https://www.w3.org/TR/owl2-profiles/xsd:boolean]</span> | ||
|Whether only active entities are included in the match clauses or select clauses | |Whether only active entities are included in the match clauses or select clauses | ||
Line 131: | Line 131: | ||
|0..1<br> | |0..1<br> | ||
|colspan="2"|mainEntity | |colspan="2"|mainEntity | ||
|<span title="international resource identifier">sh:IRI</span> | |<span title="international resource identifier">[https://www.w3.org/TR/owl2-profiles/sh:IRI]</span> | ||
|The main entity to which all matches must be related e.g. Patient or organisation. | |The main entity to which all matches must be related e.g. Patient or organisation. | ||
Line 145: | Line 145: | ||
|1..1<br> | |1..1<br> | ||
|colspan="2"|alias | |colspan="2"|alias | ||
|<span title="any valid json value characters with json escapes">xsd:string</span> | |<span title="any valid json value characters with json escapes">[https://www.w3.org/TR/owl2-profiles/xsd:string]</span> | ||
|An alias or reference term that can be used throughout a query as shorthand for the result set | |An alias or reference term that can be used throughout a query as shorthand for the result set | ||
Line 156: | Line 156: | ||
|1..1<br> | |1..1<br> | ||
|colspan="2"|label | |colspan="2"|label | ||
|<span title="any valid json value characters with json escapes">xsd:string</span> | |<span title="any valid json value characters with json escapes">[https://www.w3.org/TR/owl2-profiles/xsd:string]</span> | ||
|the name of the entity | |the name of the entity | ||
Line 162: | Line 162: | ||
|0..1<br> | |0..1<br> | ||
|colspan="2"|comment | |colspan="2"|comment | ||
|<span title="any valid json value characters with json escapes">xsd:string</span> | |<span title="any valid json value characters with json escapes">[https://www.w3.org/TR/owl2-profiles/xsd:string]</span> | ||
|the description of the entity | |the description of the entity | ||
Line 168: | Line 168: | ||
|1..1<br> | |1..1<br> | ||
|colspan="2"|type | |colspan="2"|type | ||
|<span title="">rdfs:Resource</span> | |<span title="">[https://www.w3.org/TR/owl2-profiles/rdfs:Resource]</span> | ||
|the base type of the entity i.e. one of the high level entity types | |the base type of the entity i.e. one of the high level entity types | ||
Line 174: | Line 174: | ||
|1..1<br> | |1..1<br> | ||
|colspan="2"|status | |colspan="2"|status | ||
|<span title="A status that is in active or active">im:Status</span> | |<span title="A status that is in active or active">[https://www.w3.org/TR/owl2-profiles/im:Status]</span> | ||
|the status of the entity being active, inactive, draft or unassigned | |the status of the entity being active, inactive, draft or unassigned | ||
Line 180: | Line 180: | ||
|1..1<br> | |1..1<br> | ||
|colspan="2"|scheme | |colspan="2"|scheme | ||
|<span title="Core graphs for core ontologies such as the health information model, Discovery and Snomed">im:Graph</span> | |<span title="Core graphs for core ontologies such as the health information model, Discovery and Snomed">[https://www.w3.org/TR/owl2-profiles/im:Graph]</span> | ||
|The code scheme or graph which the entity belongs to | |The code scheme or graph which the entity belongs to | ||
Revision as of 08:26, 24 August 2022
Class | Field | Type | Comment | ||
---|---|---|---|---|---|
QueryRequest | 0..1 |
page | PageInformation | optional page number and size if the client is looking for paged results | |
0..1 |
textSearch | [1] | If a free text search is part of the query | ||
0..* |
argument | Argument | arguments to pass in to the query as parameters. Parameter name and value pairs. Values ,may be strings, numbers or IRIs | ||
1..1 or |
1..1 |
query | Query | The query definition for an inline dynamic query. If the query is already defined, use the queryIri. Arguments may be used in eoither approach | |
1..1 |
queryIri | [2] | The IRI of a predefined query in the information model. i.e. request the system to run query X | ||
0..1 |
referenceDate | [3] | reference date for date ranges that use reference date. Note that it could be passed in as an argeument | ||
PageInformation | 1..1 |
pageNumber | [4] | Page number (starting at 1) | |
1..1 |
pageSize | [5] | number of entries per page | ||
Argument | 1..1 |
parameter | [6] | Parameter name for a function or the parameter name for an argument | |
1..1 or |
1..1 |
valueData | [7] | Vaue that is a literal such as a string or number | |
1..1 |
valueVariable | [8] | argumetn value which is a variable name to be resolved at run time | ||
1..1 |
valueSelect | SelectClause | Argument value that is the result of a select query | ||
1..1 |
valueIri | [9] | Argument value that is an iri | ||
Query (subtype of ModelHeading) |
0..1 |
resultFormat | [10] | Whether the result set is required flat select style json or a nested graphql json object style 'RELATIONAL' or 'OBJECT. Default is OBJECT | |
0..1 |
usePrefixes | [11] | true if you want the results to use IRI prefixes | ||
0..1 |
activeOnly | [12] | Whether only active entities are included in the match clauses or select clauses | ||
1..1 or |
1..1 |
select | SelectClause | Select query clause logically similar to SQL/SPARQL select but with GraphQL nesting ability | |
0..1 |
ask | MatchClause | If the query is a boolean true or false use match clauses as an ask | ||
0..1 |
mainEntity | [13] | The main entity to which all matches must be related e.g. Patient or organisation. | ||
SelectClause | 0..* |
subselect | SelectClause | For a query with column groups such as a list report, the select query for each group | |
ModelHeading (subtype of Entity) |
1..1 |
alias | [14] | An alias or reference term that can be used throughout a query as shorthand for the result set | |
MatchClause | |||||
Entity | 1..1 |
label | [15] | the name of the entity | |
0..1 |
comment | [16] | the description of the entity | ||
1..1 |
type | [17] | the base type of the entity i.e. one of the high level entity types | ||
1..1 |
status | [18] | the status of the entity being active, inactive, draft or unassigned | ||
1..1 |
scheme | [19] | The code scheme or graph which the entity belongs to |