Skip to Content
Technical Articles
Author's profile photo Cameron Swift

SAP Data Intelligence Cloud – Creating Documentation for Custom Operators and Graphs

This blog post is written in collaboration with the SAP HANA Database & Analytics, Cross Product Management team

Good documentation is crucial to maintenance and development of your SAP Data Intelligence assets. Within the SAP Data Intelligence Modeler, the example Graphs and standard Operators contain documentation ready for us to reference



We can view Graph Documentation using the Show Documentation button when no Operators are selected

However, when we create our own operators and graphs, we’d like to be able to create our own documentation to reference in the same way

For custom operators, we can create documentation by right clicking the operator then clicking Edit



Editing our custom operator

We can now click on the Documentation tab to create our own documentation


Writing our custom operator documentation

All text within the documentation uses Markdown formatting. Try the below text to get a handle on the basic syntax, then press Save

# Sample Main Heading

## Sample Sub Heading

Sample text in *italics* and **bold**

> Sample blockquote

- Sample bullet point

1. Sample numbered list
2. Sample numbered list



Save our operator documentation

Now we’re able to view the documentation for our custom operator in the same way as any other operator


Viewing our custom operator documentation


We can also create documentation for our custom graphs, although we need to use another method to do so

First, we want to select the Repository tab along the left hand side of the Modeler. From there, we want to double click to open the Graphs folder, followed by the folder that contains our graph


The folder for our Graph in the Repository


In this folder we’ll find the graph.json file that describes our graph. In order to create our documentation, we want to right click on the folder that contains our graph, and select Create File


Create file


In order for our new documentation file to be recognized by SAP Data Intelligence, we want to name it



We can then double click our new file to edit the documentation from within the Modeler. For now we’re using the same sample documentation as we did for our custom operator



Saving our documentation


Now that we’ve added some sample text to our documentation, we can check our new sample graph documentation within the Modeler using the Show Documentation button


Viewing our sample documentation


Throughout this blog, we’ve seen how we can both view and create documentation for our custom Operators and Graphs

I hope this blog post has been useful, and I welcome any comments or questions below

Note: While I am an employee of SAP, any views/thoughts are my own, and do not necessarily reflect those of my employer

Assigned Tags

      You must be Logged on to comment or reply to a post.
      Author's profile photo Stephan Taciak
      Stephan Taciak

      Hi Cameron,

      nice and easy way of documentation, very clearly and simply explained.
      Thanks for this blog.




      Author's profile photo Cameron Swift
      Cameron Swift
      Blog Post Author

      Glad it was helpful, Stephan. Thanks for reading