Overview of the CRT
and POS Extension
with the new Sealed
SDK
Luke Graham
Mugunthan Mani
1
Dynamics 365 Product
guidance
Implementation Guide General Case
guidance studies
Collective experience gained through
thousands of Dynamics 365 implementations
References to Guide Checklists
other guidance Experience
Highlights Recommended
deliverables
Conceptual
graphic
support
Available at: https://aka.ms/d365implementationguide
2
Agenda
❑ Overview of Commerce Extension.
❑ New Commerce SDK Overview.
❑ Setup Commerce Development Environment.
❑ Develop Headless Commerce Extensions.
❑ Extension installers.
❑ Develop POS Extensions.
❑ Session Takeaways
❑ Q & A.
3
Architecture Overview
4
DYNAMICS 365 COMMERCE
COMPONENT ARCHITECTURE
ENVIRONMENT BACK OFFICE/HEAD OFFICE OPERATIONS IN-STORE COMPONENTS E-COMMERCE WEBSITE VISIT SITE DESIGN & ADMINISTRATION
ADMINISTRATION
IT PRO CALL CENTER AGENT BACK OFFICE USER STORE ASSOCIATE CLOUD POS MODERN POS E-COMM CUSTOMER SITE DESIGNER CONTENT AUTHOR
w/OFFLINE
HARDWARE
LCS WEB PORTAL HQ CLIENT: CALL CENTER HQ CLIENT: BACK OFFICE IOS POS ANDROID POS E-COMM WEBSITE E-COMM SITE BUILDER WEBSITE SITE BUILDER WEBSITE
STATION
MOBILE WEB
ENVIRONMENT BACK OFFICE COMMERCE CORE RUNTIME E-COMMERCE WEBSITE SITE DESIGN & ADMINISTRATION
ADMINISTRATION
DYNAMICS 365 COMMERCE WEB SITE BUILDER
COMMERCE HQ SCALE UNIT STOREFRONT
DYNAMICS 365
SUPPLY CHAIN
LIFECYCLE SERVICES
(ADMIN PORTAL)
DYNAMICS 365 COMMERCE AI CLOUD POWERED DIGITAL ASSET
FINANCE SEARCH MANAGEMENT
DYNAMICS 365 CUSTOMER DYNAMICS 365 RATINGS & REVIEWS
HR INSIGHTS FRAUD PROTECTION
POWER BI AZURE DATALAKE COMMON DATA DYNAMICS 365 DYNAMICS 365 DYNAMICS 365 DYNAMICS 365 DYNAMICS 365 POWER APPS
STORAGE SERVICE MARKETING SALES CUSTOMER SERVICE FIELD SERVICE PROJECT OPS.
UNIFIED DATA PLATFORM
5
COMPILATION
EXTENSIBILITY OVERVIEW
COMPILATION DEVELOPER EXPERIENCE
DYNAMICS 365 FIN & OPS EXTENSION E-COMMERCE EXTENSION HEADLESS COMMERCE & POS EXTENSION
FIN & OPS APP E-COMMERCE HEADLESS COMMERCE HEADLESS COMMERCE MODERN POS
DEPLOYMENT EXTENSION PACKAGE EXTENSION PACKAGE EXTENSION PACKAGE ON-PREM INSTALLER ON-PREM INSTALLER
Runtime/Service Extension Modules, Themes, Data Actions POS UI & Runtime Extension Commerce Runtime Commerce Runtime
Database Extension Configuration Runtime / API Extension Channel Database Schema Channel Database Schema
Modules, Themes, Data Actions Database Extension POS UI & Runtime POS UI & Runtime
DEPLOYMENT Runtime / API Extension Runtime / API Extension
Database Extension Database Extension
POS UI & Runtime Extension POS UI & Runtime Extension
DEPLOYMENT & SERVICING EXPERIENCE
DYNAMICS 365 LIFE CYCLE SERVICES ON-PREM MASS DEPLOYMENT INFRASTRUCTURE
MICROSOFT OWNED AND MANAGED CUSTOMER OWNED AND MANAGED
DEPLOYMENT & SERVICING EXPERIENCE
DYNAMICS 365 E-COM STOREFRONT COMMERCE SCALE UNIT COMMERCE SCALE UNIT MODERN POINT OF SALE
FIN & OPS APPS RENDERING <…> CLOUD-HOSTED SELF-HOSTED
Service Fabric / Azure SQL Azure Web App / Node JS Azure Web App / Azure SQL IIS / SQL Server Windows App / SQL Express
DEPLOYMENT
EXTENSIONS EXTENSIONS EXTENSIONS EXTENSIONS EXTENSIONS
6
Commerce SDK Overview
7
Commerce SDK
Packages published to the public feed.
Samples available in GitHub.
Components Commerce SDK Old SDK (Retail SDK available in LCS Dev VM)
Reference libraries Published in the public feed. Published in the Retail SDK\Pkgs
Samples GitHub Retail SDK\Samples
Packaging tools Packages available in the public feed to generate packages. Retail SDK\Packages
Dev Environment Scripts available in GitHub Preconfigured in LCS Dev VM
POS Templates available in GitHub POS.App/Extension project available in Retail
SDK\POS
Installers New Sealed Extension installer framework (packages Retail SDK\Packages (Combined installer).
required to generate the installer are available in public
feed)
Build pipeline Sample scripts available in GitHub Based on the dirs.proj file available in the Retail
SDK
8
Commerce SDK
Why?
❑ Seamless update experience.
❑ Improved performance using the new ASP. Net Core 3.1.
❑ Sample Extensions are published to GitHub
❑ The new Sealed installers are headless.
❑ Automated packaging and configuration of extensions.
❑ Improved build times.
❑ Improved Dev experience, using VS Code for CSU extensions.
9
Setup Commerce Development Environment
10
Setup Local Commerce Development Environment
Pain points
▪ Tightly coupled with LCS VMs.
▪ Requires AOS.
▪ Deployment and Update process takes hours.
▪ VM COGS.
▪ Need Visual Studio 2017 for CSU development.
11
Setup Local Commerce Development Environment
Benefits
▪ New Sealed Installers framework to setup and deploy extensions.
▪ F5 like Developer experience using Visual Studio Code.
▪ Lightweight Scale Unit without AOS, RTS and CDX
▪ Support for full scale CSU.
▪ No dependency with LCS Dev VM, faster updates and deployment.
▪ Reduces COGS.
12
Demo - Setup Commerce Development Environment
13
Headless Commerce Extension
14
HEADLESS COMMERCE
SAMPLE NATIVE APPS HEADLESS SAMPLE THIRD PARTY
AND SERVICES COMMERCE APPS AND SERVICES
AZURE WEB APP / IIS WEB SERVICE
E-COMMERCE ODATA ENDPOINT THIRD-PARTY
STOREFRONT / POS NATIVE APP OR SERVICE
Search Controller Cart Controller Loyalty Controller Shipping Controller Ext
HTML / JavaScript App
Typescript Proxy Payments Controller Pricing Controller … Tax Controller Ext C# Proxy
MIDDLEWARES
Authentication Authorization Exception Handling …
THIRD-PARTY
COMMERCE RUNTIME
SHIPPING SERVICE
Search Service Order Service Loyalty Service Shipping Service Ext
DYNAMICS 365
FRAUD PROTECTION THIRD-PARTY
Fraud Protection Service Pricing Service Customer Service Tax Service Ext
TAX SERVICE
Recommendations Serv. Shifts Service … Gift Card Service Ext
RECOMMENDATIONS
SERVICE THIRD-PARTY
GIFT CARD SERVICE
Transaction Service Caching Service SQL Data Service …
DYNAMICS 365
FIN & OPS APPS
AZURE SQL / SQL SERVER
CHANNEL DATABASE
Commerce Runtime Schema Commerce HQ Schema Extension Schema
15
COMMERCE RUNTIME
COMMERCE SCALE UNIT COMMERCE SCALE UNIT MODERN ARCHITECTURAL
CLOUD-HOSTED SELF-HOSTED POINT OF SALE HIGHLIGHTS
AZURE WEB APP IIS WINDOWS APP Symmetric and portable architecture
1
that is independent from the host.
ODATA ENDPOINT ODATA ENDPOINT UI LAYER
Composable to fit the context of the
OOB Controllers OOB Controllers 2
hosting application.
Extension Controllers Extension Controllers
Highly extensible with request
3
handlers and pre/post triggers.
MIDDLEWARES MIDDLEWARES NATIVE CLIENT BROKER
COMMERCE RUNTIME COMMERCE RUNTIME COMMERCE RUNTIME
OOB Services OOB Services OOB Services
Common Extensions Cloud Extensions Common Extensions On-Prem Extensions Common Extensions Offline Extensions
AZURE SQL SQL SERVER SQL EXPRESS / SQL SERVER
CHANNEL
CHANNEL DATABASE
DATABASE CHANNEL
CHANNEL DATABASE
DATABASE OFFLINE
CHANNEL DATABASE
DATABASE
OOB Schema OOB Schema OOB Schema
Extension Schema Extension Schema Extension Schema
16
COMMERCE RUNTIME
COMMERCE SCALE UNIT COMMERCE SCALE UNIT MODERN ARCHITECTURAL
CLOUD-HOSTED SELF-HOSTED POINT OF SALE HIGHLIGHTS
AZURE WEB APP IIS WINDOWS APP Symmetric and portable architecture
1
that is independent from the host.
ODATA ENDPOINT ODATA ENDPOINT UI LAYER
Composable to fit the context of
OOB Controllers OOB Controllers 2
the hosting application.
Extension Controllers Extension Controllers
Highly extensible with request
3
handlers and pre/post triggers.
MIDDLEWARES MIDDLEWARES NATIVE CLIENT BROKER
COMMERCE RUNTIME COMMERCE RUNTIME COMMERCE RUNTIME
OOB Services OOB Services OOB Services
Common Extensions Cloud Extensions Common Extensions On-Prem Extensions Common Extensions Offline Extensions
AZURE SQL SQL SERVER SQL EXPRESS / SQL SERVER
CHANNEL
CHANNEL DATABASE
DATABASE CHANNEL
CHANNEL DATABASE
DATABASE OFFLINE
CHANNEL DATABASE
DATABASE
OOB Schema OOB Schema OOB Schema
Extension Schema Extension Schema Extension Schema
17
Demo – Headless Commerce Extension
18
Extension installers
19
Extension installers
❑ Headless Extension installers.
❑ Separates Core and extensions.
❑ Multiple extension installer.
❑ Parameters.
❑ Mass deployment.
❑ Extension installer can be generated by consuming the installer packages.
20
Demo – Extension installers
21
Point of Sale Extensions
22
POS Extensions Overview
Extend existing POS functionality
Views –extensions to modify the UI on POS views
Ex. App Bar Buttons, Custom Column Sets, Custom Controls, etc.
Request Handlers – Extensions that replace the handlers for select requests within the POS runtime
Triggers – that add functionality to existing POS business logic workflows
Header –extensions that add custom functionality to the POS header bar
Create new functionality
Controls – that can be re-used throughout the custom UI flows in POS
Dialogs –that look and feel like existing POS dialogs
Operations –that can perform custom business logic
Request Handlers – that enable extensions to re-use business logic throughout the extension package
Views – that look and feel like core POS views
23
POS Extensions Overview
Developed in TypeScript/HTML using the PosApi library
Each POS extension is made up of one or more a TypeScript modules and/or HTML fragments
PosApi is JavaScript module library organized into three parts
Create – These APIs enable extensions to create new user experiences and workflows
Consume – These APIs provide opportunities for extensions to consume existing POS functionality & controls
Extend – These APIs that enable extensions to extend existing POS functionality like Views and Request Handlers
Extensions that combine to enable an end-to-end scenario are
packaged into an ExtensionPackage
Contains a manifest.json file that lists all the extensions in the package
Modeled as a separate project in the Commerce SDK
24
Changes to POS Extensions in the Commerce SDK
25
Improved way to use common POS controls
The PosUISdk control library was replaced with a new APIs in PosApi/Consume/Controls
Retail SDK Commerce SDK
26
Simplified custom View creation
Extensions that create new Views
should use the new base class
CustomViewControllerBase
instead of
ExtensionViewControllerBase
Provides a more maintainable API for
creating custom views and simplifies
extension development
Automatic handling of the spinner and
header bar
27
Configuring POS Extension Packages
POS now loads the list of configured
extension package definitions from the
headless Commerce engine by calling
the GetExtensionPackageDefinitions API
instead of from extensions.json
Removes the need for a code merge in the
extensions.json file
Enables a true independent packaging model for all
extension packages
28
Independent Packaging of Extensions in the
Commerce SDK
Retail SDK Commerce SDK
29
POS Extension Project Types in the Commerce SDK
Pos Extension Package Project – Compiles all extensions in an extension package.
Commerce SDK Nuget Package: Microsoft.Dynamics.Commerce.Sdk.Pos
Project Type: .NET SDK Class Library Project (netstandard2.0, .csproj)
Output: POS extensions web artifacts to be included in a Modern POS Modification Package and/or the Commerce
Scale Unit Deployable Package for CPOS
Modern Pos Extension App Package Project – Creates a package with all the POS, Headless
Commerce & HWS extensions into a Universal Windows Platform App Modification Package.
Commerce SDK Nuget Package: Microsoft.Dynamics.Commerce.Sdk.Pos
Project Type: Universal Windows App Package Project (.jsproj)
Output: The POS Extension Modification Package (.msix)
Modern Pos Extension App Package Installer Project – Generates a ModernPos extension app
package installer.
Commerce SDK Nuget Package: Microsoft.Dynamics.Commerce.Sdk.Installers.ModernPos
Project Type: .NET SDK Console Application Project (net461, .csproj)
Output: The Modern POS Extension Installer Executable (.exe) used to install the Modern POS extension app package
and channel database extensions
30
Demo – Point of Sale Extensions
31
Takeaways
Commerce SDK modernizes the development experience while maintaining compatibility the
most of the existing code extensions from the Retail SDK
Dependencies managed through NuGet simplifying update experience
No dev VM required
Independent packaging of extensions enables streamlined upgrade experience with no code
merge required
Migration to Commerce SDK is required by October 2022 when support for the Retail SDK will
be dropped
We’re hear to help ensure the migration process is a success
Upcoming Tech Talks:
8 am PST November 17th, 2021 - POS Extensions Deep Dive
8 am PST December 8th, 2021 – Migrating a POS Extension to the Commerce SDK
TBD – Packages and Build Automation with the Commerce SDK
TBD – Headless Commerce Engine Extensions Deep Dive
TBD – Hardware Station Extensions Deep Dive
32
Q&A
33
