Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3
Section
Column

provides an add-on that you can install into Confluence to create sophisticated forms and workflows integrated with Confluence. The add-on requires installation of an in-house server.

Info

These instructions apply to the  Confluence add-on for use with a  v4an on-premise  v4.1.7 - v5.1 server.

Column
width240px

On This Page:

Table of Contents
maxLevel
1
2

Using an In-house Live Forms server

...

...

We strongly recommend the installation video.

 

  1. Download and install the  server. Instructions for your a Windows platform can be found on the Installation Instructions page. Click /wiki/spaces/frevvo52/pages/683376760 for information about other platforms.
  2. Setup your In-house  server for Confluence. You must now create a tenant specifically  specifically for Confluence. Details can be found in the Installation Video. 
  3. Click, Installing and Configuring the add-on to complete the installation
Considerations:
  1. If you change the value of the session timeout in the Confluence tenant created in  and the server is restarted, forms/flows in Confluence become inaccessible until the tenant is edited or the server is restarted once again.
  2. If you create a user in Confluence, with the role of frevvo.designer, and then try to login to the Confluence tenant on the server with this id, an "Invalid username/password" error will display. A password reset on the server will have to be performed to reset the random password generated when the user was created in Confluence. 

Installing and Configuring the Confluence add-on

...

If you cannot use UPM, you can download the  add-on from the Atlassian Marketplace. There are two serveral  add-on versions available for Confluence. The   v4.1.7 version is compatible with Confluence v3.3 and higher. The  4.1.8 version is compatible with Confluence v4.0 - 4.2.add-on version required depends on your Confluence server version number. See the  add-on compatibility matrix for details.

  • Download the  Confluence v3.x compatible add-on here.
  • Download the Confluence v4.0 - v4.2 compatible add-on here
  • Download the  Confluence v4.3 compatible add-on here.
  • Download the Confluence v5.1.1.x compatible add-on here.

Then, follow Atlassian instructions for installing the add-on into Confluence. Remember to first uninstall any previous version.

...

This is the scheme, host & port on which the forms server is running. The add-on (installed in Confluence) must be able to access the  server. For example, the URL for '  SaaS service is: http://cf.frevvo.com OR https://cf.frevvo.com if you want to use SSL. The URL to your in-house installation might be: http://frevvo.mycompany.com:8082/.

...

This feature is available in Live Forms v4.1.4 and higher. You can specify a Confluence group here. If specified, users belonging to this group can edit forms and flows already added to existing Confluence pages belonging to any other user. If this is left blank, edit access is restricted to the original designer/owner of the form/flow. If you are using Confluence 5.1.4, users Users belonging to this group can also view/delete submissions for forms and flows belonging to any other user. Note that the editor has also needs to have designer "designer" privileges for this additional capability. . 


This group does not give users permission to create new Confluence pages and add existing forms/flows created by another designer. The only forms you will see in the add existing form dropdown are the forms created by you.

Confluence Server URL

Info

This is reserved for future use.

...

In some configurations, the externally visible URL to the forms server may be different from the above URL, i.e. the URL that a browser outside the firewall uses to access  could be different from the URL that the add-on (inside the firewall) uses to access .  If that's the case, enter the externally visible URL in this configuration parameter. Your users must be able to access the  server from their browsers via this URL. When the  form, workflow or task list is rendered in the browser, this URL will be used to access . This URL defaults to the above Forms Server URL if not specified.

Info

Frevvo supports confluence over SSL. If Confluence is running over ssl, configuring this URL, helps you must configure the Form Server External URL in the Confluence add-on to your Server url. This URL will help to render forms/flows on the Confluence pages properly.  You also need to configure the 'Confluence Server Url' in the tenant you have set up specifically for Confluence. In the Server, edit the tenant and set the 'Confluence Server Url' to your HTTPS Confluence site. See Manage Tenants.

...

for more information. With both of these settings configured, you should be able to access/create forms on Confluence pages.

Enable Debugging

If checked, the add-on will print debugging information to Confluence pages. In addition, for forms and flows, you can also specify a parameter to the form macro that is generated in Confluence pages: _norender:true. If this parameter is present, the macro will simply print debugging information but will not actually render the form.

...

If you get this error adding a flow to a Confluence page you an can solve this with a simple browser setting.

...