ロールのシリアル化を構成する

Version:

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

このページの翻訳は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を使用すると、カスタムセキュリティドメインでロールをシリアル化できます。ただし、カスタムドメインはpushコマンドで自動的には作成されません。ロールが正しく機能するようにするには、ターゲット環境にセキュリティ・ドメインを手動で作成します。

ロールのシリアル化を確認する

ロールデータの概要を確認するには:

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.*$

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