Утилита умеет:

КомандаОписание
downloadСкачать справочник на сервер приложения
download-toСкачать справочник на локальную машину
scpСкопировать справочник с локальной машины на сервер приложения
updateОбновить справочник, предварительно скачанный на сервер приложения
download-outward

Скачать внешний справочник на сервер приложения

update-outwardОбновить внешний справочник, предварительно скачанный на сервер приложения

Поддерживаются справочники «Фактора»:

КодОписаниеРазмерВерсия
factor_dispemailОдноразовые адреса эл. почты2M
factor_fiasФИАС до дома1600M
factor_fiasroomsФИАС с квартирами20.9–20.12
factor_fiasfullФИАС с квартирами и зем. участками4800M21.1+
factor_flatareaПлощади квартир260M
factor_flatpriceСтоимости квартир5M
factor_geocodeГеокоординаты180M
factor_invpassportНедействительные паспорта490M
factor_oktmoОКТМО110M21.2+
factor_rossvyazСправочник Россвязи3M21.2+
factor_tldДомены верхнего уровня0M21.2+
factor_transphoneПеренесённые телефонные номера60M

Справочники «Подсказок»:

КодОписаниеРазмерВерсия
suggestions_addressАдреса России (только адм. деление)9100Mдо 22.11
suggestions_easАдреса России (адм. + мун. деление)4500M22.4+
suggestions_geo    координаты1300M
suggestions_house    дополнительные дома65M
suggestions_stead    земельные участки21.12+
suggestions_flat    квартиры21.2+
suggestions_iso3166    ISO-коды1M
suggestions_address_foreignАдреса стран мира90M23.11+
suggestions_geonamesГорода мира (кроме Белоруссии)290Mдо 23.9
suggestions_osmАдреса Белоруссии70Mдо 23.9
suggestions_fiasФИАС9100M
suggestions_bankБанки5M
suggestions_emailЭл. почта20M
suggestions_fioФИО40M
suggestions_ipIP-адреса7M
suggestions_partyКомпании19050M
suggestions_partyextКомпании
(ранжирование + реестры)
200M

Справочники «Единого клиента»:

КодОписание
cdi_egrЕГРЮЛ в плоском виде
cdi_egrnormЕГРЮЛ в нормализованном виде
cdi_egrnormincЕГРЮЛ в нормализованном виде (инкремент)

И все внешние справочники.

Скачивание справочников

Если на сервере приложения разрешён доступ к репозиторию HFLabs, для скачивания справочника достаточно команды download:

# Команды выполняются на сервере приложения

# - скачать справочники Подсказок
env/bin/fab download suggestions_bank
env/bin/fab download suggestions_email
env/bin/fab download suggestions_fio
env/bin/fab download suggestions_ip

env/bin/fab download suggestions_eas
env/bin/fab download suggestions_geo
env/bin/fab download suggestions_house
env/bin/fab download suggestions_iso3166
env/bin/fab download suggestions_geonames
env/bin/fab download suggestions_osm

env/bin/fab download suggestions_party
env/bin/fab download suggestions_partyext

# - скачать справочники Фактора
env/bin/fab download factor_geocode
env/bin/fab download factor_fias
env/bin/fab download factor_flatarea
env/bin/fab download factor_flatprice
env/bin/fab download factor_invpassport
env/bin/fab download factor_transphone

# - скачать справочники Единого клиента
env/bin/fab download cdi_egr

Если же на сервере приложения внешний доступ полностью закрыт, воспользуйтесь командами download-to и scp:

# Команды выполняются на внешней машине
# 10.0.1.34 — адрес сервера приложения

# 1) скачать справочник локально в каталог /tmp/dictionaries/email
env/bin/fab download-to suggestions_email /tmp/dictionaries/email

# 2) затем скопировать скачанный справочник на сервер приложения
env/bin/fab -H 10.0.1.34 scp suggestions_email /tmp/dictionaries/email

Обновление справочников

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

Если утилита выполняется на сервере приложения:

# Команды выполняются на сервере приложения

# - обновить справочники Подсказок
env/bin/fab update suggestions_bank
env/bin/fab update suggestions_email
env/bin/fab update suggestions_fio
env/bin/fab update suggestions_ip

env/bin/fab update suggestions_address
env/bin/fab update suggestions_flat
env/bin/fab update suggestions_stead
env/bin/fab update suggestions_geonames
env/bin/fab update suggestions_osm

env/bin/fab update suggestions_party

# - обновить справочники Фактора
env/bin/fab update factor_geocode
env/bin/fab update factor_fias
env/bin/fab update factor_flatarea
env/bin/fab update factor_flatprice
env/bin/fab update factor_invpassport
env/bin/fab update factor_transphone

# - обновить справочники Единого клиента
env/bin/fab update cdi_egr

Если утилита выполняется с внешней машины:

# Команды выполняются на внешней машине
# 10.0.1.34 — адрес сервера приложения

# - обновить справочники Подсказок
env/bin/fab -H 10.0.1.34 update suggestions_address
...

# - обновить справочники Фактора
env/bin/fab -H 10.0.1.34 update factor_geocode
...

# - обновить справочники Единого клиента
env/bin/fab -H 10.0.1.34 update cdi_egr

Скачивание и обновление внешних справочников HFLabs

Внешние справочники можно скачивать только непосредственно на сервер приложения. Если с сервера приложения нет доступа к репозиторию HFLabs, создайте каталог справочников на машине, с которой доступ есть, и подключите этот каталог на сервере приложения (по SSHFS или NFS, например).

Скачать и обновить внешний справочник (на примере справочника fms_unit):

env/bin/fab download-outward public fms_unit
env/bin/fab update-outward public fms_unit

Скачивание и обновление внешних справочников заказчика

Если внешний справочник создан заказчиком, скачать через апдейтер его не получится. Скопируйте конфигурацию и содержимое справочника на сервер «Подсказок» по инструкции.

После того, как справочник скопирован на сервер, его можно обновить командой update-outward (замените NAME на название справочника):

env/bin/fab update-outward public NAME

Проверка версии

Чтобы проверить версию утилиты, выполните команду version:

env/bin/fab version
  • Нет меток