Описание #

Сервис Wialon Transfer предназначен для переноса из Wialon Hosting и Wialon Local в Axenta следующих сущностей системы мониторинга:

• Объекты с историей сообщений (до 1200 дней)
• Геозоны
• Водителей
• Пользователей

Сервис позволяет запускать одновременно перенос элементов из нескольких учетных записей.

Порядок действий #

Перейти по ссылке https://transfer.axenta.cloud/.

Ввести имя пользователя и пароль от системы Axenta и нажать кнопку «Войти».

В поле «Wialon Token» указать токен от учетной записи Wialon, из которой будет осуществляться перенос элементов системы.

Добавить токен в это поле можно 2 способами:

1. Получить токен по инструкции из системы Wialon — https://wialon-help.link/fd546d04, вставить его в это поле и нажать кнопку «Проверить токен». В случае успеха появится надпись «Токен валиден».

2. Получить токен автоматически. Для этого необходимо нажать кнопку «Получить токен».

Далее ввести логин и пароль от системы Wialon и нажать кнопку «Войти».

Токен автоматически заполнится и пройдет проверку.

По умолчанию сервис настроен на подключение к Wialon Hosting. Если перенос будет осуществляться с локальной версии, то перед получением и проверкой токена необходимо изменить URL (заменить доменную часть hst-api.wialon.com).

Если в системе Wialon для указанного токена есть дочерние учетные записи с правами дилера, то они будут отображаться в блоке «Субпартнерские учетные записи Wialon». Если выбрать какую-то из этих учетных записей, то для переноса будет доступно только ее содержимое (клиентские учетные записи или отдельные сущности). Если ничего не выбирать, то для переноса будут доступны только клиентские учетные записи, добавленные напрямую в верхнюю учетную запись (или их отдельные сущности).

Далее необходимо выбрать учетную запись в Axenta, в которую будет осуществляться перенос.

Если установить чек-бокс «Перенести данные в мою учетную запись (партнера)», то все перенесется в текущую учетную запись, под которой был произведен вход в Wialon Transfer.

По умолчанию чек-бокс не установлен. В этом случае необходимо выбрать учетную запись из списка. При необходимости можно воспользоваться поиском.

Далее необходимо выбрать Режим переноса. Их два: «Только сущности» и «Полный перенос».

В режиме «Только сущности» можно переносить отдельные объекты, геозоны, водителей и пользователей.

Для этого необходимо установить чек-бокс, выделить все или несколько сущностей в левом списке и нажать кнопку «Добавить». Выбранные сущности переместятся в правый список и будут перенесены после запуска задачи.

Для объектов дополнительно необходимо указать период загрузки сообщений в днях (за сколько дней относительно текущей даты перенесутся сообщения). Или можно снять чек-бокс, в этом случае объекты перенесутся без истории сообщений.

В режиме «Полный перенос» можно переносить клиентские учетные записи. В этом случае переносятся все объекты, геозоны, пользователи и водители каждой учетки (без возможности выбора).

Для этого необходимо установить чек-бокс, выделить все или несколько учетных записей в левом списке и нажать кнопку «Добавить». Выбранные учетные записи переместятся в правый список и будут перенесены после запуска задачи.

После выбора сущностей или учетных записей для переноса необходимо нажать кнопку «Запустить перенос».

После этого автоматически откроется вкладка «Мои задачи», в которой можно посмотреть список запущенных и выполненных задач.

По каждой задаче можно посмотреть логи, в которых отражен весь процесс переноса.

Важная информация #

1. В режиме «Полный перенос» в рамках одной задачи все клиентские учетные записи можно перенести только в одну учетную запись в системе Axenta. Проще говоря, в рамках одной задачи можно перенести клиентов только одного интегратора. Если у вас сложная иерархия учетных записей с наличием субдиллеров, которые в свою очередь могут иметь своих субдиллеров и клиентов, то каждого такого интегратора (субдиллера) необходимо запускать отдельную задачу.

2. После переноса количество сообщений в Wialon и Axenta могут не совпадать. Это связано с тем, что в системе Wialon допускаются сообщения с одинаковой меткой времени. В системе Axenta задублированные по времени сообщения не разрешены. В связи с этим разница в сообщениях может достигать до 10%.

3. При переносе геозон и водителей проверяется уникальность названия. Т.е. нельзя перенести две геозоны или двух водителей в одну учетную запись с одинаковым названием. Перед переносом рекомендуется изменить названия. Это сделано для того, чтобы при повторном переносе геозоны и водители не продублировались.

4. При переносе учетных записей и пользователей для них генерируются новые пароли. Их можно посмотреть в логе по задаче, если отфильтровать их по признаку «ACCESSES». Для администраторов учетных записей пароли дополнительно сохраняются в поле «Комментарий» в CMS.

5. В системе Axenta при создании пользователя в логине допускаются следующие (указанные в скобках) спецсимволы — (@ . _ + -). Остальные запрещены. Пользователь с другими спецсимволами в логине будет создан, но сами спецсимволы при этом будут удалены из логина.

6. В системе Wialon на объект могут быть выданы права доступа пользователям из разных учетных записей. В системе Axenta доступ к объекту может быть предоставлен только в рамках одной учетной записи. Соответственно при переносе объекта в Axenta он будет создан в первой по порядку учетной записи, в которой в системе Wialon был доступ к этому объекту. Во избежание подобной ситуации перед переносом рекомендуется в системе Wialon оставить доступ к этому объекту только для одной учетной записи.

7. Периодически в логах можно увидеть ошибку с кодом 1003. Эта ошибка возникает из-за лимитов на обращение к API системы Wialon. В случае такой ошибки Wialon Transfer повторно выполняет запрос, гарантируя получение необходимых данных.

8. Если объекты были перенесены без сообщений (не был установлен чек-бокс), то загрузить сообщения можно через отдельную задачу. Для этого необходимо сделать такие же настройки и запустить перенос. В логах будут ошибки, указывающие на то, что объекты с таким уникальным ID уже есть в системе, но сообщения при этом перенесутся.