columnDefinition リソースの種類

  • [アーティクル]

名前空間: microsoft.graph

サイト、リスト、または contentType 内の列を表します。

既定では、 列の columnDefinitions とフィールド値 hidden は表示されません。 非表示の columnDefinitions を一覧表示するには、ステートメントに を$select含めますhidden。 listItems の非表示フィールド値を一覧表示するには、ステートメントに目的の列を$select名前で含めます。

メソッド

メソッド 戻り値の種類 説明
サイト内の列を一覧表示する columnDefinition コレクション サイト内の columnDefinition オブジェクトとそのプロパティの一覧を取得します。
リスト内の列を一覧表示する columnDefinition コレクション columnDefinition オブジェクトとそのプロパティの一覧を一覧で取得します。
コンテンツ タイプの列を一覧表示する columnDefinition コレクション コンテンツ タイプの columnDefinition オブジェクトとそのプロパティの一覧を取得します。
サイトの columnDefinition を作成する columnDefinition サイトに新しい columnDefinition オブジェクトを作成 します。
リストの columnDefinition を作成する columnDefinition リストに新しい columnDefinition オブジェクトを作成 します。
コンテンツ タイプの columnDefinition を作成する columnDefinition コンテンツ タイプに新しい columnDefinition オブジェクトを作成します。
列の取得Definition columnDefinition columnDefinition オブジェクトのプロパティとリレーションシップを読み取ります。
columnDefinition の更新 columnDefinition columnDefinition オブジェクトのプロパティを更新します。
列の削除Definition なし columnDefinition オブジェクトを削除します。

プロパティ

列には、さまざまな種類のデータを保持できます。 次のプロパティは、列に保持されるデータの種類と、そのデータに関する追加の設定を示します。 型関連のプロパティ (ブール値、計算、選択、通貨、dateTime、lookup、number、personOrGroup、text、term、hyperlinkOrPicture、thumbnail、contentApprovalStatus) は相互に排他的です。列に指定できるのは、そのうちの 1 つだけです。

プロパティ名 種類 説明
boolean booleanColumn この列にはブール値が格納されます。
calculated calculatedColumn この列のデータは、他の列に基づいて計算されます。
choice choiceColumn この列には、選択肢リストからのデータが格納されます。
columnGroup string サイト列の場合、この列が属するグループの名前。 関連する列を整理するのに役立ちます。
contentApprovalStatus contentApprovalStatusColumn この列には、コンテンツの承認状態が格納されます。
currency currencyColumn この列には通貨値が格納されます。
dateTime dateTimeColumn この列には日時の値が格納されます。
defaultValue defaultColumnValue この列の既定値です。
説明 string 列に関するユーザー向けの説明。
displayName string 列を示すユーザー向けの名前。
enforceUniqueValues ブール型 の場合 true、この列に同じ値を持つリスト アイテムが 2 つありません。
ジオロケーション geolocationColumn この列には位置情報が格納されます。
hidden ブール型 この列がユーザー インターフェイスに表示されるかどうかを指定します。
hyperlinkOrPicture hyperlinkOrPictureColumn この列には、ハイパーリンクまたは図の値が格納されます。
isDeletable ブール型 この列を削除できるかどうかを示します。
isReorderable ブール型 列の値を並べ替えることができるかどうかを示します。 読み取り専用です。
id string 列の一意識別子。
indexed ブール型 列の値を並べ替えおよび検索に使用できるかどうかを指定します。
isSealed ブール型 列を変更できるかどうかを指定します。
lookup lookupColumn この列のデータは、サイト内の別のソースから検索されます。
name string listItem の fields に表示される、列を示す API 向けの名前。 ユーザー向けの名前については displayName をご覧ください。
number numberColumn この列には数値が格納されます。
personOrGroup personOrGroupColumn この列にはユーザーまたはグループの値が格納されます。
propagateChanges ブール型 'true' の場合、この列に対する変更は、列を実装するリストに反映されます。
readOnly ブール型 列の値を変更できるかどうかを指定します。
required ブール型 列の値が省略可能でないかどうかを指定します。
sourceContentType contentTypeInfo この列の継承元の ContentType。 contentTypes 列の応答にのみ存在します。 読み取り専用。
用語 termColumn この列には分類用語が格納されます。
text textColumn この列にはテキスト値が格納されます。
thumbnail thumbnailColumn この列にはサムネイル値が格納されます。
type columnTypes サイト列の場合、列の種類。 読み取り専用。
検証 columnValidation この列には、列の検証式とメッセージが格納されます。

リレーションシップ

プロパティ名 種類 説明
sourceColumn columnDefinition コンテンツ タイプ列のソース列。

メモ： これらのプロパティは、SharePoint SPFieldType 列挙に対応します。 最も一般的なフィールド型は、前の表で表されていることに注意してください。 ただし、この API にはまだいくつかがありません。 そのような場合、どの列タイプ ファセットも入力されず、基本的なプロパティだけが列に含まれます。 サイトとリスト列の応答には、 isDeletable、 propagateChanges、 isReorderable、 isSealed、 validation、 hyperlinkOrPicture、 term、 sourceContentType、 thumbnail、 type、 contentApprovalStatus、 sourceColumn プロパティは含まれません。

JSON 表記

リソースの JSON 表記を次に示します。

{
  "boolean": { "@odata.type": "microsoft.graph.booleanColumn" },
  "calculated": { "@odata.type": "microsoft.graph.calculatedColumn" },
  "choice": { "@odata.type": "microsoft.graph.choiceColumn" },
  "columnGroup": "String",
  "contentApprovalStatus": { "@odata.type": "microsoft.graph.contentApprovalStatusColumn" },
  "currency": { "@odata.type": "microsoft.graph.currencyColumn" },
  "dateTime": { "@odata.type": "microsoft.graph.dateTimeColumn" },
  "defaultValue": { "@odata.type": "microsoft.graph.defaultColumnValue" },
  "description": "String",
  "displayName": "String",
  "enforceUniqueValues": "Boolean",
  "geolocation": { "@odata.type": "microsoft.graph.geolocationColumn" },
  "hidden": "Boolean",
  "hyperlinkOrPicture": { "@odata.type": "microsoft.graph.hyperlinkOrPictureColumn" },
  "id": "String (identifier)",
  "indexed": "Boolean",
  "isDeletable" : "Boolean",
  "isReorderable": "Boolean",
  "isSealed": "Boolean",
  "lookup": { "@odata.type": "microsoft.graph.lookupColumn" },
  "name": "staticNameForApi",
  "number": { "@odata.type": "microsoft.graph.numberColumn" },
  "personOrGroup": { "@odata.type": "microsoft.graph.personOrGroupColumn" },
  "readOnly": "Boolean",
  "required": "Boolean",
  "propagateChanges": "Boolean",
  "sourceContentType": { "@odata.type": "microsoft.graph.contentTypeInfo" },
  "term": { "@odata.type": "microsoft.graph.termColumn" },
  "text": { "@odata.type": "microsoft.graph.textColumn" },
  "thumbnail": { "@odata.type": "microsoft.graph.thumbnailColumn" },
  "type": { "@odata.type": "microsoft.graph.columnTypes" },
  "validation": { "@odata.type": "microsoft.graph.columnValidation" }
}