Sitecoreコンテンツのシリアル化

ユーザーのシリアル化

Version:

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

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

ユーザーをシリアル化すると、同期操作中に指定したユーザーが考慮されます。

ユーザーのシリアル化機能を使用すると、ソリューション内のユーザーを管理して、同じプロジェクト上の他の開発者とユーザーを同期したり、Sitecore環境全体でソース管理ユーザーに変更を昇格させたりできます。ユーザーは、アイテムパッケージファイル(*.itempackage)に含めることもできます。

メモ

この機能は現在、*.datファイルの作成には使用できません。

*module.jsonでのユーザーの設定

シリアル化プロセスに含めるユーザーを決定できます。

ユーザーは、ルートセクション内の任意の *module.json設定ファイルで指定できます。 usersプロパティは、次の2つのプロパティを持つユーザー述語項目の配列です。

domain - Sitecoreユーザードメイン。
pattern - ドメインに含める特定のユーザーを決定する正規表現パターン。

例えば：

{
    ...
    "items": {
        ...
    },
    "users": [
      {
        "domain": "sitecore",
        "pattern": "Developer"
      },
      {
        "domain": "custom",
        "pattern": "User*"
      },
      {
        "domain": "extranet",
        "pattern": "^MySite.*$"
      }
    ]
}

手記

シリアル化されていないが、設定述語に一致する孤立したユーザーは、Sitecoreから自動的に削除されます。

ser infoコマンドを使用したユーザーシリアライゼーションの検査

Sitecore CLI dotnet sitecore serialization infoコマンドを使用して、ユーザーのデータを確認できます。例えば：

ModuleWithUser
  Subtrees:
    ...
  Users: 1

詳細情報を出力するには、次のコマンドで --traceまたは -tオプションを使用できます。

dotnet sitecore serialization info

Maximum subtree-relative item path allowed: 120

ModuleWithUser
    File: C:\Projects\Example\serialization\src/ModuleWithUser/ModuleWithUser.module.json
    Subtrees:
        ...
    Users:
        domain :extranet
        pattern:^MySite.*$

サーバー側のユーザー同期構成

設定ファイルは、次の場所にあります <cm_instance_path>\App_Config\Sitecore\Services.GraphQL\Sitecore.Services.GraphQL.Serialization.Users.config

<configuration xmlns:patch="http://www.sitecore.net/xmlconfig/" xmlns:role="http://www.sitecore.net/xmlconfig/role/">
    <sitecore>
       ...
        <settings>
            <setting name="Sitecore.DevEx.GraphQL.Serialization.Users.AllowUserSynchronization" value="true" />
            <setting name="Sitecore.DevEx.GraphQL.Serialization.Users.DefaultPassword" value="sitecore" />
            <setting name="Sitecore.DevEx.GraphQL.Serialization.Users.MinPasswordLength" value="8" />
        </settings>
    </sitecore>
</configuration>

AllowUserSynchronization - ユーザーをシリアル化/逆シリアル化できます。
DefaultPassword - new users逆シリアル化されると、パスワードはこの値に設定されます。値をrandomに設定すると、パスワードはランダムに生成された長い値に設定されます。それ以外の場合は、リテラル値が使用されます。 randomパスワードモードを使用している場合、管理者はユーザーのパスワードを使用する前にリセットする必要があります。
MinPasswordLength - デフォルトのパスワードがランダムでない場合、この設定は、ユーザーを逆シリアル化するときに許容されるパスワードの最小長を定義します。長さは0より大きくする必要があります。デフォルトの長さは8です。

sitecore.jsonでのCLI側のユーザー同期設定

孤立したユーザーの管理方法を指定できます。

たとえば、孤立したユーザーを削除するには、次のようにします。

 {
   ...
    "removeOrphansForUsers": true,
   ...
  },

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