Поделиться через


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