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

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

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

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

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

フィールド名

これはフィールドが作成された際に割り当てられる名前です。 Titleフィールドが埋められていない限り、この表示はフィールドのラベルとして使われます。

注記

フィールド名は一意でなければなりません。同じ名前の単一のデータテンプレートにフィールドが定義されている場合、データテンプレートを保存した際に検証エラーが発生します。しかし、フィールドはベーステンプレートから継承することもできるため、同じ名前の複数のフィールドを含むアイテムもあります。この場合、SitecoreはContent Editorで両方のフィールドを表示しますが、APIやXSLTレンダリングを使う際にフィールド名を使って内容を取得するプログラマーは、予期しない結果を出す可能性があります。

名前でフィールドを参照する際にコードを読みやすくするために、特殊文字を使わず変数名のようにフィールド名を構築します。

種類

フィールドタイプは、Content Editorが表示する入力を制御するユーザーインターフェースを指定することであり、またこのフィールドのストレージ形式も制御します。フィールドタイプの詳細については、「 データテンプレートのフィールドタイプ」をご覧ください。

タイトル

タイトルはContent Editorのフィールドの上に表示されますが、タイトルが空欄の場合はContent Editorがフィールド名を表示します。

出典

ソースプロパティは、Content Editor内のフィールドに関連するユーザーインターフェースコントロールに影響を与える情報を提供します。ソースフィールドの挙動はフィールドの種類に依存します。

いくつかの例は以下の通りです:

  • 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チェックボックスを選択すると、すべての対応言語で番号付きバージョンごとに同じ数値が表示されます。Sharedプロパティを設定すると、任意の言語や番号付きバージョンのフィールド値の変更は、他のすべての言語バージョンおよび番号付きバージョンに反映されます。

共有値は以下の場合にのみ使用してください:

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

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

  • 値は非常に大きくなります(バージョン管理はストレージを消費します)。

注記

SharedチェックボックスとUnversionedチェックボックスの両方を選択すると、フィールドは共有されます。すべての言語のバージョンはこのフィールドに対して単一の値を共有します。バージョンなしフィールドの詳細については、このトピックの以下のセクションを参照してください。

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

バージョン変更なし

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

注記

SharedチェックボックスとUnversionedチェックボックスの両方を選択すると、フィールドは共有されます。すべての言語のバージョンはこのフィールドに対して単一の値を共有します。共有フィールドの詳細については、このトピックの前のセクションをご覧ください。

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

デフォルト値

このフィールドはSitecore内部のみの使用用であり、使用してはいけません。

検証

このフィールドには、保存時にそのフィールドの内容が検証される正規表現を含めることができます。フィールドを保存するためには、その値がこの正則表現と一致しなければなりません。

検証テキスト

システムは、フィールドを保存しようとした際にその内容が検証フィールドの式と一致しないとこのメッセージを表示します。

現場のセキュリティ

このフィールドはField DefinitionアイテムのAssign Securityダイアログボックスを開きます。フィールドリードおよびフィールドライトアクセス権が適用されます。

リセット ブランク

Reset Blankチェックボックスを選択すると、アイテムを保存した際にこのフィールドが空欄にリセットされます。NULLフィールドはフィールドの標準値を反映しています。

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

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

ページエディターのボタン

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

注記

テンプレートフィールドに関する追加情報については、「 標準テンプレートの構造 」および 「検証ルールとオプション」をご覧ください。

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