Smart Connector - Semantic tagging

[esari]

Hello

I have create semantic tagging to EBO 2022. How can I accees it from Smart Connector?

I have found folder

{
"Name": "Ontology Graph",
"Description": "https://brickschema.org/schema/Brick#Class",
"Type": 3,
"ParentId": "00/eValvomo",
"Id": "40https://brickschema.org/schema/Brick#Class"
}

But I dont know what to do next.

If I understand correcly. Third party company could use semantic tagging structure to browse to point or trend log and they don't need to know actual SBO path. Is this correct?

--

Esa

[ardak]

Hi Esa,

Semantic tagging in EBO is new and is a pretty big topic and there should be documentation out soon describing the EBO and EWS implementation, and the Smartconnector interface to the graph.

Smartconnectors interface to the graph is heavily dependent on the EWS implementation, which works like this:

You can navigate the graph by doing GetContainerItems calls on semantic nodes, denoted by the prefix "40". This call will return any relations that node has. That way you can navigate the graph and look for nodes that interest you. Those nodes can have relationships to EBO items, which you can fetch normally using normal GetItems calls using their EWS Id.

In SmartConnector GetContainerItems is used by GET/Containers/Children, so in your case a call to

GET/Containers/Children with Id "40https://brickschema.org/schema/Brick#Class"

would give you all nodes related to the base brick class and would be a good starting point.

You can also do the reverse using the "includeMetadata" query parameter on EBO objects. If an EBO object has a semantic relation connected to it, you will get it in the form of metadata connected to the object. There is also a new /Metadata endpoint on each enitity type where applicable if you are only interested in the semantic metadata of an EBO object. This way you can ask "What does this represent" type questions on EBO objects and if the point is tagget, you will know it's a "Supply temperature sensor" or whatever it is.

Hope this helps

Armend

[esari]

Hello

I try to get children from that node, but I didn't receive anything. I got response:

{
"Message": "Container Id 40https://brickschema.org/schema/Brick#Class not found"
}

I have create Semantic 'Site' which has location 'Building' which have location 'Floor' which have 'Conference Room' which has point 'Temperature'.

Do I need to create some semantic 'root' object which can be found from "40https://brickschema.org/schema/Brick#Class" ?

--

Esa

[ardak]

Hi Esa, 

That should work if I'm not wrong. Are you URL encoding the ID? You can use this:

https://meyerweb.com/eric/tools/dencoder/

[ardak · Accepted solution]

Semantic metadata needs to be enabled in EWS Server Configuration in EBO2022:

[esari]

Hello

Yes.

It was that new EWS Server setting. After enabling that "Enable Semantics" settings I was able to get semantic tagging with GET Container Children from id "40https://brickschema.org/schema/Brick#Class".

--

Esa