Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...


TableView: 
   confidoc-table


ListView:
   confidoc-list


CardView:
   confidoc-card

 

 


The confidoc-table, confidoc-list, and confidoc-card macros are macros used to present the REST service content (or RSS, CSV, XML) as a table, list (WYSIWYG), or card, each with filtering and data sorting/ordering.

Name of the serviceserviceIdServices are defined by the Confluence administrator using the plugin's configuration screen
Root elementrootApply additional filters to the returned JSON data using field names as inputs
Sorting/OrderingsortSee examples below
FilterfilterApply a filter on returned data; see examples below
Cache resources locallyuseCacheRequest results can be stored locally in the Confluence cache in order to improve page loading times and to reduce the number of requests to external servers; default local cache duration is 30 minutes
Show service configuration dialogenableLookupUsers will be able to configure their own parameters for a configured service request
Define configuration parameterslookupLabelsDefine labels for the configuration dialog using key-value pairs, separated by "&" (as in URL notation), where key is the parameter name, and value is the text to be used as the label
Caption for configuration buttonlookupBtnLabelProvide a helpful pointer under the configuration dialog submit button

ConfiDoc Field

confidoc-field

Macro to define This macro defines a field to show display returned data within the ConfiDoc TableView or ConfiDoc ListView macros.

Field namenameName The name of the field to show (based on in the returned data returned to be displayed by ConfiDoc the TableView or ConfiDoc ListView macros)
Field labellabelLabel to use, when showing this field The label for the field to be displayed inside the table or list
Choose Field type for the fieldtypeThere is a set of field types supportedChoose the field type from these supported formats:
  • Link
  • Date
  • Number
  • Image
Or
  • 'as-is' (blank
), so
  • : the value will be shown without
any transformations, but as-is
  • transformation)
Input formatinputFormatUseful when you have a date values you need to transform in more readable formatDefine the format in a returned data field in order to reformat using Output format(below), for example, to transform returned date values into more readable form
Output formatoutputFormatOutput format takes what was prepared by 'Input format' and tries to apply the formatting rules given on this value
CSS to apply on field valuecssCSS to apply on a rendered field
Define the transformation rules for Output to be applied to data in the Input format (above)
CSScssDefine CSS rules to be applied on returned data in a rendered field
Access controlrestrictionsControl access to this field with a commaVisible only to groups/usersrestrictionsComma-separated list of group names/usernames this field is visible to. Leave - or user names; leave blank if there are no restrictions

ConfiDoc Excerpt

confidoc-excerpt

Macro to include HTML or binary content from any webserver inside your Confluence page

Name of the service to useserviceIdServices are defined by Confluence administrators using ConfiDoc plugin configuration
SelectorrootCSS-like selector, but limited to a form: element attribute="value".

To select elements by name - just give a tag name. Example: div - will select all the divs from the page

To select all div elements with 'myclass' class: div class="myclass"

Download and cache resources (images) locallydownloadResourcesDownloads external resources locally, and adds them as attachments.
Cache resources locally (30 minutes, by default)useCacheYou requests are cached locally, in Confluence cache. Useful when you want to improve page loading times and reduce number of requests to external servers
Content TypecontentTypeWill force to use the given content type
Custom CSS styles to apply on rendered elementcssCustom CSS styles to apply on rendered element
Include astype 
Caption for link, when loaded as binarydownloadBtnLabelWhen the content to be loaded is binary, a download link will be rendered. This parameter set''s it''s caption

ConfiDoc Excerpt Anchor

confidoc-excerpt-anchor

The macro helps you to group content inside a block and easily reference this block later with the ConfiDoc Excerpt macro

Alphanumeric AnchorID (no spaces)anchorIdYou will be able to reference it from ConfiDoc Excerpt macro using ''div id="AnchorID"'' selector

ConfiDoc Show-For (IF) Macro

confidoc-show-for

Macro shows included content only for given users/user groups

Content is visible only torestrictionsComma-separated list of usergroup names/usernames

ConfiDoc Globals

confidoc-globals

Convenient way to store and show global variables in Confluence

Variable namevarsVariable name

CSS Rules for ConfiDoc Fields

confidoc-field-css

Helper macro to use use when you want to show fields visually differently, based on their values

Field value or expression to matchconditionYou can use values or expressions, similar to filters, Filters are very similar in functionality to ConfiForms Filters (the other plugin developed by Vertuna LLC)
Field namefieldNameName of the field this rule should be applied on, if left empty then rule is applied on the row
CSS to apply when condition is metcssCSS to apply when condition is met

...