Confluence Cloud
The integration with Confluence Cloud provides a quick and easy way to display Hava environment diagrams inside a Confluence page. It can be installed through our Atlassian Marketplace listing: Hava Viewer
Once a diagram is embedded, it can be viewed without consuming a Hava user licence or being logged into Hava.
To add an environment to your confluence page, you need to add and configure the Hava Viewer macro.
You can do this either by pressing the
+
button on the toolbar, or by typing /
and then search for Hava

Search for Hava to find the Hava Viewer macro
This will add a blank view in your page editor like below.
You can modify the size of this using the context menu on the bottom (when selected)
To configure the macro, press the edit button to open up the configuration pane

Press the edit button in the context menu to configure the macro
The configuration page has a single input field where you put the embedded view key.

Add your key to the input box
There are several different embedded views in Hava, and they are all supported by the plugin. They can loosely be categorized into
interactive
and non-interactive
views. For more details on our embedded views have a look at the embedded documentation.The interactive view give readers the ability to click on objects in the view and see more information about them.
To get a key for an Interactive View open the specific environment you would like to add to Confluence and press the
share
button on the top toolbar. EMBED
and EMBED LIGHT
are Interactive Views, select the one you prefer, and copy the ID by pressing the COPY ID
button.Add the ID to the
Embedded View Key
input in the macro configuration and the macro should update with the embedded view.

Select your view type and copy the ID
The Non-Interactive View gives a static representation of the environment as a rasterized image. It does not allow users to interact with it, but it will load faster when opening the confluence page.
To get a key for a non Interactive View open the specific environment you would like to add to Confluence and press the
share
button on the top toolbar. Select
EMBED PNG
in the modal and copy the full URL for the embedded PNG. Add the URL to the
Embedded View Key
input in the macro configuration and the macro will update with the embedded view.
Select the URL and copy it to the clipboard
Once an interactive or static diagram is inserted into your confluence page, it will remain up to date. This includes the static PNG.
When Hava auto updates your network diagrams in response to configuration changes being detected, the diagrams at the end of your embedded diagram endpoints are also updated which means when you view diagrams within a confluence page, you are always looking at the latest version without the need to update anything in Confluence.
Last modified 1yr ago