EPortal.config Settings

Starting at 14.11, Employee Portal have its own config file (EPortal.config) that stores the site-specific information (SQL Server connection info and SMTP server settings or maybe others). Employee Portal now read the settings in EPortal.config. So EPortal.config will be a static file storing customer information that stays on the customer site.

Minimal EPortal.config settings

data source - the SQL server instance name (If you prefer using an IP address as a 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 EPortal.config settings

<appSettings> <add key="data source" value="tcp:218.253.68.18,1433"/> <add key="initial catalog" value="dbDemo2016"/> <add key="user id" value="sa"/> <add key="password" value="P@ssword123456"/> <add key="password encrypted" value="1211711591811841881451421479868" /> <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="1611631901952041952051889141" /> <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="AttendanceRecordNoOfPeriods" value="12"/> <add key="iCalBeforeMonths" value="3"/> <add key="iCalAfterMonths" value="12"/> <add key="dbCommandTimeOut" value="600"/> <add key="IsSingleCompanyLogin" value="false"/> <add key="ColorBlue" value="#4285F4"/> <add key="ColorBlueDark" value="#0d47a1"/> <add key="ColorBluePale" value="#82b1ff"/> <add key="ColorBlueLight" value="#bbdefb"/> <add key="ColorRed" value="#ff4444"/> <add key="ColorRedDark" value="#cc0000"/> <add key="ColorRedPale" value="#ff8a80"/> <add key="ColorRedLight" value="#ffcdd2"/> <add key="ColorGreen" value="#00c851"/> <add key="ColorGreenDark" value="#007e33"/> <add key="ColorGreenPale" value="#b9f6ca"/> <add key="ColorGreenLight" value="#c8e6c9"/> <add key="ColorGrey" value="#616161"/> <add key="ColorGreyDark" value="#424242"/> <add key="ColorGreyPale" value="#bdbdbd"/> <add key="ColorGreyLight" value="#f5f5f5"/> <add key="ColorAmber" value="#ffbb33"/> <add key="ColorAmberDark" value="#FF8800"/> <add key="ColorAmberPale" value="#ffe57f"/> <add key="ColorAmberLight" value="#ffecb3"/> <add key="ColorBrown" value="#6d4c41"/> <add key="ColorBrownDark" value="#4e342e"/> <add key="ColorBrownPale" value="#a1887f"/> <add key="ColorBrownLight" value="#d7ccc8"/> <add key="ColorPink" value="#ff4081"/> <add key="ColorPinkDark" value="#c51162"/> <add key="ColorPinkPale" value="#f06292"/> <add key="ColorPinkLight" value="#f8bbd0"/> <add key="ColorTeal" value="#00897b"/> <add key="ColorTealDark" value="#00695c"/> <add key="ColorTealPale" value="#4db6ac"/> <add key="ColorTealLight" value="#b2dfdb"/> <add key="ColorBlueGrey" value="#546e7a"/> <add key="ColorBlueGreyDark" value="#37474f"/> <add key="ColorBlueGreyPale" value="#90a4ae"/> <add key="ColorBlueGreyLight" value="#cfd8dc"/> <add key="ColorOriginalBlue" value="#337AB7"/> <add key="ColorOriginalBlueDark" value="#336699"/> <add key="ColorOriginalBluePale" value="#81A8CE"/> <add key="ColorOriginalBlueLight" value="#EFF3FB"/> <add key="MainThemeColor" value="#4285F4"/> <add key="MainThemeColorDark" value="#0d47a1"/> <add key="MainThemeColorPale" value="#82b1ff"/> <add key="MainThemeColorLight" value="#bbdefb"/> <add key="IsDebug" value="false"/> <add key="output to jpg" value="false"/> <add key="dbCommandTimeout" value="600"/> <add key="PDFReportUseFontFile" value="false"/> <add key="EPortalRootURL" value="https://trial.hrpro.hk/EPortal/" /> <add key="LoginNotificationSubject" value="Employee Portal 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 Employee Portal 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="ScreenMaxWidth" value="1680px" /> <add key="smtp send wait" value="0" /> <add key="DefaultThemeColor" value="Original Blue" /> <add key="EmailNotificationStyle" value="<style type='text/css'>table {font-size: small;font-family: Verdana, Arial;} p {font-size: small;font-family: Verdana, Arial}</style>"/> <add key="EmailSubjectPrefix" value="EPortal: " /> <add key="MaxUploadFileSize" value="41943040" /> <add key="MaternityLeaveDays" value="98" /> <add key="domain" value="" /> <add key="DirectoryEntryUsername" value="" /> <add key="DirectoryEntryPassword" value="" /> <add key="DisAllowRepunchWorkInTime" value="false" /> <add key="DisAllowRepunchMealInTime" value="false" /> <add key="DisAllowRepunchRestInTime" value="false" /> <add key="DisAllowRepunchCallbackInTime" value="false" /> <add key="SessionTimeOut" value="600"/> <add key="AnnounceNoticeHeading" value="Dear [EE_NAME],"/> <add key="AnnounceNoticeContent" value="Please click below to login Employee Portal to view the Notice."/> <add key="AnnounceNoticeRegards" value="Regards,"/> <add key="AllowSimultaneouslyLogin" value="false" /> <add key="DisableTwoStepVerification" value="false" /> <add key="DisablePunchCard" value="false" /> <add key="DisableAllExceptPunchCard" value="false" /> <add key="DisablePayrollRelated" value="false" /> <add key="DisableAllExceptPayrollRelated" value="false" /> <add key="UseSecureCookies" value="false" /></appSettings>

The completed EPortal.config settings of your version can be found in EPortal.full.config inside the App_Data folder of your website.

You can only put the keys you require into EPortal.config. If the key is missing in EPortal.config, the system will use its default setting.

IsSingleCompanyLogin: If set to true, the company selection combo box on the Home Page will be disabled.

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

EPortalRootURL: When defined, it will replace the URL domain that is usually retrieved from the URL of the browser on all hyperlinks in all Email Notifications.

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

SMTP send wait: This is the number of seconds delay between two outgoing emails. This setting is to overcome the throttling limitation of some SMTP servers when submitting the message.

DefaultThemeColor: The possible values are Blue, Red, Green, Grey, Amber, Brown, Pink, Teal, Blue Grey, and Original Blue (See also Theme Colour in Employee Portal)

SessionTimeOut: It is the number of minutes that going to time out when no activity. The default is 600 minutes, 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 the login page. This setting should work with the "Idle Time-out (minutes)" in IIS Application Pool, Advanced Settings.

AllowSimultaneouslyLogin: When set to true, the same User ID can be logged in to multiple devices/browsers at the same time. It is not recommended to turn it on as it will produce weird results if both devices/browsers are operating the same function at the same time.

DisablePunchCard: If set to true, Punch Card will not be available on the Employee Portal menu.

DisableAllExceptPunchCard: If set to true, Punch Card will be available on the Employee Portal menu.

DisablePayrollRelated: If set to true, Payroll History, Mid-Month Payroll History, Download IR56B, and Download IR56M will not be available on the Employee Portal menu.

DisableAllExceptPayrollRelated: If set to true, Payroll History, Mid-Month Payroll History, Download IR56B, and Download IR56M will be available on the Employee Portal menu.

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 connection.

You may have a permissions issue when you save the edited EPortal.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 EPortal.config is amended.