By default, the AppSettings.config file is located in C:\LS Retail\LSCommerce\LSCommerceService\. Most values do not need to be changed.
Example: AppSettings.config file for a single-tenant
The most important values to look at are:
| Value | Description |
|---|---|
| BOConnection.Nav.Url | Main URL to theLS Central RetailWebService web service. http://Centralhost:PORTNO (ie.7047)/BCINSTANCE(ie.BC180)/WS/COMPANYNAME(ie.CRONUS - LS Central)/Codeunit/RetailWebServices |
| BOConnection.Nav.QryUrl | Query URL to the LS Central RetailWebService web service. This URL is used only for Query, Replication and Calculation requests. If no URL is set here, BOConnection.Nav.Url will be used for both. This can be separate instance of LS Central used only for purpose of Replication and Calculation. |
| BOConnection.Nav.UserName | Windows Account used to authenticate against the LS Central web service, usually has role SUPER in Central. For SaaS setup, enter the user name that was used when creating the Web Service URI. |
| BOConnection.Nav.Password | For on-premises, enter the password for the LS Central user. For SaaS setup, enter the Webkey from the admin user. |
| BOConnection.Nav.Protocol | Protocol needed to communicate with LS Central Web Service. Protocols available are: Ssl3 - Tls - Tls11 - Tls12. If no protocol is specified, Ssl3 will be used. Tls12 is usually used for SaaS environment. |
| BOConnection.Nav.Encoding | Encoding used for blob texts like Item HTML Data. Encode values available are: default - utf8 - utf7 - utf32 - unicode - ascii |
| SQLConnectionString.LSOmni | Database Connection string to the LS Commerce Service SQL Database |
| SqlConnectionString.Nav | Database Connection string to LS CentralSQL Database. It has to include the Company name also. |
| ECom.Url | URL to a Web Hook in eCom Web platform for Order Status updates and Final Payment request when eCom is handling payments. |
| BOConnection.AssemblyName | Assembly used to communicate with LS Central or LS One. Assemblies: LSOmni.DataAccess.BOConnection.xx NavSQL.dll - LS Nav 11 and older NavWS.dll - LS Central in Azure Cloud CentrAL.dll - LS Central 13 - 17.4 CentralPre.dll - LS Central 17.5 or later One.dll - LS One |
| Security.Validatetoken | Set to true when used with Loyalty Apps, false when used with eCom solution. |
You can encrypt the password with the LSOmniPasswordGenerator.exe, which you can find in the Tool package. Make sure the password ends with :encr: this will tell LS Commerce Service that the password is encrypted.
Note: If you are using the Commerce admin portal, the password is always encrypted when you save.
<add key="BOConnection.Nav.Password" value="xr53uLy7qRA+ukzeRdqvuw==:encr:"/>
Note: When you are using a domain, add the domain before the user name, DOMAIN\user name.
<add key="BOConnection.Nav.UserName" value="LSRETAIL\MrRight"/>
Example: AppSettings.config file for a single-tenant
Note: The Commerce admin portal also holds many other configurations, see Commerce Admin Portal.