Экстендер Импорт файлов в MDB¶
- Table of contents
- Экстендер Импорт файлов в MDB
- Настройка оконного плагина
Назначение¶
Предназначен для выполнения импорта списка медиаэлементов из файлов в медиа базу данных DJin. Позволяет импортировать данные из файлов в формате Excel и CSV (расширения .xlsx и .csv соответственно). Функциональные возможности:
- возможность указать, создавать или не создавать новый элемент в базе, если он не обнаружен;
- возможность сопоставлять столбцы из файла с полями медиаэлемента, который будет обновляться или создаваться в базе;
- возможность выбора кодировки, в которой будут считываться данные из файла (в случае импорта для типа файла CSV);
- возможность прервать процесс импорта файлов;
- возможность сохранения/загрузки файла пресета с настройками, которые указал пользователь;
- загрузка последнего варианта настроек, которые были выставлены пользователем;
- возможность предварительного просмотра данных для импорта перед непосредственным выполнением;
- сохранение отчёта в папке \SYSTEM\ImportToMdb\ с информацией о том, какой элемент был обновлен, какой пропущен, какой создан.
Поддерживаемые атрибуты¶
Artists
Authors
Categories
CDId
CDTrackId
Comment
DbId
DDB_ID
DDB_Owner
Energy
FadeIn
FadeOut
FileName
FirstReportLine
FullMediaId
Gain
IdInScheduleBlock
IdNumber
LastReportLine
LcCode
MaxLvl
Name
OwnerName
Publisher
RadioID
Rds
RemoteCmd
SamplingFrequency
StartNext
TextureEnd
TextureStart
Vocal
А также все дополнительные пользовательские атрибуты.
Особенности работы¶
Выбор файла¶
В разделе «Выбор файла» выставляются параметры файла, из которого планируется считывать данные для импорта в медиабазу. Имеется два варианта на выбор : файл Excel с расширением .xlsx и файл Csv с расширением.csv. Для файлов csv можно выбрать кодировку, в которой будут считываться данные и сепаратор (символ, которым разделяются колонки в файле csv).
Внимание! Выбираемый для импорта файл НЕ ДОЛЖЕН БЫТЬ ОТКРЫТ в программе Excel. Иначе его нельзя будет считать.
Настройка полей¶
В разделе настройки полей сопоставляются колонки с данными из файла с полями медиаэлемента, который будет импортироваться.
Сначала нужно выбрать тип медиа элемента по умолчанию и минимальный набор полей для импорта, по которым медиа элемент будет идентифицироваться. Для создания сопоставления нужно нажать на кнопку «Добавить». После нажатия на эту кнопку появится строка с номером столбца в файле и названием свойства медиа элемента, в которое будет добавлена информация из указанного столбца файла.
Для того, чтобы медиа элемент смог обновиться в базе – в файле должен обязательно присутствовать столбец, в котором содержатся поля DbId или IdNumber. Если их не указать, все импортируемые элементы будут интерпретироваться как новые.
Если из столбца под данным номером не нужно импортировать данные – нужно выбрать из выпадающего списка элемент <>.
Обычно первая строка файла содержит названия столбцов, которые не нужно импортировать. В таких случаях нужно ставить галочку «Игнорировать первую строку файла».
Для создания новых элементов в базе нужно выставить галочку «Создавать элемент, если он отсутствует в базе».
После настройки сопоставления полей можно проверить, смогут ли данные прочитаться из указанного файла. Для этого нужно нажать кнопку «Предварительный просмотр». Если файл корректно прочитался, в таблице предварительного просмотра отобразятся данные из файла в соответствии с настройкой полей.
Импорт¶
Если пользователь убедился в правильности выставленных настроек – можно нажать кнопку «Импорт». Появится Окно с прогрессом выполнения импорта и кнопкой остановки.
По окончании импорта будет показано окно с информацией, сколько элементов было обновлено, сколько создано и сколько пропущено.
Работа с пресетами¶
Если пользователь хочет сохранить текущие настройки в файл для последующей загрузки, можно воспользоваться кнопками «Загрузить пресет» и «Сохранить пресет». Во время сохранения сохраняются все поля и галочки, выставленные в данный момент.
Настройка оконного плагина¶
Для настройки компонента в виде оконного плагина в файле .vid добавляется строка:
CREATE_NET_WND_PLUGIN importFileToMdb Extenders\MdbImportFromFileExtender.dll MdbImportFromFileExtender.MdbImportFromfileExtenderClass
Пример части файла .vid:
…
CREATE_NET_WND_PLUGIN importFileToMdb Extenders\MdbImportFromFileExtender.dll MdbImportFromFileExtender.MdbImportFromfileExtenderClass
SET_VIEW_SINGLE_OBJ VIEW_S1 OBJID_TIME1
SET_VIEW_SINGLE_OBJ VIEW_S5 OBJID_MSG1
SET_VIEW_SINGLE_OBJ VIEW_S2 OBJID_INFO1
SET_VIEW_SINGLE_OBJ VIEW_S3 OBJID_PLAY_X1
//SET_VIEW_SINGLE_OBJ VIEW_S7 OBJID_FSK2
SET_VIEW_TAB_OBJ VIEW_T1 OBJID_MAP1 NAME_MAP
SET_VIEW_TAB_OBJ VIEW_T1 OBJID_BROW1 NAME_BROW
SET_VIEW_TAB_OBJ VIEW_T1 importFileToMdb NAME_importFileToMdb
…
