名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
サイト、リスト、または contentType 内の列を表します。
既定では、列の定義とhidden列のフィールド値は表示されません。
columnDefinitions を一覧表示するときにこれらが表示されるようにするには、$select ステートメントに hidden を含めます。
フィールド値を listItems に表示するときに表示するには、$select ステートメントに必要な列を名前で含めます。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| サイト内の列を一覧表示する | columnDefinition コレクション | サイト内の columnDefinition オブジェクトとそのプロパティの一覧を取得します。 |
| リスト内の列を一覧表示する | columnDefinition コレクション | columnDefinition オブジェクトとそのプロパティのリストをリストで取得します。 |
| コンテンツ タイプ内の列を一覧表示する | columnDefinition コレクション | columnDefinition オブジェクトとそのプロパティをコンテンツ タイプで一覧取得します。 |
| サイトの columnDefinition を作成する | columnDefinition | サイトに新しい columnDefinition オブジェクトを作成します。 |
| リストの columnDefinition を作成する | columnDefinition | リストに新しい columnDefinition オブジェクトを作成します。 |
| コンテンツ タイプの columnDefinition を作成する | columnDefinition | コンテンツ タイプに新しい columnDefinition オブジェクトを作成します。 |
| columnDefinition を取得する | columnDefinition | columnDefinition オブジェクトのプロパティとリレーションシップを読み取ります。 |
| columnDefinition を更新する | columnDefinition | columnDefinition オブジェクトのプロパティを更新します。 |
| columnDefinition を削除する | なし | columnDefinition オブジェクトを削除します。 |
プロパティ
列には、さまざまな種類のデータを保持できます。 次のプロパティは、列に保持されるデータの種類と、そのデータに関する追加の設定を示します。 型に関連するプロパティ (boolean、calculated、choice、currency、dateTime、lookup、number、personOrGroup、text) は相互排他的です。列にはこれらの 1 つだけを指定できます。
| プロパティ | 型 | 説明 |
|---|---|---|
| ブール値 | booleanColumn | この列には、ブール値が格納されます。 |
| 計算フィールド | calculatedColumn | この列のデータは、他の列に基づいて計算されます。 |
| 選択肢 | choiceColumn | この列には、選択肢リストからのデータが格納されます。 |
| columnGroup | string | サイト列の場合、この列が属するグループの名前。 関連する列を整理するのに役立ちます。 |
| contentApprovalStatus | contentApprovalStatusColumn | この列には、コンテンツの承認状態が格納されます。 |
| currency | currencyColumn | この列には通貨値が格納されます。 |
| dateTime | dateTimeColumn | この列には日時の値が格納されます。 |
| defaultValue | defaultColumnValue | この列の既定値です。 |
| 説明 | string | 列に関するユーザー向けの説明。 |
| displayName | string | 列を示すユーザー向けの名前。 |
| enforceUniqueValues | ブール型 |
trueする場合、この列に同じ値を持つリスト項目は 2 つしかありません。 |
| 位置情報 | geolocationColumn | この列には位置情報が格納されます。 |
| hidden | ブール型 | この列がユーザー インターフェイスに表示されるかどうかを指定します。 |
| hyperlinkOrPicture | hyperlinkOrPictureColumn | この列には、ハイパーリンクまたは画像の値が格納されます。 |
| id | string | 列の一意の識別子。 |
| indexed | ブール型 | 列値を並べ替えと検索に使用できるかどうかを指定します。 |
| isDeletable | ブール型 | この列を削除できるかどうかを示します。 |
| isReorderable | ブール型 | 列内の値を並べ替えることができるかどうかを示します。 読み取り専用です。 |
| isSearchable | ブール型 | 列値を検索に使用できるかどうかを指定します。 現在、 fileStorageContainer の列に対してのみサポートされています。 |
| isSealed | ブール型 | 列を変更できるかどうかを指定します。 |
| 検索 | lookupColumn | この列のデータは、サイト内の別のソースから検索されます。 |
| name | string | listItem の fields に表示される、列を示す API 向けの名前。 ユーザー向けの名前については displayName をご覧ください。 |
| 番号 | numberColumn | この列には数値が格納されます。 |
| personOrGroup | personOrGroupColumn | この列にはユーザーまたはグループの値が格納されます。 |
| propagateChanges | ブール型 |
true場合、この列への変更は、列を実装するリストに伝達されます。 |
| readOnly | ブール型 | 列の値を変更できるかどうかを指定します。 |
| 必須出席者 | ブール型 | 列の値を省略可能にしないかどうかを指定します。 |
| sourceContentType | contentTypeInfo | この列の継承元となる ContentType。 contentTypes 列をフェッチするためにのみ使用されます。 |
| term | termColumn | この列には、分類用語が格納されます。 |
| テキスト | textColumn | この列にはテキスト値が格納されます。 |
| thumbnail | thumbnailColumn | この列には、サムネイル値が格納されます。 |
| type | columnTypes | サイト列の場合、列の種類。 読み取り専用です。 |
| 検証 | columnValidation | この列には、列の検証式とメッセージが格納されます。 |
注:
isSearchable プロパティと indexed プロパティは関連していますが、独立しています。 isSearchable が明示的に指定されていない場合は、indexed の値が使用されます。 isSearchable を設定すると、インデックス付きから独立します。 isSearchable のみを指定すると、インデックス付き状態は変更されず、列の検索可能な状態が更新されます。 isSearchable プロパティは現在、fileStorageContainer の列に対してのみサポートされています。
リレーションシップ
| リレーションシップ | 型 | 説明 |
|---|---|---|
| sourceColumn | columnDefinition | コンテンツ タイプ列のソース列。 |
メモ: これらのプロパティは、SharePoint の SPFieldType 列挙型に対応します。 最も一般的なフィールドの種類を前の表に示します。 ただし、このベータ API にはまだ一部が不足しています。 そのような場合、どの列タイプ ファセットも入力されず、基本的なプロパティだけが列に含まれます。
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",
"isSearchable": "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"},
"propagateChanges": "Boolean",
"readOnly": "Boolean",
"required": "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"}
}