The following parameters are available with all Graphviz macros:
Editor Labeleditor label | Default | Description | Macro |
---|
Parameterparameter |
---|
Template |
| Enables users to pick a pre-configured template and make simple changes as per their requirement. Since 3.2. |
will be - are available in the macro editor only when the macro body is empty. If the macro body is not empty, the user
|
|
will not - are unable to see the Templates parameter in the macro editor.
- Only templates listed in the configuration page for the respective diagram types are available to choose from in the macro editor.
- This parameter is not available in Graph from table
|
|
and macros | template |
Output type | png | Specifies the output type to be generated by Graphviz. Since 2.1.0. | output |
Location of |
Graphviz source<type> source (Where 'type' includes Graphviz/ UML) |
| Specifies the source from where the macro reads the data. |
The body will be - Data in the body is used.
- ^attachment - Data is read from an attachment to the current page. Input the value in the format ^Filename.extension.
- page^attachment - Data is read from an attachment to the page name provided.
- space:page^attachment - Data is read from an attachment to the page name provided in the space indicated.
|
#filename - #filename- Data is read from the file located in the Confluence home directory/script/filename. Subdirectories can be specified.
- global page template name - Data is read from a global page template.
- space:page template name - Data is read from a space template.
Note |
---|
Graphviz recognizes the commands only when you nest the commands under "noformat", "wiki-markup", "code", or "code-pro" macros, for the sources mentioned below: |
|
name - name
- space:page template name
|
| script |
Show Graphviz Show <type> markup code (Where 'type' includes Graphviz/ UML) | False | Shows the |
Graphviz markup code, Graphviz or UML, below the generated graph. Useful for fixing syntax errors or to see the markup that is generated by macro processing or macros like the Space |
graph macrograph macro. | showCode |
Attachment name |
The
| Specify the name of the attachment to use, create or update. Use of attachments is optional but can be useful for linking from other places and to work with the Cache |
Macromacro to improve display performance. Examples: |
png — - png — the image is saved as an attachment to the current page.
- page^graphviz.
|
png — - png — the image is saved as an attachment to the page name provided.
- Space:page^graphviz.
|
png — - png — the image is saved as an attachment to the page name provided in the space indicated.
| attachment |
Attachment version | new | Specifies how the generated graph is persisted as an attachment. |
New- new — creates a new version of the attachment.
|
Replace- replace — replaces all previous versions of the attachment. To replace an existing attachment, the user must be authorized to remove attachments for the page specified.
|
Keep- keep — only saves a new attachment if there is no existing attachment. An existing attachment will not be changed or updated.
| attachmentVersion |
Attachment comment |
The
| Specify the comment on the attachment that is created or updated. | attachmentComment |
Attachment versions to keep |
| Limits the number of attachment versions of a file that is attached to a page. If the maximum number of attachments exceeds the limit, then the oldest version is deleted. Since version 3.2. Note |
---|
This parameter is only applicable if you select |
|
New new from the drop-down list under Attachment version |
|
, in | attachmentLimit |
Thumbnail | False | Used when an attachment is specified, and output is |
png jpg gifGIF. Renders graph as a thumbnail. Note |
---|
- In some cases, the image and the thumbnail generated are of the same size. This is because the image is too small and fits the preview screen perfectly.
- This parameter is not applicable
|
|
for - for the Flowchart and Space graph macros.
|
| thumbnail |
Render wiki markup macros in body | False |
Set to true Used to render wiki markup macros found in the body before processing as Graphviz markup. This is useful to run macros from Scripting for Confluence or similar that can produce Graphviz markup as output. Since 3.2. Note |
---|
This parameter is not available |
|
in in the Graph from table and Space graph macros. |
| macros |
Layout | dot | Specifies which default layout algorithm to use. Since 3.2. |
dot - dot− filter for drawing directed graphs
- neato − filter for drawing undirected graphs
- twopi − filter for radial layouts of graphs
|
circo - circo− filter for a circular layout of graphs
|
fdp - fdp− filter for drawing undirected graphs
Note |
---|
This parameter is not available in the PlantUML macro. |
| layout |
URL to |
'macro' <macro> file (Where 'macro |
~ ' includes Graphviz/ Diagraph/ Graph/ PlantUML) |
| Specifies the URL link to the Graphviz file. Administrators may restrict use. Since 3.2. Note |
---|
- The URLs are restricted to the whitelisted URLs.
- This parameter is not available
|
|
in - in the Graph from table and Space graph macros.
|
| URL |
URL user |
The for to access the specified URL |
access via basic authentication. Since 3.2. | user |
URL user password |
User password for URL access
| Specify the user password to access the specified URL via basic authentication. Since 3.2. | password |
URL connection timeout |
Used
| Specify the time in milliseconds used to increase the wait |
time for URL access time to access the specified URL on slower connections. Since 3.2. | timeout |
File encoding |
Allows the user to specify the encoding
| Specify the encoding of the file attachment if it is different from the Confluence default (like Windows-1252, UTF-8, MacRoman). Since 3.2. | encoding |
Note |
---|
For multiple macro sources (i.e. template, attachment, and URL), the order of precedence is URL > attachment > template. |