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

Материал из WiKi - UserSide
Нет описания правки
Нет описания правки
 
(не показано 25 промежуточных версий 3 участников)
Строка 1: Строка 1:
'''ВНИМАНИЕ: Данный раздел актуален для версий ERP "UserSide" 3.13 и выше. Для версии ниже 3.13 - используйте отдельную страницу [[Регионы]].
[[Address_system|en]] | [[Адресная_система|ru]]


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


В UserSide мы постарались сделать поддержку всей гибкости адресных иерархий разных стран. Города могут входить в другие города, улицы включать районы и т.д.
<youtube>https://youtu.be/BP5tm3ThYqI</youtube>


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


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


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


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


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


[[Файл:2013_04_24_16_00_04.png|center]]
[[Файл: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".


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


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


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


[[Файл:20190402-02.PNG|thumb|800px|center]]
[[Файл:Wi-Ki 107.png|thumb|800px|center]]


Несмотря на то, что настройка адресной иерархии является очень гибкой, всё же для совместимости с внешними системами присутствуют базовые категории, которые можно назначать этим адресным единицам ''(например - улица, населенный пункт)''  
Несмотря на то, что настройка адресной иерархии является очень гибкой, всё же для совместимости с внешними системами присутствуют базовые категории, которые можно назначать этим адресным единицам ''(например - улица, населенный пункт)''  
Строка 29: Строка 47:
[[Файл:20190402-03.PNG|thumb|800px|center]]
[[Файл:20190402-03.PNG|thumb|800px|center]]


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


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


Строка 45: Строка 67:
== Типы алиасов ==
== Типы алиасов ==


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


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


[[Файл:20190402-04.PNG|thumb|800px|center]]
[[Файл:Wi-Ki 207.png|thumb|800px|center]]
 
[[Файл:20190402-05.PNG|thumb|800px|center]]
[[Файл:20190402-05.PNG|thumb|800px|center]]


Строка 59: Строка 82:
== Адресные единицы ==
== Адресные единицы ==


''Настройка - Адреса''
<youtube>https://youtu.be/EojBhZ1Et34</youtube>
 
"Настройка" => "Адреса"


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


[[Файл:20190402-10.PNG|thumb|800px|center]]
[[Файл:Wi-Ki107.png|thumb|800px|center]]
 
Форма создания новой адресной единицы позволяет указать её тип, наименование и привязку к родительской адресной единице
[[Файл:20190402-11.PNG|thumb|800px|center]]
[[Файл:20190402-11.PNG|thumb|800px|center]]
Если речь идёт о добавлении записи о здании - тогда следует остановиться на возможности указания множества адресных единиц для этого здания:
[[Файл:20190402-09.PNG|thumb|800px|center]]
[[Файл:20190402-09.PNG|thumb|800px|center]]
[[Файл:20190402-08.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]]
[[Файл: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:

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