Question: How to Leverage Drawings that are Contextualized and LIVE and Hotspotted?

  • 23 January 2023
  • 8 replies

Userlevel 2

scenarios we are working on, 

  1. To show PI&D diagram with annotations, which help to select the asset and create a threat for that asset.
  2. Or draw a rectangle over the PI&D diagram to select multiple assets. 

For the above two scenarios we are referring APIs in,


We are successful in getting the PI&D as image by following the below steps,

1. List Files{project}/files

2. Convert a diagram to image format{project}/context/diagram/convert/

3. Get the results for converting an engineering diagram to an image{project}/context/diagram/convert/{jobId}


Could you please guide with APIs / JavaScript SDK methods we need to work on for the above mentioned two scenarios.



Best answer by Ola Liabøtrø 24 January 2023, 09:45

View original

8 replies

Userlevel 2

Hi Ibrahim. Thank you for raising this. We plan to provide a public Javascript component for 2D documents with annotation support in Q3-4 2023. This will be a component/library separate from Reveal, but be based on similar ideas. 


The way to work with P&IDs going forward is to overlay them with annotations. An annotation denotes a region in a file and can link to e.g. assets. You can see documentation here:

The convert to image flow will be deprecated. is the easiest way to detect references to assets, but the output should be written to the annotations API.

The overlaying of annotations is handled by a unified file viewer component which is being rolled out to relevant applications. I am not sure which application is most ideal for the mentioned use cases, or if creating a custom app is the intention, but it should anyway be based on annotations.

Hope that helps!

Hi Ibrahim.

Regarding your second second point; if you have access to Cognite Data Fusion, we have multiple apps such as Data Explorer and Interactive Engineering Diagrams where you can visualize and manually create annotations for your files. Currently, only annotations of types diagrams.AssetLink and diagrams.FileLink can be visualized and manually created in those apps. Moreover, annotations in these apps can only be edited and created one at a time.

Hope this helps,


Userlevel 2

@Lars Moastuen looking for an update on the component

Userlevel 2

@Andreea Pastinaru has taken over ownership over this component - can you provide an update?

Userlevel 2

As the roadmap is subject to be changed and due to some new developments we will have to move this work and create the component in H1 2024. 


Thank you,


“We plan to provide a public Javascript component for 2D documents with annotation.We plan to provide a public Javascript component for 2D documents with annotation  “


Could you please provide an update if there is any component / library we could start using in our custom applications.

Userlevel 2

Its a custom app that we are building and i was hoping there was something similar to Cognite Reveal for engineering that what the new file viewer is? can we test it in beta