HRPro.config Settings

Starting at 14.02, HRPro Web Client have it own config file (HRPro.config) that stored the site specific information (SQL Server connection info and smtp server settings or may be others). Web Client now read the settings in HRPro.config first before looking into Web.Config. So HRPro.config will be a static file storing customer information that stay on customer site and the settings in Web.config will be ignored.

Minimal HRPro.config settings

<appSettings> <add key="data source" value="NUTECH-OFFICE\HRPRO2021"/> <add key="initial catalog" value="dbHRPro"/> <add key="user id" value="sa"/> <add key="password" value="Password"/></appSettings>

data source - the SQL server instance name (If you prefered using IP address as data source, please use the syntax something like that

<add key="data source" value="tcp:192.168.0.1,1433"/>)

initial catalog - the HRPro Application database name

user id - the SQL server User ID

password - the SQL server password for user id (see How to enable SQL Server Password Encryption in order to encrypt the password)

Completed HRPro.config settings

<appSettings> <add key="Data Source" value="tcp:218.253.68.191,1433"/> <add key="Initial Catalog" value="dbHRPro"/> <add key="User ID" value="sa"/> <add key="Password" value="P@ssword123456"/> <add key="Password Encrypted" value="1211711591811841881451421476661"/> <add key="Integrated Security" value="false"/> <add key="SMTP From" value="hr@hrpro.hk"/> <add key="SMTP From Name" value="HR Department"/> <add key="SMTP Network Host" value="smtp.gmail.com"/> <add key="SMTP Network Port" value="587"/> <add key="SMTP UserName" value="hr@hrpro.hk"/> <add key="SMTP Password" value="P@ssword123456"/> <add key="SMTP Password Encrypted" value="1291301901952041952051881391401501481441525832"/> <add key="SMTP SecureSocketOptions" value="Auto"/> <add key="SMTP SecureSocketOptions" value="SslOnConnect"/> <add key="SMTP SecureSocketOptions" value="StartTls"/> <add key="SMTP SecureSocketOptions" value="StartTlsWhenAvailable"/> <add key="SMTP SecureSocketOptions" value="None"/> <add key="SMTP SslProtocols" value="Ssl2"/> <add key="SMTP SslProtocols" value="Ssl3"/> <add key="SMTP SslProtocols" value="Tls"/> <add key="SMTP SslProtocols" value="Tls11"/> <add key="SMTP SslProtocols" value="Tls12"/> <add key="SMTP NoCertValidation" value="false"/> <add key="SMTP CCToSender" value="false"/> <add key="SMTP BCCToSender" value="false"/> <add key="MaxUploadFileSize" value="41943040"/> <add key="EventLogMaximumRecords" value="10000"/> <add key="dbCommandTimeout" value="600"/> <add key="dbConnectionTimeout" value="15"/> <add key="GeneralExcelSingleDateTimeIOMode" value="99"/> <add key="GeneralExcelCustomDateFormat" value="yyyy/MM/dd"/> <add key="CompanyLogoURL" value="https://s.yimg.com/rz/d/yahoo_zh-Hant-HK_f_p_bestfit_2x.png"/> <add key="dbHRPro CompanyLogoURL" value="https://www.google.com.hk/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png"/> <add key="IsGridDisplayDeleteConfirmation" value="false"/> <add key="IsSingleCompanyLogin" value="false"/> <add key="PLRPS Order By" value="[Batch No.vr_PLRPE.BATCH_NO], [Name.vr_PLRPE.EE_NAME]"/> <add key="PasswordPolicy" value="8LUDS" /> <add key="EnableCopyToOtherCompany" value="false"/> <add key="PLFEE_PHOTO_Width" value="1292000"/> <add key="PLFEE_PHOTO_Height" value="1723000"/> <add key="ReportPreviewShowSaveButton" value="false"/> <add key="ReportUseFontFile" value="false"/> <add key="LoginNotificationSubject" value="HRPro Login Notification"/> <add key="LoginNotificationHeading" value="Dear [EE_NAME],"/> <add key="LoginNotificationStyle" value="&lt;style type='text/css'&gt;body {font-size: large;font-family: 'Segoe UI', Roboto, 'Helvetica Neue', Arial;}&lt;/style&gt;"/> <add key="LoginNotificationContent1" value="You have successfully logged in to HRPro on [LOGIN_TIME]."/> <add key="LoginNotificationContent2" value="You're getting this email to make sure it was you."/> <add key="LoginNotificationClosing" value="HRPro Online Security"/> <add key="MandatoryBackgroundColor" value="#F3E5AB"/> <add key="EmailDelaySecond" value="0"/> <add key="EnableGenerateBOCIPrudentialMPFExcelFile" value="false" /> <add key="EnableLeavePayCutOffDate" value="false" /> <add key="EmailNotificationStyle" value="&lt;style type='text/css'&gt;body {font-size: small;font-family: 'Segoe UI', Verdana, Arial, sans-serif;} p {font-size: small;font-family: 'Segoe UI', Verdana, Arial, sans-serif;} table {font-size: small;font-family: 'Segoe UI', Verdana, Arial, sans-serif;}&lt;/style&gt;"/> <add key="EmailSubjectPrefix" value="EPortal: " /> <add key="IsShow4DecimalPlaceForCostCentreReports" value="false" /> <add key="enableAttendanceImportWebAPI" value="false" /> <add key="enableEmployeeWebAPI" value="false" /> <add key="enablePayrollWebAPI" value="false" /> <add key="enablePayRecordWebAPI" value="false"/> <add key="IsRosterByMonth" value="false" /> <add key="MaximumNoOfActiveEmployees" value="9999" /> <add key="IsEnableIR56BControlList" value="False" /> <add key="SessionTimeOut" value="600"/> <add key="BAEmailNotificationStyle" value="&lt;style type='text/css'&gt;body {font-size: medium;font-family: 'Segoe UI', Verdana, Arial, sans-serif;} p {font-size: medium;font-family: 'Segoe UI', Verdana, Arial, sans-serif;} table {font-size: x-small;font-family: 'Segoe UI', Verdana, Arial, sans-serif;}&lt;/style&gt;"/> <add key="BAacceptedAnyIP" value="false" /> <add key="BAacceptedIPAddress" value="218.253.68.18" /> <add key="BAalternateRowColor" value="#eeeeee" /> <add key="TestEmailAddressTo" value="" /> <add key="HolidayOnlineUpdateAddress" value="https://trial.hrpro.hk:8081/WebClient/api/HolidayAPI/HolidayGet"/> <add key="PLRPS Top Margin" value="0.5"/> <add key="PLRPS Left Margin" value="1.5"/> <add key="EnableAnnualLeaveProratedEntitlementalwaysRoundUp" value="false" /></appSettings>


The completed HRPro.config settings of your version can be found in HRPro.full.config inside the App_Data folder of your web site.

You can only put the keys you required into HRPro.config. If the key is missing in HRPro.config, system will use it default setting.

If IsSingleCompanyLogin is set to true, the company selection combo box during login will be disabled.

If PDFReportUseFontFile is set to true, it supported to export PDF with Chinese Characters normally without requiring install Arial Unicode MS to the Server. See Why all Chinese Characters on the PDF report displayed as rectangular box in HRPro Web Client/EPortal?

The value of CompanyLogoURL is an URL not a physical path. (However, if the value is "\Mylogo.png", usually can refer to C:\inetpub\wwwroot\Mylogo.png).

LoginNotificationSubject, LoginNotificationHeading, LoginNotificationStyle, LoginNotificationContent1, LoginNotificationContent2, LoginNotificationClosing are for the Login Notification Email when Enable Login Email Notification in Personal Options is turned on

The smtp send wait is to define the delay (in second) when emailing documents (e.g. Pay Slip) between each email. This setting is to overcome the throttling limitation of some SMTP servers when submitting message.

SessionTimeOut is the number of minutes that going to time out when no activity. Default is 600, i.e. 10 hours. If the user does not refresh or request a page within the timeout period, the session will end and return to login page.

For database specific settings, you can put the database name in front of the Key and separated with a space, e.g

<add key="dbHRPro CompanyLogoURL" ...>

You may have permission issue when you save the edited HRPro.config using Notepad. You can either

    • Save to desktop and copy back to the original location

    • Search Notepad, right click and select run as administrator and then open the file using the file open dialog.