| Table of Contents |
|---|
| maxLevel | 1 |
|---|
| exclude | On this page |
|---|
| type | flat |
|---|
| separator | pipe |
|---|
|
...
Here is a quote from Chrisopher Owen, the original author:
For Atlassian’s 7th ShipIt Day I implemented a Confluence macro that would defer rendering its body until the full page was received by the client. The body of the macro would then be sent back to Confluence for rendering via AJAX while the user was presented with a loading placeholder. As the rendering of the body occurs in the future with respect to the original page rendering pipeline, I called this functionality the Future Macro. It is ideally suited for rendering content that is retrieved from external sources where high latency can hold up the delivery of other content on the page.
Parameters
| Parameter | Default | Macro Browser | Description |
|---|
| title | Load or Loading | Title | Text displayed before rendering completes. Also appears on the manual button. Helps user understand what information is going to appear. Prior to release 6.7, the default text would appear followed by the user provided title. After release 6.7, by default, only the user provided title will appear if it is not blank. There is an administrator option to control the behavior. See the incompatibility notice. |
| manual | false | Manual | When specified, the section is only rendered after the user presses the load button. The rendering proceeds in the background until available. |
| timeout | 120 seconds | Maximum number of seconds to render section | Timeout in seconds before the section rendering is abandoned. Once abandoned, a timeout error message is displayed. |
| delay | 0 | Delay in seconds | Rendering is delayed by the number of seconds requested. The client browser delays sending the request to the server to render the body. This applies only to manual=false cases. This can be used in cases where there are multiple future macros on the same page and it is more important to render some of these more quickly than others so the results for those appear quicker. Since 6.7. |
| retryInterval | Default | Retry interval in seconds | When greater than 0 and the rendering of the body indicates an error that can be retried, the client waits and then retry the request. See Retry Feature. Default uses the default setting configured in administration. Since 6.8. |
| Section |
|---|
| Column |
|---|
Default loading message
|
| Column |
|---|
Manual load
|
| Column |
|---|
Macro browser preview loading
| Info |
|---|
Note that in macro browser preview, only the loading message is displayed. The body is not rendered in the preview window. |
|
|
...
Future Macro - Example Video
SQL Example
| Section |
|---|
| Column |
|---|
 Image Removed Image Added
|
| Column |
|---|
| No Format |
|---|
{future}
{sql:dataSource=exampleDSTestDS}
select * from products
{sql}
{future} |
|
|
...