Skip to end of banner
Go to start of banner

Include-remote Macro

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Current »

Description

Include a page from a remote Confluence server.  This uses the Atlassian Command Line Interfaces (CLI) to get data from a remote server. 

Experimental

Advanced user only. Need feedback on use cases and requirements.

You need to know the data that you are dealing with to ensure the rendering works in a desirable way. Source from a different system will render differently! Rendering remotely ( render=true ) may not work as expected either as things like links may not work on the local system.

Consider using cache macro

Getting data from a remote site can be expensive. Consider using the Cache for Confluence to improve display performance and reduce server load.

Parameters

ParameterDefaultMacro Browser LabelDescription
pagerequiredPage to includeLocation of remote page. Must be space qualified: spacekey:page name
renderfalseRender on remote serverNormally, the page source is retrieved from the remote system. Set to true to render the content on the remote system.
profile Profile

Pre-configured profile defined by administrator used to provide some other parameters. This parameter may be restricted for security reasons.

server CLI serverCLI server equivalent to specifying the --server parameter on the CLI.
user CLI userCLI user equivalent to specifying --user parameter on the CLI.
password CLI passwordCLI password equivalent to specifying --password on the CLI.

Example

{include-remote:MySpace:Home|profile=confluence|render=true}
  • No labels