テンプレートフィールドテンプレート
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
フィールド定義項目はTemplate fieldテンプレートに基づいています。各テンプレートフィールド定義項目は、以下のフィールドプロパティのいずれかを含むことができ、多くのプロパティを定義できます。
フィールド名
これはフィールド作成時に割り当てられる名前です。 タイトル フィールドが埋められていない限り、この名前はフィールドのラベルとして使われます。
!注フィールド名は一意でなければなりません。同じ名前の単一のデータテンプレートにフィールドが定義されている場合、保存時に検証エラーが発生します。しかし、フィールドはベーステンプレートから継承されることもあり、同じ名前の複数のフィールドを含むアイテムが一つになる可能性があります。この場合、Sitecoreはコンテンツエディターで両方のフィールドを表示しますが、APIやXSLTレンダリングを使う際にフィールド名を使って内容を取得するプログラマーは予期しない結果を出すことがあります。
名前でフィールドを参照する際にコードを読みやすくするために、特殊文字を使わず変数名のようにフィールド名を構築します。
種類
フィールドタイプは、コンテンツエディターが表示するユーザーインターフェースでこのフィールドの入力を受け入れ、またこのフィールドのストレージ形式も制御します。フィールドタイプの詳細については、「 データテンプレートフィールドタイプ」をご覧ください。
タイトル
タイトルはコンテンツエディターのフィールドの上に表示されますが、タイトルが空の場合はコンテンツエディターがフィールド名を表示します。
出典
ソースプロパティは、コンテンツエディタ内のフィールドに関連付けられたユーザーインターフェースコントロールに影響を与える情報を提供します。ソースフィールドの挙動はフィールドの種類に依存します。
いくつかの例は以下の通りです:
- Droplinkのようなリストフィールドタイプでは、ソースプロパティはフィールドで表示されるリストに含まれる項目を含むコンテンツツリー内の位置を示します。
- 画像およびファイル形式については、ソースプロパティがメディアライブラリのダイアログボックスに表示される開始フォルダを示します。
!注パスがチルダ(~)文字で始まる場合、ダイアログボックスは希望するフォルダを選択して開きますが、ユーザーはツリー全体にアクセスできます。
-
リッチテキストフィールド定義の場合、ソースプロパティで指定された項目は、編集インターフェースが提供する機能を制御するHTMLエディタプロファイルを指定します。
-
選択フィールドの場合、フィールドソースプロパティは実際のクエリ文の前にquery: プレフィックスを付けてSitecoreクエリを指定することができます。以下の例で示されています。
query:/sitecore/content/Home/Employees/* startswith(@EmployeeName, 'A')
Sitecoreクエリ構文の詳細については、「 Sitecoreクエリ」のセクションをご覧ください。
ソースパラメータ
TreelistやTreelistExなどの様々なフィールドは、SourceプロパティでSitecoreQueryの代替として用いられる以下のパラメータをサポートしています。
パラメータ
概要
DataSource
フィールドデータソース項目は、前述のパスをフィールドソースプロパティとして使用することに相当します。
DatabaseName
データソース項目を含むデータベースの名前。
IncludeTemplatesForSelection
ユーザーはこのテンプレート名のカンマ区切られたリストに関連するアイテムを選択できます。
ExcludeTemplatesForSelection
ユーザーはこのカンマ区切られたテンプレート名リストに関連する項目を選択することはできません。
IncludeTemplatesForDisplay
ユーザーはこのテンプレート名のカンマ区切られたリストに関連するアイテムをナビゲートできます。
ExcludeTemplatesForDisplay
ユーザーはテンプレート名のカンマ区切られたリストに関連付けられたアイテムを見ることはできません。
IncludeItemsForDisplay
ユーザーはこのカンマ区切られたテンプレート名リストに関連する項目をナビゲートできます。
ExcludeItemsForDisplay
ユーザーはこのカンマ区切られたIDリストでアイテムを見ることはできません。
AllowMultipleSelection
ユーザーは複数のアイテムを選択できます。
以下の例のように、アンパサンド(&)文字でソースプロパティ内の複数のパラメータを分離できます。
DataSource=/sitecore/content/home&IncludeTemplatesForSelection=section,sitemap
ブロブ
このフィールドはSitecore内部のみの使用用であり、使用してはいけません。
共有
共有チェックボックスを選択すると、すべての対応言語で番号付きバージョンのフィールドが同じ値になります。Sharedプロパティを設定すると、任意の言語や番号付きバージョンのフィールド値の変更は、他のすべての言語バージョンおよび番号付きバージョンに反映されます。
共有値は以下の場合にのみ使用してください:
- フィールドの古い価値観は関係ありません。
- フィールド値にはワークフロー制限は適用されません。
- 値は非常に大きくなります(バージョン管理はストレージを消費します)。
!注共有チェックボックスと無バージョンチェックボックスの両方を選択すると、そのフィールドは共有されます。アイテムのすべての言語におけるすべてのバージョンは、このフィールドに対して単一の値を共有します。バージョンなしフィールドの詳細については、このトピックの以下のセクションをご覧ください。
共有フィールドの値にはワークフローや公開の制限は適用されません。
バージョン変更なし
Unversionedチェックボックスを選択すると、そのフィールドは言語内のすべての番号付きバージョンで同じ値になりますが、言語間で異なる場合があります。Unversionedフィールドは共有フィールドに似ていますが、システムは言語ごとに異なるフィールド値を維持できます。
!注共有チェックボックスと無バージョンチェックボックスの両方を選択すると、そのフィールドは共有されます。アイテムのすべての言語のバージョンは、このフィールドに対して単一の値を共有します。共有フィールドの詳細については、このトピックの前のセクションをご覧ください。
共有フィールドの値にはワークフローや公開の制限は適用されません。
デフォルト値
このフィールドはSitecore内部のみの使用用であり、使用してはいけません。
検証
このフィールドには、保存時にその内容が検証される正則表現を含めることができます。フィールドを保存するためには、その値がこの正規表現と一致しなければなりません。
検証テキスト
システムは、フィールドを保存しようとした際にその内容が検証フィールドの式と一致しないとこのメッセージを表示します。
現場のセキュリティ
このフィールドはField Definitionアイテムの**「セキュリティ割り当て**」ダイアログボックスを開きます。フィールドの読み取りおよびフィールド書き込みのアクセス権が適用されます。
リセット ブランク
「 Reset Blank 」チェックボックスを選択すると、アイテムが保存された際にこのフィールドが空欄にリセットされます。NULLフィールドはそのフィールドの標準値を反映しています。
テキスト検索から除外する
このチェックボックスを選択すると、このフィールドは検索インデックスには含まれません。
ページエディターのボタン
このフィールドでは、ページエディターでこのフィールドに関連付けられるコントロールを選択できます。
!注テンプレートフィールドに関する追加情報については、「 標準テンプレートの構造 」および 「検証ルールとオプション」をご覧ください。