データ定義要素
適用対象: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013
Collaborative Application Markup Language (CAML) には、ページ レンダリング用とフィールド レンダリングとスキーマ定義の 2 つの主要な種類の要素があります。 CAML フィールド レンダリング要素は、個々のフィールド値をレンダリングするときに使用するように設計されています。 これらは、フィールド型の定義に表示することも、より一般的には で FldTypes.xml に \\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATES\XML表示することもできます。
フィールドレンダリングとスキーマ定義
フィールドとは、ユーザーがリストに追加できる情報が含まれる列または属性です。 Microsoft SharePoint Foundation に基づく Web サイト上の各リストには、データベースに格納されているメタデータがあります。 スキーマの形式は、次に示すような XML 構造になります。
<Fields>
<Field Type="Counter" Name="ID"/>
...other field definitions...
</Fields>
さまざまなフィールド型の実装を簡略化し、さまざまなフィールドのレンダリングの柔軟性を高めるために、 FldTypes.xml には、各フィールド型のレンダリングと動作に関する情報が含まれています。 Field 要素は、対象のフィールドのデータ型に応じて異なる HTML をレンダリングし、FldTypes.xmlフィールドの種類ごとにデータ型とレンダリング パターンを定義します。 次の表に、このファイルで使用されるスキーマを示します。
| 名前 | データ型 | 説明 |
|---|---|---|
| Column2Suffix |
Text |
ColumnName から ColumnName2 を派生させる (URL などの 2 列のフィールドの場合) ために基本の列名に追加されるテキストが含まれます。 |
| DisplayPattern |
注 |
ビュー表示モードまたはフォーム表示モードでフィールドをレンダリングするための HTML テンプレートが含まれます。 |
| EditPattern |
注 |
フィールドの編集に使用される編集フォーム コントロールを生成するための HTML テンプレートが含まれます。 |
| HeaderPattern |
注 |
テーブル ビューの列のヘッダーを表示するための HTML テンプレートが含まれます。 |
| InternalType |
Text |
SharePoint Foundation データベースからのデータのレンダリングにおける Column 要素の動作と、データをデータベースにポストバックする方法の両方を決定します。 Text、Note、Number、Currency、Integer、Boolean、DateTime、Threading、Lookup、Choice、URL、Counter、DisplayOnly のいずれかの値を指定できます。 フィールド型が DisplayOnly の場合、そのフィールドの保存先がないことに注意してください。 |
| 名前 |
Text |
Field 要素の Type 属性で参照される内部データ型の名前を格納します。 <Field Type="Name"/> たとえば、Text、Note、Number などがあります。 |
| NewPattern |
注 |
フィールドの初期値の編集に使用される新規作成フォームを生成するための HTML テンプレートが含まれます。 |
| PreviewDisplayPattern |
注 |
Microsoft SharePoint Designer で表示フォームを編集するときにフィールドをレンダリングする方法を指定します。 |
| PreviewEditPattern |
注 |
Microsoft SharePoint Designer で編集フォームを編集するときにフィールドをレンダリングする方法を指定します。 |
| PreviewNewPattern |
注 |
Microsoft SharePoint Designer で新しいフォームを編集するときにフィールドをレンダリングする方法を指定します。 |
| 並べ替え可能か |
Text |
フィールドが並べ替え可能かどうかを指定します。 TRUE または FALSE を指定できます。 |
| TypeName |
Text |
フィールド型の定義に名前を指定します。 |
| SQLType |
Text |
指定されたフィールドの基となる SQL データ型を指定します。 指定するのは、nvarchar(255)、memo、integer、float などのデータ型です。 この種類のフィールドを作成する適切な SQL (CREATE TABLE) を作成するために使用します。 |
| SQLType2 |
Text |
空白でない場合、現在のフィールドに作成する 2 つ目の列の種類を指定します ("URL" フィールド型など)。 |
表示モードと表示パターン
各表示モード (表示、 編集、 新規) には、SharePoint Foundation でサポートされている各フィールド データ型をレンダリングする方法の定義が含まれています。
各表示モードに対応する表示パターン、つまり CAML レンダリング表現が用意されています。 一部の CAML 要素は表示パターンで使用されます。 他の CAML 要素はページ レンダリングまたはフィールド レンダリングのコンテキストで使用できますが、基本的にはフィールドのレンダリングに使用されます。 次に示す組み込み CAML レンダリング要素を使用して作成したテンプレートには、固定 HTML およびデータ、さらにレンダリングするフィールドのメタデータを含めることができます。
| 要素 | 説明 |
|---|---|
| 列 |
特定のフィールドの生データ値を返します。 |
| Column2 |
Link フィールド型のレンダリングに使用されます。 |
| エスケープ |
文字列内の特定の文字をエスケープするときに使用します。 |
| FieldFilterOptions |
フィルターのドロップダウン メニューを表示するときに、FldTypes.xml の HeaderPattern セクションで使用されます。 |
| FieldPrefix |
Microsoft Office 名前空間 urn:schemas-microsoft-com:office:office#を返します。 |
| Fieldref |
計算対象フィールドでは構成フィールドの参照に使用され、ビューでは表示されるフィールドの定義に使用されます。 |
| FieldSortImageURL |
列の並べ替え方法を指定するために使用されるイメージ ファイルの URL を返します。 |
| FieldSortParams |
リストの並べ替え順序を返します。フィールドが並べ替えられている方法に応じて Asc または Desc をレンダリングし、フィールドの現在の既定の並べ替え順序を返します。 |
| IfEqual |
2 つの CAML 式の比較に基づく条件レンダリングを可能にします。 |
| IfNew |
アイテムが新しいと見なされた場合、TRUE を返します。 |
| ImagesPath |
プロジェクトのイメージ ディレクトリの HTTP パスを返します。 |
| 制限 |
指定したサイズまでテキストを切り捨てます。 |
| LocaleInfo |
サーバー ロケール情報をクライアントに転送して、日付および数字を適切に表示および編集できるようにします。 |
| PageURL |
さまざまな場所で使用され、現在のページのエンコード済み絶対 URL を返します。 |
| プロパティ |
現在の ForEach コンテキストからプロパティを返します。 |
| ScriptQuote |
引用符で囲まれた文字列として解釈される必要のあるサーバーからのテキストをレンダリングするために使用します。 |
| TodayISO |
現在の日付および時刻を ISO 形式でレンダリングします。 |