1. 開発者向けのドキュメント

環境の設定をしましょう

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

環境設定ファイルを作成すれば、すべての環境(例えば開発・本番環境)を一か所で定義・制御できます。これは、現在の環境に特化した新しいアプリケーション設定を作成し、他の環境設定を上書きすることで実現できます。

環境固有の構成を作成するには:

  1. 新しいアプリ設定を含むweb.config.xdt変換ファイルを作成し、例えば環境名をDEVに設定するなど :

    <?xml version="1.0" encoding="utf-8"?>
    <configuration xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform">
      <appSettings>
        <add xdt:Transform="InsertIfMissing" xdt:Locator="Match(key)" key="customenvironment:define" value="DEV" />
      </appSettings>
    </configuration>
  2. プラットフォームプロジェクトにウェブ設定ファイルを含める:

    <ItemGroup>
        <Content Include="xdts\Web.config.xdt">
          <CopyToOutputDirectory>Always</CopyToOutputDirectory>
        </Content>
     </ItemGroup>
  3. ビルド設定ファイル(xmcloud.build.json)で、xdtファイルのマッピングを作成します:

    "transforms": [
          {
            "xdtPath": "/xdts/web.config.xdt",
            "targetPath": "/web.config"
          }  
        ]
    XM Cloudは現在SitecoreAIとなっています

    一部のコード例、画像、UIラベルは、エンジニアリング資産の更新中もXM Cloudを使用している場合があります。

  4. SITECORE_APPSETTINGS_customenvironment__defineという環境変数を作成します。これによりcustomenvironmentアプリの設定が上書きされます。変数の意味のある値を入力します。この例では、ステップ1でデフォルト名がDEVに設定されており、この変数を使ってPRODに変更できます。

  5. settings属性で環境固有の構成を作成し、プロジェクトに組み込みます。この例は新しいアプリ設定を使って他の設定を制御する方法を示しています:

    <?xml version="1.0" encoding="utf-8" ?>
    <configuration xmlns:patch="http://www.sitecore.net/xmlconfig/" xmlns:customenvironment="http://www.sitecore.net/xmlconfig/pskenvironment/">
      <sitecore>
        <settings>
          <setting name="Xdt.Test" value="None">
            <patch:attribute name="value" value="DEV" customenvironment:require="DEV" />
            <patch:attribute name="value" value="QA" customenvironment:require="QA" />
          </setting>
        </settings>
      </sitecore>
    </configuration>
  6. ビルドを作成してデプロイしてください。これは変更が適用されるために必要です。

この記事を改善するための提案がある場合は、 お知らせください!