WAP Help and User Guide – Mobile App Install Guide (IT)
Table of Contents
The WAP Mobile App is available for iOS and Android users and can provide a quick and easy way to enter or approve documents and reduce the risk of receipts or goods received documents being lost.
It is designed to complement the WAP website and therefore will not contain the full functionality of the WAP website, therefore if sites have a complex set-up it may not be supported by the App and should be tested before installing on customer site.
Once synced, documents will post through to WAP and if applicable, Sage. Configuration must be done in the WAP Website prior to the mobile app being used.
To use the WAP App, external access is required (e.g. access to the mobile website from outside of your local network (i.e. from the internet). This can be accomplished by the use of a VPN or an externally facing website set up on the WAP server.
It is also possible to log into the WAP Website from a mobile device using a standard internet browser to navigate to the web address used on the desktop (for example if your site’s set up is not supported by the app).
1.1. WAP Enable Module
For the WAP Mobile App to be used, WAP needs have been installed and a valid licence string entered within the WAP Web App system settings:
The WAP Mobile App is compatible with entering Requisitions, Expenses, Holidays and Timesheets, and approval of all of these modules as well as Invoices.
1.2. Mobile Service Endpoint Address
This will need to be created by the relevant IT contact.
We recommend VPN to be used via the mobile device so that the device is connected to the same network as the WAP service.
Alternatively, if WAP isn’t already externally facing, then an SSL certificate needs to be purchased and applied to the WAP Website (once purchased, refer to ‘Configuring the Mobile Endpoint Address further down this section).
In either case, the Mobile app needs its own unique URL (the Mobile Service Endpoint Address) to connect to which will need to be configured within the Mobile Access system settings within WAP, prior to configuring and installing the app. E.g. https://[Web address Domain]:61000/WAPService.
The domain server and URL for WAP Web Application should already have been set up as part of the WAP install.
Configuring the Mobile Endpoint Address – SSL
If you are already using WAP externally then the existing SSL certificate can be used, and requires port number 61000 opening on your server’s firewall and any other external firewall devices. The router then needs port forwarding set up for this port. 61000 is the recommended port for the WAP app (unless known it is being used for something else; it must be different to the default website which is usually port 80 or 443 if using SSL)
Configuring the Mobile Endpoint Address – VPN
If you are using VPN you do not need to open a port as the device will be connected directly to the network. However, the mobile endpoint address may be different to above (as in http instead of https).
1.3. Https Certificate Thumbprint
Unless using a VPN, this will need to be created by the relevant IT contact.
To use the mobile app over a secure connection requires purchasing and setting up an SSL certificate on the WAP website. The SSL certificate supplies a unique thumbprint which needs to be applied in the mobile Access System Settings (see Section 2). When the WAP Service creates the mobile service on start up the thumbprint is validated.
To find the thumbprint of any certificate:
- Open IIS
- Click the top level connection (usually the computer name)
- Double click ‘Server Certificates’
- Select the certificate from the list
- Right click and select ‘View’
- Select ‘Details’ tab and scroll down to ‘Thumbprint’
- Click ‘Thumbprint’ and copy the text from the lower box and paste this into WAP settings
2. WAP Web App Configuration
Within the main WAP System Settings there are configuration options relating to the WAP Mobile App (System Settings – Miscellaneous tab – Mobile Access banner):
Enable Mobile Service: this will enable the WAP system to allow access from mobile devices connected via the WAP Mobile app
Mobile Service endpoint address: server URL which the WAP Mobile app will connect to; e.g. “https://[Web address Domain]:[Port Number]/WAPService”.
See Section 1.2 Mobile Service Endpoint Address.
Https certificate thumbprint to bind the port number to (required for https only): required for users that require a secure connection. See Section 1.3 Https Certificate Thumbprint
Max file upload size from mobile device: if a maximum upload limit for attachments (in MBs) is required, enter the maximum size here.
Enable Mobile Timesheets: tick to allow for timesheet configuration with the WAP Mobile app.
Enable Mobile Requisitions: tick to allow for requisition configuration with the WAP Mobile app.
Enable Mobile Holiday Requests: tick to allow for holiday request configuration with the WAP Mobile app.
Enable Mobile Expenses: tick to allow for expense configuration with the WAP Mobile app.
Enable Mobile Invoices: tick to allow for invoice configuration with the WAP Mobile app.
3. WAP App User Configuration
For users to be able to use the App they will need to be configured with the relevant User Type permissions in WAP (System Settings cogs – User Setup banner – User Type):
Mobile User: if a user is to be adding documents through the app, they need to be configured as a mobile user.
Can add new timesheet: the ability for a user to add a new timesheet.
Decimal timesheet entry (default is start and end times): set how users are to enter time, either through decimal format or start and end time.
Can add new timesheet for others: whether a user is allowed to enter timesheets through the app on behalf of other users.
4. WAP App Install
Refer to our End User guide to download the app.