Тип ресурса 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" }
}