Versions Compared

Key

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

...

Column
Tip

View the Workflows in Confluence video for more information if you are using Confluence v4.0 - v4.2. In Confluence v5.1+, the Add Form, Add Flow, Add Submissions, and Add Task functions are located on the Tools Menu.

If your workflow includes an Email step that routes that step to an anonymous user:

  • Your Confluence space does not need to be configured to allow anonymous users
  • The visibility of the workflow must be set to Public.
  • The {task.notify.url} template used in the notification email that is sent to the anonymous user generates a frevvo specific URL

...

width240px

On This Page:

...


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.

Table of Contents

Creating multi-user workflows in Confluence

...

  1. An employee goes to a Confluence page that contains the workflow.
  2. Since the employee does not belong to the 'manager' Confluence group, he will only see the relevant portion of the form.
  3. The employee fills it in and clicks a Continue button.
  4. frevvo puts the task on the manager's task list, [optionally] notifies the manager by email and displays a confirmation message to the employee.
  5. When the manager logs in, she visits a Confluence page that contains her task list.
  6. The employee's vacation request will be displayed in the task list.
  7. The manager performs the task. Since she belongs to the 'manager' Confluence group, she will see the manager-specific portions of the form. The employee-specific portions are automatically pre-filled.
  8. She approves/rejects the vacation request, digitally signs the form and clicks Finish.
  9. The employee is notified by email, and [optionally] a PDF image of the form is sent to the internal document management system or to Google Apps or saved in frevvo' submissions repository.

Now, let's go through the process of building this workflow in Confluence.

Setup roles in frevvo

Note
This is a one-time setup that will have to be performed by an administrator.You only need to create roles in corresponding frevvo corresponding to the Confluence groups that you actually want to use in your workflow

...

Assume that you have groups in Confluence called 'employee' and 'manager'. To create these roles in frevvo:

  1. Login to frevvo as the administrative user for the tenant that was created in Confluence.
  2. Click the Manage link at the top right of the page.
  3. On the page that is displayed, click the 'Manage Roles' link.
  4. 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).


Create the Vacation Request

...

Note

View the multi-user workflows video for more information.

Read the documentation on creating forms in Confluence.

Read the general frevvo documentation on designing forms for a detailed discussion of forms and their features.

Here are some steps to follow to create the Vacation Request form:

  1. Add a Confluence Page and Add a form to it.
  2. Drag and drop controls on the form as desired.
  3. In the Figure below, we have
    • Created a section for the employee called Request.
    • Enabled digital signatures for this Section by clicking on the Section header and then on the Security Tab in the properties pane to the left. In the Security Tab, the Must Sign box is checked.
    • Created a section for the manager called Manager Approval.
    • Enabled digital signatures for this Section.
    • Assigned role 'manager' to this Section.

Image Removed

Create the Vacation Request workflow

Note

View the multi-user workflows video for more information.

Read the documentation on adding workflows to Confluence pages.

Read the general frevvo documentation on designing workflows for a detailed discussion of frevvo workflows and their features.

...

  1. Add a Confluence Page (say, Vacation Request Flow) and Add a workflow to it.
  2. Drag and drop forms into the workflow as desired.
  3. In the Figure below, we have

...

  1. Use the Workflow Design Wizard to create two steps:
    1. Vacation Request - Create New Form - No Assignment
    2. Manager Approval - Approval Step - Assign to Role - Select the role 'manager'.
      Image Added

Customize Workflow Step Properties

  1. Click the Vacation Request Step. On the Settings tab,

...

  1. set the

...

  1. Continue Label

...

  1. to 'Send to Manager'

...

  1. Click

...

  1. the Manager Approval step, then the Assignment tab. Notice that the assignment was already set for you and some default text was added to the Task Notification email Subject and Message fields. Customize the Email Message to include a link to the Task

...

  1. List page in Confluence

...

  1. .

...

  1. Click the Messages tab.
    1. Set the Task Info for the second step to 'Vacation Request for {FirstName} {

...

    1. LastName}'.

    2. Set the Pending Msg for the second step to 'Your request has been forwarded to your manager.'

Image Added

Edit the Vacation Request form

Note

Read the general frevvo documentation on designing forms for a detailed discussion of forms and their features.

Here are some steps to follow to create the Vacation Request form:

  1. Go to Forms editing mode in the Guided Designer Navigation bar of your workflow.
    Image Added
  2. Notice that the Workflow Design Wizard added several controls for you.

...

Image Removed

To configure email:
  1. Click the Image Removed Edit Flow Properties wizard in the designer toolbar.
  2. You can edit them, remove them, and drag/drop new controls on the form as desired.
  3. In the Figure below, we have
    • Relabeled the My Items section for the employee to 'Request.'
    • Added a date control 'Start Date' and a Number control 'Number of Days'
    • Deleted the wet signature control and enabled digital signatures for this Section by clicking on the Section header and then on the Security Tab in the properties pane to the left. In the Security Tab, Text/Signature image is selected, and the Must Sign box is checked.

Image Added

Send an Email when the Workflow is Submitted

Next you can configure a Doc Action email to send when the workflow is completed.

  1. Go to Settings editing mode in the Guided Designer navigation toolbar.
    Image Added
  2. Click on the Document Actions tab and select Send Email.
  3. In the wizard, for the To address select the Email control to generate a template. When the workflow is completed,  will  frevvo will send an email to the address that was entered in the Email control in the form.
  4. Customize the Subject and Message for the email as desired.
  5. Select the documents that you want to attach to the email. Minimally, select PDF from the 'Send Snapshot' drop down and uncheck the 'Files' checkbox. The . Other options are described below:
    1. Send the data as a  PDF attachment or other image type using the Send Snapshot dropdown. The image type options are PDF, PNG or JPG.  Select the blank option from the dropdown to exclude this attachment in the email.
    2. Attach an XML data document using the Data checkbox. This checkbox is checked by default. Uncheck it to exclude the XML data document in the email. 
    3. Attachments uploaded to your form/workflow are included if the Attachments checkbox is checked. This checkbox is checked by default. Uncheck it to exclude attachments in the submission.  
      1. If you have Pixel Perfect mapped PDFs (ex: W-4, I-9 etc…) associated with your forms/workflows, choose  the action you want to take from the Send Gen Forms control :

        •Check All to send all the Pixel Perfect PDFs. This is the default value.
        •Check None to send none of the PDFs
        •Check Select to display a list of all the PDFs associated with your form/workflow. Click the ones you want to be part of the submission. Hold down the Shift key then click the files in the list to select all PDFs or hold the control key and click specific PDFs.
  6. Click Submit. Image AddedSave the workflow.

Image RemovedImage Added

Create the Task List page

...