Адресная система: различия между версиями

Материал из WiKi - UserSide
Нет описания правки
Нет описания правки
Строка 15: Строка 15:


[[Файл:20190402-13.PNG|thumb|800px|center]]
[[Файл:20190402-13.PNG|thumb|800px|center]]
== Токены адресных единиц ==
"Токены адресных единиц" используются для взаимодействия с внешними системами, для использовании в API, для работы наших модулей взаимодействия с биллингами.
Например можно в ERP "UserSide" внести типы адресных единиц "Город" и "Поселок" и обоим указать токен "city". В таком случае при взаимодействии с биллингом - адресные объекты из таких адресных единиц будут равнозначны и все считаться населенными пунктами.
Для взаимодействия конкретно с биллингами используются предустановленные токены: "province", "district", "city", "area", "street", "house".
[[Файл:2022-04-26_15-36.png|thumb|800px|center]]


== Типы адресных единиц ==
== Типы адресных единиц ==

Версия от 12:40, 26 апреля 2022

ВНИМАНИЕ: Данный раздел актуален для версий ERP "UserSide" 3.13 и выше. Для версии ниже 3.13 - используйте отдельные страницы Регионы и Настройка - Адреса.


В ERP "UserSide" большинство объектов (абоненты, узлы связи, ВОЛС и т.п.) имеют привязку к различным адресам либо могут вообще быть без адреса.

Необходимо чётко разделять понятие "Адрес/адресная единица" и "Здание/дом". Адрес - это просто название. Если угодно - табличка на здании. А здание - это цельное единое сооружение. У одного большого здания может бы множество адресов одновременно (например дом, который стоит сразу на 4 улицах). И точно также - за одним адресом может скрываться множество строений (например - имущественный комплекс, полигон или территория где множество построек).

В ERP "UserSide" мы постарались сделать поддержку всей гибкости адресных иерархий разных стран. Города могут входить в другие города, улицы включать в себя районы и т.д.

Область видимости объектов в системе зависит от доступности текущему сотруднику того или иного адресного объекта. Это, к примеру, даёт возможность запрещать сотрудникам одних населенных пунктов видеть абонентов других населенных пунктов.

Если объекты не имеют привязки к адресу, то они доступны для всех сотрудников у кого отмечен пункт "Объекты без адреса".

Токены адресных единиц

"Токены адресных единиц" используются для взаимодействия с внешними системами, для использовании в API, для работы наших модулей взаимодействия с биллингами. Например можно в ERP "UserSide" внести типы адресных единиц "Город" и "Поселок" и обоим указать токен "city". В таком случае при взаимодействии с биллингом - адресные объекты из таких адресных единиц будут равнозначны и все считаться населенными пунктами. Для взаимодействия конкретно с биллингами используются предустановленные токены: "province", "district", "city", "area", "street", "house".

Типы адресных единиц

"Настройка" => "Адреса" => "Типы адресных единиц"

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

Несмотря на то, что настройка адресной иерархии является очень гибкой, всё же для совместимости с внешними системами присутствуют базовые категории, которые можно назначать этим адресным единицам (например - улица, населенный пункт)

В поле "Шаблон наименования объектов" можно указать как будет выглядеть именование адресной единицы этого типа в системе. Как правило это в основном необходимо для зданий. Используется разметка TWIG. Например:

Адрес здания: Киев Петровский район улица Гагарина дом 25

 шаблон:
 {{ city }}, {{ street }}, {{ house }} 
 даст: Киев, Гагарина, 25
 
 шаблон: {{ street }}, {{ house }} 
 даст: Гагарина, 25
 
 шаблон: {{ city }}, {% if area %} {{ area }}, {% endif %} {{ street }}, {{ house }}
 даст: Киев, Московский р-н., Петрова, 17
 при этом - если у адресной единицы не будет вышестоящего района,то адрес будет: Киев, Гагарина, 25 (таким образом название района и запятая будет опущены)
 

В поле "Префикс" или "Постфикс" можно указать сокращённые именования типов объектов - наприимер "г.", "ул.", "д." и т.п.

Типы алиасов

"Настройка" => "Адреса" => "Типы алиасов"

Алиасы позволяют добавлять адресным единицам дополнительные именования. В частности это актуально для улиц и населённых пунктов, у которых меняются названия. Или же указывать названия на нескольких языках.

После настройки типов алиасов - в карточке адресной единицы появится возможность заполнения этих алиасов


Адресные единицы

"Настройка" => "Адреса"

В этом разделе выполняется добавление в ручном режиме адресных единиц. Также не следует забывать, что добавление новых адресных единиц возможно через "Импорт справочников", при работе модулей взаимодействия с биллингами, а также через API.

Форма создания новой адресной единицы позволяет указать её тип, наименование и привязку к родительской адресной единице

Если речь идёт о добавлении записи о здании - тогда следует остановиться на возможности указания множества адресных единиц для этого здания:

Начиная с версии 3.17 в селекторе адресов возле наименования адресного объекта добавлено отображение его типа (страна, область, город...).

Для любой адресной единицы можно выбрать координаты на карте в виде полигона либо точки

Можно выбрать следует ли отображать этот объект на карте, каким цветом, нужно ли выводить отдельную ссылку в главном меню на этот объект (очень актуально для населённых пунктов или районов).

Добавление зданий на карту покрытия

Все здания разумно размещать на карте гео-службы. Это удобно, наглядно, практично.

Прежде всего стоит ознакомиться с FAQ по этому поводу. Раздел "Карты и адреса"

Добавление здания на карту осуществляется из карточки редактирования здания (см. страницу выше).

Стоит отметить, что при добавлении здания на карту можно воспользоваться услугами служб-геокодеров (OpenStreetMap Nominatim, Yandex Geocoder)

И тогда, если адрес добавляемого здания будет известен геокодеру - он отцентрует карту на нужном месте и, возможно, предложит правильное указание полигона нужной формы, исходя из своей базы, в котором указаны конкретные координаты углов этого здания.