- Table of contents
- Обмен информацией между БД RCS Selector и МБД
Обмен информацией между БД RCS Selector и МБД¶
Введение¶
Данное описание проверялось при работе с версией селектора RCS Selector 12.x (MS DOS).
ПО Джин позволяет импортировать и экспортировать информацию для базы данных (БД) RCS Selector. При этом элемент из раздела Selector попадают в раздел МБД Музыка, а элементы из раздела Linker попадают в раздел Джинглы. Элементы создаются в категории, указанной в настройках, с сохранением категорий, указанной в Selector.
Обмен позволяет:
- Импортировать новые элементы из БД RCS Selector в МБД с сохранением идентификатора и описания.
- Обновить описательную информацию в МБД при смене данных в БД RCS Selector.
- Обновить информацию о Runtime в БД RCS Selector при изменение разметки или смене звукового файла в МБД
При обмене главной считается БД Selector, поэтому новые элементы должны создаваться в ней. При самом первом обмене сначала выполняется экспорт из БД RCS Selector в МБД. В дальнейшем, при необходимости внести изменения, внесенные одной из сторон, необходимо на этой стороне выполнить операцию экспорта, а потом, на другой стороне - импорта.
Экспорт из БД Selector.¶
Считаем, что оба приложения настроены для совместной работы. Подробнее о настройке написано ниже.
Действия в ПО RCS Selector. Экспорт¶
Для экспорта необходимо выполнить последовательность приведенных ниже действий.
- Запуститьи RCS Selector
- Выбрать раздел 1. Selector
- Выбрать пункт 5. Utilities
- Выбрать пункт 2. Interface to other Products
- Выбрать пункт 3. Other product.
- В окне Interface menu выбрать пункт DBase Interface. Наличие и расположение этого пункта в меню зависит от первоначальной настройки ПО RCS Selector.
- Выбрать пункт 1. SELECTOR
- Выбрать пункт 2. Export Songs from SELECTOR. Откроется окно настройки экспорта.
- В окне EXPORT SONGS FROM SELECTOR
- В поле DBASE filespec уже будет указан путь к каталогу и файлу, через который будет происходить обмен (см. настройку ПО ниже), необходимо только убедиться что имя указанного файла S_EXPORT.DBF
- В поле Export mode установить Rewrite
- Нажать F2. Откроется окно выбора элементов для экспорта.
- В окне Export Songs to dBASE нажать F6-Category. Откроется окно выбора категории.
- В окне GET CATEGORY/LEVEL
- В качестве имени категории указать звездочку *.
- Поле Level оставить пустым
- Нажать F2-GetCategory/Level. На экране снова появится окно Export Songs to dBASE со списком выбранных элементов.
- В окне Export Songs to dBASE нажать F2-Export. Откроется окно PRINT OPTIONS
- В окне PRINT OPTIONS выбрать любой подходящий пункт для сохранения отчета о выполненной операции. Например, VIEW/FILE - отчет будет записан в файл, о потом открыт для просмотра. Если отчет не нужен - то выбрать Send to file. Отчет будет сохранен в файл без отображения. Считаем, что выбран Send to file.
- Снова откроется окно Interface menu. (Шаг 6.).
Для экспорта из Linker необходимо повторить шаги 6-13 для со следующими отличиями:
Шаг 7: 2. LINKER
Шаг 8: 2. Export Songs from LINKER
Шаг 9: Имя файла в DBASE filespec должно быть L_EXPORT.DBF
В случае возникновения ошибок необходимо обратиться к дежурному инженеру.
Действия в ПО Джин. Импорт.¶
Джин выполняет импорт материала, экспортированного ранее их RCS Selector. Для импорта необходимо:
- Запустить программу Джин.
- Выбрать пункт главного меню Сервис/RCS Selector/Импорт из:Ххх. Где ХХХ - название настроенного подключения.
- Дождаться завершения операции.
- Просмотреть открывшийся отчет. В случае нормального завершения в отчете будет указано количество новых и обновленных элементов, и приведен их список.
В случае ошибки - в окне появится текст ошибки. В этой ситуации необходимо обратиться к дежурному инженеру.
Импорт в RCS Selector¶
Действия в ПО Джин. Экспорт.¶
При экспорте действия совершаются в обратной последовательности. Сначала экспорт в ПО Джинн, потом импорт в ПО RCS Selector. При экспорте из МБД программа определяет, какие элементы изменились, сравнивая актуальное описание элементов в МБД и описание этих элементов, сохраненное при последнем экспорте из RCS Selector. Обратно в RCS Selector экспортируются только те элементы, которые изменились с момента их импорта в МБД. Список полей, изменение которых приведет к экспорту, указан ниже.
Для экспорта необходимо:
- Запустить программу Джин
- Выбрать пункт главного меню Сервис/RCS Selector/Экспорт в:Ххх. Где ХХХ - название настроенного подключения.
- Дождаться завершения операции.
- Просмотреть открывшийся отчет.
В случае нормального завершения в отчете будет указано количество и приведен список элементов, которые были сохранены для импорта в БД RCS Selector.
В случае ошибки в окне отчета отобразится ее текст. В этой ситуации необходимо обратиться к дежурному инженеру.
Действия в ПО RCS Selector. Импорт.¶
Для импорта необходимо выполнить следующие шаги:
- Запустить RCS Selector
- Выбрать раздел 1. Selector
- Выбрать пункт 5. Utilities
- Выбрать пункт 2. Interface to other Products
- Выбрать пункт 3. Other product.
- В окне Interface menu выбрать пункт DBase Interface. Наличие и расположение этого пункта в меню зависит от первоначальной настройки ПО RCS Selector.
- Выбрать пункт 1. SELECTOR
- Выбрать пункт 1. Import Songs from SELECTOR. Откроется окно настройки импорта.
- В окне IMPORT SONGS TO SELECTOR
- В поле DBASE filespec уже будет указан путь к каталогу и файлу, через который будет происходить обмен (см. настройку ПО ниже), необходимо только убедиться что имя указанного файла S_IMPORT.DBF
- В поле Import mode установить Add / Update
- Нажать F2-Import. Откроется окно Print options.
- Выбрать пункт 2. Send to file. Произойдет импорт и снова откроется окно Interface menu.
Для импорта в Linker необходимо повторить шаги 6-10 для со следующими отличиями:
Шаг 7: 2. LINKER
Шаг 8: 1. Import Songs to LINKER
Шаг 9: Имя файла в поле DBASE filespec должно быть L_IMPORT.DBF
Настройка¶
Обмен данными между программами происходит через файлы формата dBase (*.dbf). Обе программы могут сохранять и считывать элементы своих БД из файлов этого формата. Всего используется 4 файла, размещенных в одном каталоге. Имена файлов фиксированные (регистр букв не имеет значения) и связаны с назначением файла, описанном в таблице:
Файл | Описание |
S_EXPORT.dbf | В этот файл Selector сохраняет информацию при экспорте из БД SELECTOR. (S*elector_EXPORT*) Пустой файл должен быть предварительно скопирован в каталог при настройке, т.к. Selector не умеет его создавать. [raw-S_EXPORT.DBF Ссылка на S_EXPORT.dbf] |
L_EXPORT.dbf | Аналогично для экспорта из БД Linker. [raw-L_EXPORT.DBF Ссылка на L_EXPORT.dbf] |
S_IMPORT.dbf | Из этого файла Selector импортирует элементы БД SELECTOR. Файл автоматически создается программой Джин при экспорте. |
L_IMPORT.dbf | Аналогично для импорт БД LINKER. |
Идентификатор элемента в БД Selector (SONGID или LINKID) сохраняется в МБД в поле IdNumber.
Если в обмене с Selector участвуют несколько рабочих мест, то они все должны быть настроены на работу с одной копией файлов.
Оба файла, S_EXPORT.DBF и L_EXPORT.DBF должны быть помещены в каталог обмена, даже если БД Linker не используется.
Настройка ПО Джинн¶
Настройка производится в разделе настроек Сервис\Настройки\Доп\RCS Selector.
Программа умеет работать с 2-мя независимыми подключениями к Selector.
Подключения настраиваются в узлах Подключение 1 и 2. В каждом узле присутствует одинаковый набор параметров:
|Название подключения|Необходимо указать произвольное название, которое будет отображаться в меню Сервис\RCS Selector в названиях пунктов меню:
Экспорт из:<название подключения 1>
Импорт из:<название подключения 1>
Экспорт из:<название подключения 2>
Импорт из:<название подключения 2>|
|Корневая категория для песен|Джин будет располагать в указанной категории МБД элементы, импортированные из базы Selector.
Категория будет создана в разделе МБД Музыка.
Например, если указать в этом пункте Selector, то, если в БД Seletor элемент принадлежал категории A, то в Джине он окажется в категории Selector\A в разделе Музыка.
Внимание: В данной категории запрещается:
- создавать, переименовывать и удалять подкатегории, т.к. это разорвет связь элемента с его копией в БД Selector.
- перемещать элементы между подкатегориями, по той же причине._|
|Корневая категория для линков|Аналогично предыдущему, но для элементов базы Linker (Линки или джинглы).
Категория будет создана в разделе МБД Джинглы|
|Путь к каталогу звуковых файлов (SELECTOR)|Указать каталог, в котором находятся звуковые файлы элементов БД Selector.
В БД Selector хранятся только имена файлов, без пути.|
|Путь к каталогу звуковых файлов (LINKER)|Аналогично предыдущему, для элементов БД Linker.|
|Каталог хранения файлов|Указать каталог, в котором находятся файлы DBF.
Необходимо настроить одинаковый каталог на всех рабочих местах, работающих с одной и той же базой Селектора.
При указании пути можно использовать UNC имена (\\server\share) или отображаемые диски (Mapped drives).|
|Постфикс к ID элемента|Необходимо указывать только в случае, если Id элемента в базе Селектора может совпасть с ID Number элемента в МБД.
Обычно, это необходимо для подключения к 2-м базам селектора, в которых идентификаторы элементов могут совпадать.
Если постфикс не пустой, то при импорте из Селектора ID Number в МБД будет выглядеть так:
Id Number=IDпостфикс
где ID-это ID Элемента в БД Cелектор, а постфикс - это указанный в данном пункте текст.
Постфикс не должен содержать пробелов.|
_Примечание_: В первых версиях при настройке обмена с селектором необходимо было указать имя специально созданного ODBC источника, созданного для работы с DBF файлами. В версии начиная с 2.13.232 в этом нет необходимости.
Следующие параметры влияют на оба подключения сразу:
Экспорт всех полей |
При нормальной работе - нет. Позволяет расширить список полей, экспортируемых в Селектор. Дополнительно будут сохранятся Название и Артист. Это может пригодиться только для восстановления содержимого Selector при импорте данных из МБД. При использовании опция устанавливается в состояние Да только на время одной операции экспорта. После экспорта данных из Джина опция возвращается в Нет. |
Экспортировать только изменения |
При нормальной работе - да. Эта опция позволяет экспортировать в Selector только действительно изменившиеся элементы и формировать отчеты о выполненных операциях. Т.к. Джин не имеет прямого доступа к БД Selector и не может точно определить разницу между элементами МБД и элеметами БД Selector, то Джинн использует для сравнения данные, экспортированные из Selector последний раз. Именно поэтому из Selector необходимо экспортировать ВСЕ элементы. Программа сравнивает элементы и экспортирует обратно только те, которые действительно изменились. Если опция установлена в Нет, то программа отправляет в селектор все элементы корневых категорий МБД, при этом пропадает возможность формирования отчетов. |
Настройка RCS Selector¶
Необходимо, чтобы в окне Interface menu в меню присутствовал пункт DBase interface. Если его там нет, то:
- Запустить RCS Selector
- Выбрать раздел 1. Selector
- Выбрать пункт 5. Utilities
- Выбрать пункт 2. Interface to other Products
- Выбрать пункт 3. Other product
- Выбрать пункт 8. Configure menu option
- Выбрать пункт меню, в котором будет указан Dbase interface и нажать F5.
- В открывшемся окне выбрать Dbase interface и нажать Enter
- Нажать F2, потом ESC
- Рассказать об этом пользователям.
Теперь необходимо один раз выполнить обмен с Selector, чтобы в окне настроек обмена через Dbase interface (IMPORT/EXPORT SONGS TO SELECTOR) был указан путь к файлам (пользователи в дальнейшем будут только исправлять имя файла, но не каталога), для этого выполнить действия раздела Экспорт из БД Selector с указанием полного пути к файлу S_EXPORT.dbf.
На этом настройка программ закончена.
Поля, участвующие в обмене¶
Поля, импортируемые в МБД при импорте нового элемента¶
Поле БД Селеткор | Поле МБД | Смысл |
title | Название | Название Элемента МБД |
songid или linkid | Id Number | Идентификатор |
cat | Категория | Категория, к которой принадлежит элемент в селекторе. Короткая - только одна буква. |
runtime | Длительность | Длительность звучания. Только, если нет файла. |
radiotxt, tvnote1 или rnote | Файл | Имя файла, может быть в одном из трех полей. К имени добавляется каталог хранения, указанный в настройках обмена. |
только для Selector (не Linker) | ||
artist1, artist2, artist3, artist4 | Артист | Суммарное значение всех полей, собранное через /. Например: Lennon/Ivanov |
snote1, snote2, snote3, snote4, snote5 | Комментарий | Все комментарии, построчно |
intro1,intro2,intro3 | Intro1,Intro2,Intro3 | Все метки Интро |
Поля, импортируемые в МБД при изменении существующего элемента.¶
_’Поле Селектор_’ | _’Поле МБД_’ | _’Смысл_’ |
title | Название | Название Элемента МБД |
cat | Категория | Категория, к которой принадлежит элемент в селекторе. Короткая - только одна буква. |
artist1, artist2, artist3, artist4 | Артист | Суммарное значение всех полей, собранное через /. Например: Lennon/Ivanov |
Song notes: snote1, snote2, snote3, snote4, snote5 |
Комментарий | Все комментарии, построчно |
Поля, экспортируемые из МБД после изменения разметки или файла¶
_’Поле Селектор_’ | _’Поле МБД_’ | _’Смысл_’ |
runtime | Runtime | Длительность звучания до старта следующего. |
radiotxt | Имя файла | Имя файла без пути, 76 символов максимум. |
intro1,2,3 | Intro1,2,3 | Метки интро, только Selector |
title | Название | Особый случай. только если Экспорт всех полей = да |
artist1 | артист | Особый случай. только если Экспорт всех полей = да |