Versions Compared

Key

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


Warning
titleFeature Retirement: frevvo for Confluence

Atlassian is dropping support for Confluence Server in 2024 and encouraging customers to migrate to Confluence Cloud. The frevvo plug-in is not compatible with Confluence Cloud. Existing frevvo for Confluence licenses will be supported, but frevvo for Confluence will not be available for new customers.

Please see the frevvo for Confluence page for details about this announcement and recommendations.


Section


Column

The Confluence frevvo Confluence add-on is available for both Confluence v3, v4 and v5.1. See Live Forms frevvo add-on installation for details. The macro frevvo macro syntax depends on your version of Confluence.

Warning

It is very important to know that the add frevvo add-on macros DO NOT work when added via the Confluence v4.0 - 4.2 macro browser. See Live Forms frevvo add-on usage for details. However, if you are using versions 4.3 or 5.1, you CAN use the macro browser to add them. See below for more information.



Column
width240px

On This Page:

Table of Contents
maxLevel2

...


frevvo macros

frevvoform macro

Add and frevvo and workflows to your Confluence page via the Add menu options that the frevvo add-on incorporates into the Confluence's Add menu. The Add > Form and Add > Flow menu items described in detail in Using the add-on automatically add the frevvoform macro to your page with the correct form identification.

...

Warning

DO NOT use the new Confluence v4.x macro browser to add a frevvoform macro to your page. See Live Forms frevvo Confluence add-on usage for details. However, you CAN use the macro browser to add the frevvoform macro to your form if you are using Confluence versions 4.3 -5.1.

You can customize the appearance of the form or workflow by editing the parameters to the macro as described below:

Note
iconfalse


ParameterValuesDefaultMeaning
 center  true or falsefalseCenters the form on the page. This property applies only when container=true.
containertrue or falsetrueGenerates a border around the form if true. If set to false, the frame will not be seen and hence the Edit and remove buttons will go away too.
_data
Live Forms
frevvo generated valuegenerated
Used to initialize the form. You can add parameters here but do not remove the existing ones auto-added by the
add
frevvo add-on. See the documentation for more information.
formtypeid
Live Forms
frevvo generated value
 

The internal ID of the form/workflow. Do not modify. Not visible in Confluence v4.x.
formtypeurl
Live Forms
frevvo generated value
 

The internal URL of the form/workflow. Do not modify. Not visible in Confluence v4.x.
heightnumeric
 

The initial height of the form. Used when you disable auto-resizing.
locale3 letters
 

The desired locale (e.g. ger, dan, ara etc.). The form will be rendered in the specified language. See the multi language support documentation for more information.
resizetrue, false, vert or horz
 

Automatically resizes the form. vert enables vertical resizing only and horz enables horizontal resizing only. Auto-resizing can add a URI fragment to the browser URL. If you need to use URI fragments, you must disable auto resizing
scrollingno, yes, or autoautoIf no, scrollbars will never appear, if yes, scrollbars will always be present, if auto, they will be present if required. This property is redundant when resize is true. Auto-resizing will always ensure that the frame is big enough so that scrollbars never appear.
widthnumeric
 

The initial width of the form. Used when you disable auto resizing.


Turning off auto resizing

Auto-resizing is extremely convenient since the form will automatically resize to take up as much horizontal and vertical space as it needs. This can be very useful for forms that have collapsible sections, multiple Tabs, repeat controls etc. and where user actions can alter the vertical space. However, in cross-domain environments where Confluence and frevvo are running in different containers or on different machines, auto-resizing requires adding a URI fragment to the browser URL. The fragment looks something like: #632:234:form-1304106048646 where the numbers can be different. This can affect URLs that you may be using that already contain URI fragments since the frevvo URI fragment will overwrite your URI fragment.

To fix this, you will have to disable auto-resizing. This means that if the form does not fit in its alloted area, scroll bars will automatically appear. To turn off resizing, set the parameter resize=false and specify an initial height and width using the height and width parameters e.g.....resize=false|height=250|width=632|... The form will be rendered with the specified height and width and will never resize. frevvo will not alter the browser's URL either. 

...

Note

We assume that you are familiar with designing Live Formsfrevvo. Specifically, forms differentiate between the label of a control and the name of a control. The control name (without spaces) is used in the macros below.

...

Warning

The macro syntax is different if you are using the add frevvo add-on for Confluence v3.x versus the add frevvo add-on for Confluence v4 and Confluence 5.

...

Warning

DO NOT use the new Confluence v4.x macro browser to add a frevvoresolve macro to your page. See Live Forms frevvo Confluence add-on usage for details.

...

It is important to note that a form/workflow submission can be edited by any Confluence user using the Edit link from template. For Example, a workflow created with 2 activities A1 (employee) -> A2(manager), submitted by an employee, can be edited by any other employee by clicking the  "Edit" link generated through template. The workflow data can be edited and the workflow submitted again. This is as designed. 

Warning

The Save/Load Feature cannot be used together with this Edit link. You cannot edit a form using this link, save the partially edited form and continue later.

...

Warning

DO NOT use the new Confluence v4.x macro browser to add a frevvoattachment macro to your page. See Live Forms frevvo Confluence add-on usage for details.

...

Forms and workflows can have repeating data. For example, a person may have multiple nick names. Let's say you have a control on the form labeled Nick Name (as a reminder, frevvo will automatically generate a name for this control without spaces NickName, (which you may edit) and a macro in your template.

...

Warning

DO NOT use the new Confluence v4.x macro browser to add a frevvotasks macro to your page. See Live Forms frevvo Confluence add-on usage for details. However, you can add the frevvotasks macro via the macro browser if you are using Confluence versions 4.3 - 5.1.

...

Warning

DO NOT use the new Confluence v4.x macro browser to add a frevvosubs macro to your page. See Live Forms frevvo Confluence add-on usage for details. However, you can add the frevvosubs macro via the macro browser if you are using Confluence versions 4.3 - 5.1.

...

Please click here for detailed instructions on creating/updating Confluence pages via frevvo and workflows.

Merge into existing Confluence Page

...