Специальные справочники

В системе существуютс специальные справочники, от которых зависит функциональность каких-либо частей системы:

Для работы с этими справочниками используется раздел «Системные справочники» настроек платформы:

Рисунок 4.250. Раздел «Системные справочники»

Раздел «Системные справочники»

Все справочники в этом разделе созданы автоматически. Создание новых справочников и удаление существующих недоступно.

Кроме вышеперечисленного списка, в системе существуют и другие справочники (преднастроенные и при этом скрытые из интерфейса), от которых также зависит функциональность каких-либо частей системы. Например, справочник process_messages_dict_name, который соответствует разделу конфигуратора «Конструктор процессов».

Справочник назначения календаря

Справочник назначения календаря должен иметь код calendar_types и поля:

Код поля Название Описание

type

Тип календаря

Целое неотрицательное число, идентификтор типа. Значения данного поля должны быть уникальными.

Данное поле является ключевым - по нему будут идентифицироваться элементы при импорте настроек платформы, если включен флаг «Объединять элементы справочников».

title

Название статуса

Название статуса, которое будет отображаться в списке выбора в маршруте. Например: «отпуск», «командировка».

state_label

Название текущего статуса пользователя

Название текущего статуса пользователя, которое будет отображаться в системе. Например: «В отпуске с {date.start} по {date.finish}» или просто «В отпуске».

color

Цвет статуса

Цвет статуса, который будет отображен в системе. Например: «#5462ef».

busy_status

Тип занятости

Тип занятости в данный период, поддерживаются значения:

  • busy - занят в каждый день периода

  • free - свободен в каждый день периода

  • standart - обычное рабочее время

Замечание

Пока данное поле ни на что не влияет.

make_vacant

Признак занятости штатной единицы

Признак занятости штатной единицы, поддерживаются значения:

  • 0 - пользователь с таким статусом занимает штатную единицу на период действия статуса

  • 1 - пользователь с таким статусом не занимает (освобождает) штатную единицу на период действия статуса

Справочник текстов резолюции

Справочник текстов резолюции должен иметь код resolution и поля:

Код поля Название Описание

type

Тип элемента резолюции

Тип элемента резолюции, поддерживаются значения:

  • 0 - согласование

  • 1 - утверждение

  • 2 - ознакомление

  • 3 - работа

text

Текст резолюции

Текст резолюции, который будет отображаться при выборе соответствующего типа.

Справочник подписей прогресса поручений

Справочник подписей прогресса поручений должен иметь код action_progress и поля:

Код поля Название Описание

to

Верхняя граница прогресса

Верхняя граница прогресса (включающая)

from

Нижняя граница прогресса

Нижняя граница прогресса (включающая)

label

Значение прогресса

Значение прогресса, которое будет отображаться при выставлении соответствующего прогресса

Справочник дополнительных полей проекта / портфеля

Справочник дополнительных полей проекта / портфеля должен иметь код pm_custom_fields и поля:

Код поля Название Описание

name

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

Название поля, которое будет отображаться в проекте / портфеле.

code

Код

Код дополнительного поля. Поле может содержать только символы: a-z, A-Z, цифры, _ (подчеркивание) и - (дефис), не может начинаться с цифры.

Данное поле является ключевым - по нему будут идентифицироваться элементы при импорте настроек платформы, если включен флаг «Объединять элементы справочников».

type

Тип доп.поля

Тип дополнительного поля, поддерживаются значения:

  • number - числовое значение;

  • non_negative_number - числовое значение;

  • text - произвольная строка;

  • dictionary - значение из справочника.

aggregate

Тип пересчета

Поддерживаются значения:

  • sum - сумма (только для number и non_negative_number);

  • average - среднее арифметическое (только для number).

dictionary_value_field

Поле со значением записи справочника

Ссылка на поле справочника, которое содержит значение записи. Имеет смысл только для записей типа dictionary.

Формат ссылки: <код_справочника>.<код_поля>

dictionary_label_field

Поле с подписью записи справочника

Ссылка на поле справочника, которое содержит подпись записи. Имеет смысл только для записей типа dictionary.

Формат ссылки: <код_справочника>.<код_поля>

measure_code

Код показателя

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

Справочник подписи исполнителя документа

Справочник подписи исполнителя документа должен иметь код l10n и поля:

Код поля Название Описание

location

Расположение

Место в системе, где будет применяться значение справочника, для подписи исполнителя значение строгое: document_item_labels

code

Код

Для подписи исполнителя значение строгое: originator

Данное поле является ключевым - по нему будут идентифицироваться элементы при импорте настроек платформы, если включен флаг «Объединять элементы справочников».

label

Подпись

Подстановка подписи поля «Исполнитель документа»

Если такой справочник в системе отсутствует либо в нем нет записи с таким кодом, то подписью поля - «Отписано».

Справочник пунктов меню отправки

Справочник пунктов меню отправки должен иметь код send_items и поля:

Код поля Название Описание

item_name

Название пункта меню отправки

Текст, который будет отображаться в соответствующем пункте меню; может иметь переводы.

item_process

Действие, которое осуществляет пункт

Возможные значения этого поля:

  • send-document - отправка документа;

  • assignment - перепоручение;

  • agreement - согласование;

  • transfer - передача работы;

  • approval - утверждение;

  • acquaintance - ознакомление;

  • split - псевдо-пункт меню, обозначающий вставку в него разделителя.

item_number

Порядковый номер пункта в меню отправки

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

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

Пункты с процессом split означают вставку в меню разделителей. Название (item_name) такого пункта не используется, т.е. может быть любым.

Справочник типов работ по резолюции

Справочник текстов резолюции должен иметь код resolution_work_types и поля:

Код поля Название Комментарий Переводить Назначение

item_name

Название пункта типа работы

Да

Тот текст, который отображается в соответствующем пункте меню (на языке сессии пользователя)

item_process

Действие, которое осуществляет пункт

assignment - работа, agreement - согласование, approval - утверждение, acquaintance - ознакомление, resolution - резолюция, send-document - отправка документа

Нет

Возможные значения этого поля:

  • assignment - работа

  • agreement - согласование

  • approval - утверждение

  • acquaintance - ознакомление

  • resolution - резолюция

  • send-document - отправка документа

item_number

Порядковый номер пункта в выпадающем списке

Нет

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

code

Код типа работы

Значение данного поля должно быть уникальным

Нет

Значение данного поля должно быть уникальным. Используется для связи со справочником resolution, а Тип элемента резолюции

Данное поле является ключевым: по нему будут идентифицироваться элементы при импорте настроек платформы, если включен флаг «Объединять элементы справочников».

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

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

Данные справочника:

Название пункта типа работы Действие, которое осуществляет пункт Порядковый номер пункта в выпадающем списке Код типа работы

Работа

assignment

1

3

Согласование

agreement

2

0

Утверждение

approval

3

1

Ознакомление

acquaintance

4

2

Резолюция

resolution

5

33

Отправка документа

send-document

6

17

При удалении самого справочника / отдельных его записей, редактировании записей, которые уже были выбраны в основном приложении, будет происходить следующее:

  • При редактировании черновиков резолюции

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

    Выбранный тип работы по резолюции отсутствует в справочнике. Выберите другое значение.

  • При редактировании наложенной резолюции

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

Справочник сопоставления полей входящих документов DT-INT

Данный справочник предназначен для сопоставления полей входящих документов DT-INT. Он выглядит следущим образом:

Код поля Название Назначение

document_type_id

Код типа документа

Код типа документа, содержащего форму с доп.карточкой документа Synergy

incoming_field_id

Код поля во входящем документе

Код поля в карточке входящего документа, из которого должно браться значение для автозаполнения в форме Synergy

synergy_field_id

Код поля в форме Synergy

Код поля в форме Synergy, которое должно быть автоматически заполнено значением из входящего документа

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

При получении исходящего документа, созданного как интеграцией с «Эвридок», так и с Synergy, в журнале входящего документа Synergy будут обрабатываться те поля карточки, что настроены согласно вышеописанного справочника dtint_internal_fields. Т.е. поля карточки формы Synеrgy synergy_field_id будут автоматически заполняться значениями из соответствующих полей incoming_field_id. В результате такой обработки полям типа «выпадающий список» и «переключатель вариантов» будет установлено значение, а содержимое таких компонентов не изменится.

Если справочник dtint_internal_fields отсутствует, то поля с одинаковыми кодами как во входящем документе, так и в форме Synergy, будут заполнены автоматически.

Кроме того, обработка поля «Subject» будет происходить вне настроек данного справочника и осуществляется следующим образом:

  • если форма Synergy является доп.карточкой исходящего документа, то значением исходящего поля «Subject» будет значение темы (при наличии) либо краткого содержания (при отсутствии темы);

  • если форма Synergy является доп.карточкой входящего документа, то значение входящего поля «Subject» будет скопировано и в поле темы, и в поле краткого содержания.

Пример

Пусть форма карточки входящего документа содержит следующий набор полей:

    ...
    <DocumentNumber>104-27-02-2015</DocumentNumber>
    <Tos><To>Бобров</To></Tos>
    <Date>2015-02-27T11:54:34</Date>
    <Language>Русский</Language>
    <DocumentView>Альбомный</DocumentView>
    ...

Форма карточки документа Synergy содержит следующий набор полей:

    ...
    <DocumentNumber>104-27-02-2015</DocumentNumber>
    <Tos><To>Бобров</To></Tos>
    <Date>2015-02-27T11:54:34</Date>
    ...

Поля должны быть одинаково объявлены в модели данных.

Чтобы данные поля заполнились автоматически, необходимо заполнить справочник следующим образом:

document_type_id incoming_field_id synergy_field_id

document_type_id

DocumentNumber

DocumentNumber

document_type_id

Tos.To

Tos.To

document_type_id

Date

Date

где document_type_id - код типа документа, содержащего форму Synergy.