Тип ресурса columnDefinition
Пространство имен: microsoft.graph
Представляет столбец на сайте, в списке или contentType.
По умолчанию значения столбцов и значения полей для hidden столбцов не отображаются. Чтобы получить список скрытых столбцовDefinitions, добавьте hidden в инструкцию $select . Чтобы получить список скрытых значений полей в 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, term, hyperlinkOrPicture, thumbnail и contentApprovalStatus) являются взаимоисключающими; в столбце может быть указан только один из них.
| Имя свойства | Тип | Описание |
|---|---|---|
| boolean | booleanColumn | В этом столбце хранятся логические значения. |
| calculated | calculatedColumn | Данные в этом столбце вычисляются относительно других столбцов. |
| choice | choiceColumn | В этом столбце хранятся данные из списка вариантов. |
| columnGroup | строка | Для столбцов сайтов это имя группы, к которой принадлежит данный столбец. Помогает упорядочивать связанные столбцы. |
| contentApprovalStatus | contentApprovalStatusColumn | В этом столбце хранится состояние утверждения содержимого. |
| currency | currencyColumn | В этом столбце хранятся денежные значения. |
| dateTime | dateTimeColumn | В этом столбце хранятся значения даты и времени. |
| defaultValue | defaultColumnValue | Значение по умолчанию для этого столбца. |
| description | строка | Описание столбца, которое видит пользователь. |
| displayName | строка | Имя столбца, которое видит пользователь. |
| enforceUniqueValues | Логический | Если trueзадано значение , ни один из двух элементов списка не может иметь одинаковое значение для этого столбца. |
| Географическое расположение | geolocationColumn | В этом столбце хранится географическое расположение. |
| hidden | Логический | Указывает, отображается ли столбец в пользовательском интерфейсе. |
| hyperlinkOrPicture | hyperlinkOrPictureColumn | В этом столбце хранятся значения гиперссылок или рисунков. |
| isDeletable | Логический | Указывает, можно ли удалить этот столбец. |
| isReorderable | Логический | Указывает, можно ли изменить порядок значений в столбце. Только для чтения. |
| id | string | Уникальный идентификатор столбца. |
| indexed | Логический | Указывает, можно ли использовать значения столбцов для сортировки и поиска. |
| isSealed | Логический | Указывает, можно ли изменить столбец. |
| lookup | lookupColumn | Данные в этом столбце берутся из другого источника на сайте. |
| name | строка | Используемое в API имя столбца из свойства fields объекта listItem. Имя, которое видит пользователь, указывается в свойстве displayName. |
| число | 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" }
}