Массовая загрузка маршрутов

Этот перевод выполнен автоматически и ещё не вычитан. Читать английскую версию

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

Где найти

Откройте 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`, чтобы добавить его

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