1 Definition | 2 Functional Requirements | 3 Syntax | 4 Semantics |
1 Definition
An Item used by a Process to request that a Service discover Items and Processes based on the basic discovery method specified by MMM-TEC.
2 Functional Requirements
Discovery Request includes
- The IDs of a model Items or Processes.
- Item ID, the Item, or the Process ID of which similar Items or Processes is being searched.
- Model Rights for Use of Basic Discovery Response.
Examples of the object of a Discovery Request are:
- Text specifying the characteristics of the Object or Process.
- The M-Location wrapping a Model Item
- A Perceptible Entity describing the Item or the Process.
- Model Rights to use the Basic Discovery Response.
Basic Discovery Response includes a set of:
- Item ID, Process ID, and Perceptible Entity.
3 Syntax
https://schemas.mpai.community/MMM4/V2.1/data/BasicDiscovery.json
4 Semantics
Label | Size | Description |
Header | N1 Bytes | Basic Discovery Header |
– Standard-BasicDiscovery | 9 Bytes | The characters “MMM-BDV-V” |
– Version | N2 Byte | Major version – 1 or 2 characters |
– Dot-separator | 1 Byte | The character “.” |
– Subversion | N3 Byte | Minor version – 1 or 2 characters |
M-InstanceID | N4 Bytes | Identifier of M-Instance. |
BasicDiscoveryID | N5 Bytes | Identifier of Basic Discovery. |
BasicDiscovery | N6 Bytes | Data of Basic Discovery. |
– BasicDiscoveryRequest | N7 Bytes | Data of Request |
– ItemID | N8 Bytes | ID of Item provided as an example of what is searched. |
– MLocation | N9 Bytes | The M-Location wrapping a Model Item. |
– ProcessID | N10 Bytes | Process ID provided as an example of what is searched. |
– PerceptibleEntity | N11 Bytes | A perceptible Item. |
– BasicDiscoveryResponse | N12 Bytes | Data of Response |
– Items[] | N13 Bytes | List of IDs of found Items. |
– ItemID | N14 Bytes | the ID of a found Item. |
– PerceptibleEntity | N15 Bytes | A perceptible Item. |
– Processes[] | N16 Bytes | List of IDs of found Processes. |
– ProcessID | N17 Bytes | The ID of a found Process. |
– PerceptibleEntity | N18 Bytes | A perceptible Item. |
DescrMetadata | N19 Bytes | Descriptive Metadata |