次の方法で共有


有効な機能に基づくサイト ビルダーのグローバル構成設定のコンフィギュレーション

この記事では、特定の Commerce 機能が有効になった際、Microsoft Dynamics 365 Commerce サイト ビルダーのグローバル構成プロパティがどのように表示、非表示、または無効にすることができるか説明します。

サイト ビルダーのサイト設定 > 拡張機能 > 構成で有効なグローバル構成プロパティは、アプリ設定ファイル (/settings/app.settings.json) の hiddenWithFeatureFlags および disabledWithFeatureFlags プロパティの設定に基づき、表示、非表示、または無効に設定できます (読み取り専用)。 アプリ設定については、アプリ設定を参照してください。

使用状況

特定の構成プロパティを表示、非表示、または無効に設定するには、hiddenWithFeatureFlags および disabledWithFeatureFlags プロパティの Dynamics 365 機能フラッグの名前一覧を追加し、それぞれに"ON" または "OFF" の値を指定します。 複数の機能フラグ名を追加する場合、論理 "OR" 演算子では構成プロパティを表示するか非表示にするか決定します。 たとえば、hiddenWithFeatureFlags プロパティに両方の "FeatureName1""FeatureName2" を追加し、両方に "ON" の値を指定します。 この場合、Commerce headquarters で 2 つの機能のいずれかを有効にすると、関連する構成プロパティは非表示になります。 この機能は、Commerce Headquarters で両方の機能がオフになっている場合に表示されます。

プロパティ スキーマ

hiddenWithFeatureFlags: {"<FeatureName1>": "ON/OFF", "<FeatureName2>": "ON/OFF"}
disabledWithFeatureFlags: {"<FeatureName1>": "ON/OFF", "<FeatureName2>": "ON/OFF"}

特定の機能が有効な場合、app.settings.json ファイルに構成プロパティを表示させます

次の例では、hiddenWithFeatureFlags プロパティをアプリ設定ファイル内でどのように使用できるか示します。 この例では、B2B_INVENTORY_MANAGEMENT 機能が Commerce headquarters でオフになっている場合のみ、b2bQuantityMultiple 構成プロパテイはサイト ビルダーで表示されます。

{ 
    "config":{ 
        "b2bQuantityMultiple":{
            "friendlyName":"Quantity multiple",
            "description":"Number of items needed to be purchased together",
            "type":"number",
            "default":2,
            "hiddenWithFeatureFlags":{
                "Dynamics.AX.Application.B2B_INVENTORY_MANAGEMENT": "ON"
             },
            "group":"B2B Inventory management"
        }
    }
}

特定の機能が有効な場合、app.settings.json ファイルに構成プロパティを無効にします

次の例では、disabledWithFeatureFlags プロパティをアプリ設定ファイル内でどのように使用できるか示します。 この例では、B2B_INVENTORY_MANAGEMENT 機能が Commerce headquarters でオンになっている場合のみ、maxQuantityForCartLineItem 構成プロパテイはサイト ビルダーで表示されます。

{
    "config":{
        "maxQuantityForCartLineItem":{
            "friendlyName":"Cart Line Quantity Limit",
            "description":"Limit to the number of copies of an item that can be added to a cart line",
            "type":"number",
            "default":10,
            "disabledWithFeatureFlags":{
                "Dynamics.AX.Application.B2B_INVENTORY_MANAGEMENT" : "ON"
            },
            "group": "B2B Inventory management"
        }
    }
}

Commerce で機能をオンにする方法については、機能管理の概要を参照してください。

追加リソース

アプリ設定

機能管理の概要