HRPro.config Settings

HRPro.config is the configuration file for storing site-specific information, such as SQL Server connection details and SMTP server settings. HRPro now prioritizes the settings in HRPro.config over those in Web.config, making HRPro.config a static file that remains on the customer site, effectively ignoring the settings in Web.config.

Minimal HRPro.config settings

data source - the SQL server instance name (If you prefer using IP address as the 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="SMTP Timeout" value="100000"/> <add key="SMTP Send Wait" value="0" /> <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="<style type='text/css'>body {font-size: large;font-family: 'Segoe UI', Roboto, 'Helvetica Neue', Arial;}</style>"/> <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="EnableGenerateBOCIPrudentialMPFExcelFile" value="false" /> <add key="EnableLeavePayCutOffDate" value="false" /> <add key="EmailNotificationStyle" value="<style type='text/css'>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;}</style>"/> <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="<style type='text/css'>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;}</style>"/> <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" /> <add key="PDFReportUseFontFile" value="true" /> <add key="PDFReportAllowInvokeWindowsLibraries" value="false" /> <add key="GridPageSize" value="50" /> <add key="PLFPA_GridPageSize" value="50" /> <add key="DisableWebClientCustomizedReports" value="false" /> <add key="AllowEnableUSDEmployeeSalaryPackage" value="false" /> <add key="AllowGenerateIR56B2018" value="false" /> <add key="AllowCreateIR56F2018" value="false" /> <add key="AllowSimultaneouslyLogin" value="false" /> <add key="SimultaneousLoginIdleMinutes" value="20" /> <add key="DisableTwoStepVerification" value="false" /> <add key="DisableSuperAdmin" value="false" /> <add key="EnableAnnualLeaveConsidersAppointmentHistory" value="false" /> <add key="UseSecureCookies" value="false" /> <add key="ReportColumnMaximumWidth" value="26" /></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 only need to include the keys you require in HRPro.config. If a key is missing, the system will use its default setting.

IsSingleCompanyLogin: If set to true, the company selection combo box during login will be disabled. See How to Enable Single Company Login?
PDFReportUseFontFile: If set to true, it supports exporting PDF with Chinese characters without needing Arial Unicode MS installed on the server. See why all Chinese Characters on the PDF report are displayed as rectangular boxes in HRPro Web Client/EPortal?
CompanyLogoURL: This is a URL, not a physical path. (e.g., if the value is \Mylogo.png, it usually refers to C:\inetpub\wwwroot\Mylogo.png).
Login Notification Settings: Includes LoginNotificationSubject, LoginNotificationHeading, LoginNotificationStyle, LoginNotificationContent1, LoginNotificationContent2, and LoginNotificationClosing. These are used when Enable Login Email Notification in Personal Options is turned on.
SMTP Timeout: Sets the timeout duration for network streaming operations in milliseconds. This means it determines how long HRPro will wait for a response from the SMTP server before giving up and throwing a timeout exception. By default, HRPro will wait up to 10 seconds for a response before timing out.
SMTP Send Wait: Defines the delay (in seconds) between sending each email (e.g., Pay Slip) to overcome the throttling limitations of some SMTP servers.
SessionTimeOut: Number of minutes before a session times out due to inactivity. The default is 600 minutes (10 hours). If the user does not refresh or request a page within this period, the session will end and return to the login page. This setting should work with "Idle Time-out (minutes)" in IIS Application Pool, Advanced Settings.
AllowSimultaneouslyLogin: If set to true, the same User ID can log in to multiple devices/browsers simultaneously. It is not recommended as it may produce unpredictable results if both devices/browsers operate the same function at the same time. (Effective only if the database is licensed as a Company license or a Server license).
SimultaneousLoginIdleMinutes: Number of minutes required to wait before the same User ID can log in to another device/browser if another logged-in session is inactive. Applicable to both HRPro and EPortal.
UseSecureCookies: This option ensures that cookies are only sent over secure HTTPS connections, which utilize SSL/TLS protocols to encrypt the data being transmitted. This option is specifically applicable to SSL/TLS connections.
ReportColumnMaximumWidth: This specifies the number of characters in the column heading before it wraps in an Excel report. It controls how wide the column heading can be before it breaks into multiple lines.

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

You may have a 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 dialogue.

It is recommended to either recycle the Application Pool, restart IIS or restart the server after HRPro.config is amended.