Адресная система: различия между версиями
Admin (обсуждение | вклад) Нет описания правки |
Нет описания правки |
||
(не показано 19 промежуточных версий 3 участников) | |||
Строка 1: | Строка 1: | ||
[[Address_system|en]] | [[Адресная_система|ru]] | |||
'''ВНИМАНИЕ: Данный раздел актуален для версий ERP "UserSide" 3.13 и выше. Для версии ниже 3.13 - используйте отдельные страницы [[Регионы]] и [[Настройка - Адреса]]. | |||
<youtube>https://youtu.be/BP5tm3ThYqI</youtube> | |||
В UserSide мы постарались сделать поддержку всей гибкости адресных иерархий разных стран. Города могут входить в другие города, улицы включать районы и т.д. | В ERP "UserSide" большинство объектов ''([[Список_абонентов|абоненты]], [[Карточка_узла_связи|узлы связи]], [[Кабельные_линии|ВОЛС]] и т.п.)'' имеют привязку к различным адресам либо могут вообще быть без адреса. | ||
Необходимо чётко разделять понятие "Адрес/адресная единица" и "Здание/дом". Адрес - это просто название. Если угодно - табличка на здании. А здание - это цельное единое сооружение. У одного большого здания может бы множество адресов одновременно ''(например дом, который стоит сразу на 4 улицах)''. И точно также - за одним адресом может скрываться множество строений ''(например - имущественный комплекс, [[Карты_покрытия|полигон]] или территория где множество построек)''. | |||
В ERP "UserSide" мы постарались сделать поддержку всей гибкости адресных иерархий разных стран. Города могут входить в другие города, улицы включать в себя районы и т.д. | |||
Область видимости объектов в системе зависит от доступности текущему сотруднику того или иного адресного объекта. Это, к примеру, даёт возможность запрещать сотрудникам одних населенных пунктов видеть абонентов других населенных пунктов. | Область видимости объектов в системе зависит от доступности текущему сотруднику того или иного адресного объекта. Это, к примеру, даёт возможность запрещать сотрудникам одних населенных пунктов видеть абонентов других населенных пунктов. | ||
Строка 11: | Строка 15: | ||
Если объекты не имеют привязки к адресу, то они доступны для всех сотрудников у кого отмечен пункт "Объекты без адреса". | Если объекты не имеют привязки к адресу, то они доступны для всех сотрудников у кого отмечен пункт "Объекты без адреса". | ||
[[Файл:20190402-12.PNG|thumb|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". | |||
== Типы адресных единиц == | == Типы адресных единиц == | ||
"Настройка" => "Адреса" => "Типы адресных единиц" | |||
В данном разделе выполняется создание типов адресных единиц - они могут совершенно произвольными - страны, континенты, улицы, проспекты, акватории и т.п. | В данном разделе выполняется создание типов адресных единиц - они могут совершенно произвольными - страны, континенты, улицы, проспекты, акватории и т.п. | ||
[[Файл: | [[Файл:Wi-Ki 107.png|thumb|800px|center]] | ||
Несмотря на то, что настройка адресной иерархии является очень гибкой, всё же для совместимости с внешними системами присутствуют базовые категории, которые можно назначать этим адресным единицам ''(например - улица, населенный пункт)'' | Несмотря на то, что настройка адресной иерархии является очень гибкой, всё же для совместимости с внешними системами присутствуют базовые категории, которые можно назначать этим адресным единицам ''(например - улица, населенный пункт)'' | ||
Строка 27: | Строка 47: | ||
[[Файл:20190402-03.PNG|thumb|800px|center]] | [[Файл:20190402-03.PNG|thumb|800px|center]] | ||
В поле "Шаблон наименования объектов" можно указать как будет выглядеть именование адресной единицы этого типа в системе. Как правило это в основном необходимо для зданий. Например: | В поле "Шаблон наименования объектов" можно указать как будет выглядеть именование адресной единицы этого типа в системе. Как правило это в основном необходимо для зданий. Используется разметка TWIG. Например: | ||
Адрес здания: Киев Петровский район улица Гагарина дом 25 | Адрес здания: Киев Петровский район улица Гагарина дом 25 | ||
Строка 37: | Строка 57: | ||
шаблон: {{ street }}, {{ house }} | шаблон: {{ street }}, {{ house }} | ||
даст: Гагарина, 25 | даст: Гагарина, 25 | ||
шаблон: {{ city }}, {% if area %} {{ area }}, {% endif %} {{ street }}, {{ house }} | |||
даст: Киев, Московский р-н., Петрова, 17 | |||
при этом - если у адресной единицы не будет вышестоящего района,то адрес будет: Киев, Гагарина, 25 (таким образом название района и запятая будет опущены) | |||
</nowiki> | </nowiki> | ||
Строка 43: | Строка 67: | ||
== Типы алиасов == | == Типы алиасов == | ||
"Настройка" => "Адреса" => "Типы алиасов" | |||
Алиасы позволяют добавлять адресным единицам дополнительные именования. В частности это актуально для улиц и населённых пунктов, у которых меняются названия. Или же указывать названия на нескольких языках. | Алиасы позволяют добавлять адресным единицам дополнительные именования. В частности это актуально для улиц и населённых пунктов, у которых меняются названия. Или же указывать названия на нескольких языках. | ||
[[Файл: | [[Файл:Wi-Ki 207.png|thumb|800px|center]] | ||
[[Файл:20190402-05.PNG|thumb|800px|center]] | [[Файл:20190402-05.PNG|thumb|800px|center]] | ||
Строка 57: | Строка 82: | ||
== Адресные единицы == | == Адресные единицы == | ||
<youtube>https://youtu.be/EojBhZ1Et34</youtube> | |||
"Настройка" => "Адреса" | |||
В этом разделе выполняется добавление в ручном режиме адресных единиц. Также не следует забывать, что добавление новых адресных единиц возможно через "[[Импорт справочников]]", при работе модулей взаимодействия с [[Поддерживаемые биллинги|биллингами]], а также через [[API]]. | В этом разделе выполняется добавление в ручном режиме адресных единиц. Также не следует забывать, что добавление новых адресных единиц возможно через "[[Импорт справочников]]", при работе модулей взаимодействия с [[Поддерживаемые биллинги|биллингами]], а также через [[API]]. | ||
[[Файл: | [[Файл: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]] | |||
Для любой адресной единицы можно выбрать координаты на карте в виде полигона либо точки | Для любой адресной единицы можно выбрать координаты на карте в виде полигона либо точки | ||
Строка 78: | Строка 109: | ||
Можно выбрать следует ли отображать этот объект на карте, каким цветом, нужно ли выводить отдельную ссылку в главном меню на этот объект ''(очень актуально для населённых пунктов или районов)''. | Можно выбрать следует ли отображать этот объект на карте, каким цветом, нужно ли выводить отдельную ссылку в главном меню на этот объект ''(очень актуально для населённых пунктов или районов)''. | ||
== | == Добавление зданий на карту покрытия == | ||
<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
ВНИМАНИЕ: Данный раздел актуален для версий 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:
В раздел "Настройка - Адреса" добавлена ссылка на просмотр и массовое удаление неиспользуемых адресов.