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

Материал из WiKi - UserSide
(Новая страница: «В САП "UserSide" большинство объектов относятся к различным адресам. Об…»)
 
Нет описания правки
 
(не показаны 34 промежуточные версии 3 участников)
Строка 1: Строка 1:
В САП "UserSide" большинство объектов относятся к различным [[Настройка - Адреса|адресам]].
[[Address_system|en]] | [[Адресная_система|ru]]


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


Населенные пункты могут быть как самостоятельными городами, так и районными/областными центрами. Доступ к населенным пунктам регулируется их иерархическим подчинением районам и областям.
<youtube>https://youtu.be/BP5tm3ThYqI</youtube>


Область видимости объектов зависит от доступности текущему оператору того или иного населенного пункта/района/области. Это, к примеру, даёт возможность запрещать операторам одних населенных пунктов видеть абонентов других населенных пунктов.
В ERP "UserSide" большинство объектов ''([[Список_абонентов|абоненты]], [[Карточка_узла_связи|узлы связи]], [[Кабельные_линии|ВОЛС]] и т.п.)'' имеют привязку к различным адресам либо могут вообще быть без адреса.


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


[[Файл:2013_04_24_16_00_04.png|center]]
В ERP "UserSide" мы постарались сделать поддержку всей гибкости адресных иерархий разных стран. Города могут входить в другие города, улицы включать в себя районы и т.д.


== Настройка адресов ==
Область видимости объектов в системе зависит от доступности текущему сотруднику того или иного адресного объекта. Это, к примеру, даёт возможность запрещать сотрудникам одних населенных пунктов видеть абонентов других населенных пунктов.
# [[Настройка - Карты покрытия]] - добавляем карты, где работает предприятие
# [[Настройка - Адреса]] - составляем список всех областей/районов/населенных пунктов, где работает предприятие и указываем привязку карт к населенным пунктам
# [[Учетные записи|Операторы - Учетные записи]] - настраиваем доступ для операторов к нужным им географических объектам
# [[Сотрудники|Персонал - сотрудники]] - для каждого сотрудника указываем в каких населенных пунктах он работает
# [[Карточка абонента]] - для каждого абонента должен быть указан адрес дома
# [[Узлы связи|Узел связи]] - узлы связи/муфты/опоры/колодцы прикрепляются либо к населенному пункту напрямую, либо к конкретному дому


Таким образом - каждый конкретный абонент (или узел связи) соотносится населенному пункту и к нему имеют доступ только операторы, у которых разрешена работа с данным населенным пунктом.
Если объекты не имеют привязки к адресу, то они доступны для всех сотрудников у кого отмечен пункт "Объекты без адреса".
 
[[Файл:20190402-12.PNG|thumb|800px|center]]
 
[[Файл:20190402-13.PNG|thumb|800px|center]]
 
<br>
'''Начиная с версии 3.18:'''
 
<span id="anchor_318_75">В форме редактирования адресной единицы в селекторе типа адреса выводится кроме названия типа ещё и его токен.</span>
 
[[Файл:2023-04-24_20-38.png|thumb|800px|center]]
 
== Токены адресных единиц ==
 
"Токены адресных единиц" используются для взаимодействия с внешними системами, для использовании в API, для работы модулей взаимодействия с биллингами.
 
[[Файл:2022-04-26_15-36.png|thumb|800px|center]]
 
Например можно в ERP "UserSide" внести типы адресных единиц "Город" и "Поселок" и обоим указать токен "city". В таком случае при взаимодействии с биллингом - адресные объекты из таких адресных единиц будут равнозначны и все считаться населенными пунктами.
Для взаимодействия конкретно с биллингами используются предустановленные токены: "province", "district", "city", "area", "street", "house".
 
== Типы адресных единиц ==
 
"Настройка" => "Адреса" => "Типы адресных единиц"
 
В данном разделе выполняется создание типов адресных единиц - они могут совершенно произвольными - страны, континенты, улицы, проспекты, акватории и т.п.
 
[[Файл:Wi-Ki 107.png|thumb|800px|center]]
 
Несмотря на то, что настройка адресной иерархии является очень гибкой, всё же для совместимости с внешними системами присутствуют базовые категории, которые можно назначать этим адресным единицам ''(например - улица, населенный пункт)''
 
[[Файл:20190402-03.PNG|thumb|800px|center]]
 
В поле "Шаблон наименования объектов" можно указать как будет выглядеть именование адресной единицы этого типа в системе. Как правило это в основном необходимо для зданий. Используется разметка TWIG. Например:
 
Адрес здания: Киев Петровский район улица Гагарина дом 25
<nowiki>
шаблон:
{{ city }}, {{ street }}, {{ house }}
даст: Киев, Гагарина, 25
шаблон: {{ street }}, {{ house }}
даст: Гагарина, 25
шаблон: {{ city }}, {% if area %} {{ area }}, {% endif %} {{ street }}, {{ house }}
даст: Киев, Московский р-н., Петрова, 17
при этом - если у адресной единицы не будет вышестоящего района,то адрес будет: Киев, Гагарина, 25 (таким образом название района и запятая будет опущены)
</nowiki>
 
В поле "Префикс" или "Постфикс" можно указать сокращённые именования типов объектов - наприимер "г.", "ул.", "д." и т.п.
 
== Типы алиасов ==
 
"Настройка" => "Адреса" => "Типы алиасов"
 
Алиасы позволяют добавлять адресным единицам дополнительные именования. В частности это актуально для улиц и населённых пунктов, у которых меняются названия. Или же указывать названия на нескольких языках.
 
[[Файл:Wi-Ki 207.png|thumb|800px|center]]
 
[[Файл:20190402-05.PNG|thumb|800px|center]]
 
После настройки типов алиасов - в карточке адресной единицы появится возможность заполнения этих алиасов
 
[[Файл:20190402-06.PNG|thumb|800px|center]]
 
 
== Адресные единицы ==
 
<youtube>https://youtu.be/EojBhZ1Et34</youtube>
 
"Настройка" => "Адреса"
 
В этом разделе выполняется добавление в ручном режиме адресных единиц. Также не следует забывать, что добавление новых адресных единиц возможно через "[[Импорт справочников]]", при работе модулей взаимодействия с [[Поддерживаемые биллинги|биллингами]], а также через [[API]].
 
[[Файл:Wi-Ki107.png|thumb|800px|center]]
 
Форма создания новой адресной единицы позволяет указать её тип, наименование и привязку к родительской адресной единице
[[Файл:20190402-11.PNG|thumb|800px|center]]
 
Если речь идёт о добавлении записи о здании - тогда следует остановиться на возможности указания множества адресных единиц для этого здания:
 
[[Файл:20190402-09.PNG|thumb|800px|center]]
 
[[Файл:20190402-08.PNG|thumb|800px|center]]
 
<span id="anchor_317_124">Начиная с версии 3.17 в селекторе адресов возле наименования адресного объекта добавлено отображение его типа (страна, область, город...).</span>
 
[[Файл:2022-04-11_15-44.png|thumb|800px|center]]
 
Для любой адресной единицы можно выбрать координаты на карте в виде полигона либо точки
 
[[Файл:20190402-07.PNG|thumb|800px|center]]
 
Можно выбрать следует ли отображать этот объект на карте, каким цветом, нужно ли выводить отдельную ссылку в главном меню на этот объект ''(очень актуально для населённых пунктов или районов)''.
 
== Добавление зданий на карту покрытия ==
 
<youtube>https://youtu.be/c9GGSinDag8</youtube>
 
Все здания разумно размещать на карте гео-службы. Это удобно, наглядно, практично.
 
[[Файл:20190402-14.PNG|thumb|800px|center]]
 
Прежде всего стоит ознакомиться с FAQ по этому поводу. Раздел "[[Частые вопросы#Карты и адреса|Карты и адреса]]"
 
Добавление здания на карту осуществляется из карточки редактирования здания ''(см. страницу выше)''.
 
Стоит отметить, что при добавлении здания на карту можно воспользоваться услугами служб-геокодеров ''(OpenStreetMap Nominatim, Yandex Geocoder)''
 
[[Файл:Wi-Ki 307.png|thumb|800px|center]]
 
И тогда, если адрес добавляемого здания будет известен геокодеру - он отцентрует карту на нужном месте и, возможно, предложит правильное указание полигона нужной формы, исходя из своей базы, в котором указаны конкретные координаты углов этого здания.
 
== Удаление неиспользуемых адресов ==
 
'''Начиная с версии 3.18:'''
 
<span id="anchor_318_69">В раздел "Настройка - Адреса" добавлена ссылка на просмотр и массовое удаление неиспользуемых адресов.</span>
 
[[Файл:2023-04-24_20-20.png|thumb|800px|center]]

Текущая версия от 19:35, 24 апреля 2023

en | ru

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

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

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

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

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

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


Начиная с версии 3.18:

В форме редактирования адресной единицы в селекторе типа адреса выводится кроме названия типа ещё и его токен.

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

"Токены адресных единиц" используются для взаимодействия с внешними системами, для использовании в 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)

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

Удаление неиспользуемых адресов

Начиная с версии 3.18:

В раздел "Настройка - Адреса" добавлена ссылка на просмотр и массовое удаление неиспользуемых адресов.