Масове завантаження маршрутів

Цей переклад зроблено автоматично і ще не вичитано. Читати англійську версію

Прайс-лист вендора часто містить тисячі префіксів, а ціни змінюються щотижня. Замість того щоб редагувати маршрути по одному, ви вивантажуєте маршрути маршруту термінації у файл, змінюєте його в редакторі таблиць і завантажуєте назад. Кожен рядок містить дію, яка вказує, чи додати, оновити або видалити маршрут. Так само працюють і ставки ваших тарифів.

Де знайти

Відкрийте Vendors → Termination Routes, натисніть Routes (маршрути) у рядку маршруту термінації вендора й скористайтеся кнопками Download (вивантажити) і Upload (завантажити) над списком. URL - /routes.php?i_destination_set=<id>. Для завантаження потрібне право редагування у вашому рівні доступу. Див. Маршрути термінації.

Screenshot "admin-panel/routes-upload-mapping" has not been generated yet — see scripts/screenshots/screens.yml.

Що ви бачите

Download експортує маршрути, що відповідають поточному фільтру, у CSV чи Excel, у вашому форматі вивантаження. Файл має такі колонки:

Колонка	Значення
`Action [A\|D\|U\|S\|SA]`	Що зробити з рядком під час завантаження. У вивантаженому файлі порожня; рядок із порожньою дією пропускається
`Id`	ID маршруту. Потрібен для `U` і `D`; для нових рядків залиште порожнім
`Prefix`	Префікс напрямку. Літери, цифри, `_` і `#`. Кілька префіксів через кому в одному рядку застосовуються по одному для `A`, `S` і `SA`
`Country`	Експортується для довідки, під час завантаження ігнорується
`Preference`	Preference (пріоритет) маршруту; `5`, якщо колонку не зіставлено
`Interval 1`, `Interval N`	Інтервали тарифікації в секундах
`Price 1`, `Price N`	Ціна вендора за хвилину для першого й наступних інтервалів
`1xx Timeout`, `2xx Timeout`	Тайм-аути маршруту в секундах; `10` і `60`, якщо не зіставлено
`Huntstop`, `Forbidden`	`1` або `0`
`Activation Date`	Коли маршрут починає діяти: дата й час або `now`. Не може бути в минулому
`Expiration Date`	Коли маршрут припиняє діяти: дата й час або `never`. Порожнє значення означає `never`

Маршрут термінації з увімкненим Local Calling (місцеві дзвінки) додає Area/State Name, Local Interval 1, Local Interval N, Local Price 1 і Local Price N.

Завантаження прайс-листа

Натисніть Download, щоб отримати поточні маршрути. Для нового маршруту термінації спершу додайте один маршрут вручну й вивантажте його як шаблон.
Відкрийте файл у редакторі таблиць і впишіть дію в першу колонку кожного рядка, який потрібно змінити, як описано нижче. Нові рядки додавайте в кінці з A.
Збережіть файл як .csv або .xlsx.
Натисніть Upload і виберіть файл. Відкривається Map CSV Columns (зіставлення колонок CSV).
Перевірте, що кожне поле зіставлено з правильною колонкою. Prefix і Price N обов’язкові. Для незіставленого поля задайте значення за замовчуванням, а щоб масштабувати ціни, задайте для них Multiplier (множник), наприклад 1.05 для 5%.
Натисніть Import (імпортувати).
Дочекайтеся завершення завдання. Рядок статусу показує Uploading (завантаження), потім Processed (оброблено) з відсотком і Finished on (завершено) з часом. До цього маршрут термінації заблоковано для змін.
Натисніть Get report. (отримати звіт), коли статус показує with errors (з помилками). Звіт містить рядки, які не вдалося обробити, кожен із колонкою Error Message.

Власний файл вендора можна завантажити напряму, без кроку вивантаження: зіставте його колонки в діалозі й установіть дію за замовчуванням A — Add або AS — Add or Update.

Дії

Дія	Що робить
`A`	Додає новий маршрут. Якщо для префікса вже є безстроковий маршрут, новий має починатися пізніше; старий закривається на цю дату
`U`	Оновлює маршрут із цим `Id`
`S`	Оновлює поточний маршрут із цим `Prefix`
`SA` (або `AS`)	Оновлює маршрут із цим `Prefix`, якщо він є, інакше додає його
`D`	Видаляє маршрут із цим `Id`

Порядок літер не має значення: SA і AS - це та сама дія.

Дати під час оновлення

Активний маршрут зберігає свою Activation Date (дата активації): для U і S значення у файлі ігнорується для маршрутів, які вже діють. Щоб змінити ціну активного маршруту з певної дати, додайте для префікса новий маршрут з A і цією Activation Date або задайте Expiration Date (дата закінчення дії) для старого. Маршрут, що припинив дію, змінити не можна. Див. Дати активації й закінчення дії.

Помилки

Звіт перелічує кожен рядок, який не вдалося обробити, з причиною. Типові:

Повідомлення	Як виправити
`"Prefix" field has incorrect format.`	Приберіть із префікса пробіли, `+` та інші символи
`"Activation Date" cannot be in the past.`	Для нових маршрутів використовуйте `now` або майбутню дату
`Another Route with conflicting "Prefix" or "Activation/Expiration Date" already exists.`	Для префікса вже є маршрут на цей період: оновіть його за допомогою `S` або задайте новому маршруту пізнішу дату активації
`Unrecognized Action.`	Використовуйте одну з дій `A`, `U`, `S`, `SA`, `D`
`No such Id.`	`Id` належить іншому маршруту термінації або маршрут видалено: вивантажте файл знову
`No such Prefix.`	`S` не знайшла активного маршруту для префікса: використовуйте `SA`, щоб додати його

Виправляйте невдалі рядки у своєму вихідному файлі, а не у звіті. Очистьте дію в рядках, які оброблено успішно, щоб вони не застосувалися двічі, і завантажте файл знову.