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 with the App Settings at the bottom.
- Click any configuration or the App Settings to open the settings for that configuration.
In the top-right corner you have buttons to create and delete a configuration, import and export the configurations, and to open the app logs.
A configuration can be one of three types: Web Client, External Application, or Folder.
- 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. |
| Use Simplified URL | If you select this check box, simplified URL is enabled, which allows the user to input each part of the URL separately. |
| URL | The URL of the POS or BackOffice the configuration should open. |
| Login settings | User name and password to open the POS or BackOffice. |
| 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. |
| 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
Starting with AppShell version 2.3 on Windows 10, the Services functionality can 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 (minutes) | Controls 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. |
| Settings Authentication | User name and password to access the settings in the AppShell. |
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:
