Утилита умеет:
| Команда | Описание |
|---|---|
| download | Скачать справочник на сервер приложения |
| download-to | Скачать справочник на локальную машину |
| scp | Скопировать справочник с локальной машины на сервер приложения |
| update | Обновить справочник, предварительно скачанный на сервер приложения |
| download-outward | Скачать внешний справочник на сервер приложения |
| update-outward | Обновить внешний справочник, предварительно скачанный на сервер приложения |
Поддерживаются справочники «Фактора»:
| Код | Описание | Размер | Версия |
|---|---|---|---|
| factor_dispemail | Одноразовые адреса эл. почты | 2M | |
| factor_fias | ФИАС до дома | 1600M | |
| factor_fiasrooms | ФИАС с квартирами | — | 20.9–20.12 |
| factor_fiasfull | ФИАС с квартирами и зем. участками | 4800M | 21.1+ |
| factor_flatarea | Площади квартир | 260M | |
| factor_flatprice | Стоимости квартир | 5M | |
| factor_geocode | Геокоординаты | 180M | |
| factor_invpassport | Недействительные паспорта | 490M | |
| factor_oktmo | ОКТМО | 110M | 21.2+ |
| factor_rossvyaz | Справочник Россвязи | 3M | 21.2+ |
| factor_tld | Домены верхнего уровня | 0M | 21.2+ |
| factor_transphone | Перенесённые телефонные номера | 60M |
Справочники «Подсказок»:
| Код | Описание | Размер | Версия |
|---|---|---|---|
| suggestions_address | Адреса России (только адм. деление) | 9100M | до 22.11 |
| suggestions_eas | Адреса России (адм. + мун. деление) | 4500M | 22.4+ |
| suggestions_geo | координаты | 1300M | |
| suggestions_house | дополнительные дома | 65M | |
| suggestions_stead | земельные участки | — | 21.12+ |
| suggestions_flat | квартиры | — | 21.2+ |
| suggestions_iso3166 | ISO-коды | 1M | |
| suggestions_address_foreign | Адреса стран мира | 90M | 23.11+ |
| suggestions_geonames | Города мира (кроме Белоруссии) | 290M | до 23.9 |
| suggestions_osm | Адреса Белоруссии | 70M | до 23.9 |
| suggestions_fias | ФИАС | 9100M | |
| suggestions_bank | Банки | 5M | |
| suggestions_email | Эл. почта | 20M | |
| suggestions_fio | ФИО | 40M | |
| suggestions_ip | IP-адреса | 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, создайте каталог справочников на машине, с которой доступ есть, и подключите этот каталог на сервере приложения (по 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 |