Technology Blogs by SAP
Learn how to extend and personalize SAP applications. Follow the SAP technology blog for insights into SAP BTP, ABAP, SAP Analytics Cloud, SAP HANA, and more.
Showing results for 
Search instead for 
Did you mean: 
Product and Topic Expert
Product and Topic Expert
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