1. Sitecoreコンテンツシリアライズ

ロールシリアライゼーションの設定

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

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

同期操作に指定された役割を含めるように役割をシリアライズすることも可能です。シリアライゼーションは、開発者やDevOpsエンジニアが同じプロジェクト内の他の開発者とロールを同期させることで、自分たちのソリューション内で役割を管理できるようにします。これにより、Sitecore環境全体でソース制御ロールの変更を推進できます。

注記

この機能はCLI 4.0以降から利用可能で、現在は*.datファイル作成には利用できません。バージョン4.1以降、Sitecore CLIはアイテムパッケージ内でシリアライズされたロールの組み込みをサポートします。

*module.jsonファイルで役割を設定する

シリアライズプロセスに含める役割を定義できます。どの設定ファイルでも役割を指定 *module.jsonことができます。rolesプロパティは、2つのプロパティを持つ役割述語項目からなる配列です。

  • domain(Sitecoreロールドメイン)

  • pattern(ドメインに含める特定の役割を決定するための正則表現パターン)

大事な

変更を行う前に、地域の環境が最新であることを必ず確認してください。^.*$のようなパターンを定義し、pullコマンドの前にpushコマンドを実行すると(シリアライズされたロールがコンピュータに存在しないように)、Sitecoreインスタンスから削除予定の段階化されたすべてのロールが削除されます。

*module.json設定ファイルで役割を設定するには:

  • ルートセクション内で、patternとdomain役割プロパティを指定します。例えば：

    {
    ...
    "items": {
        ...
    },
    "roles": [
      {
        "domain": "sitecore",
        "pattern": "Developer"
      },
      {
        "domain": "custom",
        "pattern": "Role*"
      },
      {
        "domain": "extranet",
        "pattern": "^MySite.*$"
      }
    ]
}
大事な

設定述語に一致する非シリアライズされた孤児ロールは自動的にSitecoreから削除されます。

警告

Sitecore CLIはカスタムセキュリティドメイン内でロールをシリアライズすることを可能にします。ただし、プッシュコマンドで自動的にカスタムドメインが作成されるわけではありません。ロールが正しく機能するように、ターゲット環境で手動で セキュリティドメインを作成し てください。

ロールシリアライズのチェック

役割データの要約を確認するには:

  • serialization infoコマンドを実行してください。出力:

    ModuleWithRole
  Subtrees:
    ...
  Roles: 1

役割データの詳細を確認するには:

  • serialization info -tコマンドを実行してください。出力:

    Maximum subtree-relative item path allowed: 120

ModuleWithRole
    File: C:\Projects\Example\serialization\src/ModuleWithRole/ModuleWithRole.module.json
    Subtrees:
        ...
    Roles:
        domain :extranet
        pattern:^MySite.*$
この記事を改善するための提案がある場合は、 お知らせください!