Главная  |  О продукте  |  Пользователям  |  Community

Поиск

 

Служебные поля

Все служебные поля начинаются со знака подчёркивания. Они присутствуют у каждого документа в системе. Поведение системы зависит от значений служебных полей. Изменение одного из этих полей приводит к изменению поведения системы.

На основании данных служебных полей можно ориентироваться по событиям, которые происходили с документом.

Список служебных полей:

Название поля

Описание

Возможность записи
из DJEM-скрипта

_id

Идентификатор документа – уникальное цифровое значение для каждого документа и раздела. Значение его используется всегда, когда нужно обратиться к полям конкретного документа или раздела. Это самое важное поле документа, с помощью него документы ссылаются друг на друга, а пользователь (DJEM-скрипт) запрашивает документ у системы с помощью оператора прямого доступа <[id].field>.

нет

_name

Название документа. При создании зависимых друг от друга документов часто используется комбинация полей _id и _name, где _name является описательным полем, а _id указывает на нужный документ.

есть

_type

Тип документа, который определяет, является ли документ разделом или обычным документом. Принимает значения:

  • 0 – раздел;
  • 1 – обычный документ.

Только раздел может содержать другие документы или разделы. Это поле позволяет скрипту узнать, могут ли быть у данного документа «дочерние».

нет

_sort

Значение документа, используемое для сортировки документов при выводе. Из скрипта это значение изменить нельзя. Можно изменить значение _sort, передвигая документы в клиентской оболочке с помощью комбинации клавиш <Ctrl> +<UP> и <Ctrl> + <Down>.

нет

_code

Условный код раздела. Используется как имя директории в файловых системах, для формирования пути к документам и для формирования внутреннего пути к документу – _path.

нет

_path

Путь к документу, формируемый из полей _code. Например, код родительского раздела системы – main, код подкаталога первого уровня – menu, в подкаталоге menu находится каталог news. Путь до каталога news будет: main.menu.news. При выборке документов часто используются имена для указания пути. Например, с помощью оператора foreach требуется получить доступ к документам-новостям, находящимся внутри подкаталога news, то используйте путь main.menu.news.$.

нет

_codepage

Кодировка документа – одна из разрешенных в системе кодировок. Доступны для выбора следующие кодировки: utf-8, koi8-r и windows-1251. По умолчанию документ выводится в кодировке windows-1251.

есть

_url

url-ссылка документа

есть

_file

Имя файла от html-корня сайта, куда публикуется документ. Обычно, значение этого поля совпадает со значением поля _url, за редкими исключениями – например, документ является "документом-ссылкой", когда на сервере его нет в виде файла. Он является пунктом в меню и указывает на другие документы.

есть

_parent_id

Идентификатор родительского раздела документа. Ссылается на поле _id документа, содержащего данный документ.

есть

_create_time

Время создания документа. Выдается в виде стандартного для UNIX-систем timestamp и представляется количеством секунд, прошедших с 1 января 1970 года. Значение можно обработать методом time для получения удобочитаемого выражения времени.

нет

_modify_time

Время последней модификации документа. Задаётся в виде UNIX-timestamp

нет

_publish_time

Время первой публикации документа – выдается в виде UNIX timestamp. До момента первой публикации документа равняется нулю. После первой публикации устанавливается и сохраняется неизменным при всех последующих публикациях.

есть

_last_publish_time

Время последней публикации документа. Устанавливается при каждой публикации документа.

нет

_status

Статус документа. Содержит числовой код статуса, созданного пользователем в папке «Статусы». Статус документа может изменяться:

вручную пользователем, используя пункт контекстного меню «Изменить статус»;

автоматически, при условии, что раздел, содержащий документ имеет назначенную ему «ролевую карту».

нет

_ctpl_id

Идентификатор контент-шаблона документа. Если его значение равно 0, то документ использует собственный контент-шаблон.

есть

_dtpl_id

Идентификатор дизайн-шаблона документа. Если его значение равно 0, то документ использует собственный дизайн-шаблон.

есть

_dtpl

Собственный дизайн-шаблон документа. Чтобы получить дизайн-шаблон для текущего документа, необходимо запросить поле _dtpl у того документа, на который сылается поле _dtpl_id. Если _dtpl_id равен 0, то используется собственный дизайн-шаблон.

нет

_creator_id

Идентификатор пользователя, создавшего документ.

нет

_level

Уровень вложенности документа в дереве документов. Корневой документ имеет уровень вложенности 0.

нет

_sub_folders

Количество подразделов в данном разделе. 

нет

_sub_documents

Количество документов в данном разделе.

 нет

_grid_where

Содержит условия фильтрации документов, если раздел является метапапкой. Это поле можно использовать в дизайн-шаблоне при выводе, для того, чтобы скопировать условия метапапки. Например,  <foreach name=x where=<#_grid_where#>>

нет

_grid_path

Содержит путь к документам, отображаемым в данном разделе. Как и поле _grid_where, может быть использовано для вывода документов мета-папки.

нет