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

Элемент FieldRef (ContentType)

  • Статья

Область применения: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Указывает столбец для ссылки в этом типе контента.

Определение

<FieldRef
  Aggregation="sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  Customization="Text"
  DefaultValue="Text"
  Description="Text"
  DisplayName="Text"
  Format="Text"
  Filterable="TRUE" | "FALSE"
  FilterableNoRecurrence="TRUE" | "FALSE"
  FromBaseType="TRUE" | "FALSE"
  Hidden="TRUE" | "FALSE" | "orResource"
  ID="Text"
  Locked="TRUE" | "FALSE"
  Name="Text"
  Node="Text"
  NumLines="Integer"
  PIAttribute="Text"
  PITarget="Text"
  PrimaryPIAttribute="Text"
  PrimaryPITarge="Text"
  ReadOnly="TRUE" | "FALSE"
  ReadOnlyClient="TRUE" | "FALSE"
  Required="TRUE" | "FALSE"
  Sealed="TRUE" | "FALSE"
  ShowInDisplayForm="TRUE" | "FALSE"
  ShowInEditForm="TRUE" | "FALSE"
  ShowInFileDlg="TRUE" | "FALSE"
  ShowInListSettings="TRUE" | "FALSE"
  ShowInNewForm="TRUE" | "FALSE"
  Sortable="TRUE" | "FALSE">
</FieldRef>

Элементы и атрибуты

В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.

Атрибуты

Атрибут Описание
Агрегации

Если используется атрибут Node для указания выражения XPath, возвращающего коллекцию значений, можно также включить атрибут Aggregation, указывающий действие для выполнения над возвращенным набором значений.

Этим действием может быть агрегатная функция или указатель определенного элемента в коллекции.

Возможны следующие значения:

  • Сумма

  • count

  • Средняя

  • Мин

  • Макс

  • Объединить

  • plaintext Преобразует текстовое содержимое узла в обычный текст.

  • first Применяет повышение и понижение свойств к первому элементу в коллекции.

  • last Применяет повышение и понижение свойств к последнему элементу в коллекции.

Дополнительные сведения о том, как атрибуты Node, PIAttribute, PITarget, PrimaryPIAttribute и PrimaryPITarget используются для повышения и понижения свойств в XML-документах, см. в разделе Использование типов контента для указания свойств XML-документа.
Настройка

Необязательный текст. Строка на языке CAML, которая определяет свойства настраиваемого поля.
DefaultValue

Устаревшие.
Описание

Необязательный атрибут типа Text. Предоставляет описание, показываемое в форме редактирования для списка, если указано описание столбца. По умолчанию столбцы в SharePoint Foundation не имеют описаний.
DisplayName

Обязательный текст. Отображаемое имя для столбца. Максимальная длина: 255 символов.

Значение этого атрибута используется в качестве заголовка столбца при отображении поля в табличном представлении и в качестве метки формы при отображении поля в форме. Атрибут DisplayName используется для изменения отображаемого имени на значение, отличающееся от имени, определенного в самом поле.
Format

Необязательный атрибут типа Text. Указывает форматирование для использования для численных значений.

Для столбцов даты/времени возможны следующие значения.

  • DateOnly Отображает (и разрешает изменения) часть даты (для всех измененных значений задано значение 12:00).

  • DateTime Отображение и изменение даты и времени дня (по умолчанию).

  • ISO8601 Отображение даты и времени в формате времени ISO8601, преобразованном в UTC: ГГГГ-ММ-ДДТЧЧ:ММ:ССЗ.

    Этот формат используется для свойств документов в системе Microsoft Office, а также для стандартного формата обмена, используемого в Microsoft SharePoint Foundation между формами "Создать" и "Изменить" и сервером.

  • ISO8601Basic Используется сокращенная форма форматов даты и времени 8601: ГГГГММДДTHHMMSSZ.

    Этот формат используется для vCard или iCal.

Для полей Выбора этот атрибут может быть задан как Раскрывающийся список (по умолчанию), который предоставляет параметры редактирования через раскрывающийся список, или Значение RadioButtons, которое предоставляет параметры с помощью группы переключателей.

Для полей URL-адреса для этого атрибута можно задать значение Гиперссылка (по умолчанию), в котором URL-адрес отображается как обычный <A> тег, или значение Image, в котором URL-адрес отображается как <IMG SRC="URL" ALT="Description">.
Filterable

Необязательный логический. TRUE, чтобы определить столбец как фильтрующийся.
FilterableNoRecurrence

Необязательный логический. TRUE, чтобы определить столбец как фильтрующийся без повторяющихся значений.
FromBaseType

Необязательный логический. Вместо этого атрибута рекомендуется атрибут Sealed.
Hidden

Необязательный логический. При значении TRUE поле полностью скрыто для пользовательского интерфейса. Параметр ReadOnly значение TRUE означает, что поле не отображается в формах "Создать " или "Изменить" , но по-прежнему может быть включено в представления.

Если этот атрибут не включен, SharePoint Foundation обрабатывает столбец так, как если бы атрибуту было присвоено значение FALSE.
ID

Обязательный текст. Указывает идентификатор поля столбца, на который ссылается этот элемент FieldRef . Идентификатор поля — это строковое представление GUID, включая фигурные скобки. Значение учитывает регистр.

Идентификаторы встроенных полей можно найти в файле fieldswss.xml , расположенном по следующему пути:
%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\FEATURES\fields
Locked Устаревшие.
Имя

Обязательный текст. Имя столбца. Это внутреннее имя столбца и оно гарантировано не изменится на протяжении существования определения поля. Оно должно быть уникальным по отношению к набору полей в списке.
Node

Необязательный атрибут типа Text. Указывает XML-узел в документе, который содержит значение столбца. Используется для повышения и понижения свойства в XML-документах.

Дополнительные сведения об использовании атрибутов Node, PIAttribute, PITarget, Primary PIAttribute и PrimaryPITarget для повышения и понижения свойств в XML-документах см. в разделе Using Content Types to Specify XML Document Properties.
NumLines

Необязательный атрибут типа Integer. Рекомендует количество строк для отображения в блоке TEXTAREA во время правки. Это просто подсказка пользовательского интерфейса клиента; не существует принудительного ограничения количества строк текста, которые можно изменить.
PIAttribute Необязательный текст. Указывает атрибут в инструкции по обработке документа (заданный атрибутом PITarget) для использования в качестве значения столбца. Используется для повышения и понижения уровня свойств в XML-документах.

Если указан атрибут PIAttribute, необходимо также указать атрибут PITarget.

Дополнительные сведения об использовании атрибутов Node, PIAttribute, PITarget, Primary PIAttribute и PrimaryPITarget для повышения и понижения уровня свойств в XML-документах см. в статье Using Content Types to Specify XML Document Properties.
PITarget

Необязательный атрибут типа Text. Указывает инструкцию по обработке документа, в которой значение столбца хранится в документах данного типа контента. Используется для повышения и понижения уровня свойств в XML-документах.

Если указан атрибут PIAttribute, необходимо также указать атрибут PITarget.

Дополнительные сведения об использовании атрибутов Node, PIAttribute, PITarget, Primary PIAttribute и PrimaryPITarget для повышения и понижения уровня свойств в XML-документах см. в статье Using Content Types to Specify XML Document Properties.
PrimaryPIAttribute

Необязательный текст. Указывает альтернативный атрибут в инструкции по обработке документа, заданной атрибутом PrimaryPITarget, для использования в качестве значения столбца.

Если указан атрибут PrimaryPIAttribute, необходимо также указать атрибут PrimaryPITarget. Если это указано, SharePoint Foundation использует эти значения перед значениями, указанными в атрибутах PITarget и PIAttribute .

Используется для повышения и понижения уровня свойств в XML-документах.

Дополнительные сведения об использовании атрибутов Node, PIAttribute, PITarget, Primary PIAttribute и PrimaryPITarget для повышения и понижения свойств в XML-документах см. в разделе Using Content Types to Specify XML Document Properties.
PrimaryPITarget

Необязательный атрибут типа Text. Указывает альтернативную инструкцию по обработке документа, в которой значение столбца хранится в документах данного типа контента.

Если указан атрибут PrimaryPIAttribute, необходимо также указать атрибут PrimaryPITarget. Если это указано, SharePoint Foundation использует эти значения перед значениями, указанными в атрибутах PITarget и PIAttribute .

Дополнительные сведения об использовании атрибутов Node, PIAttribute, PITarget, Primary PIAttribute и PrimaryPITarget для повышения и понижения уровня свойств в XML-документах см. в статье Using Content Types to Specify XML Document Properties.
ReadOnly

Необязательный логический. Если значение TRUE, поле не отображается в формах "Создать" или "Изменить" , но может быть включено в представления. Установка для атрибута Hidden значения TRUE полностью скрывает поле из пользовательского интерфейса.

Если этот атрибут не включен, SharePoint Foundation обрабатывает столбец так, как если бы атрибуту было присвоено значение FALSE.
Required

Обязательный атрибут типа Boolean. Если значение TRUE, поле должно иметь присвоенное ему значение, прежде чем элемент, созданный с помощью этого типа контента, можно будет сохранить.

Если в записи формы задано пустое значение поля, в форме ошибки отображается либо стандартный текст обязательного поля, либо явно указанное сообщение (т. е. с помощью <тегов ErrorText> ). Эта проверка обрабатывается только клиентом (база данных разрешает значение "NULL" для всех полей пользователей).
Запечатаны

Необязательный логический. TRUE, чтобы определить столбец как запечатанный. Нельзя изменять запечатанные столбцы с помощью пользовательского интерфейса Или объектной модели SharePoint Foundation. Если этот атрибут не включен, SharePoint Foundation обрабатывает столбец так, как если бы атрибуту было присвоено значение FALSE.
ShowInDisplayForm

Необязательный логический. TRUE, чтобы отобразить столбец в форме "Отображать" для элементов этого типа контента.
ShowInEditForm

Необязательный логический. TRUE, чтобы отобразить поле на странице "Изменить элемент".
ShowinFileDlg

Необязательный логический. TRUE, чтобы отобразить столбец в диалоговом окне файла для элементов этого типа контента.
ShowInListSettings

Необязательный логический. При значении FALSE поле не отображается в перечислении Fields, когда задан режим отображения New. Поля с этим параметром не отображаются на странице создания элемента по умолчанию для данного списка.
ShowInNewForm

Необязательный логический. TRUE, чтобы отобразить столбец в форме "Создать" для элементов этого типа контента.
Возможность сортировки

Необязательный логический. Имеет значение TRUE, если возможна сортировка значений в поле.

Дочерние элементы

Нет

Родительские элементы

Occurrence

  • Минимум: 0
  • Максимум: без ограничения

Замечания

Элемент FieldRef является ссылкой на столбец, определенный в другом месте — на уровне сайта или списка. В ссылке на поле можно переопределить подмножество свойств столбца, включая следующее:

  • Отображаемое имя
  • XML-атрибуты повышения и понижения уровня;
  • Является ли поле доступным только для чтения, обязательным или скрытым

Изменение этих свойств в ссылке поля изменяет их только при их применении к определенному типу контента, в котором содержится ссылка поля.

Важно!

Атрибуты ID, Name, DisplayName и Required всегда являются обязательными, даже если элемент FieldRef ссылается на поле, определенное в том же манифесте элемента.

Пример

В следующем примере показаны два элемента FieldRef , указывающие столбцы для включения в тип контента.

<FieldRefs>
  <!--  Built-in Title field -->
  <FieldRef ID="{fa564e0f-0c70-4ab9-b863-0177e6ddd247}" Name="Title" DisplayName="Item" Required="TRUE" Sealed="TRUE"/>
  <!--  Custom CostCenter field -->
  <FieldRef ID="{943E7530-5E2B-4C02-8259-CCD93A9ECB18}" Name="CostCenter" DisplayName="Department" Required="TRUE"/>
</FieldRefs>

См. также