Формулы столбцов вида
Для задания формулы столбца необходимо сначала перейти в объектно-событийной панели на конкретный объект Column Value (значение столбца). При этом в панели программного кода можно определить характеристики выводимого значения. В верхней части программной панели расположено поле Display (отображение), которое с помощью трех радиокнопок определяет способ задания значения колонки вида. Интерфейс радиокнопок предлагает для выбора следующие значения:
- Simple Function (простые функции). Определение значения столбца идет на основании предопределенного набора функции. Все они имеют аналоги в языке @-формул. Ниже в таблице приведен список этих функций с расшифровкой выполняемых ими действий:
Название | Перевод | Расшифровка действия | Аналог на языке @-формул | ||||
# in View (eg 2.1.2) | Номер в виде (например, 2.1.2) | Отображает иерархический уровень текущего документа. Номер 2.1.2 говорит, что документ на верхнем уровне иерархии лежит во второй категории, на втором уровне иерархии в первой категории, а сам принадлежит к третьему уровню иерархии и в рамках его лежит вторым, считая сверху вниз. | @DocNumber | ||||
# of Responses (1 Level) | Число ответных документов на первом уровне иерархии | Определяет число документов или подкатегорий, лежащих на один уровень ниже от текущей категории. Колонка с этой формулой должна находится левее колонки с категорией, для которой определяется число ответных документов. | @DocChildren | ||||
# of Responses (All Level) | Число ответных документов на всех уровнях иерархии | Определяет число документов или подкатегорий, лежащих на всех уровнях ниже текущей категории. Колонка с этой формулой должна находиться левее колонки с категорией, для которой определяется число ответных документов. | @DocDescendants | ||||
Attachment Lengths | Размер в байтах присоединенных файлов | Возвращаемое значение есть число, или числовой список, если присоединенных файлов несколько. | @AttachmentLengths | ||||
Attachment Names | Имена присоединенных файлов | Возвращаемое значение есть текст, или текстовый список, если присоединенных файлов несколько. | @AttachmentNames | ||||
Attachments | Количество присоединенных файлов | Возвращаемое значение есть число, соответствующее числу присоединенных файлов. | @Attachments | ||||
Author(s) (Distinguished Name) | Автор (ы) (полное иерархическое имя) | Возвращает имя автора документа в иерархическом формате | @Author | ||||
Author(s) (Simple Name) | Автор(ы) (сокращенное имя) | Возвращает имя автора документа в сокращенном формате | @Name([CN]; @Author) | ||||
Collapse/Expand (+/-) | Уровень «свернут/развернут» | Возвращает строку "+", если уровень в виде разворачиваемый, и "-" - если нет. Столбец должен иметь категоризацию (свойство Categorized), либо лежать левее категоризующей колонки. | @IsExpandable | ||||
Creation Date | Дата создания | Возвращает дату и время создания документа | @Created | ||||
Last Modified | Дата последней модификации | Возвращает дату и время последнего сохранения документа | @Modified | ||||
Last Read or Edited | Дата последнего чтения или редактирования документа | Возвращает дату и время последнего чтения или редактирования документа | @Accessed | ||||
Size (bytes) | Размер в байтах | Возвращает размер документа в байтах | @DocLength |
- Field (поля). Определение значения столбца идет на основании полей, присутствующих в текущей БД. В панели программного кода перечислен список этих полей. Следует помнить, что в колонках видов нельзя отображать значение Rich Text полей. Имена таких полей обычно отсутствуют в панели программного кода. Это происходит в случае, когда у всех документов текущей БД поле с таким именем имеет тип Rich Text. Далее, если текущая колонка категоризованная (Categorized), и в значении поля присутствует символ обратного слеша («\»), то в колонке возникают дополнительные уровни иерархии, число которых зависит от количества обратных слешей в значении поля. Например, значение поля «Европа\Россия\Москва» в категоризованной колонке вида будет отображено тремя уровнями иерархии, соответственно «Европа», «Россия» и «Москва». При этом, следует не забывать, что Domino поддерживает до 32 уровней иерархии;
- Formula (@-формула). Определение значения столбца идет на основании языка @-формул. Это наиболее гибкий способ определения значения колонки вида. В контексте формулы колонки видов допускается использовать ссылки на значения полей, а также ряд @-функции, которые поддерживаются в этом контексте (подробнее см. документацию). Аналогично предыдущему пункту в категоризованных колонках допускается использовать символ обратного слеша («\»). В этом случае стоит не забывать, что согласно синтаксису @-формул, символ слеша должен быть удвоен. Например, формула столбца может выглядеть так: Country + "\\" + Region + "\\" + Town.
Продемонстрировать формулу столбца со слешем (см. вид Hotel with slash).
Продемонстрировать и объяснить работу примера галереи в рамках вида (см. вид Table photo БД TestJPG.nsf). Самостоятельно реализовать аналог табличной галереи.
Рассмотреть механизм использования циклов в формулах видов на примере видов Numb и NumbSelFormula. Рассмотреть синтаксис циклов (см. стр. 43).