Setup in Head Office

Retail Setup

The Preaction Creation by field must have the values Database Triggers:

Scheduler Setup

In the Scheduler Setup page, in the General FastTab, you must configure the following:

Activate the Replicate using Preactions check box.
This ensures that preactions are created with the correct Location Group Filters that will enable replication based on preactions.
Set up the control location in the Azure Storage Control Location field.

Normally, you should select the HEADOFFICE value. This is the source distribution location that is the location holding the control information about data packages.

Note: In the Configuration Packages provided by LS Retail, Distribution Locations are included in the replication jobs, so you need to make sure that the Web Server FastTab in the Distribution Location Card is properly set up. You should use the Test Web Connection action to test that. If the setup is not correct, the POS might not be able to communicate with the Head Office, and you need to review the Web Server FastTab setup for the Azure Storage Control Location, in the POS terminal.

Azure Storage Account Setup

Define the access to the Azure Storage:

In the Scheduler Setup page, click the Setup action, then click Web Replication Azure Storage Setup. Here you set up the Azure Storage Account and Container to use:

Note: Before you define access to Azure Storage, you must create a storage account in Azure. Refer to How to: Set Up an Azure Storage Account for detailed instructions on setting up an Azure Blob Storage account.

Web Replication Azure Storage Setup is only required on the HO and should not be replicated to the POS. The required information for the POS to connect to Azure Storage and to the specific file(s) to be fetched is included in the HO response when the POS connects to HO asking for new packages.

Distribution Locations

HEADOFFICE Distribution Location

Fill in the following fields in the Distribution Location Card as shown:

Web Server FastTab:

Web SSL: Enabled
Web Server SaaS: Enabled
Web Server Computer Name: api.businesscentral.dynamics.com
Web Server Version: v2.0
Web Server Tenant: The SaaS environment tenant ID.
Web Service Environment Name: Environment name to where the transactional data from the POS is going to be replicated to.
Web Service Company Name: Company name to where the transactional data from the POS is going to be replicated to.
Web Service URI: No need to update as it should be automatically filled in when filling the other fields.
Web Server AuthType: S2S
Web Service Client ID: The Entra Application (former Azure Active Directory app) ID created for the S2S authentication.
Web Service Client Secret: The Entra Application client secret.

Azure Storage FastTab:

Azure Storage Active: Disabled.

Note: The Azure Storage is not supposed to be active on the Azure Storage Control Location (usually the HO), because the Web Replication using Azure Storage is only being used when replicating from Head Office to the POSs. Replication from the POSs to Head Office still relies on Web Replication without Azure Storage and therefore this flag should be disabled.

If you are following the documentation (see Offline POS) on how to set up a new Offline POS using Update Service, the HO Distribution Location Card is included in the installation process, and the fields in the Web Server FastTab are filled in during the installation for the POS.

POS Distribution Locations

For each Distribution Location related to a POS, define which locations take part in the Azure Storage replication:

Navigate to the Distribution Location Card, and in the Azure Storage FastTab, enable the Azure Storage Active check box.

Note: For the POS Distribution location it is not required to fill in the Web Server FastTab. The only requirement is to enable the Azure Storage Active check box. The POS is requesting the package from HO, therefore it is not required for HO to know the URI of the POS.

Web Services

Go to the Web Services page, and publish a support web request by publishing codeunit 10000772 LSC Web Repl. AzS OData Mgt as OData V4 with service name WebReplAzSODataMgt.