Расширенные свойства полей

Для типов полей файл, выпадающий список и список значений, помимо основного значения поля существуют еще различные наборы расширенных свойств.

Расширенные свойства поля хранятся и адресуются в виде «field:additionalField». Например, для поля sun, имеющего тип список значений, расширенное свойство text можно получить по имени «sun:text», а для файлового поля myfile, например, можно получить длину закачанного файла в дополнительном поле <#myfile:size#>.

Каждому из перечисленных типов полей соответствует свой набор расширенных свойств. Наибольшее количество расширенных свойств у поля типа файл. Они обновляются при каждом изменении поля и берутся из файла, на который указывает значение поля, т. е. данные берутся из файла, путь на сервере к которому прописан в поле.

Для всех файлов поддерживаются следующие расширенные свойства:

• :size – размер файла в байтах;
• :atime – timestamp времени последнего доступа к файлу;
• :mtime – timestamp времени последней модификации файла;
• :ctime – timestamp времени создания файла;
• :ext – расширение файла.

Система пытается опознать тип файла по содержимому файла, а не по расширению. Распознаются основные графические форматы – JPG, GIF, BMP, PNG, и из них извлекаются следующие данные:

• :width – ширина в пикселях;
• :height – высота в пикселях.

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

Поля типа выпадающий список (ComboBox) и список значений (ListBox) имеют расширенное свойство :text. Это поле содержит текст, соответствующий выбранному элементу списка.

Например, список в контент-шаблоне состоит из следующих вариантов выбора:

1:Экономика

2:Бизнес

3:Финансы

Это означает, что при выборе строки «Экономика», значение поля будет равно 1, при выборе строки «Бизнес» – 2 и т.д. При этом значение расширенного свойства :text будет соответствовать выбранной строке.

Такое дополнительное поле полезно для списков, не имеющих привязки к документам, например сформированным вручную спискам данных. Значение поля можно использовать в каких-либо математических вычислениях, показывая пользователю текст, соответствующий результату.