How to Configure the Approval Site for Use of Approvals by Email Feature & Supported Features

*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 install the .NET Core Runtimes below and reboot IIS*

• Hosting Bundle
• x64 ASP.NET Runtime
• x86 ASP.NET Runtime

https://dotnet.microsoft.com/en-us/download/dotnet/7.0

Below are a list of the runtimes that must be installed. Note the version number must be 7.0 and not 8.0.

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':

6. Enable 'Window Authentication' in IIS:

'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:

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