Configuring Approval Process
Applies to: Kyvos Reporting
To use the Approval Process, the following configurations are required:
Application Configuration: Enable the feature and define approval states.
User Preferences: Set email notifications and customize messages.
Report Configuration: Associate reports with approval workflows and assign approvers/commenters.
Configuring the Application
Step 1: Enable Approval Process
To enable the feature:
Go to Navigate > Administration > Configure > Server.
Locate the
Published Report Approval Requiredproperty under the Compliance section.Set the property to Enable.
Click Save to apply the setting.
Step 2: Define Approval States
To define approval states:
Go to Navigate > Administration > Secure Data > Approval Process.
On the Approval Process page:
Enter a name in the Name field.
Define captions for the states:
Pending: Indicates the report is awaiting review.
Rejected: Indicates the report has been rejected.
Approved: Indicates the report is approved and ready for public access.
Click Save to store the process.
You can also Delete or Cancel the workflow as needed.
Configuring User Preferences
Email Notifications
Kyvos Reporting can send email notifications to users involved in the approval process when:
A report is published and pending approval.
A comment is added to a pending report.
A report is approved or rejected.
You can customize email messages using the following files:
File Name | Purpose |
|---|---|
| Notification when a report is published. |
| Notification when a comment is added. |
| Notification when status is updated. |
These files are located at:
<Kyvos Reporting_installation_folder>/Kyvos Reporting/reportengine/config/messages/mailsSet User Email Preferences
Go to Navigate > Personalization > Preferences > User Preferences tab.
Under the Send Email section, select Approval Process.
Enter your email address if not already set.
Click Save.
Report Access Rights
Role | Required Access Rights |
|---|---|
Super Administrator | No additional rights required |
Administrator | No additional rights required |
User | Requires Run Report and Publish rights for the report or category |
The ability to approve or comment is assigned at the report level during deployment.
Configuring Reports for Approval
To associate a report with an approval process:
Go to Navigate > Repository > Manage Categories and Reports.
Navigate to the folder where the report is deployed.
Select the report to open its properties.
Associate Approval Process
In the Process Name drop-down, select the desired approval process.
Click Assign Users to open the Approval Process Access Rights dialog.
Assign roles:
Approver: Can approve or reject.
Commenter: Can add comments.
Note: Assigning Approver automatically includes Commenter rights.
Click Set to confirm.
Click Save on the main page to apply changes.
Detach Approval Process
If you detach an approval process from a report that is currently in Pending state:
Click Detach.
Choose whether to Approve or Reject the pending version.
Click OK to complete the detachment.