# Инструкции по Synergy KATO

## О классификаторе КАТО

КАТО (классификатор административно-территориальных объектов) устанавливает структуру, порядок ведения и коды административно-территориальных объектов Республики Казахстан. Как правило, КАТО используется для определения местоположения объекта с точностью до области, района и населенного пункта.

Источник классификатора КАТО, который используется в данном приложении - Комитет по статистике Министерства национальной экономики Республики Казахстан:

- сайт Комитета: https://stat.gov.kz/
- страница с классификаторами: https://stat.gov.kz/important/classifier
- прямая ссылка на КАТО в формате Excel: https://stat.gov.kz/api/getFile/?docId=ESTAT343047

Классификатор, скачанный с данного источника, представляет собой архив, содержащий, как правило, 2 файла Excel.

Уведомления о выходе новых версий КАТО отсутствуют, следить за обновлениями классификатора и актуализировать значения в нем нужно самостоятельно.

Важно

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

## Установка приложения

Важно

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

### Предварительные шаги

1. Установить самую актуальную версию платформы Arta Synergy, не менее версии 4.1 minsky.
2. При необходимости, в подсистеме администрирования обновить базу данных и процессы.
3. Завести Системного пользователя:
   - с произвольными логином/паролем;
   - с доступом в систему;
   - с ролью «Разработчик Synergy»;
   - назначенный на произвольную должность.

### Процесс установки

Synergy KATO устанавливается отдельным пакетом. Варианты установки отсутствуют - загружается конфигурация Synergy, а также все значения данного классификатора в соответствующий реестр. При этом имеющиеся в Системе данные не удаляются.

Внимание

Т.к. значений в КАТО порядка 20 000, установка может занять продолжительное время.

Установочный пакет находится в репозитории extensions. В файле `/etc/apt/sources.list` необходимо добавить либо раскомментировать следующую строку:

>     deb http://deb.arta.kz/tengri extensions main contrib non-free

Для установки приложения необходимо выполнить команду:

>     # apt-get update
>     # apt-get install arta-synergy-extensions-kato

В ходе установки необходимо выполнить следующее:

- Указать URL до Synergy, на котором производится работа (например: http://192.168.4.247:8080/Synergy):

  > Рис. Ввод synergy URL

- Ввести последовательно логин и пароль Системного пользователя:

  > Рис. Ввод логина

  > Рис. Ввод пароля

- Дождаться окончания загрузки данных.

## Обновление приложения

Важно

Из-за особенностей распространения классификатора, процесс обновления его значений не автоматизирован. В данной инструкции описан вариант полного обновления всех значений КАТО.

### Предварительные шаги

1. Установить наиболее актуальную версию приложения для импорта данных из Excel из пакета `Customers` в режиме `Manual` по инструкции.
2. Иметь Системного пользователя:
   - с произвольными логином/паролем;
   - с доступом в систему;
   - с ролью «Разработчик Synergy»;
   - назначенный на произвольную должность.
3. Скачать и распаковать из архива наиболее актуальную версию КАТО с официального источника.

### Процесс обновления

Во-первых, используя механизм массовых действий, удалите все записи реестра КАТО:

- открыть Конфигуратор `%server_name%/Configurator`;
- открыть реестр КАТО с кодом `kato`;
- нажать кнопку «Управление записями»;
- выбрать массовое действие - «Удаление»;
- прочие настройки оставить по умолчанию;
- нажать кнопку «Запустить»;
- дождаться окончания процесса.

Во-вторых, используя механизм импорта, загрузить в реестр КАТО актуальную версию классификатора:

- открыть приложение импорта `%server_name%/import`;
- код формы и реестра - `kato`;
- логин и пароля от Системного пользователя;
- прочие настройки оставить по умолчанию;
- нажать кнопку «Выбрать файл» и выбрать распакованный файл Excel с КАТО;
- нажать кнопку «Импортировать»;
- дождаться окончания процесса.

Если файлов Excel с КАТО несколько - повторить процесс импорта для каждого такого файла.

## Как использовать КАТО

После установки в Конфигураторе добавится новое приложение `kato`, которое включает:

- форму с кодом `kato`;
- реестр с кодом `kato`;
- пользовательский компонент с кодом `kato`.

Для того, чтобы использовать КАТО, необходимо:

- во-первых, переместить все 3 объекта конфигурации в нужное приложение;
- во-вторых, добавить пользовательский компонент во необходимые формы, а в настройках компонента выбрать КАТО.

Готово.

Пользовательский компонент КАТО представляет собой выпадающий список, в котором доступен выбор объектов двумя способами:

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

Read the Docs v: latest

Versions
  latest

Downloads
  pdf
  docx
  htmlzip
  epub

On Read the Docs
  Project Home
  Builds

Free document hosting provided by Read the Docs.