Configuring the Web Application
Version 7
Connecting to the server components
The first step in getting the web application to work is to connect it to the HR Manage Server application. This is as simple as running the ConfigureApp.exe in the \bin\Server folder on the HR Manage Application Server and exporting the client configuration. Simply copy the exported _HrmClient.config file into the Web\Config folder and you’re set.
Restart the HR Manage application pool in IIS and open the web application in your browser. If you manage to reach the login screen, then the configuration is successful.
Building the theme
You can customise or build your own theme at https://devexpress.github.io/ThemeBuilder/master. Select any of the base Light or Dark themes to get started and select an accent colour that most closely matches your corporate colours and you’re done. However, if you want finer control over how the colour scheme works, you can click on the Advanced Settings button and customise almost every aspect of the theme.
Once finished, click on the Export button.
- On step 1, leave all the fields as-is and click the Next Step button.
- On step 2, make sure “All Widgets” is selected / checked and click on the Next Step button.
- On step 3, click the Download CSS File button under the “Export CSS” section and save it to the Web\Config folder. Just ensure that there are no other .css files in the Web\Config folder. There should always be only one css file.
- If you want to make changes to this theme in the future, click the Download Metadata File button and save it somewhere. You can use this file to modify the theme at https://devexpress.github.io/ThemeBuilder/import.
It is possible that the old theme was cached, so to refesh the theme, open the page https://hrmanage-url/System/Restart.
Customising the theme
You can further customise the theme appearance by modifying specific elements. Simply place a file called “overrides.css” in the Config folder and override the specific css elements that you want custom appearance for.
Changing the logo
By default, HR Manage will use the logo assigned to the main Company in HR Manage. If your company consists of multiple “sub-companies”, each with their own url, theme and logo, you can configure a website in HR Manage and link the website to the specific location whose logo should be used for that site.
To link the specific web application to the website in HR Manage, open the \Web\Config\Site.config file in Notepad and specify the ID for the website in the <WebsiteID>put id here</WebsiteID> line. Here is what the default Site.config file looks like:
<?xml version="1.0" standalone="yes"?>
<Settings>
<Site>
<WebsiteID>-1</WebsiteID>
</Site>
</Settings>
As a final alternative override, like if the logo was specifically modified for the web application and shouldn’t be used elsewhere in the system, you can save the logo in the \Web\Config folder and specifically rename it to “CompanyLogo.png”. If that file is present, then all other logos will be ignored for the website header.
