Расширенные свойства полей
Для типов полей файл, выпадающий список и список значений, помимо основного значения поля существуют еще различные наборы расширенных свойств.
Расширенные свойства поля хранятся и адресуются в виде "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 будет соответствовать выбранной строке.
Такое дополнительное поле полезно для списков, не имеющих привязки к документам, например сформированным вручную спискам данных. Значение поля можно использовать в каких-либо математических вычислениях, показывая пользователю текст, соответствующий результату.
|