*Имя. Указывается при создании типа сущности. Используется, например, при обращении к сущностям в программном коде. Имя должно быть уникальным в рамках одного модуля, состоять из букв латинского алфавита и цифр. При необходимости имя можно изменить. Для этого сохраните все изменения в редакторе, перейдите по ссылке Изменить и задайте новое имя. После изменения имени доработайте программный код, в котором оно используется.

*Имя в базе данных. Используется при генерации таблиц для хранения данных типа сущности в базе данных. Заполняется автоматически. При необходимости имя в базе данных можно изменить. Для этого введите новое значение вручную. Имя должно быть уникальным в рамках одного модуля, состоять из букв латинского алфавита и цифр. Чтобы вернуть первоначальное значение, нажмите По умолчанию.

*Имя в сервисе интеграции. Используется при генерации наборов данных EntitySet в метаданных OData для типов сущностей, которые используются при настройке интеграции Directum RX с внешними системами. Заполняется автоматически по шаблону <Имя модуля><Имя типа сущности>. При необходимости имя в сервисе интеграции можно изменить. Например, для ранее созданных типов сущностей с одинаковыми именами, из-за которых возникал конфликт в сервисе интеграции. Для этого введите новое значение вручную. Имя должно быть уникальным в рамках одного модуля, состоять из букв латинского алфавита и цифр. Чтобы вернуть первоначальное значение, нажмите По умолчанию.

*Отображаемое имя. Имя типа сущности, которое отображается в проводнике системы.

*Отображаемое имя в винит. падеже. Имя типа сущности, которое отображается в названии кнопки быстрого создания:

*Отображаемое имя во мн. числе. Имя списка сущностей данного типа, которое отображается в списке папок проводника системы:

Для локализации отображаемых имен перейдите по ссылке Локализовать.

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

В качестве дополнительной информации указывается одно или несколько свойств типа сущности с типом Ссылка или Строка и Текст. Свойства указываются в квадратных скобках, простой текст задается в произвольном виде, например, <Текст> [<Свойство типа сущности>].

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

Пример. Настройка дополнительной информации для справочника «Сотрудники»

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

После чтения инструкцию можно скрыть по кнопке . Нажмите на подсказку на ленте, чтобы скрыть или вновь показать инструкцию, если нужно вернуться к ее чтению. В карточке сущности сохраняется состояние инструкции: скрыта или показана.

Иногда нужно менять инструкцию в зависимости от исполнителя задания, состояния сущности и т.п. Например, может потребоваться показывать разный текст на каждой стадии жизненного цикла документа. Для этого настройте инструкцию через аргумент e.Instruction в клиентском событии «Показ формы» (Showing).

Отображать в проводнике. Тип сущности отображается в списке папок модуля в проводнике системы.

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

Отображать в диалоге поиска. Сущности данного типа можно найти по свойствам в проводнике системы. Для этого в узле «Свойства» для нужных свойств установите флажок Отображать в диалоге поиска. Например, для документов типа «Приложение к обращению» можно добавить поиск по обращению, к которому относятся документы. Рекомендуется использовать в поисках не более пяти свойств типа сущности. Флажок доступен только в редакторе типа справочника, документа и задачи.

Скрыть из области создания. В списках и папках будут скрыты кнопки быстрого создания типа сущности.

Скрыть из области создания выпадающего списка. Тип сущности нельзя создать из выпадающего списка.

Отображать в выборе содержимого для папки. Тип сущности можно выбирать в качестве основного содержимого папок:

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

Кэшировать на клиенте. Записи типа сущности кэшируются на стороне клиента. Это позволяет ускорить доступ к данным типа сущности. Рекомендуется устанавливать флажок для небольших по объему (до 2000 записей) и редко изменяемых типов сущностей. При перекрытии и наследовании, если в родительском типе сущности флажок Кэшировать на клиенте установлен, то его нельзя снять. Кроме этого, флажок не получится установить, если для типа сущности добавлен обработчик серверного события UI-фильтрация или Фильтрация: при сохранении появится сообщение валидации.

Создавать только программно. Пользователи не смогут создавать сущности в клиентском приложении Directum RX. Например, флажок устанавливается для служебных справочников или задач, которые необходимо создавать автоматически при выполнении какого-либо действия. В базовом решении Directum RX флажок установлен для типа «Задача на продление срока» и справочника «Типы документов». Флажок доступен в редакторах типа справочника, документа и задачи.

Совет. Если флажок установлен, напишите код для программного создания сущностей в функции инициализации.

Вести историю изменений. Если флажок установлен, то в карточке сущности появится закладка «История». На ней фиксируется история работы с сущностью.

Использовать в сервисе интеграции. Этим признаком отмечаются типы сущностей, которые используются при интеграции Directum RX с внешними системами. Флажок установлен для всех типов сущностей из базового решения. Также при создании типа сущности флажок по умолчанию установлен для типов документов, задач и заданий. Особенности при:

•наследовании. Если в базовом типе сущности флажок установлен, то при создании наследников в дочерних типах флажок устанавливается автоматически. При этом в дочерних типах флажок можно снять.

•перекрытии. Если флажок установлен в типе сущности из базового решения, то после перекрытия этого типа флажок снять нельзя, но можно установить, если флажка изначально не было.

Совет. При установке флажка проверьте, что в вашей разработке нет другого типа сущности с таким же именем, у которого уже установлен флажок Использовать в сервисе интеграции. Из-за особенностей протокола OData, когда флажок уставлен в двух типах сущностей с одинаковыми именами, после публикации метаданные генерируются только для одного случайного типа. Ко второму типу без метаданных не получится обратиться из внешней системы. Сообщение о возникшем конфликте появляется в лог-файле сервиса интеграции. Чтобы устранить ошибку, измените значение в поле Имя в сервисе интеграции для одного из типов сущностей.

Запретить создавать версии схемы задачи в перекрытиях. Если флажок установлен, то в перекрытии типа задачи не получится изменить схему. Например, установите флажок, если схема задачи сложная и при доработке на новом слое ее можно сломать. Флажок доступен только в редакторе типа задачи. В перекрытиях параметр нельзя изменить.

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

Действующая/Закрытая. Возможность закрытия записей справочников. Рекомендуется задавать параметр для всех типов справочников. У типа справочника появится свойство Статус с возможными значениями Действующая и Закрытая. В качестве значений свойств-ссылок на тип сущности доступны только действующие записи. Например, при заполнении в справочнике Контакты поля Персона, в списке для выбора отображаются только записи справочника Персоны со статусом Действующая. Флажок доступен только в редакторе типа справочника.

Только исполнители могут выполнять задания. Возможность для инициатора выполнить задание за исполнителя. Установите флажок, например, если требуется запретить инициатору задачи выполнять задания за исполнителей при согласовании официальных документов. При этом инициатор может выполнить задание, если замещает исполнителя, является руководителем подразделения или нашей организации. По умолчанию флажок не установлен. Флажок доступен только в редакторе типа задачи.

ПРИМЕЧАНИЕ. Ограничение на выполнение распространяется и на программную работу с заданием.

Создавать задание на приемку. По умолчанию задание на приемку не создается. Установите флажок, если после выполнения задачи нужно автоматически создавать задание на приемку. Флажок доступен только в редакторе типа задачи.

Примечание. Определить логику выполнения действия можно через свойство Задание на приемку (NeedsReview), даже если флажок снят.

В переписке показывать тип вместо темы. По умолчанию в переписке отображается тема задачи. Она хранится в свойстве Subject. Как правило, тема включает в себя название документа, которое может быть достаточно длинным. Например: «Согласование: <Название документа>», «Распечатайте: <Название документа>» и т.д. Если флажок установлен, то вместо темы выводится тип задачи, задания или уведомления: «Задача на согласование по регламенту», «Печать официального документа» и т.д. Это упрощает чтение переписки. Флажок доступен только в редакторе типа задачи.

ПРИМЕЧАНИЕ. Тема изменяется только в переписке. В папках «Входящие» и «Исходящие» она остается прежней.

ПОДРОБНЕЕ

Чтобы в качестве темы задать собственное значение, используйте свойство ThreadSubject объектной модели. В этом случае параметр В переписке показывать тип вместо темы и свойство Subject не учитываются.

Схема настраивается в проводнике. Если флажок установлен, то для выбранного типа задачи в веб-клиенте нужно создать вариант процесса и настроить схему. В этом случае блоки для схемы создаются в среде разработки в узле «Блоки». В узле «Схема» отображается ссылка для открытия схемы в веб-клиенте. Если флажок снят, то схема задачи вместе с блоками создается в среде разработке в редакторе типа задачи. В этом случае узел «Схема» отображается, а узел «Блоки» скрыт. При создании нового типа задачи флажок установлен по умолчанию. Флажок доступен только в редакторе типа задачи.

*Наследовать от. Имя типа сущности, от которого наследуются свойства, действия, форма, логика работы и другое. Указывается в поле Базовый тип сущности при создании и перекрытии типа сущности:

В редакторе типа сущности поле доступно только для просмотра.

Примечание. Если в среду разработки импортировано несколько базовых решений с одинаковыми перекрытиями, то при перекрытии этого же типа сущности на своем слое в редакторе перекрытого типа в поле Наследовать от отображается последний тип сущности в цепочке перекрытий. Подробнее см. раздел «Объединение изменений в перекрытиях».

Иногда нужно посмотреть, как в типе сущности реализовано, например, событие. Если тип сущности унаследован, то в его редакторе не отображается код этого события. Чтобы открыть редактор базового типа сущности, нажмите на ссылку Перейти. Если базовый тип тоже является наследником, таким же способом можно перейти к его предку. Ссылка доступна, если базовый тип сущности находится на прикладном уровне.

*Способ выбора значения свойства-ссылки на тип сущности. Возможные значения:

•Выпадающий список. Значения свойства-ссылки отображаются в виде выпадающего списка. Рекомендуется устанавливать, если сущностей данного типа немного (до 20), их количество не будет меняться и у типа сущности мало свойств.

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

Разрешить создание версий документа. Создание версии документа доступно одним или несколькими способами. Возможные значения:

•Из файла. При выборе этого способа можно создавать документ или его новую версию из файла, в том числе с помощью механизма Drag&Drop. Также документ можно импортировать;

•Со сканера. В этом случае документ или его версию можно создавать сканированием;

•Из шаблона. Разрешается создавать документ или его версию с использованием шаблона;

•Копированием. При выборе этого значения документ и его версию можно создавать на основе выбранной или последней версии, а также через действие Создать копию контекстного меню документа.

Примечание. Определить логику доступности действия можно в обработчике события Выполнение/Возможность выполнения, даже если флажок снят.

Иконка. Иконка типа сущности, которая отображается в проводнике системы, например, в списке сущностей или в заголовке карточки сущности. Добавьте две иконки в формате SVG и в размерах 16х16 и 32х32. Иконки, используемые в базовом решении, можно найти в локальной папке исходных кодов. Расположение папки задается при установке системы. Например, в папке C:\DEVRX\Base\Sungero.Company\Sungero.Company.ClientBase\Icons можно найти файлы иконок модуля «Компания».

Добавление обработчиков для:

•серверных событий. Код обработчиков выполняется на сервере, когда происходит соответствующее событие;

•клиентских событий. Код обработчиков выполняется на стороне клиентского приложения, когда происходит соответствующее событие.

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

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

Настройка формы для задач и заданий

Результаты выполнения заданий

Создание функций инициализации

Уникальность и ограничения кодов