Массовая загрузка и даты активации

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

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

Как это работает

Скачайте список. Кнопка Download (выгрузить) на экране списка экспортирует строки, соответствующие текущему фильтру, в CSV или Excel в зависимости от формата скачивания вашего веб-пользователя. Первый столбец - Action, второй - Id, далее идут поля объекта.
Отредактируйте файл. Поставьте код действия в столбец Action каждой строки, которую хотите изменить. Строки с пустым Action игнорируются, так что остальную часть файла можно не трогать. Новые строки добавляйте под существующими с пустым Id; коммутатор назначит его сам.
Загрузите файл. Кнопка Upload (загрузить) принимает файл .csv или .xlsx. На экранах ставок и маршрутов сначала открывается Map CSV Columns (сопоставление столбцов CSV), где вы сопоставляете столбцы любого прайс-листа с полями и выбираете действие по умолчанию. См. Ставки и Маршруты терминации.
Примените изменения. Каждая строка проверяется и применяется отдельно. Строки, прошедшие проверку, сохраняются; строки с ошибками возвращаются вам с сообщением об ошибке. Ставки и маршруты обрабатывает фоновое задание, которое блокирует тариф или маршрут терминации до своего завершения, а затем показывает Get report. (получить отчёт) для строк с ошибками. Другие экраны отвечают сразу: количеством добавленных, обновлённых и удалённых строк или файлом со строками, которые не прошли.
Исправьте и повторите. Исправьте строки с ошибками в своём файле, а не в отчёте об ошибках, и загрузите их снова.

Коды действий

Код	Название	Что делает
`A`	Add (добавить)	Создаёт новый объект из строки. Столбец `Id` игнорируется
`U`	Update (обновить)	Изменяет объект с указанным `Id`. Записывается каждый столбец строки, так что оставьте значения, которые не хотите менять
`D`	Delete (удалить)	Удаляет объект с указанным `Id` независимо от его дат
`S`	Update by prefix (обновить по префиксу)	Как `U`, но находит ставку или маршрут по `Prefix`, а не по `Id`: тот, что действует сейчас
`AS`	Add or update (добавить или обновить)	Выполняет `S`; если действующей ставки или маршрута с этим префиксом нет, выполняет `A`. `SA` - то же самое

Какие коды принимает экран, показано в заголовке его столбца Action:

Экран	Действия
Rates (ставки) тарифа, Routes (маршруты) маршрута терминации, DIDs, Destinations (направления)	`A`, `U`, `S`, `AS`, `D`
Accounts (аккаунты), Authentication Rules (правила аутентификации), Vouchers (ваучеры)	`A`, `U`, `D`
Incoming Routing (входящая маршрутизация)	`U`

Для A, S и AS в ставках и маршрутах ячейка Prefix может содержать несколько префиксов через запятую. Строка применяется к каждому из них.

Даты активации и окончания действия

У каждой ставки и каждого маршрута есть Activation Date (дата активации) и Expiration Date (дата окончания действия). В любой момент для префикса используется только действующая ставка: активированная в прошлом и ещё не истёкшая. Пустая дата окончания действия означает never.

A закрывает старую цену. Когда вы добавляете ставку для префикса, у которого уже есть бессрочная ставка, активированная ранее, старая ставка получает новую дату активации в качестве даты окончания действия. Старая и новая цены идут друг за другом без промежутка, а старая остаётся в списке как Discontinued (прекращена).
Даты не могут быть в прошлом. Новой ставке нужна дата активации now или позже, и ни одна дата окончания действия не может быть в прошлом.
Действующие ставки сохраняют дату активации. U и S меняют дату активации только у ставки, которая ещё не действует. Для уже действующей ставки они могут изменить цены и задать будущую дату окончания действия.
Прекращённые ставки доступны только для чтения. Ставку, дата окончания действия которой прошла, обновить нельзя.
Периоды не должны пересекаться. Две ставки для одного префикса не могут действовать одновременно; вторая завершается ошибкой Another Rate with conflicting "Prefix" or "Activation/Expiration Date" already exists.

Те же правила действуют для маршрутов маршрута терминации. У записей групп маршрутизации тоже есть собственные Activation Date и Expiration Date; см. Маршрутизация.

Ключевые понятия

Ставка - цена звонков на один префикс направления в рамках тарифа, с интервалами, платой за соединение и датами действия.
Маршрут терминации - прайс-лист префиксов вендора, по которому звонки маршрутизируются к этому вендору; хранится как набор направлений.
Префикс - начальные цифры набранного номера, которые определяют ставку или маршрут, например 4420.
CDR (запись о звонке) - одна строка на каждый звонок со временем, длительностью, направлением, стоимостью и причиной разъединения.

Типичные сценарии

Вендор присылает прайс-лист на следующий месяц

Загрузите его с действием A и Activation Date первого дня месяца в 00:00:00. До этого момента действуют текущие цены; в полночь их сменяют новые, а старые истекают. Каждый CDR сохраняет цену, которая действовала в момент звонка, так что CDR всегда соответствуют истории ставок.

Вы исправили опечатку в сегодняшних ценах

Используйте S (или U с Id), чтобы изменить цену действующей ставки на месте. Звонки, протарифицированные до исправления, сохраняют в CDR неверную цену, потому что U и S перезаписывают ставку, а не добавляют новую. При необходимости пересчитайте эти звонки; см. Перерасчёт CDR после исправления ставок.

Префиксы должны перестать работать в определённую дату

Задайте Expiration Date их ставок через U или S. С этого момента у префиксов нет действующей ставки, и звонки на них отклоняются с No Rate Found (ставка не найдена). Используйте D только для ставок, через которые никогда не шёл трафик.