In this article
Using the AppShell to run LS Central POS locally
System requirements
-
Windows 10, build 17763 or later.
Using the AppShell to run LS Central POS locally
To use the AppShell with a local LS Central system, you need to enable the loopback for the AppShell:
- Run this command in PowerShell in admin mode:
checknetisolation loopbackexempt -a -n='LSRETAILINC.LSCentral_kxgjq7wq1nzrp'
You can see if the app has been added by running the checknetisolation loopbackexempt -s command:
LS Start page
When you open the app in Windows, it opens with the LS Start page. The Windows version of the AppShell can have multiple different configurations, and the Start screen shows all configurations that have been set up.
- Click a configuration to open it.
- Click the Settings Icon in the top-right corner to open the Settings page.
Settings page
The Settings page is split into two parts, on the left side is a list of all your configurations.
- Click any configuration to open the settings for that configuration.
In the top-right corner you have App Settings and buttons to create and delete a configuration, import and export the configurations, and to open the app logs.
A configuration can be one of four types:
- Web Client is for opening the POS or BackOffice.
- External Application opens another program on the computer.
- Folder is used to create a folder structure on the LS Start page.
- PowerShell is used to run PowerShell scripts.
The General tab
The General tab contains all the settings for the selected configuration.
| Field | Description |
|---|---|
| Description | The name of the configuration that is displayed on the LS Start page. |
| Folder | The folder where this configuration is located. Leave this field empty to display at the root. |
| URL | The URL of the POS or BackOffice the configuration opens. |
| URL assist button | Allows the user to input each part of the URL separately. |
| Login settings | User name and password to open the POS or BackOffice. |
| Backup config | If there is no connection to the current configuration, fallback to this configuration. |
| Disable closing the POS | If you select this check box, the app will not show the Close button and the app will be stopped from closing whenever possible while the configuration is open. |
| Run on startup | If you select this check box, the app will run the configuration at start-up, meaning it will not show the LS Start page. |
| Open in new window | If you select this check box, the app will open the configuration in a new window from the LS Start page. |
| Show Back button | If you select this check box, the app will show a Back button in the upper-left corner when this configuration is opened. |
| Enable Cache | Cache is disabled by default, but can be enabled here. |
| Color | This is the color that this configuration will have on the LS Start page. |
URL Parameters
Business Central has a list of URL parameters that you can use, listed below are the notable ones but for a full list and information on how to use the parameters, click here.
| Field | Description |
| company | The name of the company in Dynamics 365 that you want to target. If you only have one company, you can omit this parameter. |
| page | Opens a page object. |
| tenant | (on-premises only) Specifies the ID of the tenant to connect to. Use this parameter when Web client is deployed in multitenant architecture. The tenant that you specify must be mounted on the Dynamics 365 Business Central service instance that the Web client connects to. |
| shownavigation | Specifies whether to show the navigation bar when the specified page opens. To show the navigation bar, omit this parameter or use shownavigation=1. To hide the navigation bar, use shownavigation=0. When you hide the navigation bar, it will remain hidden as you move to different pages, until you refresh or reload the browser or set shownavigation=1 in the URL. Once you move to another page, the parameter is no longer shown in the URL, even though it is still in effect. |
| showheader | Specifies whether to show the Dynamics 365 Business Central header and its functionality. (This was introduced in Business Central 2020 release wave 1, update 16.2.)
The header is the bar at the top of pages. It gives access to the general functionality like Tell Me, Notifications, My Settings, and more. To show the header, omit this parameter or use showheader=1. To hide the header, use showheader=0. When hidden, functionality that has a keyboard shortcut, like Tell Me, is still accessible by the shortcut. The parameter is preserved when you move to other pages and if you refresh or reload the browser. |
The Services tab
Check the status of the Service Tier and the Hardware Station.
| Field | Description |
|---|---|
| Host Name | Name or the host's IP address. |
| Port | The port used to connect to the Hardware Station |
| Client service port | Client service port in LS Central. |
App Settings
These are settings that affect the app and all configurations.
| Items | Description |
|---|---|
| Auto Update Configuration | If you select this check box, you can input a file location, and the app will check the file and update configurations according to it every time it starts. |
| Service Check Timer (seconds) | Enter the time to control how often the app checks if services are running. |
| Run app in Fullscreen mode | Select this check box to run the AppShell in full screen. |
| Allow to Toggle full screen using f11 | Select this check box to toggle full screen to break out of the app and access other apps. |
| WebView2 Runtime Location | To use other than default (auto updated) WebView2 Runtime, to lock on specific version. |
| Require authentication to open settings | Select this check box to access the user name and password settings in the AppShell. |
| Use fixed size grid on start page | Select this check box to have fixed grid on the start page to fill the screen and to place tiles in a specific location. |
| Ignore certificate errors | Select this check box to ignore all certificate errors. |
| Debug Settings | Allows AppShell DevTools to be opened on start or at runtime. |
| Show hardware overlay | Select this check box to show hardware overlay. This is used to monitor AppShell RAM and CPU usage and the URL response time. |
| Put hardware overlay to debug log | Select this check box to log the information in the hardware overlay. |
| Log down console log from pos | Log down console logs from the webpage. |
| Run app at startup | Run AppShell when windows starts. |
Logs
- Click Logs in the top-right corner of the Settings screen to see the app's logs.
You can delete the logs or save them to a text file using the icons in the upper-right corner:
