Элементы определения данных
Дата последнего изменения: 9 марта 2015 г.
Применимо к: SharePoint Foundation 2010
Язык 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 |
Note |
Содержит HTML-шаблон для отрисовки поля в режиме отображения представления или формы. |
EditPattern |
Note |
Содержит HTML-шаблон формы "Редактирование", предназначенной для изменения поля. |
HeaderPattern |
Note |
Содержит HTML-шаблон для отображения заголовка столбца в табличном представлении. |
InternalType |
Text |
Определяет поведение элемента Column в отображаемых данных из базы данных SharePoint Foundation и то, каким образом данные передаются обратно в базу данных. Допустимые типы: Text, Note, Number, Currency, Integer, Boolean, DateTime, Threading, Lookup, Choice, URL, Counter или DisplayOnly. Обратите внимание, что тип поля DisplayOnly не имеет собственного хранилища. |
Name |
Text |
Содержит имя внутреннего типа данных, который указывается в атрибуте Type элемента Field: <Field Type="Name"/>. Примеры: Text, Note, Number и т. д. |
NewPattern |
Note |
Содержит HTML-шаблон формы "Создание", предназначенной для редактирования начального значения поля. |
PreviewDisplayPattern |
Note |
Указывает, как отображаются поля при редактировании формы "Просмотр" в Microsoft SharePoint Designer. |
PreviewEditPattern |
Note |
Указывает, как отображаются поля при редактировании формы "Редактирование" в Microsoft SharePoint Designer. |
PreviewNewPattern |
Note |
Указывает, как отображаются поля при редактировании формы "Создание" в Microsoft SharePoint Designer. |
Sortable |
Text |
Указывает, может ли поле быть сохранено. Возможные значения: TRUE или FALSE. |
TypeName |
Text |
Указывает имя в определении типа поля. |
SQLType |
Text |
Определяет базовый тип данных SQL для данного поля. Примеры: nvarchar(255), memo, integer, float. Используется для генерации соответствующего SQL-кода (CREATE TABLE) при создании поля этого типа. |
SQLType2 |
Text |
Если значение указано, оно определяет тип данных SQL дополнительного столбца, используемого при создании текущего поля (например, см. тип поля URL). |
Режимы отображения и шаблоны отображения
Каждый из режимов отображения (Display, Edit и New) содержит определение того, как отображать каждый из типов полей данных, поддерживаемых SharePoint Foundation.
Для каждого режима отображения существует свой шаблон отображения в виде выражения на языке CAML. Некоторые элементы CAML специально предназначены для использования только в шаблонах отображения. Другие элементы можно использовать в любом контексте — и для отображения страниц, и для отображения полей — но они применяются главным образом при отображении полей. Следующие внутренние элементы отображения языка CAML используются для построения шаблонов, которые могут включать и статический код HTML, и данные, а также метаданные отображаемого поля.
Элемент |
Описание |
|---|---|
Возвращает необработанные данные отдельного поля. |
|
Используется при отображении поля типа "Ссылка". |
|
Используется для замены определенных символов в строке. |
|
Используется в разделах HeaderPattern файла FldTypes.xml для отображения раскрывающихся меню фильтров. |
|
Возвращает пространство имен Microsoft Office — "urn:schemas-microsoft-com:office:office#". |
|
Используется в вычисляемых полях для ссылки на поля-компоненты и в представлениях для определения присутствующих полей. |
|
Возвращает URL-адрес файла изображения, используемого, чтобы показать направление сортировки столбца. |
|
Возвращает направление сортировки списка, отображая Asc (по возрастанию) или Desc (по убыванию), если поле было отсортировано, а если не было — направление сортировки этого поля по умолчанию. |
|
Разрешает условное отображение на основе сравнения двух выражений CAML. |
|
Возвращает TRUE, если элемент считается новым. |
|
Возвращает HTTP-путь к каталогу изображений проекта. |
|
Ограничивает длину текста до указанного значения. |
|
Передает клиенту локальную информацию сервера, чтобы обеспечить правильное отображение и редактирование дат и чисел. |
|
Используется в любом месте для получения абсолютного, кодированного URL-адреса текущей страницы. |
|
Возвращает свойство из текущего контекста цикла ForEach. |
|
Используется для того, чтобы отобразить текст, полученный с сервера, в виде строки в кавычках. |
|
Отображает текущую дату и время в формате ISO. |