*This feature is only available in Release 6.9 or later*
*Must have the 'Automated Approvals Module' enabled in order to use this feature*
*Please consult company IT team for configuration of this feature*
*Must reboot IIS post-install*
Below is the hyperlink to the Windows Hosting Bundle you need to install prior to configuration:
Must install the following Windows feature, 'WebSocket Protocol', via Server Manager:
1. Create an IIS site to host the 'ApprovalsSite' for this feature.
- open IIS
- select 'Sites' right-click
- select 'Add Website'.
*Refer to the 'Site Settings' screenshot below as a guide for which settings to enable and set:
2. Navigate to the 'Application Pools'
3. Select the newly named 'ApprovalsSite' application pool
4. Select 'Advanced Settings' on the right-hand side.
*Refer to the screenshot below for which settings to enable in the application pool:
5. Double-check the application pools for the API are set to 'LocalSystem':
'ApprovalsSite' file contents to be provided by WeSuite Support. Please request these zipped files from the team.
7. Once the zipped files are received, extract these in a directory within the file directory below or what is configured for the site in IIS:
C:\inetpub\wwwroot\ApprovalsSite
8. Create A records in your DNS for 'approvalsserver' and 'approvalsserversb'. The external IP used must be pointed to the Web server where the sites are hosted.
9. Attach to existing domain. (Complete for both Sandbox and Production environments)
10. Manually enter the 'WSAPIURL' and 'SiteURL' for your existing/newly created DNS in the 'appsettings.json' file within the ApprovalsSite file directory:
If issues generating reports occurs from the approval email, change the 'WSAPIURL' to be a local binding instead, e.g. 'http://localhost:91/':
11. Enter the 'Approval Server URL' on the database; this is located in the 'programoption' table:
12. Validate service is running by running the below in command prompt:
'cd C:\inetpub\wwwroot\ApprovalServerSandbox'
'ApprovalServer.exe'
If the service is failing, you can run the service via the command prompt which will often yield more extensive results for the issue you may be experiencing.
If you are receiving an error that the Windows user is untrusted, change the connectionstring defined in the 'appsettings.json' file to use SQL authentication instead, e.g:
Additional Configuration for WeSuite-Hosted Customers:
The following requirements are needed if a load balancer is forwarding your sites' web traffic:
- Enable stickiness on the target group within your load balancer, usually the group where the traffic is primarily routed to:
2. Increase the connection idle timeout on your load balancer to one hour:
Supported Features:
The main features this functionality supports are:
- Summary report of the job sent with the initial approval email.
- Reject jobs: mark as not approved and provide comment.
- Approvers with ‘rights’ to approve in multiple ‘hierarchy’ Groups, may utilize ‘Approve for All My Groups’ with a single click.
- Approval summary email notifying user the process is completed
Comments
Please sign in to leave a comment.