Section | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
- Create a new form. Enter a name and click Add. This will launch the Form Designer where you can drag and drop controls, change labels etc. When you click Finish in the Form Designer the form will be added to your Confluence page.
- Choose a form template. Templates are published by the administrative user and serve as starting points for your own forms. See Templates in the documentation. Choose a template and click Add. It will be copied to your user account and the form will immediately get added to the Confluence page.
- Choose an existing form. This will show the forms that you have previously created. Select one and click Add; the form will immediately be added to the Confluence page.
...
Edit a Form
Section | ||||||
---|---|---|---|---|---|---|
|
...
can be styled to blend in nicely to the look and feel you choose for your web pages. The form's base layouts/styles depend on the selections for your form. To change the layout/style, select one from the dropdowns of your form's Style Properties . By default provides four layouts and four styles. You can customize styles for font name, background color, etc. from the Style tab. In addition, each control on your form can be customized via its own Control Style Properties. Here you can style such things as width, background color, label size and color, bold, italic, etc.
...
- The forms may not automatically resize to the proper size initially. The workaround is to manually set the initial height/width of the form in the Form Designer so that it initially renders correctly. You can find instructions for doing so at Form Style Properties. You only need to manually set the initial height of the form. Subsequent resizing will be performed automatically.
- If the designer deletes one of the forms from the page all of the forms will be deleted.
- If the forms are a mix of public and private visibility you will get access denied.
- If a form and a submission are on the same page you may also experience permission denied to view the submission even when the user does have permission.
Using Roles (Confluence Groups)
Info |
---|
Roles must be manually created in the ' server corresponding to the Confluence groups that you actually want to use in your forms or workflows. This is a one-time setup that will have to be performed by an administrator. |
uses roles for a variety of reasons including digital signatures on forms and workflows. When used with Confluence, the add-on will automatically map Confluence Groups to roles. However, in order to use these roles in the Form or Flow Designer, your administrator will have to create the roles in Confluence as a one-time setup task.
Assume that you have groups in Confluence called 'employee' and 'manager'. To create these roles in :
- Login to as the administrative user for the tenant that was created in Confluence.
- Click the Manage link at the top right of the page.
- On the page that is displayed, click the 'Manage Roles' link.
- Click the icon and in the form that is displayed, type in the desired role. Make sure that the role names match exactly (including case).
Form Submissions
Viewing Form Submissions
...
- the user does have permission.
Using Roles (Confluence Groups)
Info |
---|
Roles must be manually created in the ' server corresponding to the Confluence groups that you actually want to use in your forms or workflows. This is a one-time setup that will have to be performed by an administrator. |
uses roles for a variety of reasons including digital signatures on forms and workflows. When used with Confluence, the add-on will automatically map Confluence Groups to roles. However, in order to use these roles in the Form or Flow Designer, your administrator will have to create the roles in Confluence as a one-time setup task.
Assume that you have groups in Confluence called 'employee' and 'manager'. To create these roles in :
- Login to as the administrative user for the tenant that was created in Confluence.
- Click the Manage link at the top right of the page.
- On the page that is displayed, click the 'Manage Roles' link.
- Click the icon and in the form that is displayed, type in the desired role. Make sure that the role names match exactly (including case).
Form Submissions
Viewing Form Submissions
Form submissions can be viewed directly in your Confluence page. By default, the designer who created the form/flow can view/edit submissions. If you want non-designer users to have the ability to view/edit submissions, verify the following:
- These Confluence users must belong to the groups assigned in the Form Designer Group and Form Editors Group fields on your plug-in configuration.
- Those users are assigned the view/edit permission in the Access Control list for the form/flow.
Adding Submissions to a Confluence Page
To add Submission to any page, select the Submissions menu item. This menu item is available only when the Confluence add-on is correctly installed and configured and you are logged in to Confluence as a user with the appropriate permissions. Refer to Viewing Submissions in Excel for information about time data exported to an Excel worksheet.
The Add Menu in Confluence 4.x is shown in the image below:
The Add Menu in Confluence v5.1 has changed. Click on the Tools Menu then select Add Submissions from the menu choices.
The Add Submissions page displays. Select a form or flow from the dropdown and click "Add". The submissions view will be added to your Confluence page. Submissions are displayed in a table view. Double click on any submissions to view all of the data. Please refer to Viewing Form Submissions in the documentation for a full description of all the features.
...
Downloading Form Submissions to Excel
...
- Create a new flow. Enter a name and click Add. This will launch the Flow Designer where you can drag and drop forms, create new ones etc. When you click Finish in the Flow Designer the flow will be added to your Confluence page.
- Choose an existing flow. This will show the flows that you have previously created. Select one and click Add; the flow will immediately be added to the Confluence page.
Edit a Flow
Section | ||||||
---|---|---|---|---|---|---|
|
...
What does the user see when they click the Finish button? Please refer to Form Action Wizards in the documentation.
Some Wizards (Create/Update Confluence Page Wizard and the Merge to Confluence Page Wizard) are only applicable to and visible from Confluence. These are wizards to Create/Update Confluence pages and to Merge form data into a Confluence page.
...
Please refer to the general task list documentation for details on using the task list.
Note |
---|
The Quick View feature can be configured in the designer but the icon will not display when the Task List is added to a Confluence page. This may be enabled in a future release. |
...
Login to Confluence as a user in the Form Designers group. If you did not select a group, login to Confluence as a user. See Configuring the add-on
Adding Forms
- Create a new page (say, Test Form) in Confluence by clicking the Add Page button for Confluence v4.0 - 4.2. To add a page in Confluence v5.1, click Create Child Page on the Space sidebar.
- Add a Form as described above.
- If you create a new form, you'll be taken to the Form Designer, where you can drag/drop controls, set properties etc. to design your form. Otherwise, the existing form will be added to your Confluence page.
...
Logout of Confluence and do not login. This assumes that you have enabled anonymous access in Confluence. Forms and flows must have visibility set to "public" in order to be used anonymously. See the chapter on Making a Form or Flow Public. If your form/flow is not set to public the anonymous user will see the following error in the page:
...