SaveToDB Framework для MySQL

SaveToDB Framework для MySQL

SaveToDB Framework for MySQL

SaveToDB Framework for MySQL содержит готовые решения задач разработки приложений с использованием MySQL и Microsoft Excel.

Фреймворк корректно устанавливается и удаляется. Используются схемы savetodb_dev и savetodb_xls.

Фреймворк можно быстро установить непосредственно из плагина SaveToDB и сгенерировать книгу для настройки фреймворка из Microsoft Excel.

См. Мастер установки SaveToDB Framework и Мастер создания книги настройки.

 

Далее можно настроить наиболее интересующие возможности:

Установка и удаление

Варианты установки и удаления SaveToDB Framework

Возможны следующие варианты установки и удаления SaveToDB Framework:

  1. С использованием Мастера установки SaveToDB Framework из плагина SaveToDB.
  2. С использованием программы SaveToDB Framework Installer из состава SaveToDB SDK.
  3. С использованием исходного SQL-кода.
  4. С использованием командных файлов.

Первые два способа позволяют установить или удалить SaveToDB Framework во всех поддерживаемых серверах баз данных:
Microsoft SQL Server, Microsoft SQL Server Compact, Oracle Database, IBM DB2, MySQL, MariaDB, PostgreSQL, NuoDB и SQLite.

Описание шагов SaveToDB Framework Installer полностью совпадает с Мастером установки SaveToDB Framework.

Исходный SQL код находится в папке "SaveToDB Framework for MySQL" в файлах:

  • framework-install-ru.sql
  • framework-remove-ru.sql

Вариант с использованием командных файлов описан ниже.

Замечания к установке и удалению

Для установки и удаления требуются права администратора БД.

После установки следует предоставить права конечным пользователям Excel на объекты схемы savetodb_xls, а разработчикам приложений Excel или продвинутым пользователям - на объекты схемы savetodb_dev.

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

Важно! При удалении объектов SaveToDB Framework удаляется вся информация о выполненных настройках из конфигурационных таблиц.

Если Вы планируете установить SaveToDB Framework повторно, сохраните предварительно данные конфигурационных таблиц.

Установка и удаление командными файлами

Код и утилиты фреймворка находится в папке "SaveToDB Framework for MySQL".

Установка

  1. Запустите 1-edit-config.cmd и настройте строку подключения "setup".
  2. Запустите 2-install-savetodb-framework.cmd.
  3. Запустите 3-clear-credentials.cmd и удалите пароль строки подключения "setup".

Пользователь строки подключения "setup" должен обладать правами администратора базы данных.

Вместо удаления пароля в строке подключения на шаге 3, можно зашифровать строку:

выберите опцию "Только пользователь" в программе gConnectionManager.

Удаление

  1. Запустите 1-edit-config.cmd и настройте строку подключения "setup".
  2. Запустите framework-remove.cmd.
  3. Запустите 3-clear-credentials.cmd и удалите пароль строки подключения "setup".

Вывод объектов базы данных

  1. Запустите 1-edit-config.cmd и настройте строку подключения "setup".
  2. Запустите framework-list.cmd.
  3. Запустите 3-clear-credentials.cmd и удалите пароль строки подключения "setup".

Схемы и роли

Фреймворк создает следующие схемы базы данных:

СхемаОписание
savetodb_xlsСхема содержит объекты конфигурации для конечных пользователей.
savetodb_devСхема содержит данные конфигурации, которые используются разработчиками.

Пользователям приложений необходимо предоставить права на чтение данных объектов схемы savetodb_xls.

Разработчикам приложений необходимо предоставить права на чтение и изменение данных объектов и выполнение процедур схемы savetodb_dev, и права на чтение данных объектов схемы savetodb_xls.

Список запросов

Назначение

С плагином SaveToDB пользователи могут переключать запросы к базе данных, используя список запросов на ленте.

Это удобно, т.к. в книге Microsoft Excel не нужно делать много листов, а можно динамически переключать запросы на одном листе. К тому же, при добавлении новых запросов в базу данных, пользователю достаточно обновить список запросов, и можно получать данные новых объектов.

Представление списка запросов используется также для конфигурирования таблицы сохранения или пользовательских процедур сохранения изменений данных представлений и процедур.

Список запросов может содержать объекты базы данных, SQL-код, http-запросы и запросы к текстовым файлам.

Все эти возможности могут быть настроены в базе данных, и SaveToDB Framework предлагает готовую инфраструктуру.

См. Настройка списка запросов, Настройка сохранения изменений.

Таблица данных списка запросов

Таблица savetodb_dev.query_list является дополнительным источником данных для представлений списков запросов.

CREATE TABLE IF NOT EXISTS savetodb_dev.query_list (
    ID INTEGER NOT NULL AUTO_INCREMENT,
    TABLE_SCHEMA VARCHAR(64) NOT NULL,
    TABLE_NAME VARCHAR(64) NOT NULL,
    TABLE_TYPE VARCHAR(64) NOT NULL,
    TABLE_CODE MEDIUMTEXT,
    INSERT_PROCEDURE MEDIUMTEXT,
    UPDATE_PROCEDURE MEDIUMTEXT,
    DELETE_PROCEDURE MEDIUMTEXT,
    PROCEDURE_TYPE VARCHAR(64),
    PRIMARY KEY (ID)
);

Таблица позволяет:

  • Указать SQL-код в списке запросов.
    Код указывается в поле TABLE_CODE, в поле TABLE_TYPE должен быть указан тип CODE.
  • Указать http-запрос в списке запросов.
    Код указывается в поле TABLE_CODE, в поле TABLE_TYPE должен быть указан тип HTTP.
  • Указать запрос к текстовому файлу в списке запросов.
    Код указывается в поле TABLE_CODE, в поле TABLE_TYPE должен быть указан тип TEXT.
  • Указать таблицу сохранения данных, полученных из представлений, хранимых процедур или SQL-кода.
    Таблица должна быть указана во всех трех полях INSERT_PROCEDURE, UPDATE_PROCEDURE и DELETE_PROCEDURE.
  • Указать SQL код или хранимые процедуры для сохранения изменений данных, полученных из представлений, хранимых процедур или SQL-кода.
    Должны быть заполнены все три поля INSERT_PROCEDURE, UPDATE_PROCEDURE и DELETE_PROCEDURE.
  • Указать таблицу, SQL код или хранимые процедуры для слияния данных, полученных из любого источника, в том числе из веб или текстовых файлов.
    Должно быть заполнено одно поле INSERT_PROCEDURE.

См. Настройка списка запросов и Настройка сохранения данных.

Представление конфигурации списка запросов для разработчиков

Представление savetodb_dev.view_query_list выводит список всех доступных пользователю объектов и данные из таблицы savetodb_dev.query_list.

Представление удобно использовать разработчикам приложений, т.к. показываются все объекты, в отличие от представления savetodb_xls.view_query_list.

Представление конфигурации списка запросов для пользователей

Представление savetodb_xls.view_query_list выводит список объектов, доступных пользователю, за исключением объектов настройки плагина SaveToDB.

Представление позволяет просто реализовывать дополнительные представления списков запросов, что позволяет создавать логические списки запросов, содержащие только объекты, которые необходимо показать пользователям.

Например, в одной базе данных можно создать списки запросов для финансистов, бухгалтеров, менеджеров и т.д.

Пример пользовательского представления:

CREATE VIEW stocks.view_query_list
AS
SELECT
    t.TABLE_SCHEMA
    , t.TABLE_NAME
    , t.TABLE_TYPE
    , t.TABLE_CODE
    , t.INSERT_PROCEDURE
    , t.UPDATE_PROCEDURE
    , t.DELETE_PROCEDURE
    , t.PROCEDURE_TYPE
FROM
    savetodb_xls.view_query_list t
WHERE
    t.TABLE_SCHEMA IN ('stocks', 'savetodb_xls')

В примере представления отобраны объекты схем stocks и savetodb_xls.

Обработка событий

Назначение

Используя плагин SaveToDB к Microsoft Excel можно обрабатывать события Microsoft Excel хранимыми процедурами MySQL, заданным SQL-кодом или http-запросами:

  • Change
  • DoubleClick
  • SelectionChange

За счет этого можно изменять любые данные базы данных из Microsoft Excel, реализовывать уточняющие запросы, логику Master-Details и т.д.

Также можно настроить контекстное меню Microsoft Excel и меню "Действия" плагина для запуска:

  • представлений,
  • хранимых процедур,
  • SQL-кода,
  • http-запросов,
  • запросов к текстовым файлам,
  • макросов,
  • команд Windows Shell и CMD,
  • обновления справочников Excel из баз данных.

См. Настройка обработчиков событий.

Таблица данных обработчиков событий

Таблица savetodb_dev.event_handlers содержит конфигурацию обработчиков событий.

CREATE TABLE IF NOT EXISTS savetodb_dev.event_handlers (
    ID INTEGER NOT NULL AUTO_INCREMENT,
    TABLE_SCHEMA VARCHAR(64) NOT NULL,
    TABLE_NAME VARCHAR(64) NOT NULL,
    COLUMN_NAME VARCHAR(64),
    EVENT_NAME VARCHAR(50) NOT NULL,
    HANDLER_SCHEMA VARCHAR(64),
    HANDLER_NAME VARCHAR(64) NOT NULL,
    HANDLER_TYPE VARCHAR(64),
    HANDLER_CODE MEDIUMTEXT,
    TARGET_WORKSHEET VARCHAR(256),
    MENU_ORDER SMALLINT,
    EDIT_PARAMETERS BIT(1),
    PRIMARY KEY (ID)
);

Описание полей конфигурации см. в разделе Настройка обработчиков событий.

Поле HANDLER_CODE может содержать SQL-код или текст http-запросов.

Рекомендуемый формат имен обработчиков событий:

  • xl_<event>_<schema>_<name>
  • xl_<event>_<schema>_<name>_<column>

где <schema>_<name> - имя объекта, к которому относится обработчик, а <event> принимает допустимые имена или акронимы событий:

  • act - Actions
  • chg - Change
  • dbl - DoubleClick
  • mnu - ContextMenu
  • sel - SelectionChange

Объекты с именами xl_% автоматически исключаются из списков запросов.

Представление конфигурации обработчиков событий SaveToDB

Представление savetodb_xls.view_event_handlers используется для настройки плагина и просто выбирает данные из таблицы savetodb_dev.event_handlers.

CREATE OR REPLACE VIEW savetodb_xls.view_event_handlers
AS
SELECT
    t.ID,
    t.TABLE_SCHEMA,
    t.TABLE_NAME,
    t.COLUMN_NAME,
    t.EVENT_NAME,
    t.HANDLER_SCHEMA,
    t.HANDLER_NAME,
    t.HANDLER_TYPE,
    t.HANDLER_CODE,
    t.TARGET_WORKSHEET,
    t.MENU_ORDER,
    t.EDIT_PARAMETERS
FROM
    savetodb_dev.event_handlers t

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

Перевод данных

Назначение

Плагин SaveToDB позволяет переводить описания объектов базы данных и полей/параметров объектов на бизнес-язык пользователей или любой естественный язык в самом Microsoft Excel после загрузки запроса.

Это позволяет менять перевод полей в специальной таблице базы данных, не меняя сами объекты базы данных.

См. Настройка перевода данных.

Таблица данных перевода объектов базы данных

Таблица savetodb_dev.object_translation содержит данные перевода объектов.

CREATE TABLE IF NOT EXISTS savetodb_dev.object_translation (
    ID INTEGER NOT NULL NOT NULL AUTO_INCREMENT,
    TABLE_SCHEMA VARCHAR(64) NOT NULL,
    TABLE_NAME VARCHAR(64) NOT NULL,
    LANGUAGE_NAME CHARACTER(2) NOT NULL,
    TRANSLATED_NAME VARCHAR(64),
    TRANSLATED_DESC VARCHAR(256),
    TRANSLATED_COMMENT VARCHAR(2000),
    PRIMARY KEY (ID)
);

ALTER TABLE savetodb_dev.object_translation
    ADD UNIQUE INDEX ix_schema_name_language
    USING BTREE (
        TABLE_SCHEMA,
        TABLE_NAME,
        LANGUAGE_NAME
    );

Описание полей см. в разделе Настройка перевода данных.

Можно изменить разрядность полей TRANSLATED_*, если требуются описания большей длины.

Представление конфигурации перевода объектов базы данных

Представление savetodb_xls.view_object_translation используется для настройки плагина и просто выбирает данные из таблицы savetodb_dev.object_translation.

CREATE VIEW savetodb_xls.view_object_translation
AS
SELECT
    t.TABLE_SCHEMA,
    t.TABLE_NAME,
    t.LANGUAGE_NAME,
    t.TRANSLATED_NAME,
    t.TRANSLATED_DESC,
    t.TRANSLATED_COMMENT
FROM
    savetodb_dev.object_translation t

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

Таблица данных перевода полей и параметров

Таблица savetodb_dev.column_translation содержит данные перевода полей и параметров объектов базы данных.

CREATE TABLE IF NOT EXISTS savetodb_dev.column_translation (
    ID INTEGER NOT NULL AUTO_INCREMENT,
    TABLE_SCHEMA VARCHAR(64),
    TABLE_NAME VARCHAR(64),
    COLUMN_NAME VARCHAR(64) NOT NULL,
    LANGUAGE_NAME CHARACTER(2) NOT NULL,
    TRANSLATED_NAME VARCHAR(64),
    TRANSLATED_DESC VARCHAR(1024),
    PRIMARY KEY (ID)
);

ALTER TABLE savetodb_dev.column_translation
    ADD UNIQUE INDEX ix_schema_name_column_language
    USING BTREE (
        TABLE_SCHEMA,
        TABLE_NAME,
        COLUMN_NAME,
        LANGUAGE_NAME
    );

Описание полей см. в разделе Настройка перевода данных.

Представление конфигурации перевода полей и параметров

Представление savetodb_xls.view_column_translation используется для настройки плагина и просто выбирает данные из таблицы savetodb_dev.column_translation.

CREATE VIEW savetodb_xls.view_column_translation
AS
SELECT
    t.TABLE_SCHEMA,
    t.TABLE_NAME,
    t.COLUMN_NAME,
    t.LANGUAGE_NAME,
    t.TRANSLATED_NAME,
    t.TRANSLATED_DESC
FROM
    savetodb_dev.column_translation t

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

Представление описания объектов

Представление savetodb_xls.view_object_description выводит информацию о доступных пользователю объектах БД, для которых есть описание в таблице savetodb_dev.object_translation.

Такое представление удобно использовать как начальную страницу приложений, с которой пользователь может переключиться на любой интересующий объект, используя Список запросов на ленте.

Значения параметров

Назначение

Используя плагин SaveToDB пользователи могут работать в Microsoft Excel с хранимыми процедурами и запросами в виде SQL кода так же, как с таблицами или представлениями.

Если хранимая процедура или SQL код имеет параметры, то плагин SaveToDB выводит параметры на ленту и пользователи могут изменять значения.

Для таблиц и представлений пользователи могут выбрать поля, которые будут показаны на ленте и использоваться при формировании запроса WHERE.

Используя настройку в базе данных можно задать представления, хранимые процедуры или SQL код, которые будут использоваться для формирования списков значений полей и параметров.

См. Конфигурирование значений параметров.

Таблица конфигурации запросов значений параметров

Таблица savetodb_dev.parameter_values служит источником данных для представления конфигурации savetodb_xls.view_parameter_values.

CREATE TABLE IF NOT EXISTS savetodb_dev.parameter_values
(
    ID INTEGER NOT NULL AUTO_INCREMENT,
    TABLE_SCHEMA VARCHAR(64) NOT NULL,
    TABLE_NAME VARCHAR(64) NOT NULL,
    PARAMETER_NAME VARCHAR(64) NOT NULL,
    SELECT_SCHEMA VARCHAR(64),
    SELECT_NAME VARCHAR(64) NOT NULL,
    SELECT_TYPE VARCHAR(64),
    SELECT_CODE MEDIUMTEXT,
    PRIMARY KEY (ID)
);

ALTER TABLE savetodb_dev.parameter_values
    ADD UNIQUE INDEX ix_schema_name_parameter
    USING BTREE (
        TABLE_SCHEMA,
        TABLE_NAME,
        PARAMETER_NAME
    );

Описание полей см. в разделе Настройка значений параметров.

Рекомендуемый формат имен объектов запроса значений SELECT_NAME параметров PARAMETER_NAME:

  • xl_val_<parameter_name>

Объекты с такими именами автоматически исключаются из списков запросов.

Поле SELECT_CODE может содержать SQL-код. При этом в поле SELECT_TYPE должен быть указан тип CODE.

Представление конфигурации значений параметров SaveToDB

Представление savetodb_xls.view_parameter_values используется для настройки плагина и просто выбирает данные из таблицы savetodb_dev.parameter_values.

CREATE OR REPLACE VIEW savetodb_xls.view_parameter_values
AS
SELECT
    t.ID,
    t.TABLE_SCHEMA,
    t.TABLE_NAME,
    t.PARAMETER_NAME,
    t.SELECT_SCHEMA,
    t.SELECT_NAME,
    t.SELECT_TYPE,
    t.SELECT_CODE
FROM
    savetodb_dev.parameter_values t

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

См. раздел Настройка значений параметров.

Форматы таблиц

Назначение

Данный компонент позволяет сохранять и восстанавливать форматирование таблиц Microsoft Excel для объектов БД в базе данных.

Форматирование таблицы загружается при первом подключении к объекту.
За счет этого пользователь получает не только данные, но и полное форматирование, включая:

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

Управление форматами производится из Мастера управления форматами таблиц.

См. также Настройка форматов таблиц.

Таблица форматов

Таблица savetodb_dev.table_formats хранит форматирование таблиц Microsoft Excel для объектов базы данных.

CREATE TABLE IF NOT EXISTS savetodb_dev.table_formats (
    ID INTEGER NOT NULL AUTO_INCREMENT,
    TABLE_SCHEMA VARCHAR(64) NOT NULL,
    TABLE_NAME VARCHAR(64) NOT NULL,
    TABLE_EXCEL_FORMAT_XML MEDIUMTEXT,
    PRIMARY KEY (ID)
);

ALTER TABLE savetodb_dev.table_formats
    ADD UNIQUE INDEX ix_table_formats_schema_name
    USING BTREE (
        TABLE_SCHEMA,
        TABLE_NAME
    );

Данные таблицы управляются плагином при сохранении из Мастера управления форматами таблиц с использованием процедуры savetodb_dev.table_format_save.

Представление конфигурации форматов

Представление savetodb_xls.view_table_formats используется плагином для выборки сохраненных форматов таблиц и просто выбирает данные из таблицы savetodb_dev.table_formats.

CREATE OR REPLACE VIEW savetodb_xls.view_table_formats
AS
SELECT
    t.ID,
    t.TABLE_SCHEMA,
    t.TABLE_NAME,
    t.TABLE_EXCEL_FORMAT_XML
FROM
    savetodb_dev.table_formats t

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

Процедура сохранения форматов

Процедура savetodb_dev.table_format_save используется плагином SaveToDB для сохранения или удаления форматов таблиц в таблице savetodb_dev.table_formats.

Объявление процедуры:

CREATE PROCEDURE savetodb_dev.table_format_save (
        IN `Schema` VARCHAR(64),
        IN `Name` VARCHAR(64),
        IN `ExcelFormatXML` MEDIUMTEXT
    )

История изменений

Версия 7.2 от 20.03.2017

[*] Новые типы обработчиков событий: ConvertFormulas и DoNotConvertFormulas.
[*] Добавлены списки проверки значений в таблицы query_list, event_handlers, parameter_values и их представления.
[*] Поле event_handlers.HANDLER_NAME может содержать значения NULL.

Версия 7.1 от 03.02.2017

[*] Добавлены типы RANGE и VALUES в поле SELECT_TYPE.
[*] Добавлены типы RANGE и VALUES в поле HANDLER_TYPE.

Версия 7.0 от 17.01.2017

[*] Обновлены командные файлы и файлы readme.txt.
SQL-код объектов SaveToDB Framework версии 6.9 остался неизменным.

Версия 6.9 от 21.06.2016

[+] Новый тип обработчика событий: ProtectRows.

Версия 6.7 от 14.04.2016

[*] Фреймворк включает обновленный список значений колонки EVENT_NAME таблиц конфигурации обработчиков событий.
Используйте файл savetodb-framework-62-upgrade-to-67.sql для обновления версий 6.2.
После обновления используйте Мастер управления форматами таблиц для перезагрузки списков в существующие таблицы Excel.
Также можно создать новые книги настройки, используя Мастер генерации книги настройки.

Версия 6.2 от 23.12.2015

[+] Новые типы обработчиков событий: DoNotSelect, DoNotSave, DoNotChange, Formula, FormulaValue, ValidationList.
[*] В представлении savetodb_dev.view_query_list исключаются объекты с именами в формате '%_change'.
[*] Для обновления SaveToDB Framework 5.0 можно использовать код в каталоге "SaveToDB Framework Upgrade 5.0 to 6.2".

Версия 5.2 от 12.05.2015

[*] Обновлены командные файлы.
[*] Процедуры с суффиксом _merge исключаются из вывода в представлениях savetodb_dev.view_query_list и savetodb_xls.view_query_list.

Версия 5.0 от 13.04.2015

[*] В таблицу savetodb_dev.query_list и представления view_query_list добавлены поля TABLE_CODE и PROCEDURE_TYPE.
[*] Типы полей INSERT_PROCEDURE, UPDATE_PROCEDURE, DELETE_PROCEDURE изменены на MEDIUMTEXT, чтобы было можно хранить большой SQL код.
[*] В таблицу savetodb_dev.event_handlers и представление savetodb_xls.view_event_handlers добавлено поле HANDLER_CODE.
[*] В таблицу savetodb_dev.parameter_values и представление savetodb_xls.view_parameter_values добавлено поле SELECT_CODE.
[*] Поля SPECIFIC_SCHEMA и SPECIFIC_NAME таблицы savetodb_dev.parameter_values и представления savetodb_xls.view_parameter_values переименованы в TABLE_SCHEMA и TABLE_NAME.
[*] Типы полей TABLE_SCHEMA и HANDLER_SCHEMA изменены на VARCHAR(64).

Версия 4.8 от 27.08.2014

[-] Исправлены ошибки кодировки при выводе сообщений в командных файлах.
Все командные файлы переведены на кодировку CP866.

Версия 4.7 от 15.07.2014

[*] SaveToDB Framework for MySQL стал совместим с MariaDB.
Схема performance_schema исключена из представлений списков запросов.
[*] Командные файлы обновлены на использование утилиты командной строки gsqlcmd.exe вместо mysql.exe.
Вследствие этого, операции установки и удаления можно совершать без предустановленных компонент MySQL.

Версия 4.0 от 13.12.2013

[*]Размер полей INSERT_PROCEDURE, UPDATE_PROCEDURE, DELETE_PROCEDURE таблицы savetodb_dev.query_list увеличен до 2000 символов.
Эти поля могут содержать SQL код для сохранения изменений. Размер полей можно увеличить по необходимости.
[*]Изменено представление savetodb_dev.view_query_list для вывода запросов в виде SQL-кода, запросов к веб и текстовым файлам (типы CODE, HTTP, TEXT).
[*]Размер поля SELECT_SCHEMA таблицы savetodb_dev.parameter_values увеличен до 2000 символов.
Это поле может содержать SQL код для формирования списка значений параметров. Размер поля можно увеличить по необходимости.
[*]Размер поля TARGET_WORKSHEET таблицы savetodb_dev.event_handlers увеличен до 255 символов.
Поле может содержать список листов для обновления справочников для обработчика REFRESH.
[*]В таблицы savetodb_dev.parameter_values, savetodb_dev.object_translation, savetodb_dev.column_translation, savetodb_dev.table_formats добавлены уникальные индексы.
[*]В меню "Действия" добавлены ссылки на онлайн документацию для таблиц и представлений SaveToDB Framework for MySQL.

Версия 3.0 от 10.06.2013

[+]Первая версия.

Системные требования

Поддерживаемые версии SaveToDB:

  • SaveToDB 6.x и выше
  • SaveToDB 5.x, без новых возможностей SaveToDB 6.x-7.x

Поддерживаемые версии MySQL:

  • MySQL 5.0, 5.1, 5.2, 5.5, 5.6, 5.7

Поддерживаемые версии SkySQL MariaDB:

  • MariaDB 5.1, 5.2, 5.3, 5.5, 10.0, 10.1, 10.2

Примеры для MySQL

SaveToDB SDK включает исходный код и рабочие книги Microsoft Excel приложений и примеров для СУБД MySQL и MariaDB.

Приложение Реестр платежей

Это готовое к использованию приложение позволяет вести реестр платежей и строить отчеты о движении денежных средств.

Приложение является комплексным примером полноценного приложения, реализованного с помощью Microsoft Excel и MySQL.

Установка и удаление примеров приложений

Установка примеров приложений MySQL

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

  1. Установить базу данных примера приложения.
  2. Изменить данные подключения в книге Microsoft Excel примера.

Установка базы данных примера

Код развертывания базы данных примеров MySQL находится в папке "source code" соответствующего примера.

Откройте папку и выполните следующие командные файлы:

  1. Запустите 1-edit-config.cmd и настройте строку подключения "setup".
  2. Запустите 2-edit-grants.cmd и измените права, если необходимо.
  3. Запустите 3-install-savetodb-framework.cmd для установки SaveToDB Framework for MySQL.
  4. Запустите 4-install-application.cmd для установки приложения.
  5. Запустите 5-clear-credentials.cmd и удалите пароль подключения "setup".

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

Пользователь строки подключения "setup" должен обладать правами администратора (root).

Вместо удаления пароля в строке подключения на шаге 5, можно зашифровать строку:
выберите опцию "Только пользователь" в программе gConnectionManager.

Пример также можно установить вручную, используя файл application-install.sql.

Изменение параметров подключения в рабочей книге Microsoft Excel

В папке примеров содержатся предварительно настроенные рабочие книги Microsoft Excel для конечных пользователей и разработчиков приложений.

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

Также, в процессе развертывания могли быть изменены имена и пароли тестовых пользователей приложения.

Для изменения параметров подключения следует:

  1. Активировать вкладку SaveToDB и запустить "Мастер изменения строк подключения".
  2. Ввести новые параметры сервера и базы данных и нажать кнопку "Далее".
  3. Отметить все таблицы и нажать кнопку "Готово".

Далее следует обновить данные всех таблиц рабочей книги Microsoft Excel.

Это можно сделать, используя пункт меню "Обновить, Обновить все таблицы книги".

Имена и пароли пользователей в рабочих книгах Microsoft Excel:

ПримерЛогин разработчикаПароль разработчикаЛогин пользователяПароль пользователя
Реестр платежейpayments_devDev_2011#_Xls4168payments_userUsr_2011#_Xls4168

Удаление примеров приложений MySQL

Для удаления откройте папку "source code" соответствующего примера и выполните следующие командные файлы:

  1. Запустите 1-edit-config.cmd и настройте строку подключения "setup".
  2. Запустите application-remove.cmd.
  3. Запустите 5-clear-credentials.cmd и удалите пароль подключения "setup".

Пользователь строки подключения "setup" должен обладать правами администратора.

Вместо удаления пароля в строке подключения на шаге 3, можно зашифровать строку:
выберите опцию "Только пользователь" в программе gConnectionManager.

Пример также можно удалить вручную, используя файл application-remove.sql.

Утилита командной строки gsqlcmd

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

Утилита устанавливается в составе SaveToDB и доступна через переменную среды PATH,
соответственно, приложения могут быть установлены из любого каталога.

В составе SaveToDB SDK утилита находится в подкаталоге gsqlcmd и доступна из только подкаталогов SaveToDB SDK.

История изменений

Версия 7.2 от 20.03.2017

[*] Обновлен SaveToDB Framework 7.2.

Версия 7.0 от 17.01.2017

[*] Обновлены даты на 2017 год.
[*] Обновлены SaveToDB Framework 7.0, командные файлы и файлы readme.txt.

Системные требования

Поддерживаемые версии SaveToDB:

  • SaveToDB 5.x и выше

Поддерживаемые версии SaveToDB Framework for MySQL:

  • SaveToDB Framework 5.0 for MySQL и выше

Поддерживаемые версии MySQL:

  • MySQL 5.0, 5.1, 5.2, 5.5, 5.6, 5.7

Поддерживаемые версии SkySQL MariaDB:

  • MariaDB 5.1, 5.2, 5.3, 5.5, 10.0, 10.1, 10.2