Элементы определения данных
Применимо к: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
Язык Collaborative Application Markup Language (CAML) имеет два основных вида элементов: первый — для отображения страниц, а второй — для отображения полей и определения схем. Элементы CAML для отображения полей предназначены для того, чтобы отображать значения отдельных полей. Они могут отображаться в определениях типов полей или, чаще всего, в FldTypes.xml в \\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATES\XML.
Отрисовка поля и определение схемы
Поле — это столбец или атрибут, содержащий сведения, которые пользователь может добавить в список. Каждый список на веб-сайте, основанном на Microsoft SharePoint Foundation, содержит метаданные, хранящиеся в базе данных. Формат схемы имеет структуру XML, например:
<Fields>
<Field Type="Counter" Name="ID"/>
...other field definitions...
</Fields>
Чтобы упростить реализацию различных типов полей и обеспечить более высокую степень гибкости при отрисовке различных полей, FldTypes.xml содержит сведения о отрисовке и поведении каждого типа полей. Элемент Field отображает различные html-коды в зависимости от типа данных соответствующего поля, а FldTypes.xml определяет типы данных и шаблоны отрисовки для каждого типа полей. В следующей таблице представлена схема, используемая в этом файле.
| Имя | Тип данных | Описание |
|---|---|---|
| Column2Suffix |
Text |
Содержит текст, добавляемый к имени базового столбца, чтобы получить ColumnName2 из ColumnName (для полей из двух столбцов, например URL). |
| DisplayPattern |
Примечание |
Содержит HTML-шаблон для отрисовки поля в режиме отображения представления или формы. |
| EditPattern |
Примечание |
Содержит HTML-шаблон формы "Редактирование", предназначенной для изменения поля. |
| HeaderPattern |
Примечание |
Содержит HTML-шаблон для отображения заголовка столбца в табличном представлении. |
| InternalType |
Text |
Определяет поведение элемента Column при отрисовке данных из базы данных SharePoint Foundation и способ их отправки обратно в базу данных. Допустимые типы: Text, Note, Number, Currency, Integer, Boolean, DateTime, Threading, Lookup, Choice, URL, Counter или DisplayOnly. Обратите внимание, что тип поля DisplayOnly не имеет собственного хранилища. |
| Имя |
Text |
Содержит имя внутреннего типа данных, указанное в атрибуте Type элемента Field: <Field Type="Name"/>. Примеры: Text, Note, Number и т.д. |
| NewPattern |
Примечание |
Содержит HTML-шаблон формы "Создание", предназначенной для редактирования начального значения поля. |
| PreviewDisplayPattern |
Примечание |
Указывает, как отображаются поля при редактировании формы отображения в Microsoft SharePoint Designer. |
| PreviewEditPattern |
Примечание |
Указывает, как отображаются поля при редактировании формы редактирования в Microsoft SharePoint Designer. |
| PreviewNewPattern |
Примечание |
Указывает способ отображения полей при редактировании новой формы в Microsoft SharePoint Designer. |
| Возможность сортировки |
Text |
Указывает, может ли поле быть сохранено. Возможные значения: TRUE или FALSE. |
| TypeName |
Text |
Указывает имя в определении типа поля. |
| SQLType |
Text |
Определяет базовый тип данных SQL для данного поля. Примеры: nvarchar(255), memo, integer, float. Используется для генерации соответствующего SQL-кода (CREATE TABLE) при создании поля этого типа. |
| SQLType2 |
Text |
Если значение указано, оно определяет тип данных SQL дополнительного столбца, используемого при создании текущего поля (например, см. тип поля URL). |
Режимы отображения и шаблоны отображения
Каждый из режимов отображения (отображение, изменение и новый) содержит определение способа отображения каждого из типов данных полей, поддерживаемых SharePoint Foundation.
Для каждого режима отображения существует свой шаблон отображения в виде выражения на языке CAML. Некоторые элементы CAML специально предназначены для использования только в шаблонах отображения. Другие элементы можно использовать в любом контексте — и для отображения страниц, и для отображения полей — но они применяются главным образом при отображении полей. Следующие внутренние элементы отображения языка CAML используются для построения шаблонов, которые могут включать и статический код HTML, и данные, а также метаданные отображаемого поля.
| Элемент | Описание |
|---|---|
| Столбец |
Возвращает необработанные данные отдельного поля. |
| Столбец 2 |
Используется при отображении поля типа "Ссылка". |
| Побег |
Используется для замены определенных символов в строке. |
| FieldFilterOptions |
Используется в разделах HeaderPattern файла FldTypes.xml для отображения раскрывающихся меню фильтров. |
| FieldPrefix |
Возвращает пространство имен Microsoft Office , urn:schemas-microsoft-com:office:office#. |
| FieldRef |
Используется в вычисляемых полях для ссылки на поля-компоненты и в представлениях для определения присутствующих полей. |
| FieldSortImageURL |
Возвращает URL-адрес файла изображения, используемого, чтобы показать направление сортировки столбца. |
| FieldSortParams |
Возвращает направление сортировки списка, отображая Asc (по возрастанию) или Desc (по убыванию), если поле было отсортировано, а если не было — направление сортировки этого поля по умолчанию. |
| IfEqual |
Разрешает условное отображение на основе сравнения двух выражений CAML. |
| IfNew |
Возвращает TRUE, если элемент считается новым. |
| ImagesPath |
Возвращает HTTP-путь к каталогу изображений проекта. |
| Ограничение |
Ограничивает длину текста до указанного значения. |
| LocaleInfo |
Передает клиенту локальную информацию сервера, чтобы обеспечить правильное отображение и редактирование дат и чисел. |
| PageUrl |
Используется в любом месте для получения абсолютного, кодированного URL-адреса текущей страницы. |
| Свойство |
Возвращает свойство из текущего контекста цикла ForEach. |
| ScriptQuote |
Используется для того, чтобы отобразить текст, полученный с сервера, в виде строки в кавычках. |
| TodayISO |
Отображает текущую дату и время в формате ISO. |