Интеграция с ФИАС

Репозиторий с шаблоном разработки "Интеграция с ФИАС (Открытые API-сервисы ФИАС)". Подробное описание см. в docs\Описание шаблона разработки Интеграция с ФИАС.docx.

Note

Замечания и пожеланию по развитию шаблона разработки фиксируйте через Issues. При оформлении ошибки, опишите сценарий для воспроизведения. Для пожеланий приведите обоснование для описываемых изменений - частоту использования, бизнес-ценность, риски и/или эффект от реализации.

Внимание! Изменения будут вноситься только в новые версии.

Порядок установки

Для работы требуется:

• Directum RX версии 4.10 и выше.
• Открытый доступ к API-сервисам со всех веб-серверов системы.
• Токен для предоставления доступа к API-сервисам (порядок получения описан в Условиях использования Открытых API-сервисов ФИАС, Форма заявки на подключение).

Установка для ознакомления

Склонировать репозиторий rx-template-fias в папку. Указать в _ConfigSettings.xml DDS:

<block name="REPOSITORIES">
  <repository folderName="Base" solutionType="Base" url="" />
  <repository folderName="RX" solutionType="Base" url="<адрес локального репозитория>" />
  <repository folderName="<Папка из п.1>" solutionType="Work" 
     url="https://github.com/DirectumCompany/rx-template-fias" />
</block>

Установка для использования на проекте

Возможные варианты:

A. Fork репозитория

Сделать fork репозитория rx-template-fias для своей учетной записи. Склонировать созданный в п. 1 репозиторий в папку. Указать в _ConfigSettings.xml DDS:

<block name="REPOSITORIES">
  <repository folderName="Base" solutionType="Base" url="" /> 
  <repository folderName="<Папка из п.2>" solutionType="Work" 
     url="<Адрес репозитория gitHub учетной записи пользователя из п. 1>" />
</block>

B. Подключение на базовый слой.

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

Склонировать репозиторий rx-template-fias в папку. Указать в _ConfigSettings.xml DDS:

<block name="REPOSITORIES">
  <repository folderName="Base" solutionType="Base" url="" /> 
  <repository folderName="<Папка из п.1>" solutionType="Base" 
     url="<Адрес репозитория gitHub>" />
  <repository folderName="<Папка для рабочего слоя>" solutionType="Work" 
     url="https://github.com/DirectumCompany/rx-template-fias" />
</block>

C. Копирование репозитория в систему контроля версий.

Рекомендуемый вариант для проектов внедрения.

В системе контроля версий с поддержкой git создать новый репозиторий. Склонировать репозиторий rx-template-fias в папку с ключом

--mirror.

Перейти в папку из п. 2. Импортировать клонированный репозиторий в систему контроля версий командой:

git push –mirror <Адрес репозитория из п. 1>