Project

General

Profile

Обмен информацией между БД 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. Экспорт

Для экспорта необходимо выполнить последовательность приведенных ниже действий.

  1. Запуститьи RCS Selector
  2. Выбрать раздел 1. Selector
  3. Выбрать пункт 5. Utilities
  4. Выбрать пункт 2. Interface to other Products
  5. Выбрать пункт 3. Other product.
  6. В окне Interface menu выбрать пункт DBase Interface. Наличие и расположение этого пункта в меню зависит от первоначальной настройки ПО RCS Selector.
  7. Выбрать пункт 1. SELECTOR
  8. Выбрать пункт 2. Export Songs from SELECTOR. Откроется окно настройки экспорта.
  9. В окне EXPORT SONGS FROM SELECTOR
    1. В поле DBASE filespec уже будет указан путь к каталогу и файлу, через который будет происходить обмен (см. настройку ПО ниже), необходимо только убедиться что имя указанного файла S_EXPORT.DBF
    2. В поле Export mode установить Rewrite
    3. Нажать F2. Откроется окно выбора элементов для экспорта.
  10. В окне Export Songs to dBASE нажать F6-Category. Откроется окно выбора категории.
  11. В окне GET CATEGORY/LEVEL
    1. В качестве имени категории указать звездочку *.
    2. Поле Level оставить пустым
    3. Нажать F2-GetCategory/Level. На экране снова появится окно Export Songs to dBASE со списком выбранных элементов.
  12. В окне Export Songs to dBASE нажать F2-Export. Откроется окно PRINT OPTIONS
  13. В окне PRINT OPTIONS выбрать любой подходящий пункт для сохранения отчета о выполненной операции. Например, VIEW/FILE - отчет будет записан в файл, о потом открыт для просмотра. Если отчет не нужен - то выбрать Send to file. Отчет будет сохранен в файл без отображения. Считаем, что выбран Send to file.
  14. Снова откроется окно Interface menu. (Шаг 6.).

Для экспорта из Linker необходимо повторить шаги 6-13 для со следующими отличиями:
Шаг 7: 2. LINKER
Шаг 8: 2. Export Songs from LINKER
Шаг 9: Имя файла в DBASE filespec должно быть L_EXPORT.DBF

В случае возникновения ошибок необходимо обратиться к дежурному инженеру.

Действия в ПО Джин. Импорт.

Джин выполняет импорт материала, экспортированного ранее их RCS Selector. Для импорта необходимо:

  1. Запустить программу Джин.
  2. Выбрать пункт главного меню Сервис/RCS Selector/Импорт из:Ххх. Где ХХХ - название настроенного подключения.
  3. Дождаться завершения операции.
  4. Просмотреть открывшийся отчет. В случае нормального завершения в отчете будет указано количество новых и обновленных элементов, и приведен их список.
    В случае ошибки - в окне появится текст ошибки. В этой ситуации необходимо обратиться к дежурному инженеру.

Импорт в RCS Selector

Действия в ПО Джин. Экспорт.

При экспорте действия совершаются в обратной последовательности. Сначала экспорт в ПО Джинн, потом импорт в ПО RCS Selector. При экспорте из МБД программа определяет, какие элементы изменились, сравнивая актуальное описание элементов в МБД и описание этих элементов, сохраненное при последнем экспорте из RCS Selector. Обратно в RCS Selector экспортируются только те элементы, которые изменились с момента их импорта в МБД. Список полей, изменение которых приведет к экспорту, указан ниже.
Для экспорта необходимо:

  1. Запустить программу Джин
  2. Выбрать пункт главного меню Сервис/RCS Selector/Экспорт в:Ххх. Где ХХХ - название настроенного подключения.
  3. Дождаться завершения операции.
  4. Просмотреть открывшийся отчет.
    В случае нормального завершения в отчете будет указано количество и приведен список элементов, которые были сохранены для импорта в БД RCS Selector.
    В случае ошибки в окне отчета отобразится ее текст. В этой ситуации необходимо обратиться к дежурному инженеру.

Действия в ПО RCS Selector. Импорт.

Для импорта необходимо выполнить следующие шаги:

  1. Запустить RCS Selector
  2. Выбрать раздел 1. Selector
  3. Выбрать пункт 5. Utilities
  4. Выбрать пункт 2. Interface to other Products
  5. Выбрать пункт 3. Other product.
  6. В окне Interface menu выбрать пункт DBase Interface. Наличие и расположение этого пункта в меню зависит от первоначальной настройки ПО RCS Selector.
  7. Выбрать пункт 1. SELECTOR
  8. Выбрать пункт 1. Import Songs from SELECTOR. Откроется окно настройки импорта.
  9. В окне IMPORT SONGS TO SELECTOR
    1. В поле DBASE filespec уже будет указан путь к каталогу и файлу, через который будет происходить обмен (см. настройку ПО ниже), необходимо только убедиться что имя указанного файла S_IMPORT.DBF
    2. В поле Import mode установить Add / Update
    3. Нажать F2-Import. Откроется окно Print options.
  10. Выбрать пункт 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. Если его там нет, то:

  1. Запустить RCS Selector
  2. Выбрать раздел 1. Selector
  3. Выбрать пункт 5. Utilities
  4. Выбрать пункт 2. Interface to other Products
  5. Выбрать пункт 3. Other product
  6. Выбрать пункт 8. Configure menu option
  7. Выбрать пункт меню, в котором будет указан Dbase interface и нажать F5.
  8. В открывшемся окне выбрать Dbase interface и нажать Enter
  9. Нажать F2, потом ESC
  10. Рассказать об этом пользователям.

Теперь необходимо один раз выполнить обмен с 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 артист Особый случай. только если Экспорт всех полей = да

Add picture from clipboard (Maximum size: 742 MB)