История страницы

Hfl
Базовый вшитый перечень настроенных справочников dictionaries.json можно глянуть в gitlab.

Значение dictionary.name для справочников Фактора, для которого

Секция

Столбец

width	30%20%

Пример для каждого продукта:

Блок кода

language	bash
title	dictionaries.json

[
  {
    "tag": "cdi_egrnorm",
    "path": "ru/hflabs/factor/dictionary/egr-cdi-norm",
    "local_path": "egr",
    "name_tmpl": "egr-cdi-norm-{metaDate}.dic",
    "task_name": "EgrDictionaryImport"
  },
  {
    "tag": "factor_flatarea",
    "path": "ru/hflabs/factor/index/index_flatArea",
    "name_tmpl": "index_flatArea-{build}-{metaDate}.idx",
    "with_build_version": true,
    "factor_name": "flatArea"
  },
   {
    "tag": "suggestions_iso3166eas",
    "path": "ru/hflabs/suggestions/iso3166dictionary/sgt-gar-eas/",
    "local_path": "address/iso3166",
    "name_tmpl": "iso3166sgt-gar-eas-{metaDate}.zip",
    "task_name": "address",
    "secondary_tags": [
            "suggestions_geo",
            "suggestions_house",
            "suggestions_iso3166"],
     "dependent_tags": [
             "suggestions_flat",
             "suggestions_stead"
  ]
  },
  {
    "tag":"rdm_bic",
    "path":"ru/hflabs/rdm/bic/",
    "dictionary_update_local_path":"bic",
    "name_tmpl":"bic-{metaDate}.csv",
    "task_name": "addressd40ec606-0b9e-451d-a419-84fee93a21e3"
  }
]

Столбец

width	70%80%

Настраиваемые параметры:

Название	Описание

Значение по

По умолчанию
`tag`	Название справочника в формате "продукт_имя". Продукт может принимать одно из

трёх

значений: cdi, factor, suggestions, rdm
`path`	Путь к директории с разными версиями этого словаря в Artifactory после значения ARTIFACTORY_PATH из конфига updater.

env

yaml
`local_path`	Путь относительно домашней директории продукта (FACTOR_DICTIONARY_HOME / SUGGESTIONS_DICTIONARY_HOME / CDI_DICTIONARY_HOME), куда нужно положить справочник. Если пустой, справочник будет размещен

прям

в

ней

корне домашней директории.
`name_tmpl`	Шаблон имени справочника. В него будет подставляться версия (в формате yyyymmdd) и, если предусмотрено, билд продукта
`with_build_version`	Используется для простановки в шаблон (name_tmpl)

билда

версии продукта в поле {build}. Сама версия запрашивается по API продукта	false
`unzip`	Требуется ли распаковка справочника после скачивания. Для всех базовых справочников ЕК, Фактора и Подсказок распаковка по умолчанию не требуется

, т

.

к. Подсказки 22.9+ умеют индексировать справочники без распаковки.

	false
`increment`

Не удалять предыдущие версии (т.е. не очищать папку).

false

depends_on

Указывает на конфиг другого словаря (обязательно должен присутствовать).

Позволяет перекрыть параметры.

Признак, указывающий на то, что данный справочник является инкрементальным (справочники компаний для ЕК и Подсказок)	false
`task_name`	Название

задачи в Едином клиенте / Едином адресе, которую надо вызвать через API во время команды update

сервиса/задачи, которые будут инициированы по API для обновления справочника.

Указывается в зависимости от продукта:

для Фактор — значение dictionary.name (

EgrDictionaryImport

factor_name

будет запущено через API горящее обновление справочника)
для ЕК/ЕА — название задачи (напр EgrDictionaryImport), которую надо вызвать через API во время команды

update

dictionary_update_task_name

Переопределение названия справочника в команде update для API Подсказок.

upload
для Подсказок — значение names (префикс названия сервиса обновления справочника)

external

Определяет, является ли справочник внешним, влияет на update и unzip.

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

false

custom_artifactory_path

Определяет кастомный путь в артифактори, применяется только для этого словаря. Пока экспериментальная настройка


`secondary_tags`	Список вспомогательных справочников, которые будут скачаны автоматически при загрузке основного. Например: suggestions_eas или suggestions_party (для него вспомогательный suggestions_partyext обязательный, поэтому по умолчанию всегда загружаются вместе)
`dependent_tags`	Список зависимых справочников, которые не нужно скачивать отдельно (они упакованы в основной), но для их загрузки в продукт нужно вызывать отдельный сервис
`depends_on`	Указывает на то, от какого справочника зависит текущий, предназначен для зависимых справочников, таких как suggestions_flat и suggestions_stead Для внутренних настроек.
`secondary_on`	Указывает на то, от какого справочника зависит текущий, предназначен для вспомогательных справочников, таких как suggestions_geo, suggestions_house, suggestions_iso3166 Для внутренних настроек.

Дерево страниц

Сравнение версий

Старая версия 2

Новая версия Текущий

Ключ