/
Справочники кодов

Справочники кодов

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

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

Основные тезисы по кодам

Важно! Если справочник создан, то он является обязательным к заполнению (для профиля персоны или для заказа/командировки).

  • Каждый код привязан к определенному справочнику кодов. Фактически, справочник является контейнером кода одного вида

  • Справочники кодов бывают пяти типов:

    • Бюджетные – привязаны к заказам или командировке, выбираются пользователем при создании нового заказа/командировки или когда командировка переводится из состояния "Черновик".

    • Объяснения причин отклонений от ТП - данные коды заказчик должен указать для заказов, в которых есть нарушения ТП.

    • Структурные – привязаны к подразделению (неперсонифицированный код) или к персоне (персонифицированный).

    • Структурные меняемые коды - справочники привязанных к персоне структурных кодов, которые можно поменять "на лету".

    • Нарушение ТП – привязаны к правилам нарушений тревел-политик.

  • Справочники кодов привязаны к юридическим лицам-плательщикам. Фактически выбор плательщика при создании заказа определяет используемый в заказе набор кодов.

  • Код может быть виртуальным (справочник-клон), в этом случае его жизненный цикл зависит от цикла оригинального кода – если удаляется оригинальный код, то клон тоже удаляется.

  • К одному объекту (нарушению ТП, персоне, подразделению) можно привязать не более одного кода каждого типа.

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

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

  • Коды следует указывать не при создании заказа, а тогда, когда командировка переводится из состояния "Черновик".

Рекомендуемая последовательность заведения кодов

  1. Завести структурные коды.

  2. Завести структурные меняемые коды.

  3. Завести бюджетные коды (так как могут потребоваться клоны структурных).

  4. Завести коды объяснения причин отклонений от ТП.

  5. Завести коды нарушения ТП.

Для чего используются коды

  • Для экспорта данных в мидофис-систему агента для формирования отчетности для клиента.

  • Для выбора схемы авторизации и авторизующих лиц в сложных схемах авторизации.

  • Для формирования командировочных документов (авансовый отчет, задание, приказ) – для заполнения кодами отсутствующих в системе полей.

  • Для быстрого поиска заказов по меткам.

Соответственно, ту или иную модель использования кодов необходимо строить исходя из этих задач.

Для добавления кодов необходимо открыть “Меню” в “Настройки” найти раздел “Справочники кодов” и перейти в него.

image-20250318-090442.png

Далее, в зависимости от того, какие коды планируется завести, следует перейти в ту или иную вкладку:

image-20250318-090723.png

1. Структурные (Справочники структурных кодов)

Структурный код добавляется в заказ в случае, если в заказ была добавлена персона, которая ссылается на этот код.

Связь структурных кодов и заказов определяется тройкой "код, персона, заказ".

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

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

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

Для создания,редактирования и удаления структурного справочника переходим в “Структурные” справочники.

image-20250318-110857.png

Страница “Справочники структурных кодов” содержит список ранее заведенных структурных справочников.

  • Для добавления нового справочника кликнуть “Создать”.

  • Для редактирования созданного ранее справочника необходимо кликнуть на него для перехода к настройке.

  • Для удаления созданных справочников необходимо кликнуть “Удалить”.

image-20250318-120833.png

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

image-20250318-090901.png
  • Название на русском - название справочника (обязательно).

  • Название на английском - название справочника (обязательно).

  • Комментарий - комментарий к справочнику в свободной форме (не обязательно).

  • Специальное поведение - выбираем специальное поведение из выпадающий списка (не обязательно).

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

  • Наследуется от справочника - если в выпадающем списке выбрано это значение, то в справочник нельзя добавить коды, так как они берутся из того справочника, от которого наследует данный. От одного справочника можно унаследовать только один справочник-клон. Классическим примером справочника-клона является кост-центр: например, кост-центр может быть как привязан к персоне, так и выбираться при создании заказа из списка (бюджетный).

  • Тип селектора - выбираем тип селектора из выпадающего списка.

image-20250318-121652.png

Текстовое поле - если выбран данный тип селектора, то справочник будет в себе содержать “одноразовые значения”, которые пользователь указывает каждый раз заново, а не выбирает из списка (неограниченный справочник).
Кроме того, можно предусмотреть валидацию на код. Выделенный на скриншоте блок доступен в том случае, если выбрано текстовое поле.

image-20250318-123729.png

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

Список символов для написания регулярных выражений здесь

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

Автозавершение - если выбран данный тип селектора, то справочник будет содержать список кодов, которые добавляются в админке и пользователь сможет выбрать одно значение из выпадающего списка путем ввода его наименование в специальное поле, по мере ввода наименования кода пользователю будут предлагаться подходящие варианты (ограниченный справочник) - используется для справочников с БОЛЬШИМ количеством кодов.

Если в справочнике будет более 100 кодов, форма редактирования будет открываться очень долго. Для больших справочников рекомендуем использовать тип селектора «Автозавершение».

  • Очередность отображения - очередность отображения справочника.

Затем созданный справочник необходимо сохранить нажав на кнопку “Сохранить”.

После сохранения справочника появляются следующие разделы:

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

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

image-20250318-093112.png

Коды справочника

Для добавления, редактирования или удаления кода необходимо перейти во вкладку “Коды справочника”.

image-20250319-091733.png

На страница “Кодов справочника” содержит список ранее заведенных кодов.

  • Для добавления нового кода кликнуть “Создать”.

  • Для редактирования созданного ранее кода необходимо кликнуть на него для перехода к настройке.

  • Для удаления кода необходимо кликнуть “Удалить”.

image-20250318-093715.png

Создание кода

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

  • Название - любые символы (обязательно).

  • Название на английском языке - латиница (обязательно).

  • Значение кода - любые символы (обязательно).

  • Служебное поле - например, пояснение к коду.

Для сохранения кода нужно нажать на “Сохранить”, после этого код добавится в список кодов данного справочника.

image-20250318-094715.png

После сохранения кода становятся доступны две опции.

  • Организации

  • Тревел-политики

image-20250318-101629.png

Привязка кода к Организации

Здесь можно сделать привязку кода к организации.

image-20250318-125538.png
  1. Выбираем организацию из выпадающего списка или нажимаем кнопку “Добавить все”, если нужно привязать все организации договора.

image-20250318-102700.png
  1. После выбора организации необходимо нажать на “Добавить”.

image-20250318-102046.png
  1. В результате этого код будет привязан к организации.

image-20250318-102953.png
  1. Для удаления привязки кода к организации необходимо нажать на “Удалить” или на “Удалить все записи”.

image-20250318-102505.png

Привязка кода к Тревел-политикам

Здесь можно сделать привязку тервел-политик к структурному коду.

Персоны с таким кодом получат тервел-политику, которая преобладает над более общими политиками (по умолчанию и для юр.лица), но менее приоритетна персональной тревел-политики персоны, которая задаётся в карточке персоны.

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

image-20250318-104321.png
  1. При выборе услуги добавляется поле “Выберите тревел-политику” выбираем из выпадающего списка тревел-политику.

image-20250318-104633.png
  1. После выбора типа услуги и тревел-политики для нее необходимо нажать на “Добавить”.

image-20250318-104913.png
  1. В результате этого тревел-политика будет привязаны к услуге.

Возможно привязать несколько тревел-политик по одному типу услуг.

image-20250318-105103.png
  1. Для удаления привязки тревел-политики необходимо нажать на “Удалить” или на “Удалить все записи”.

image-20250318-105512.png

Организации

Здесь можно привязать справочник к организации, для этого переходим в “Организации”.

image-20250318-125647.png
  1. Выбираем организацию из выпадающего списка или нажимаем кнопку “Добавить все”, если нужно привязать все организации договора.

image-20250318-125825.png
  1. После выбора организации необходимо нажать на “Добавить”.

image-20250318-125942.png
  1. В результате этого код будет привязан к организации.

image-20250318-130021.png
  1. Для удаления привязки кода к организации необходимо нажать на “Удалить” или на “Удалить все записи”.

image-20250318-130135.png

2. Структурные меняемые (Справочники структурных меняемых кодов)

Структурные меняемые кода - это справочники привязанных к персоне структурных кодов, которые можно поменять "на лету".

Для создания,редактирования и удаления структурного меняемого справочника переходим в “Структурные меняемые” справочники.

image-20250318-130413.png

Страница “Справочники структурных меняемых кодов” содержит список ранее заведенных структурных меняемых справочников.

  • Для добавления нового справочника кликнуть “Создать”.

  • Для редактирования созданного ранее справочника необходимо кликнуть на него для перехода к настройке.

  • Для удаления созданных справочников необходимо кликнуть “Удалить”.

image-20250318-131052.png

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

image-20250318-131222.png
  • Название на русском - название справочника (обязательно).

  •  Название на английском - название справочника (обязательно).

  • Специальное поведение - выбираем специальное поведение из выпадающий списка (не обязательно).

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

  • Наследуется от справочника – если в этом выпадающем списке выбрано значение, то в справочник нельзя добавить коды, они берутся из того справочника, от которого данный наследует. От одного справочника можно унаследовать только один справочник-клон. Классическим примером справочника-клона является кост-центр, например, кост-центр может быть как привязан к персоне, так и выбираться при создании заказа из списка (бюджетный).

  • Тип селектора - выбираем тип селектора из выпадающего списка.

image-20250318-121652.png

Текстовое поле - если выбран данный тип селектора, то справочник будет в себе содержать “одноразовые значения”, которые пользователь указывает каждый раз заново, а не выбирает из списка (неограниченный справочник).
Кроме того, можно предусмотреть валидацию на код. Выделенный на скриншоте блок доступен в том случае, если выбрано текстовое поле.

image-20250318-123729.png

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

Список символов для написания регулярных выражений здесь

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

Автозавершение - если выбран данный тип селектора, то справочник будет содержать список кодов, которые добавляются в админке и пользователь сможет выбрать одно значение из выпадающего списка путем ввода его наименование в специальное поле, по мере ввода наименования кода пользователю будут предлагаться подходящие варианты (ограниченный справочник) - используется для справочников с БОЛЬШИМ количеством кодов.

Если в справочнике будет более 100 кодов, форма редактирования будет открываться очень долго. Для больших справочников рекомендуем использовать тип селектора «Автозавершение».

  • Очередность отображения - очередность отображения справочника.

Затем созданный справочник необходимо сохранить нажав на кнопку “Сохранить”

После сохранения справочника появляются следующие разделы:

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

  • Организации – коды будут привязаны только к персонам, которые принадлежат к данным организациям (настройка в редакторе персон). Подробно об этом здесь.

  • Типы услуг – в зависимости от настроек справочник будет появляться при оформлении заказа определенного типа услуг.

  • Зависимость от кодов – в зависимости от настроек правил показа справочник может появляться при заполнении определенного кода другого справочника или нескольких кодов, а также в случае совпадения определенных значений кодов, установленных у персон.

image-20250318-132700.png

Типы услуг справочника

Здесь можно сделать привязку справочника к “Типы услуг”.

image-20250318-160718.png
  1. Выбираем тип услуги из выпадающего списка или нажимаем кнопку “Добавить все”, если нужно привязать все типы услуг.

image-20250318-160913.png
  1. После выбора типа услуг необходимо нажать на “Добавить”.

image-20250318-161031.png
  1. В результате этого тип услуги будет привязан к организации.

image-20250318-161141.png
  1. Для удаления привязки типа услуг к организации необходимо нажать на “Удалить” или на “Удалить все записи”.

image-20250318-161324.png

Зависимость от кодов

Создаем зависимость от кодов.

image-20250318-161848.png
  1. Выбираем код из выпадающего списка.

image-20250318-162431.png
  1. После выбора кода необходимо выбрать “Разрешено” или “Запрещено” нажать на “Добавить”.

image-20250318-162618.png
  1. В результате этого создается зависимость от кодов.

image-20250318-163101.png
  1. Для удаления зависимости необходимо нажать на “Удалить” или на “Удалить все записи”.

image-20250318-163334.png

3. Бюджетные (Справочники бюджетных кодов)

Бюджетные коды – коды, которые к заказу должен привязать сам пользователь при создании заказа. Набор используемых в данном заказе бюджетных кодов определяется выбором организации-плательщика; справочники кодов должны быть привязаны к соответствующим организациям.

Связь бюджетных кодов и заказов определяется как "код, заказ".

Пример: в системе заведены справочники бюджетных кодов: СП1, СП2, СП3 и есть два юридических лица: ООО-1 и ООО-2. При этом в редакторе справочника указаны связи "СП1 – ООО-1", "СП2 – ООО-1 и ООО-2", "СП3 – ООО-2". Тогда, если при создании заказа ООО-1 будет указан в качестве плательщика, то система предоставит возможность выбрать коды из СП1 и СП2, а если ООО-2 – то из СП2 и СП3.

Создание бюджетного справочника

Для создания,редактирования и удаления справочника переходим в “Бюджетные” справочники.

image-20250318-133635.png

Страница “Справочники бюджетных кодов” содержит список ранее заведенных бюджетных справочников.

  • Для добавления нового справочника кликнуть “Создать”.

  • Для редактирования созданного ранее справочника необходимо кликнуть на него для перехода к настройке.

  • Для удаления созданных справочников необходимо кликнуть “Удалить”.

image-20250318-134219.png

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

image-20250318-134403.png
  • Название на русском - название справочника (обязательно).

  • Название на английском - название справочника (обязательно).

  • Комментарий - комментарий к справочнику в свободной форме (не обязательно).

  • Специальное поведение - выбираем специальное поведение из выпадающий списка (не обязательно).

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

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

  • Установить код выбираемый по умолчанию - переключатель.

Установить код по умолчанию можно только для типов селекторов “автозавершение” и “выпадающий список”.

  • Наследуется от справочника - если в выпадающем списке выбрано это значение, то в справочник нельзя добавить коды, так как они берутся из того справочника, от которого наследует данный. От одного справочника можно унаследовать только один справочник-клон. Классическим примером справочника-клона является кост-центр: например, кост-центр может быть как привязан к персоне, так и выбираться при создании заказа из списка (бюджетный).

  • Тип селектора - выбираем тип селектора из выпадающего списка.

image-20250318-121652.png

Текстовое поле - если выбран данный тип селектора, то справочник будет в себе содержать “одноразовые значения”, которые пользователь указывает каждый раз заново, а не выбирает из списка (неограниченный справочник).
Кроме того, можно предусмотреть валидацию на код. Выделенный на скриншоте блок доступен в том случае, если выбрано текстовое поле.

image-20250318-123729.png

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

Список символов для написания регулярных выражений здесь

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

Автозавершение - если выбран данный тип селектора, то справочник будет содержать список кодов, которые добавляются в админке и пользователь сможет выбрать одно значение из выпадающего списка путем ввода его наименование в специальное поле, по мере ввода наименования кода пользователю будут предлагаться подходящие варианты (ограниченный справочник) - используется для справочников с БОЛЬШИМ количеством кодов.

Если в справочнике будет более 100 кодов, форма редактирования будет открываться очень долго. Для больших справочников рекомендуем использовать тип селектора «Автозавершение».

  • Очередность отображения - очередность отображения справочника.

Затем созданный справочник необходимо сохранить нажав на кнопку “Сохранить”

После сохранения справочника появляются следующие разделы:

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

  • Организации – коды будут привязаны только к персонам, которые принадлежат к данным организациям (настройка в редакторе персон). Подробно об этом здесь.

  • Типы услуг – в зависимости от настроек справочник будет появляться при оформлении заказа определенного типа услуг. Подробно об этом здесь.

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

image-20250318-140040.png

4. Объяснения причин отклонений от ТП

Объяснения причин отклонений от ТП - данные коды заказчик должен указать для заказов, в которых есть нарушения ТП.

Создание справочника Объяснения причин отклонений от ТП

Для создания,редактирования и удаления справочника переходим в “Объяснения причин отклонений от ТП”.

image-20250318-140518.png

Страница “Справочники кодов объяснения причин отклонений от ТП” содержит список ранее заведенных справочников.

  • Для добавления нового справочника кликнуть “Создать”.

  • Для редактирования созданного ранее справочника необходимо кликнуть на него для перехода к настройке.

  • Для удаления созданных справочников необходимо кликнуть “Удалить”.

image-20250318-153724.png

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

image-20250318-142910.png
  • Название на русском - название справочника (обязательно).

  • Название на английском - название справочника (обязательно).

  • Комментарий - комментарий к справочнику в свободной форме (не обязательно).

  • Специальное поведение - выбираем специальное поведение из выпадающий списка (не обязательно).

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

  • Наследуется от справочника - если в выпадающем списке выбрано это значение, то в справочник нельзя добавить коды, так как они берутся из того справочника, от которого наследует данный. От одного справочника можно унаследовать только один справочник-клон. Классическим примером справочника-клона является кост-центр: например, кост-центр может быть как привязан к персоне, так и выбираться при создании заказа из списка (бюджетный).

  • Тип селектора - выбираем тип селектора из выпадающего списка.

image-20250318-121652.png

 

Текстовое поле - если выбран данный тип селектора, то справочник будет в себе содержать “одноразовые значения”, которые пользователь указывает каждый раз заново, а не выбирает из списка (неограниченный справочник).
Кроме того, можно предусмотреть валидацию на код. Выделенный на скриншоте блок доступен в том случае, если выбрано текстовое поле.

image-20250318-123729.png

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

Список символов для написания регулярных выражений здесь

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

Автозавершение - если выбран данный тип селектора, то справочник будет содержать список кодов, которые добавляются в админке и пользователь сможет выбрать одно значение из выпадающего списка путем ввода его наименование в специальное поле, по мере ввода наименования кода пользователю будут предлагаться подходящие варианты (ограниченный справочник) - используется для справочников с БОЛЬШИМ количеством кодов.

Если в справочнике будет более 100 кодов, форма редактирования будет открываться очень долго. Для больших справочников рекомендуем использовать тип селектора «Автозавершение».

  • Очередность отображения - очередность отображения справочника.

Затем созданный справочник необходимо сохранить нажав на кнопку “Сохранить”.

После сохранения справочника появляется следующий раздел:

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

  • Организации – коды будут привязаны только к персонам, которые принадлежат к данным организациям (настройка в редакторе персон). Подробно об этом здесь.

  • Типы услуг – в зависимости от настроек справочник будет появляться при оформлении заказа определенного типа услуг. Подробно об этом здесь.

  • Зависимость от кодов – в зависимости от настроек правил показа справочник может появляться при заполнении определенного кода другого справочника или нескольких кодов, а также в случае совпадения определенных значений кодов, установленных у персон.

image-20250318-153851.png

5. Отклонения от ТП (справочники нарушений ТП)

Нарушение ТП – привязаны к правилам нарушений тревел-политик. 

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

В плане редактирования, коды нарушения ТП, пожалуй, являются самыми простыми: они не имеют привязки к организациям (добавляются во все заказы с нарушением тп, не зависимо от плательщика).

Создание справочника Отклонения от ТП

Для создания,редактирования и удаления справочника переходим в “Отклонения от ТП”.

image-20250318-145240.png

Страница “Справочники нарушений ТП” содержит список ранее заведенных справочников.

  • Для добавления нового справочника кликнуть “Создать”.

  • Для редактирования созданного ранее справочника необходимо кликнуть на него для перехода к настройке.

  • Для удаления созданных справочников необходимо кликнуть “Удалить”.

image-20250318-145515.png

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

image-20250318-145703.png
  • Название на русском - название справочника (обязательно).

  • Название на английском - название справочника (обязательно).

  • Комментарий - комментарий к справочнику в свободной форме (не обязательно).

  • Специальное поведение - выбираем специальное поведение из выпадающий списка (не обязательно).

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

  • Наследуется от справочника - если в выпадающем списке выбрано это значение, то в справочник нельзя добавить коды, так как они берутся из того справочника, от которого наследует данный. От одного справочника можно унаследовать только один справочник-клон. Классическим примером справочника-клона является кост-центр: например, кост-центр может быть как привязан к персоне, так и выбираться при создании заказа из списка (бюджетный).

  • Тип селектора - выбираем тип селектора из выпадающего списка.

image-20250318-121652.png

Текстовое поле - если выбран данный тип селектора, то справочник будет в себе содержать “одноразовые значения”, которые пользователь указывает каждый раз заново, а не выбирает из списка (неограниченный справочник).
Кроме того, можно предусмотреть валидацию на код. Выделенный на скриншоте блок доступен в том случае, если выбрано текстовое поле.

image-20250318-123729.png

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

Список символов для написания регулярных выражений здесь

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

Автозавершение - если выбран данный тип селектора, то справочник будет содержать список кодов, которые добавляются в админке и пользователь сможет выбрать одно значение из выпадающего списка путем ввода его наименование в специальное поле, по мере ввода наименования кода пользователю будут предлагаться подходящие варианты (ограниченный справочник) - используется для справочников с БОЛЬШИМ количеством кодов.

Если в справочнике будет более 100 кодов, форма редактирования будет открываться очень долго. Для больших справочников рекомендуем использовать тип селектора «Автозавершение».

  • Очередность отображения - очередность отображения справочника.

Затем созданный справочник необходимо сохранить нажав на кнопку “Сохранить”.

 

После сохранения справочника появляется следующий раздел:

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

image-20250318-150349.png

В Тревел-политиках на каждое правило можно привязать свой код нарушения тревел-политики, а также в некоторых правилах внутри списка возможно выставить свой код нарушения. Указанный код будет внесен в заказ в том случае, если было нарушено правило из данного блока и данная политика применяется к одному из пассажиров в заказе.

Подробно об этом https://corteos-platform.atlassian.net/wiki/x/3f0K?atlOrigin=eyJpIjoiZTVhZTRhY2JiMzQ0NDkwMWJlYTBkZWI4MjExOGM4MzIiLCJwIjoiYyJ9

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

Список символов для написания регулярных выражений

  • [abc] – любой из перечисленных в скобках символов. Используя дефис, можно указать диапазон символов: например, [a-f]

  • то же самое, что [abcdef];

  • [^abc] – любой символ, кроме перечисленных в скобках;

  • \d – цифра. Эквивалентно [0-9];

  • \D – любой символ, кроме цифр. Эквивалентно [^0-9];

  • \w – цифра, буква (латинский алфавит) или знак подчеркивания. Эквивалентно [0-9a-zA-Z_];

  • \W – любой символ, кроме цифр, букв (латинский алфавит) и знака подчеркивания. Эквивалентно [^0-9a-zA-Z_];

  • \s – пробельный символ (пробел, табуляция, перевод строки и т. п.);

  • \S – любой символ, кроме пробельных;

  • . – любой символ, кроме перевода строки. Для поиска любого символа, включая перевод строки, можно использовать конструкцию [\s\S];

  • \ – экранирование. Например, символ "." является спецсимволом; если же нужно, чтобы он воспринимался буквально, т. е. означал именно точку, то нужно записать это так: "\." ;

  • a|b – условие "или" (a или b). Так как в данном случае с обеих сторон разделителя ровно по одному символу, то можно заменить на [ab];

  • (abc) – подвыражение. Соответствующий подвыражению текст запоминается отдельно от общего результата;

  • (?:abc) – подвыражение. Соответствующий подвыражению текст не запоминается. Используется для группировки частей образца.
    Например, "/ко(?:т|шка)/" эквивалентно "/кот|кошка/";

  • (?=abc) – поиск с "заглядыванием вперед". Срабатывает, если соответствие найдено.
    Например, "/Windows (?=95|98|NT|2000)/" найдет "Windows " в строке "Windows 98", но ничего не найдет в строке "Windows 3.1". После сопоставления поиск продолжается с позиции, следующей за найденным соответствием, без учета заглядывания вперед;

  • (?!abc) – поиск с "заглядыванием вперед". Срабатывает, если соответствие не найдено.
    Например, "/Windows (?!95|98|NT|2000)/" найдет "Windows " в строке "Windows 3.1", но ничего не найдет в строке "Windows 98". После сопоставления поиск продолжается с позиции, следующей за найденным соответствием, без учета заглядывания вперед.

Пример регулярного выражения для валидации введенной в поле даты вида "31-05-2019" (разделитель - дефис) с учетом високосных лет:

(^((((0[1-9])|([1-2][0-9])|(3[0-1]))|([1-9]))-(((0[1-9])|(1[0-2]))|([1-9]))-(([0-9]{2})|(((19)|([2]([0]{1})))([0-9]{2}))))$)

Пример регулярного выражения для валидации введенной в поле даты вида "31.05.2019" (разделитель - точка) с учетом високосных лет:

(^((((0[1-9])|([1-2][0-9])|(3[0-1]))|([1-9]))\.(((0[1-9])|(1[0-2]))|([1-9]))\.(([0-9]{2})|(((19)|([2]([0]{1})))([0-9]{2}))))$)

Подробнее о составлении регулярных выражений можно узнать в большом количестве литературы (особенно хорошо это разбирается в книгах по Perl).

Related content