Project

General

Profile

Экстендер Импорт файлов в MDB

Назначение


Предназначен для выполнения импорта списка медиаэлементов из файлов в медиа базу данных DJin. Позволяет импортировать данные из файлов в формате Excel и CSV (расширения .xlsx и .csv соответственно). Функциональные возможности:

  • возможность указать, создавать или не создавать новый элемент в базе, если он не обнаружен;
  • возможность сопоставлять столбцы из файла с полями медиаэлемента, который будет обновляться или создаваться в базе;
  • возможность выбора кодировки, в которой будут считываться данные из файла (в случае импорта для типа файла CSV);
  • возможность прервать процесс импорта файлов;
  • возможность сохранения/загрузки файла пресета с настройками, которые указал пользователь;
  • загрузка последнего варианта настроек, которые были выставлены пользователем;
  • возможность предварительного просмотра данных для импорта перед непосредственным выполнением;
  • сохранение отчёта в папке \SYSTEM\ImportToMdb\ с информацией о том, какой элемент был обновлен, какой пропущен, какой создан.

03.jpg

Поддерживаемые атрибуты


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. Иначе его нельзя будет считать.

01.jpg

Настройка полей


В разделе настройки полей сопоставляются колонки с данными из файла с полями медиаэлемента, который будет импортироваться.

02.jpg

Сначала нужно выбрать тип медиа элемента по умолчанию и минимальный набор полей для импорта, по которым медиа элемент будет идентифицироваться. Для создания сопоставления нужно нажать на кнопку «Добавить». После нажатия на эту кнопку появится строка с номером столбца в файле и названием свойства медиа элемента, в которое будет добавлена информация из указанного столбца файла.
Для того, чтобы медиа элемент смог обновиться в базе – в файле должен обязательно присутствовать столбец, в котором содержатся поля DbId или IdNumber. Если их не указать, все импортируемые элементы будут интерпретироваться как новые.
Если из столбца под данным номером не нужно импортировать данные – нужно выбрать из выпадающего списка элемент <>.
Обычно первая строка файла содержит названия столбцов, которые не нужно импортировать. В таких случаях нужно ставить галочку «Игнорировать первую строку файла».
Для создания новых элементов в базе нужно выставить галочку «Создавать элемент, если он отсутствует в базе».

После настройки сопоставления полей можно проверить, смогут ли данные прочитаться из указанного файла. Для этого нужно нажать кнопку «Предварительный просмотр». Если файл корректно прочитался, в таблице предварительного просмотра отобразятся данные из файла в соответствии с настройкой полей.

04.jpg

Импорт


Если пользователь убедился в правильности выставленных настроек – можно нажать кнопку «Импорт». Появится Окно с прогрессом выполнения импорта и кнопкой остановки.

05.jpg

По окончании импорта будет показано окно с информацией, сколько элементов было обновлено, сколько создано и сколько пропущено.

06.jpg

Работа с пресетами


Если пользователь хочет сохранить текущие настройки в файл для последующей загрузки, можно воспользоваться кнопками «Загрузить пресет» и «Сохранить пресет». Во время сохранения сохраняются все поля и галочки, выставленные в данный момент.

Настройка оконного плагина


Для настройки компонента в виде оконного плагина в файле .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

Add picture from clipboard (Maximum size: 742 MB)