1. データ テンプレート フィールド

テンプレート フィールド テンプレート

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

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

フィールド定義アイテムは、Template fieldテンプレートに基づいています。各テンプレート フィールド定義アイテムには、次のフィールド プロパティのいずれかを含めることができ、多くのプロパティを定義できます。

フィールド名

これは、フィールドの作成時にフィールドに割り当てられた名前です。これは、Titleフィールドが入力されていない限り、フィールドのラベルとして使用されます。

メモ

フィールド名は一意である必要があります。フィールドが同じ名前の単一のデータテンプレートで定義されている場合、データテンプレートの保存時に検証エラーが発生します。ただし、フィールドは基本テンプレートから継承することもできるため、アイテムには同じ名前の複数のフィールドが含まれる可能性があります。これが発生すると、Sitecoreはコンテンツ エディターに両方のフィールドを表示しますが、APIとXSLTレンダリングを使用するときにフィールド名を使用してコンテンツを取得するプログラマーは、予期しない結果になる可能性があります。

フィールドを名前で参照するときにコードを読みやすくするには、特殊文字を使用せずに、変数名のようなフィールド名を作成します。

種類

フィールド タイプは、このフィールドへの入力を受け入れるためにコンテンツ エディタに表示されるユーザー インターフェイス コントロールを指定し、このフィールドの格納形式も制御します。フィールド タイプの詳細については 、「データ テンプレート フィールド タイプ」を参照してください。

タイトル

タイトルは、タイトルが空白の場合はフィールド名が表示されますが、タイトルが空白の場合はフィールド名が表示されます。

源

sourceプロパティは、コンテンツ エディターのフィールドに関連付けられたユーザー インターフェイス コントロールに影響を与える情報を提供します。ソース フィールドの動作は、フィールドのタイプによって異なります。

次に例を示します。

  • Droplinkなどのリスト フィールド タイプの場合、sourceプロパティは、フィールドによって表示されるリストに含まれるアイテムを含むコンテンツ ツリー内の場所を示します。

  • 画像タイプとファイルタイプの場合、sourceプロパティはメディアライブラリダイアログボックスに表示される開始フォルダーを示します。

手記

パスがチルダ (~) 文字で始まる場合、ダイアログ ボックスは目的のフォルダーが選択された状態で開きますが、ユーザーはツリー全体にアクセスできます。

  • リッチテキストフィールド定義の場合、sourceプロパティで指定された項目は、編集インターフェイスによって提供される機能を制御するHTMLエディタープロファイルを指定します。

  • 選択フィールドの場合、次の例に示すように、field sourceプロパティでは、実際のクエリ ステートメントの前にquery: プレフィックスを使用してSitecoreクエリを指定できます。

    query:/sitecore/content/Home/Employees/*[ startswith(@EmployeeName, 'A')]

    Sitecoreクエリ構文の詳細については、「 Sitecoreクエリ」セクションを参照してください。

ソース・パラメーター

TreelistやTreelistExなどのさまざまなフィールドでは、SitecoreQueryの代わりにSourceプロパティで使用される次のパラメーターがサポートされています。

パラメーター

形容

DataSource

フィールド データ ソース アイテムは、前に説明したように、フィールド ソース プロパティとしてパスを使用するのと同じです。

DatabaseName

データ ソース アイテムを含むデータベースの名前。

IncludeTemplatesForSelection

ユーザーは、このテンプレート名のコンマ区切りリストに関連付けられたアイテムを選択できます。

ExcludeTemplatesForSelection

ユーザーは、このテンプレート名のカンマ区切りリストに関連付けられているアイテムを選択できません。

IncludeTemplatesForDisplay

ユーザーは、このテンプレート名のカンマ区切りリストに関連付けられた項目を移動できます。

ExcludeTemplatesForDisplay

ユーザーは、テンプレート名のコンマ区切りリストに関連付けられたアイテムを表示できません。

IncludeItemsForDisplay

ユーザーは、このテンプレート名のコンマ区切りリストに関連付けられた項目を移動できます。

ExcludeItemsForDisplay

ユーザーは、このカンマ区切りのIDリストを持つアイテムを表示できません。

AllowMultipleSelection

ユーザーは複数のアイテムを選択できます。

次の例に示すように、sourceプロパティの複数のパラメーターはアンパサンド (&) 文字で区切ることができます。

DataSource=/sitecore/content/home&IncludeTemplatesForSelection=section,sitemap

ブロッブ

このフィールドはSitecoreの内部でのみ使用されるため、使用しないでください。

シェアード

Sharedチェック ボックスをオンにすると、サポートされているすべての言語の番号付きバージョンごとに、フィールドの値が同じになります。Sharedプロパティを設定すると、アイテムの任意の言語または番号付きバージョンのフィールド値に対する変更は、他のすべての言語バージョンと番号付きバージョンに反映されます。

Shared値は、次の場合にのみ使用する必要があります。

  • フィールドの古い値は関係ありません。

  • ワークフローの制限は、フィールド値には適用されません。

  • 値が非常に大きい (バージョニングはストレージを消費する)。

手記

「 Shared 」チェック・ボックスと「 Unversioned 」チェック・ボックスの両方を選択すると、フィールドは共有されます。アイテムのすべての言語のすべてのバージョンは、このフィールドの1つの値を共有します。バージョン管理されていないフィールドの詳細については、このトピックの次のセクションを参照してください。

ワークフローと公開の制限は、共有フィールドの値には適用されません。

バージョン管理なし

Unversionedチェック ボックスをオンにすると、フィールドの値は言語内のすべての番号付きバージョンで同じになりますが、言語間で値が異なる場合があります。バージョン非対応のフィールドは共有フィールドと似ていますが、システムは言語ごとに異なるフィールド値を保持できます。

手記

「 Shared 」チェック・ボックスと「 Unversioned 」チェック・ボックスの両方を選択すると、フィールドは共有されます。アイテムのすべての言語のすべてのバージョンは、このフィールドの1つの値を共有します。共有フィールドの詳細については、このトピックの前のセクションを参照してください。

ワークフローと公開の制限は、共有フィールドの値には適用されません。

既定値

このフィールドはSitecoreの内部でのみ使用されるため、使用しないでください。

検証

このフィールドには、フィールドの保存時にフィールドの内容を検証する正規表現を含めることができます。フィールドを保存するには、その値がこの正規表現と一致する必要があります。

検証テキスト

このメッセージは、フィールドを保存しようとしたときに、その内容が検証フィールドの式と一致しない場合に表示されます。

フィールドセキュリティ

このフィールドでは、Field DefinitionアイテムのAssign Securityダイアログボックスが開きます。フィールド読み取りアクセス権とフィールド書き込みアクセス権が適用されます。

空白にリセット

Reset Blankチェック ボックスをオンにすると、このフィールドを空白に設定してアイテムを保存するときに、フィールド値がNULLにリセットされます。NULLフィールドには、フィールドの標準値が反映されます。

テキスト検索から除外する

このチェック ボックスをオンにすると、このフィールドは検索インデックスに含まれません。

ページエディタのボタン

このフィールドでは、ページエディタでこのフィールドに関連付けるコントロールを選択できます。

手記

テンプレートフィールドの詳細については 、標準テンプレートの構造 および 検証ルールとオプションを参照してください。

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