相対シリアル化パスのハッシュおよびエイリアス
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Sitecore コンテンツのシリアル化 (SCS) システムはハッシュを使用して、ファイル システムのパス長ルールに違反するパスを短縮します。また、ユーザーにとって読みやすいハッシュのエイリアスも提供します。
シリアル化されたコンテンツ アイテムのファイル システム パスは、1 つの絶対パスと 3 つの相対パスによって決定されます。
SCS システムは、ベース パス、シリアル化パス、インクルード パス、およびコンテンツ アイテム パスを使用して、ファイル システム パスとファイル名を生成します。
たとえば、次のような 4 つのパスを考えてみましょう。
-
C:\Users\Peter\Sitecore\Project\src\Sites\はベース パスです。 -
serialization\はシリアル化パスです。 -
content\はインクルード パスです。 -
Home\Products\Toys\Ball.ymlはコンテンツ アイテム パスです。
SCS システムはこれらのパスを使用して、ファイル システム パスとファイル名を生成します。
C:\Users\Peter\Sitecore\Project\src\Sites\serialization\content\Home\Products\Toys\Ball.ymlこのパスとファイル名の長さは、最新のファイル システムでは問題になりませんが、コンテンツの作業者は、ファイル システムのパスとファイル名の最大長ルールに違反するコンテンツ アイテム パスを作成する可能性があります。これを回避するには、コンテンツ アイテムの最大相対パス長を設定します。
SCS システムは、以下の方法で最大長ルールを遵守します。
-
コンテンツ アイテム パスが十分に短くなるまで、コンテンツ アイテム パス セグメントを削除します。
-
削除されたコンテンツ アイテム パス セグメントを単一のハッシュ値にハッシュします。
-
ハッシュ値を残りのコンテンツ アイテム パスと連結します。
たとえば、コンテンツ アイテム パスの最大長が 20 に設定されており、24 文字の長さを持つコンテンツ アイテム パス /Home/Products/Toys/Ball をシリアル化する場合、SCS システムは /Home/Products/Toys/ を単一の値にハッシュして、Ball.yml を C:\Users\Peter\Sitecore\Project\src\Sites\serialization\content\<hash value>\Ball.yml のように連結します。
ユーザーにとってハッシュ値が読みにくい場合は、ルールにパス エイリアスを追加できます。パス エイリアスは、ユーザーが定義するカスタム ハッシュ値です。
たとえば、コンテンツ アイテム パス /Home/Producs/Toys/Ball を hptoys/Ball にハッシュするには、以下のように alias をルールに追加します。
"rules": [
{
"path": "/Home/Products/Toys/Ball",
"alias": "hptoys"
}
]こうすることで SCS システムは、シリアル化されたコンテンツ アイテムを C:\Users\Peter\Sitecore\Project\src\Sites\serialization\content\hptoys\Ball.yml に保存します。