ColumnDefinition リソース
JSON 表記
以下は、ColumnDefinition リソースの JSON 表記です。
{
"columnGroup": "string",
"description": "description",
"displayName": "friendly name",
"enforceUniqueValues": "true",
"hidden": false,
"id": "string",
"indexed": true,
"name": "staticNameForApi",
"readOnly": false,
"required": false,
"boolean": { "@odata.type": "microsoft.graph.booleanColumn" },
"calculated": { "@odata.type": "microsoft.graph.calculatedColumn" },
"choice": { "@odata.type": "microsoft.graph.choiceColumn" },
"currency": { "@odata.type": "microsoft.graph.currencyColumn" },
"dateTime": { "@odata.type": "microsoft.graph.dateTimeColumn" },
"defaultValue": { "@odata.type": "microsoft.graph.defaultColumnValue" },
"lookup": { "@odata.type": "microsoft.graph.lookupColumn" },
"number": { "@odata.type": "microsoft.graph.numberColumn" },
"personOrGroup": { "@odata.type": "microsoft.graph.personOrGroupColumn" },
"text": { "@odata.type": "microsoft.graph.textColumn" }
}
プロパティ
列には、さまざまな種類のデータを保持できます。 次のプロパティは、列に保持されるデータの種類と、そのデータに関する追加の設定を示します。 型関連のプロパティ (ブール値、計算、選択、通貨、dateTime、lookup、number、personOrGroup、text) は相互に排他的です。列には、指定できるプロパティの 1 つだけです。
| プロパティ名 | 種類 | 説明 |
|---|---|---|
| columnGroup | string | サイト列の場合、この列が属するグループの名前。 関連する列を整理するのに役立ちます。 |
| description | string | 列に関するユーザー向けの説明。 |
| displayName | string | 列を示すユーザー向けの名前。 |
| enforceUniqueValues | boolean | True の場合、この列で 2 つのリスト アイテムの値を同じにすることはできません。 |
| hidden | boolean | この列がユーザー インターフェイスに表示されるかどうかを指定します。 |
| id | string | 列の一意識別子。 |
| indexed | boolean | 列の値を、並べ替えと検索に使用できるかどうかを指定します。 |
| name | string | listItem の fields に表示される、列を示す API 向けの名前。 ユーザー向けの名前については displayName をご覧ください。 |
| readOnly | bool | 列の値を変更できるかどうかを指定します。 |
| required | boolean | 列の値が省略不可であるかどうかを指定します。 |
| boolean | booleanColumn | この列にはブール値が格納されます。 |
| calculated | calculatedColumn | この列のデータは、他の列に基づいて計算されます。 |
| choice | choiceColumn | この列には、選択肢リストからのデータが格納されます。 |
| currency | currencyColumn | この列には通貨値が格納されます。 |
| dateTime | dateTimeColumn | この列には日時の値が格納されます。 |
| defaultValue | defaultColumnValue | この列の既定値です。 |
| lookup | lookupColumn | この列のデータは、サイト内の別のソースから検索されます。 |
| number | numberColumn | この列には数値が格納されます。 |
| personOrGroup | personOrGroupColumn | この列にはユーザーまたはグループの値が格納されます。 |
| text | textColumn | この列にはテキスト値が格納されます。 |
注: これらのプロパティは SharePoint の SPFieldType 列挙体に対応しています。 上記ではほとんどの一般的なフィールドの種類を示しましたが、このベータ版 API に含まれないものもあります。 そのような場合、どの列タイプ ファセットも入力されず、基本的なプロパティだけが列に含まれます。
備考
hidden 列の ColumnDefinitions とフィールドの値は、既定では表示されません。
columnDefinitions を一覧表示するときにこれらが表示されるようにするには、$select ステートメントに hidden を含めます。
listItems にフィールド値を表示するときに表示するには、ステートメントに目的の列を$select名前で含めます。