Импорт файлов

В различных разделах веб-интерфейса присутствует возможность импорта данных из файла.
Меню импорта имеет похожий вид в различных разделах веб-интерфейса.
Однако некоторые опции этого меню могут отличаться.
Ниже разберем функционал импорта на примере импорта Биллинговых пакетов.

Сохранить как шаблон - вы можете сохранить все текущие параметры импорта в шаблон, и в следующий раз выбрать этот шаблон и не заполнять форму импорта заново.
Обычно вы имеете дело с рядом партнеров, которые отправляют вам биллинговые пакеты в определенном формате.
Вы можете для каждого партнера подготовить 1 раз шаблон импорта, и в дальнейшем при импорте выбирать данный шаблон без заполнения полей формы импорта.

Общие

Здесь вы можете выбрать:

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

локаль - локаль, в которой записан файл.
В локали определена кодировка и дробный разделитель.

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

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

при дублировании - определяете поведение при обнаружении дубликата - уже присутствующей такой же записи в базе данных.
В случае импорта биллингового пакета вы выбираете поведение при дубликате E.164 кода.
Обычно подходит значение "заменить".

остановиться при ошибке - при ошибке можно остановить импорт либо продолжать со следующей строки.

откатить изменения при ошибке - при ошибке можно откатить те строки, которые были импортированы ранее, до ошибки.

шаблон импорта - вместо параметров из данной формы использовать данные из сохранненного ранее и выбранного сейчас шаблона.

Дополнительно.

формат времени - определяете формат даты и времени.
Обычно нужно для файлов .csv.
В Excel файлах для даты используется специальный формат ячейки, который автоматически распознается системой.
Однако бывает, что дату сохраняют в формат ячейки "строка". В таком случае при импорте требуется указать формат даты явно.

при дублировании изменения - выбираете поведение при появлении дубликата изменения.
Например, партнер прислал вам код 380 с временем активации 2017-09-01 00:00:00.
Вы успешно импортировали эту строку.
Однако затем партнер прислал вам новый прайслист, в котором опять есть код 380 с временем активации 2017-09-01 00:00:00, но уже с другой ценой.
Если вы с партнером договорились, что такое допустимо, то следует установить в данной опции значение "заменить".

удалить отсутствующие коды - удалять из базы данных коды, которых нет в импортируемом прайс-листе.
Часто партнеры отправляют 2 типа прайс-листов:
- полный прайс-лист, в котором перечислены все поддерживаемые коды и цены.
Для импорта такого прайс-листа следует включать данную опцию.
- частичное обновление, в котором перечислены только измененные коды и цены после отправки последнего полного прайс-листа.
Для импорта такого прайс-листа следует выключать данную опцию.
Удобно иметь по отдельному шаблону импорта для каждого из этих типов прайслистов, чтоб не переключать эту опцию вручную каждый раз.

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

проверять время активации - проверять что изменение цены происходит согласно параметров отсрочка поднятия цены (дней) и отсрочка снижения цены (дней), установленным в биллинговом пакете.
Например, если отсрочка поднятия цены (дней) договорена с партнером в 3 дня, а он уведомляет вас о поднятии цены за 1 день, то при импорте соответствующей строки выдаст ошибку.

Индексы

В данной вкладке вы должны указать в каком столбце импортируемого файла следует искать соответствующую информацию.
Если вы не хотите импортировать определенные поля из файла, а хотите вставить в базу определенные значения, то следует оставить соответствующее поле пустым.
В этом случае в соответствующее поле будет импортировано значение из вкладки Значения (см. ниже).
Например, если вы хотите импортировать только дату активации, цену минуты и статус то вы указываете индексы только для этих столбцов.
Остальные оставляете пустыми, и их значения будут взяты из вкладки Значения.

Значения

В данной вкладке вы должны указать значения по умолчанию для полей, которые не будут импортироваться из файла согласно вкладке Индексы (см. выше).
Значение из данной вкладки будет импортировано для определенного поля, если в вкладке Индексы для него не указан индекс.

Классы замены

Часто формат значений из прайс-листа партнера не соответствует формату Smartswitch.
Например, партнер использует значения 'Open', 'New' для обозначения активного кода, 'DELETE' для обозначение удаленного кода, 'Close' для обозначения закрытого кода.
А в Smartswitch приняты значения 'enabled','disabled','deleted'.
С помощью данного меню можно автоматически заменять 'Open' и 'New' -> 'enabled', 'DELETE' -> 'deleted', 'Close' -> 'disabled'.

Excel

Настройки, специфичные для формата Excel.

Часто парнеры отправляют ненужные данные на первых или последних листах прайс-листов.
Например, промо-акции, рекламу, логотипы итд.

начинать с листа - с какого листа начинать импорт
пропустить листы с конца - сколько листов с конца пропускать.

CSV

Настройки, специфичные для формата CSV.

разделитель - символ разделителя, используемого в файле.

English translation