Section | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
- Login as the tenant admin user. An example of the tenant admin user id is: admin@mycompany.
Each tenant has it's own admin user that has permission to create new users, roles and perform other management functions for the tenant. For Live Forms In-house software users it is important to note the distinction between the frevvo admin user and the tenant admin user. Next we need to create a few users and roles in this tenant that we'll use in our Leave Approval workflow
..
Setup users and roles
Warning |
---|
This is a one-time setup that will have to be performed by an administrator. |
We will need to create three roles for the Leave Approval workflow:
...
Creating the Leave Approval Workflow
- Logon to your tenant as the designer.
- Click the Edit icon for the My Company HR application.
- Click the Flows tab.
- Click the New icon to create a new flow. Change the name of the flow to Leave Approval Workflow. Check the Save PDF checkbox so that a pdf image of the flow is saved in the submission repository.
If you completed the Getting Started with Forms exercise, you should have a Leave Approval Form listed in the palette.
DragDrag and drop the Leave Approval form you just created into the flow. This creates the first step (activity) in the workflow.
NameName the activity 'Employee' by typing the name in the Name property.
- In our example, we will use the same form three times, once for the Employee, Manager and HR. Select the Employee activity and click the icon icon twice. This will create two linked activities. A linked activity refers to the same form as the original activity. The form cannot be edited from the linked activity but any edits made to the original form are reflected in the linked activity.
- Name the second activity Manager and the third activity HR.
Setup the steps in your workflow
- Click on the Employee step. Leave the role dropdown blank so anyone that logs into the tenant can perform step 1.
- Change the text of the Submit Button label by typing it in the Continue Label field. Ex: Send to Manager
Assign the role of Manager to the second step.
Add a customized message in the Pending Message field. Tom will see this message when he clicks the Send to Manager button. Ex: Your request has been forwarded to your manager for approval.
Add some text in the Task Info field so manager Jerry can identify the task when he sees it on the Task List. You can use a template in the message. A template is a control in your form encased in curly brackets.
will resolve the template at runtime and replace the field in the Task Info with the data that is entered into it. If you want to use the workflow for more than one employee, enter Leave Approval for {EmployeeName} in the Task Info field so the approving manager will know who the request is for when it appears on their task list. .
- Change the Continue Label to Send to HR. Manager Jerry will click on this button to send the workflow to the HR department.
- For the third activity, set the role to HR.
- Enter "Leave Approval for {EmployeelName}" in the Task Info field.
- Enter a Pending Message that Jerry will see when he clicks the Send to HR button. Ex: The Leave Approval for {EmployeeName} has been forwarded to HR.
- You can customize the message the HR user will see when the workflow is completed.
- Click on the Form Action icon in the tool bar.
- Click on the Display Message wizard.
- Enter your customized message
- Click the save and exit icon to save the work your have done so far.
...
Control Label | Control Name | Description |
---|---|---|
Employee Name | EmployeeName | the current user's full name |
Employee Id | EmployeeId | the login id of the current user |
Manager Id | ManagerId | the login id of the current user's manager |
Employee Email | EmployeeEmail | the current user's email address |
...
Add the Manager Approval Section
...
A great way to test your flow is to use a space. A space is a frevvo website that is very easy to create. Your deployed forms/workflows are automatically added. Follow these steps to create the space:
- Ensure the visibility of your Expense Report flow is set to public in tenant and that it is deployed to production:
- Click on the Spaces Tab. Click the icon. Enter an id and name for your space. Click Create.
- Click the Edit Edit icon on the Space Home page.
- Click the icon to hide the left panel.
- Click the save and exit icon to save the changes to your space.
- Click the Share icon. Copy the share url for your space then logoff .
- Paste the space url into another browser or a new tab of the browser you are using. Login as tom@<your tenant name>. automatically makes your application a tab on the space menu and your Leave Approval Workflow an option on the menu under the tab. Your space should look something like this:
- Click on the tab for your application and then click on the Leave Approval workflow. This brings you to the first step in your flow. The workflow automatically has a navigation bar to indicate which step you are currently in as well as the next steps that are coming.
Fill in the fields in the 1st step, remember to sign and click the Send to Manager button to route the workflow to the next step - manager approval.
- Tom should see the customized pending message that you set up on the manager activity in the workflow.
- Logout of your space then login to the space as the manager jerry - jerry@<your tenant>.
- Click on the Important Items tab, then click the Task List. Jerry will see the pending Leave Approval request from Tom. Note the Task information that we set up on step 2 of the flow using the template - Leave Approval for {EmployeeName}
- Click the Perform icon to display the task. Notice Manager Jerry sees the Employee Information section filled in by Tom and the Manager Approval section so he can approve or reject the request.
- The manager name and email fields are populated by our business rule.
- Add a comment and sign the section.
- Click the customized Send to HR button. The pending message that you set up on the HR step of the workflow displays.
- Logout of your space and login as sue@<your tenant>.
- Click on the Important Items tab and then on the Task List. The pending task for the HR department displays. Note Sue, the HR employee, sees the Employee Information section, the Manager Approval section and the HR section.
- Click the Finish button to complete the workflow. The flow's configured form action message displays.
- Logout of your space.
...