Store Commerce アプリ

この記事では、Windows 用の Microsoft Dynamics 365 Commerce Store Commerce アプリの設定および構成方法について説明します。 Dynamics 365 Commerce バージョン 10.0.25 以降に適用されます。

「Dynamics 365 Commerce Store Commerce アプリは、実店舗向けの次世代製品です。」 Modern 販売時点管理 (MPOS) および Cloud 販売時点管理 (CPOS) (現在の Web 向け Store Commerce) を 1 つのアプリケーションに統合し、拡張機能を含む MPOS および Web 向け Store Commerce の機能を保持しながら、小売業者に配置の選択肢を提供し、パフォーマンスの向上や、優れたアプリケーション ライフサイクル管理 (ALM) を行ないます。

Store Commerce アプリは、レジ担当者、販売担当者、販売在庫担当者、在庫担当者、および店舗管理者などの第一線の作業者に豊富なコマース機能を提供し、作業者は次のような Commerce オペレーションを実行することができます。

  • 現金払いトランザクション
  • キャッシュ アンド シフトの管理
  • 顧客エンゲージメント
  • 支援販売
  • クライアンテリング
  • エンドレス アイル
  • 注文の処理とフルフィルメント
  • インベントリ管理
  • レポーティング

Store Commerce アプリは、Windows Presentation Foundation (WPF) シェル アプリケーションで、Windows 用であり、Microsoft Edge WebView2 コントロールを使用してウェブ用の Store Commerce をレンダリングします。 Web 用 Store Commerce は Web ブラウザでのみ実行できますが、Store Commerce は MPOS のようにネイティブの Windows アプリケーションとして実行できます。このアプリケーションには、Store Commerce アプリと Web 用 Store Commerce の両方の利点があります。

Store Commerce はローカル ハードウェア ステーションおよびオフライン使用をサポートし、支払ターミナル、プリンター、キャッシュ ドロワーに直接統合できます。 共有ハードウェア ステーションを設定することなく、ハードウェア デバイスを使用することができます。

ユーザー インターフェイス (UI) を表示するために、Store Commerce は、ユニバーサル Windows プラットフォーム (UTC) アプリ表示フレームワークの代わりに Chromium エンジンを使用します。 Chromium エンジンは、Windows の ネイティブの JavaScript UWP アプリよりも表示パフォーマンスが優れています。 MPOS と Store Commerce の主な違いは、Store Commerce がアプリを表示するのに Chromium エンジンを使用する点です。

Store Commerce アプリは、Android および iOS プラットフォームでも利用できます。 詳細については、モバイル用 Store Commerce を参照してください。

Store Commerce の利点

  • アプリケーションのライフサイクル管理を簡素化します。
  • Store CommerceアプリまたはWeb for Web向けに開発された拡張機能や独立ソフトウェアベンダー(ISV)コードを、Commerce Software Development Kit(SDK)を最小限の変更で再利用できるようにします。
  • Visual Studio CodeとGitHubを活用した業界標準の開発者体験を提供します。
  • MPOSとウェブ向けのストアコマースの利点を組み合わせています。
  • パフォーマンスを向上させます。
  • Commerceのシールドインストーラーフレームワークを通じてPOSおよび拡張機能のアップグレードを簡素化します。
  • 専用のハードウェアステーションをサポートしています。
  • オフライン展開をサポートします。

Store Commerce アプリの機能を確認するには、Store Commerce アプリ機能を参照してください。

アプリケーション ライフサイクル管理

ストアコマースアプリはWindowsデバイスで動作し、Microsoft Dynamicsライフサイクルサービスの共有アセットライブラリからダウンロードできます。 共有アセットライブラリページで、アセットタイプとして「Retail Self-service package」を選択し、「Store Commerce」で終わるファイルを見つけてください。使用しているCommerceリリースのバージョン(例:10.0.25や10.0.26)を選択してください。

Store Commerce の配置オプション

Store Commerce は、2 つのタイプの配置トポロジをサポートしています。

  • アプリ内 – すべてのコンポーネントをローカルにデプロイします。 オフラインモードおよびローカルハードウェアステーション(HWS)をサポートしています。
  • ハイブリッド – ストアコマースは、Commerce Scale Unit(CSU)に展開されるクラウドPOSをレンダリングし、ローカルハードウェアステーションをサポートします。 ただし、オフラインモードには対応していません。

ハイブリッドトポロジーとアプリ内トポロジーには別々のインストーラーはありません。 インストールパラメータが展開オプションを決定します。

Store Commerce の配置オプション。

アプリ内配置

アプリ内展開オプションでは、アプリケーションコンテンツがローカルにデプロイされます。 ストアコマースは、アプリケーションのローカル展開からコンテンツを表示します。 Commerce Scale Unit (CSU) にホストされているクラウド POS UI は取得されません。

アプリケーション コンテンツを更新するには、最新バージョンの Store Commerce インストーラを実行します。 CSUの更新はアプリケーションの内容を更新しないので、個別のレジで更新を管理できます。

アプリ内配置はオフライン モードをサポートします。 インストール中に --installoffline パラメーターを渡して、オフラインのデータベースを配置します。 オフラインモードでは、アプリケーションはCSUや商務本部に接続できず、ローカルに展開されたCRTを使用します。

Note

Store Commerce のインストール中に、ユーザーはパラメーターを渡して、ハイブリッド オプションまたはアプリ内オプションのいずれかを選択できます。 既定のオプションは、アプリ内配置です。

ハイブリッドデプロイ

Store Commerce は、CSU をオンライン モードで使用して Commerce および Commerce headquarters に接続するシェルです。 ハイブリッド モードでは、Store Commerce は、CSU でホストされている クラウドPOS UI をレンダリングします。 Store Commerceアプリを開くと、Cloud POSのURLを入力するよう促されます。

Cloud POS の URL の入力を求めるメッセージが表示される Store Commerce ダイアログ ボックスを有効化します。

Store Commerce を更新するには、CSU を更新して Store Commerce を自動的に更新します。 CSUで更新が中央管理されているため、個別のレジで管理する必要はありません。 ストアーラーを使ってStore Commerceのアプリケーションシェルを別途更新する必要があります。 CSU の更新方法の詳細については、Commerce Scale Unit (クラウド) への更新プログラムと拡張機能の適用 を参照してください。

Store Commerce と MPOS の機能

Store Commerce には MPOS と完全に同等の機能があります。 さまざまな POS アプリケーションおよびトポロジの詳細については、Store Commerce アプリと Web 用 Store Commerce の選択 を参照してください。

MPOS と Store Commerce の間のハードウェア パリティ

Store Commerce アプリは、ポイント オブ サービス デバイス のユニバーサル Windows プラットフォーム (UWP) 周辺機器をサポートしません。 現在、ユニバーサル シリアル バス (USB) スキャナーや磁気ストライプ リーダーをプラグアンドプレイ モードで使用している場合は、OLE for Retail POS (OPOS) ドライバーをインストールし、ハードウェア プロファイルでこれらのデバイスを構成して、Store Commerce アプリで動作するようにする必要があります。 Store Commerce の周辺機器サポートの詳細については、Commerce の周辺機器 をご参照ください。

MPOS から Store Commerce に移行するには、Modern POS を Store Commerce に移行する を参照してください。

Store Commerce と Web 用 Store Commerce

Store Commerce は Web 用 Store Commerce と完全に同等の機能を持ちます。 さらに、Store Commerce は専用のハードウェアをサポートし、オフラインで配置します。

MPOS と Hybrid アプリのロードマップ

Windows およびモバイル プラットフォーム用の Store Commerce アプリは、Dynamics 365 Commerce 用の次世代の POS アプリケーションです。 マイクロソフトでは、2023 年 10 月に MPOS および Retail ハイブリッド アプリ のハイブリッド アプリケーションを廃止する予定であり、新しいすべての配置には Store Commerce または CPOS の使用をお勧めします。 既存の顧客は、MPOS から Store Commerce への移行を計画する必要があります。

Store Commerce と MPOS の比較

ストアコマース MPOS
操作環境 ウィンドウズ ウィンドウズ
ALM Store Commerce アプリは、Lifecycle Services および Commerce headquarters を使用してセルフサービスを行います。 Store Commerce インストーラを使用してパッケージ化され、インストールされます。Web 用 Store Commerce は CSU を通じて配置されます。 Store Commerce アプリは、Lifecycle Services および Commerce headquarters を使用してセルフサービスを行います。 Store Commerce アプリ インストーラーを使用してパッケージ化され、インストールされます。
拡張機能 拡張機能は、CPOS に配置するか、拡張機能インストーラを使用してインストールします。 拡張機能が Store Commerce アプリと共にパッケージ化されるか、あるいは独立した拡張パッケージが使用されます。
オフライン モードでのサポート はい はい
ローカル ハードウェア ステーションのサポート はい、しかし、ポイントオブサービスデバイスであるUWP周辺機器はサポートしていません。 Store Commerce の周辺機器サポートの詳細については、Commerce の周辺機器 をご参照ください。 はい
UI レンダリング エンジン UI の表示には、Curomium エンジンが使用されます。 UI の表示には UWP アプリの表示フレームワークが使用されます。
デプロイ モード アプリ内、ハイブリッド。 詳細については、ハイブリッド配置 を参照してください。 アプリ内。
フルスクリーン モード Yes. Alt + Enter キーを押して、全画面モードの入力と終了を行います。 Yes. F11 キーを選択して、全画面モードの入力と終了を行います。

セットアップとインストール

Prerequisites

  • ストアコマースは以下のオペレーティングシステムをサポートしています:
    • Windows 11 (Pro、Enterprise、Enterprise LTSC、IoT Enterprise LTSC。)
    • 使用可能な最新の更新プログラムを含む Windows 10 (Pro、Enterprise、Enterprise LTSC、IoT Enterprise LTSC)。
    • Windows Server 2022 (Standard、Essentials)。
    • 最新の更新プログラムを含む Windows Server 2019 (Standard、Essentials)。
    • Windows 10 バージョン17763.0以降(Pro、Enterprise、Enterprise LTSC)、Windows 11(Pro、Enterprise、LTSC、IoT Enterpriseエディション)、またはWindows Server 2019(Standard、Essentials)です。

      Note

      Windows 用 Store Commerce は、ARM プロセッサでサポートされていません。

  • Microsoft Edge WebView2 (Evergreen スタンドアロン インストーラーを使用)。
  • SQL Server Express、SQL Server Standard、または SQL Server Enterprise (オフライン モードの場合のみ必須)。 使用する SQL Server エディションの詳細については、「 コマース オフライン実装に関する考慮事項」を参照してください。
  • Dynamics 365 Commerce(商務本社およびクラウドスケールユニット)。
  • 組み込みのハードウェアステーション コンポーネントをサポートするには、適切なバージョンの .NET Framework をインストールする必要があります。 Commerceのバージョンが10.0.42以降の場合は、.NET Framework 4.8をインストールします。 Commerceのバージョンが10.0.41以前の場合は、.NET Framework 4.7.2をインストールします。 詳細については、.NET Framework のインストール をご参照ください。
  • ストアコマースアプリはUIレンダリングに.NETデスクトップランタイムを使用しています。 Commerceバージョン10.0.49以降では、.NETデスクトップランタイム10をインストールしてください。 Commerceバージョン10.0.42から10.0.48までは、.NETデスクトップランタイム8をインストールしてください。 Commerceのバージョン10.0.41以前については、.NET 6.0.16をインストールしてください。 Commerceバージョン10.0.49以降向けのストアコマース拡張を開発するには、.NET 10 SDKもインストールしてください。
  • 外部アプリケーションやウイルス対策ソフトなどのプログラムを実行する際は、フォルダの削除を防ぐために以下のストアコマースフォルダを除外してください:
    • ユーザー スコープのアプリケーション データ: C:\Users\**\Microsoft Dynamics 365\10.0\Data\Store Commerce
    • 共通アプリケーション データ: C:\ProgramData\Microsoft Dynamics 365\10.0\Data\Store Commerce
  • 外部アプリケーションやアンチウイルスアプリケーションなどのプログラムを実行する際は、以下のストアコマースレジストリエントリを除外して、レジストリエントリが削除されるのを防ぎます。
    • HKLM:SOFTWARE\Microsoft\Dynamics\Commerce\10.0\Store Commerce\Configuration\*
    • HKLM:Software\Policies\Microsoft\Edge\WebView2\UserDataFolder\Microsoft.Dynamics.Commerce.StoreCommerce.exe

Commerce headquarters でのデバイスの設定

ストアコマースでは、デバイスページにストアコマースというアプリケーションタイプが追加されました(Retail and Commerce>Channel setup>POS setup>Devices)。 Store Commerce でデバイスを作成する場合、このアプリケーション タイプを選択します。

もしドロップダウンメニューにストアコマースのアプリケーションタイプが表示されない場合は、コマースパラメータページの一般タブ(Retail and Commerce>Headquarters setup>Parameters>Commerce パラメータ)から初期化関数を実行してみてください。 その後、ページを更新します。

Store Commerce のために登録デバイス を作成する必要があります。 その後、アプリを有効にする前に、Commerce headquarters の配送スケジュールからレジスター ジョブを実行します。 デバイスの作成中に、アプリケーション タイプ フィールドを Store Commerce に設定します。

デバイスのインストール

ライフサイクルサービスの共有資産ライブラリからストアコマースをダウンロードしてください。 共有アセット ライブラリ ページで、Retail セルフサービス パッケージをアセット タイプとして選択し、Store Commerce で終わるファイルを検索します。 ファイルをダウンロードしたら、以下の手順に従ってアプリをインストールしてください。

  1. Store Commerce をダウンロードしたフォルダーに移動し、管理者モードで PowerShell を開きます。
  2. PowerShell で Store Commerce のインストーラーを検索し、install パラメーターを渡してアプリをインストールします。 オフライン コンポーネントをインストールするには、--installoffline パラメーターを渡します。 (たとえば、Store_Commerce Installer_exe_name install --installoffline と入力します。) インストール中にデバッグ モードを有効にする場合は、--enablewebviewdevtools パラメーターを渡します。

Store Commerce のインストール パラメーター

PowerShellの ヘルプ コマンドを使って、すべてのパラメータに関する情報を探してください。 PowerShell で、Store Commerce インストーラを検索し、Store_Commerce Installer_exe_name help install と入力します。

Parameter Description
--config <path to config file> インストールの一部として使用する設定ファイルのパスを指定します。
--device <device identifier> ストアコマースアプリケーションで使用されるデバイス識別子をデフォルト値として指定します。 このパラメータを省略すると、デバイス起動時にデバイス識別子の入力を促されます。
--disableaadauthentication デバイスの有効化時の Microsoft Entra 認証の利用を無効にします。 このパラメーターは、オンプレミスの Active Directory フェデレーション サービス (AD FS) (ADFS) ベースの展開でのみサポートされています。
--enablewebviewdevtools Store Commerce の開発者ツールを有効にします。 このパラメータを省略すると、開発者ツールはWindows開発者モードが有効である場合にのみ有効になります。
--help パラメーターの情報を表示します。
--inplaceupgradefrommodernpos Modern POS から一括アップグレードを実行します。 このパラメータを省略した場合、インストール後にストアコマースを有効にする必要があります。
--installoffline オフラインのデータベースを配置します。 Modern POS からアップグレードする場合、--sqlservername パラメータに SQL インスタンスを渡すことで、既存のオフライン データベースを更新することができます。
--logdirectorypath <path to log directory> ログのディレクトリのパスを指定します。
--reenabledisabledclusteredindexes データベースをアップグレードする前に、オフライン データベースで現在無効になっているクラスター化インデックスを再構築します。 このパラメーターは、オフライン モードがインストールされている場合にのみ適用されます。 このオプションを使用すると、大量のテーブルで再度有効にするインデックスがある場合、インストール プロセスの実行時間が大幅に長くなる可能性があります。
--register <register number> ストアコマースアプリケーションで使用されるレジスタ番号をデフォルト値として指定します。 このパラメータを指定しない場合、デバイス起動時にレジスタ番号の入力を求められます。
--retailserverurl <Retail Server URL> Store Commerce に使用する既定の Retail Server の URL を指定します。 このパラメータを指定していない場合、デバイスのアクティベーション時にRetail ServerのURLを入力するよう促されます。
--skipdotnetversioncheck .NET がインストールされているかどうかのチェックをバイパスします。
--skipenhancedmodernposupgradevalidation 既存の Modern POS デバイスから移行する際に、強化されたアップグレード検証をバイパスすることができます。
--skipsqlfulltextcheck オフライン配置に必要な SQL 全文検索の検証をスキップします。
--skipschannelcheck セキュリティで保護されたチャンネルの必須チェックをバイパスします。
--skiptelemetrycheck インストールするアプリケーションで使用される検証をスキップします。
--skipuninstallmodernposafterupgrade アップグレードの最後の手順として、Modern POS のアンインストールをスキップします。
--skipurlcheck インストーラに渡される URL の検証をスキップします。
--skipversioncheck ダウングレードの評価時にバージョンの検証をバイパスします。
--sqlservername <SQL server name> Store Commerce がオフライン モードで使用する SQL Server のインスタンスの名前を指定します。 このパラメータを省略すると、インストーラーはデフォルトのインスタンスを使用します。
--trustsqlservercertificate SQL Server に対する接続が確立された場合は、SQL Server の証明書を信頼します。 セキュリティリスクを避けるために、本番環境での展開ではこの議論を使わないでください。 既定では、SQL Server の証明書は信頼されません。
--usecommonapplicationdata 共通のアプリケーション データ フォルダーにトークンを配置することで、デバイス上のすべてのユーザーに Store Commerce アプリをインストールします。 Store Commerceアプリを使用するには、デバイスのRetailChannelUsersグループにユーザーを追加してください。 このパラメータを省略すると、ストアコマースアプリは現在のユーザーだけにインストールされます。
--useremoteappcontent Commerce Scale Unit(CSU)からStore Commerce UIをダウンロードし表示します。 このパラメータを省略すると、Store Commerceで展開されたローカルアプリケーションコンテンツが使用されます。 詳細については、ハイブリッド配置 を参照してください。
--verbosity ログの複雑性を指定します (0 - 追跡、1 - デバッグ、2 - 情報、3 - 警告、4 - エラー、5 - 重要、6 - サイレント)。 このパラメータを省略すると、デフォルトの値である2が使われます。
--version アプリのバージョンに関する情報を表示します。

Store Commerce のアンインストール

デバイスから Store Commerce アプリケーションをアンインストールするには、次の手順に従います。

  1. PowerShellを管理者モードで開き、Store Commerceのインストーラー実行ファイルをダウンロードしたフォルダに行ってください。
  2. PowerShellでStore Commerceのインストーラー実行ファイルを見つけて、 StoreCommerce.Installer.exe uninstall パラメータを使ってアプリをアンインストールします。 このコマンドを実行するとすぐに起動し、Store Commerceをアンインストールする前に確認ダイアログが表示されません。

Store Commerce の有効化

インストール後に Store Commerce をアクティブ化するには、次の手順に従います。

  1. Windows のスタート メニューで Store Commerce を検索し、アプリケーションを開きます。

    Note

    Store Commerceアプリを権限昇格で動かさず、権限が昇格したアカウントからも動かさないでください。

  2. アプリケーションの開始ページで配置オプションとしてリモート アプリ コンテンツ を選択した場合は、CPOS URL を入力し、保存 を選択します。 クラウド POS URL は Lifecycle Services の環境詳細ページ、または Commerce のチャネル プロファイル ページ (Dynamics 365 Commerce > チャネル設定 > チャネル プロファイル) で確認できます。
  3. ガイド付きアクティブ化を使用して Store Commerce をアクティブ化する に記載の手順に従って、Store Commerce のアクティブ化を行います。
  4. アクティベーション完了後、従業員アカウントでアプリケーションにサインインしてください。

アプリをカスタマイズする

Commerce SDKを使ってストアコマースをカスタマイズしてください。 POS のユーザー エクスペリエンスの変更と作成、標準の機能拡張または変更、検証の追加、カスタム機能の追加を行うことができます。 詳細については、販売時点管理 (POS) 拡張機能の概要を参照するか、または GitHub のサンプルを確認してください。

ハードウェア ステーション拡張機能

Store Commerce は、ハードウェア デバイスと統合できるよう拡張することができます。 GitHubのサンプル拡張機能コードを使って、Store Commerceのハードウェア拡張パッケージを生成してください。 詳細については POS と新しいハードウェア デバイスの統合 を参照してください。

Microsoft Edge の WebView2 コントロール

Windows 用の Store Commerce アプリは、レンダリングに Microsoft Edge WebView2 コントロールを使用しています。 マイクロソフトは、すべての Windows 11 および対象のWindows 10 デバイスに WebView2 エバーグリーン ランタイムをプリインストールし、自動更新しています。 エバーグリーンランタイム配布モデルは管理に手間がかかるわけではありませんが、特定のStore Commerceアプリのリリースで使われるWebView2のバージョンを制御することはできません。

Microsoftは、ストアコマースアプリの特定のアップデートで使用されているWebView2バージョンを明示的に管理することを推奨しており、これによりストアコマースアプリと最新のWebView2制御原因間の不整合による回帰リスクを軽減します。

WebView2バージョンの管理

WebView2 のバージョンを管理するには、次の手順に従います。

  1. グループ ポリシーまたはレジストリ キーによる自動WebView2更新を無効にします。
  2. スタンドアロンのインストーラーを使用して、特定のバージョンのWebView2コントロールをインストールします。

    Note

    スタンドアロンのインストーラーの特定のバージョンでは、常に同じバージョンのWebView2ランタイムがインストールされます。

  3. Store Commerce アプリの各差分リリースを WebView2 Runtime の最新バージョンでテストし、Store Commerce アプリを更新するのと同時にレジスターで WebView2 Runtime を更新します。
  4. スタンドアロンのエバーグリーンインストーラーを使って、Store Commerceアプリのユーザーアクセプタンステスト(UAT)で使用した特定のWebView2ランタイムバージョンを展開してください。
  5. WebView2 Runtime のマシン全体へのインストールを強制したり、インストールを無効にしたりするには、インストール (WebView) ポリシーを使用します。 このポリシーにより、コンピュータのすべてのユーザーが同じバージョンのWebView2ランタイムを使用することができます。
  6. Update (WebView) ポリシーを使用して、Microsoft Edge の更新によるすべての WebView2 ランタイム更新を無効にします。

    Note

    Edge には別のアップデート ポリシーがあるため、Microsoft Edge のアップデートによる WebView2 Runtime のすべてのアップデートを無効にしても、Edge ブラウザのバージョンには影響しません。

Microsoft Edge WebView2 コントロールに関する既知の問題

有効化の際に、複数のオプションを使用して Microsoft Entra パスワードを入力するように求めるメッセージが表示されたら、パスワードを選択します。 他のオプションが機能しない場合があります。

その他のリソース