アプリ設定

[アーティクル]
07/30/2024

この記事では、Microsoft Dynamics 365 Commerce でのアプリ設定について説明します。

\src\settings\app.settings.json ファイルには、グローバル構成、ルート、およびテーマのアプリ設定が保持されます。次の例では、設定の各タイプのセクションを含む JavaScript Object Notation (JSON) ファイルを示します。

{
    "config":{
        "logoUrl":{
            "type": "image",
            "friendlyName": "Logo Image",
            "description": "Logo Image"
        }
    },
    "routes": {
        "cart": {
            "friendlyName": "Cart Page Route",
            "description": "Cart Page Route",
            "default": "/cart2"
        },
        "checkout": {
            "friendlyName": "Checkout Page Route",
            "description": "Checkout Page Route",
            "default": "/checkout"
        }
    },
    "themes": {
       "default":{
            "friendlyName": "Default Theme"
        }
        "spring":{
            "friendlyName": "Spring Theme"
        }
    }
}

構成セクション

app.settings.json ファイルの構成セクションでは、グローバル構成フィールドがサポートされます。このフィールドは、作成ツールでサイトレベルで設定でき、this.props.context.app.config.* アプリケーションプログラミングインターフェイス (API) を使用してすべてのモジュールで共有されます。

グローバル構成フィールドは、オンラインサイト全体で 1 回だけ設定する必要があるデータがありますが、それが複数のモジュールで必要とされる場合に役立ちます。たとえば、評価とレビュー用の API キーはオンラインサイトで同じ値を持ち、その値は複数のモジュールで必要とされます。モジュール自体はサイト規模のコンフィギュレーション設定もサポートしますが、これらの設定を複数のモジュール間で共有することはできません。

これらのコンフィギュレーションのスキーマは、モジュールコンフィギュレーションに使用されるスキーマと同じです。

ルートセクション

app.settings.json ファイルのルート セクションを使用して、モジュールに URL ルートを追加します。たとえば、モジュールでカートページへのリンクを作成する必要がある場合、「カート」 ルートが JSON ファイルに追加されます。その後、作成ツールを使用して、モジュールコードからルートを取得できます。

this.props.context.app.routes.* API を使用して、モジュールビューファイルのルートにアクセスできます。

テーマセクション

app.settings.json ファイルのテーマ セクションを使用して、作成ツールにテーマを公開します。このセクションのテーマは、\src\themes\ ディレクトリのテーマ名と一致する必要があります。サイトレベルまたはテンプレート、レイアウト、またはページエディタでテーマを設定するときに、作成者ツールが表示できるローカライズ可能なフレンドリ名を提供する必要があります。

ローカライズされたアプリの一般設定

各アプリ設定の friendlyName プロパティと説明プロパティの両方を、Dynamics 365 Commerce 作成ツールのサイトロケールに合わせてローカライズする必要があります。 src/resources/authoring/global.json ファイルを更新して設定プロパティを含め、リソース文字列に関連するすべての設定をそのプロパティの下にリストする必要があります。

リソーススキーマ

{
    "settings": {
        "<setting_property>": {
            "friendlyName": {
                "value": "",
                "_value.comment": ""
            },
            "description": {
                "value": "",
                "_value.comment": ""
            },
        }
    },
}

こちらは、リソースファイルの例です。

{
    "settings": {
         "logoUrl": {
            "friendlyName": {
                "value": "Logo Image",
                "_value.comment": ""
            },
            "description": {
                "value": "Logo Image",
                "_value.comment": ""
            }
        },
         "cart": {
            "friendlyName": {
                "value": "Cart URL",
                "_value.comment": ""
            },
            "description": {
                "value": "Cart page route",
                "_value.comment": ""
            }
        }
    }
}