Мастера плагина SaveToDB 7

Мастера плагина SaveToDB 7

Мастера плагина SaveToDB

Запуск мастеров осуществляется из меню "Мастера":

Мастера SaveToDB для Microsoft Excel
Мастер подключения к данным
Мастер позволяет подключиться к объекту базы данных (таблицы, представления и хранимые процедуры), текстовому файлу или веб-источнику данных в формате HTML, XML, JSON или CSV, включая веб-сервисы OData.
После первого подключения к объектам базы данных можно подключаться к другим объектам, используя Список запросов.
При этом запросы будут обновляться в активной таблице. Таким образом, для работы со многими объектами базы данных не требуется создавать много листов в книге.
Мастер публикации таблицы в базу данных
Мастер позволяет создать таблицу в базе данных, экспортировать в нее данные текущей таблицы Microsoft Excel и вставить в книгу новую таблицу из базы данных.
После этих операций можно использовать обычную функциональность сохранения изменений в таблице, без использования мастера публикации. К новой таблице могут подключаться другие пользователи, и таким образом, получается реальная многопользовательская работа с данными в Microsoft Excel.
Мастер доступен, если активирована таблица Microsoft Excel на листе.
Чтобы создать таблицу, надо выделить требуемый диапазон и выбрать пункт меню Microsoft Excel Вставка, Таблица.
Мастер сохранения данных слиянием
Мастер позволяет сохранить данные таблицы Excel в существующую таблицу базы данных.
При этом существующие в обеих таблицах записи обновляются, а существующие только в таблице Excel добавляются в таблицу БД.
Обновляются только поля, которые присутствуют в обеих таблицах. Поля таблицы Excel можно формировать формулами.
Мастер доступен, если активирована таблица Microsoft Excel на листе.
Чтобы создать таблицу, надо выделить требуемый диапазон и выбрать пункт меню Microsoft Excel Вставка, Таблица.
Мастер изменения строк подключения
Мастер позволяет изменить данные подключения (сервер, базу данных, имя и пароль пользователя) сразу для группы объектов базы данных.
Это удобно использовать при переносе базы данных или передаче книги пользователям.
Мастер установки SaveToDB Framework
Мастер позволяет установить SaveToDB Framework во все поддерживаемые базы данных,
а также проверить наличие объектов и удалить SaveToDB Framework по необходимости.
После установки можно настроить все возможности плагина SaveToDB на серверной стороне.
Для выполнения операций требуются права на создание схем и объектов базы данных.
Мастер создания книги настройки SaveToDB Framework
Мастер позволяет сгенерировать книгу настройки SaveToDB Framework.
В книгу импортируются таблицы настройки и новые настройки можно сохранять с помощью кнопки "Сохранить".
Фактически, всю настройку приложения можно выполнять непосредственно в Microsoft Excel.
Это удобно, т.к. результат можно видеть в книге приложения сразу после обновления конфигурации.
Мастер управления форматами таблиц
Мастер позволяет сохранять, загружать и удалять форматы таблиц в книге и базе данных.
После сохранения форматов таблиц в базе данных, другие пользователи могут загрузить новые форматы, включая условное форматирование, формулы и т.д.
Внешние инструменты
Мастер позволяет запускать внешние продукты, входящие в состав пакета SaveToDB.
Описание продуктов см. в пунктах справки, относящихся к конкретному продукту.

Каждый мастер детально описан в своем разделе документации:

Мастер подключения к данным

Введение

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

Поддерживаются следующие базы данных:

  • Microsoft Azure SQL Database
  • Microsoft SQL Server, включая Microsoft SQL Server Express LocalDB
  • Microsoft SQL Server Compact
  • Oracle Database
  • IBM DB2
  • Oracle MySQL
  • SkySQL MariaDB
  • NuoDB
  • PostgreSQL
  • SQLite

Можно подключиться к таблицам, представлениям и хранимым процедурам.

Поддерживаются следующие виды веб-источников:

  • Веб-сервисы, включая веб-сервисы OData.
  • Веб-страницы.

Поддерживаются следующие форматы данных веб и текстовых файлов: HTML, XML, JSON, CSV.

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

В целом, подключение состоит из следующих шагов:

  1. Выбор провайдера подключения.
  2. Подключение к базе данных или веб-источнику.
  3. Выбор объекта подключения.
  4. Ввод параметров или настройка запроса.
  5. Вставка таблицы данных в Microsoft Excel.

Мастер подключения позволяет также настраивать или изменять данные текущего запроса.

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

Шаг 1. Выбор провайдера подключения

На данном шаге выполняется выбор провайдера для подключения к данным.

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

Если провайдер используется в запросе, но он не установлен, то кнопка "Далее" не доступна.

Различные провайдеры могут обладать различающимися возможностями. Наиболее важные замечания приведены в поле комментария.

Для Microsoft Excel x64 требуются 64-разрядные провайдеры, а для x86 - 32-разрядные. Диалог содержит список провайдеров, соответствующей разрядности.

OLEDB-провайдеры являются предпочтительными, т.к. Microsoft Excel позволяет их легко настраивать встроенными средствами.

ODBC-драйверы позволяют полноценно работать с данными, но менее удобны в работе с Microsoft Excel.

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

Например, работа с Microsoft SQL Server Compact возможна только с использованием плагина, т.к. под эту БД нет ни OLEDB-провайдера, ни ODBC-драйвера, с которым работал бы Microsoft Excel.

Мастер подключения к данным из Microsoft Excel - выбор провайдера

Комментарии к различным провайдерам приведены в отдельных разделах справки:

Шаг 2. Подключение к базе данных

На данном шаге производится подключение к базе данных.

Для получения справки по параметрам подключения можно нажать кнопки получения помощи, клавишу F1 или нажать на ссылку "Примеры".

Мастер, по возможности, выполняет проверку подключения в фоне и активирует кнопку "Далее".

Если кнопка не доступна, то можно провести проверку подключения по кнопке "Тест подключения".
Если подключение прошло успешно, то кнопка "Далее" становится доступной.

Мастер подключения к данным из Microsoft Excel - подключение к базе данных

Специфические особенности подключения к различным базам данных приведены в отдельных разделах справки:

Шаг 3. Выбор объекта базы данных

На данном шаге выбирается объект подключения, а также выбирается его список запросов.

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

Если список запросов переключать не нужно, то можно снять галочку с поля "Включить список запросов на ленте".

Плагин SaveToDB сохраняет необходимые данные для работы на скрытых листах книги.
Если такие листы, еще не добавлены, то можно добавить их в процессе подключения.
Это управляется опцией "Включить SaveToDB в этой книге".
Если опция отключена, то некоторые возможности плагина будут недоступны.
Если листы уже добавлены в книгу, то опция является недоступной для выбора.

На снимке экрана показан пример списка запросов по умолчанию, который выводит все объекты базы данных.

Мастер подключения к данным из Microsoft Excel - выбор объекта

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

В примере ниже показан список запросов xls41.ViewQueryList, который отбирает объекты базы данных, относящиеся к бюджетированию.

Мастер подключения к данным из Microsoft Excel - выбор объекта

Шаг 4. Ввод параметров запроса

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

Мастер подключения к данным из Microsoft Excel - ввод параметров

Это очень удобная возможность, отсутствующая в Microsoft Excel.

Списки значений параметров можно настроить.

Шаг 5. Вставка таблицы объекта базы данных

Если подключение производится с чистого листа, то на этом шаге выбирается адрес вставки таблицы.

Если же подключение производится при наличии таблицы, то новая таблица заменит текущую.
Это удобно использовать для полной замены запроса, включая восстановление изменившегося порядка полей в объекте базы данных.

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

Параметры хранимых процедур также отображаются на ленте и их можно менять.

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

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

В примере показан пример вставки данных хранимой процедуры xls31.uspBudgetForm.

Данные уже отформатированы, т.к. из базы данных можно загружать не только данные, но и форматы данных.

Мастер подключения к данным из Microsoft Excel - результат хранимой процедуры

Возможности перевода диалоговых окон

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

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

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

Мастер подключения к данным из Microsoft Excel - выбор объекта

Аналогично, диалог ввода параметров при наличии перевода отображает понятную пользователям информацию:

Мастер подключения к данным из Microsoft Excel - ввод параметров

Возможности настройки запросов из таблиц и представлений

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

Для таблиц и представлений показывается диалог настройки запроса:

Мастер подключения к данным из Microsoft Excel - выбор полей и фильтров запроса

Слева, в поле "S" - Select, отмечаются поля, которые должны быть выведены в таблицу.

Справа, в поле "W" - Where, отмечаются поля, которые используются для формирования фильтров запроса.

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

Мастер подключения к данным из Microsoft Excel - результат представления

Мастер подключения сводных таблиц

Введение

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

Процесс подключения аналогичен процессу подключения в Мастере подключения к данным.

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

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

См. подробности в разделе Работа со сводными таблицами.

Мастер публикации таблицы в базу данных

Введение

Мастер публикации позволяет создать таблицу базы данных на основе таблицы Microsoft Excel и сразу же экспортировать данные.

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

Это самый быстрый и простой способ организовать многопользовательскую работу в Microsoft Excel.

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

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

См. также Мастер сохранения данных слиянием, который позволяет сохранять данные Excel в существующие таблицы баз данных.

Используя мастер, можно опубликовать данные во все поддерживаемые базы данных:

  • Microsoft Azure SQL Database
  • Microsoft SQL Server, включая Microsoft SQL Server Express LocalDB
  • Microsoft SQL Server Compact
  • Oracle Database
  • IBM DB2
  • Oracle MySQL
  • SkySQL MariaDB
  • NuoDB
  • PostgreSQL
  • SQLite

Требования к таблицам для публикации

Мастер работает с таблицами Excel, которые ранее назывались списками. Для запуска мастера курсор должен находиться внутри таблицы.

Если мастер не доступен, то следует создать таблицу Excel.

Для этого следует выделить диапазон и выбрать команду Microsoft Excel "Вставка, Таблица".

Вставка таблицы Excel

Шаги мастера публикации

Мастер публикации включает следующие шаги:

  1. Выбор провайдера подключения.
  2. Подключение к базе данных.
  3. Дизайн новой таблицы в базе данных.
  4. Ввод схемы и имени таблицы.
  5. Проверка и исполнение скрипта публикации.
  6. Проверка результатов публикации.
  7. Создание новой таблицы Excel и подключение к таблице БД.
Мастер публикация таблицы Excel в базу данных - шаги мастера

Полезные замечания

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

В примере будет использована следующая таблица Excel:

Мастер публикация таблицы Excel в базу данных - исходная таблица данных

В таблице использованы все базовые типы Excel: integer, double, datetime, string и boolean.

Также таблица содержит колонку Formula Float с формулой, ссылающейся на поле Float.

Важно!

При вставке новой таблицы первой колонкой добавляется поле номеров строк.
Соответственно, колонки таблицы сдвигаются на одно поле вправо.

Если после экспорта планируется перенести формулы с листа, то желательно сдвинуть таблицу, если она располагается в колонке А.

Шаг 1. Выбор провайдера

На данном шаге выполняется выбор провайдера для подключения к базе данных.

Мастер отображает все установленные и доступные для подключения провайдеры.

Мастер публикация таблицы Excel в базу данных - выбор провайдера

Комментарии к различным провайдерам приведены в отдельных разделах справки:

Шаг 2. Подключение к базе данных

На данном шаге производится подключение к базе данных.

Мастер, по возможности, выполняет проверку подключения в фоне и активирует кнопку "Далее".

Если кнопка не доступна, то можно провести проверку подключения по кнопке "Тест подключения".

Мастер публикация таблицы Excel в базу данных - выбор сервера и базы данных

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

Шаг 3. Дизайн целевой таблицы базы данных

На этом шаге определяется дизайн целевой таблицы базы данных.

Мастер публикация таблицы Excel в базу данных - дизайн таблицы

Возможности дизайнера:

  • Добавление и удаление колонок целевой таблицы.
  • Изменение порядка колонок целевой таблицы.
  • Изменение наименований колонок целевой таблицы.
  • Изменение типов колонок целевой таблицы.
  • Изменение колонки первичного ключа.

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

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

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

4-х байтовые типы real и float не включены в дизайнер, т.к. они приводят к искажению значений в Microsoft Excel.

Таблица должна содержать первичные ключи. Поля первичных ключей отмечаются в колонке PK.

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

Если целочисленное поле содержит только уникальные значения и оно указано как первичный ключ, то включается свойство IDENTITY.

Если поле GUID указано как единственный первичный ключ, то добавляется признак генерации уникальных идентификаторов при вставке.

Указанные выше свойства первичных ключей поддерживаются во всех типах баз данных.

Шаг 4. Выбор схемы и имени таблицы

На этом шаге задаются схема и имя целевой таблицы.

Мастер публикация таблицы Excel в базу данных - выбор схемы и имени таблицы

Поле схемы содержит все схемы, в которых можно создать новую таблицу, т.е. есть право ALTER на схему.
Новую схему можно ввести, если есть право CREATE SCHEMA.

Поле имени таблицы содержит все таблицы выбранной схемы.

Если в качестве целевой выбрана существующая таблица, то выдается предупреждение, что таблица будет предварительно удалена перед публикацией.
Будьте внимательны!

Мастер публикация таблицы Excel в базу данных - предупреждение об удалении таблицы

Шаг 5. Проверка и исполнение скрипта публикации

Перед выполнением скрипт можно изменить.

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

Для выполнения скрипта следует нажать кнопку "Выполнить".

Если выполнение завершается по тайм-ауту, то время выполнения можно увеличить в диалоге Настройка.

Мастер публикация таблицы Excel в базу данных - проверка и выполнение скрипта

Два полезных совета:

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

Шаг 6. Проверка результатов публикации

В окне отображаются результаты публикации таблицы на сервере.

Если произошли какие-либо ошибки, то можно вернуться на предыдущие шаги и сделать изменения.

Мастер публикация таблицы Excel в базу данных - проверка результатов скрипта

Шаг 7. Создание новой подключенной таблицы

По нажатию кнопки "Готово" выполняется:

  • Создание нового листа.
  • Вставка таблицы, подключенной к целевой таблице в базе данных.
  • Копирование колонок с формулами из исходной таблицы.
  • Форматирование колонок по форматам исходной таблицы.
Мастер публикация таблицы Excel в базу данных - новая таблица данных

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

В случае успеха выдается сообщение об удачной публикации:

Мастер публикация таблицы Excel в базу данных - сообщение об успешном создании таблицы

Полезные замечания

Данные новой таблицы можно редактировать (изменять, добавлять, удалять).
И если нажать кнопку "Сохранить", то данные будут сохранены в базу данных.

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

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

Мастер сохранения данных слиянием

Введение

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

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

Мастер генерирует код обновления и вставки данных, используя сведения о таблице Excel и таблицы базы данных.

Для обновления данных требуется наличие полей первичных ключей таблицы базы данных в таблице Excel.
Для этой цели удобно использовать естественные ключи, например, источник данных и адрес электронной почты или номер мобильного телефона.
К примеру, контакты социальных сетей могут быть импортированы по первичным ключам Source (LinkedIn, Facebook, GooglePlus) и Email.

Поля целевой таблицы базы данных могут быть получены формульными колонками Microsoft Excel.
Например, формулами можно получить поля FirstName и LastName из поля Name.

Целевая таблица может содержать поле MergeDate или merge_date, которое получает дату и время формирования запроса.
За счет этого поля можно понять наличие записи в последнем наборе данных.

Используя мастер, можно сохранить данные во все поддерживаемые базы данных:

  • Microsoft Azure SQL Database
  • Microsoft SQL Server, включая Microsoft SQL Server Express LocalDB
  • Microsoft SQL Server Compact
  • Oracle Database
  • IBM DB2
  • Oracle MySQL
  • SkySQL MariaDB
  • NuoDB
  • PostgreSQL
  • SQLite

Требования к таблицам Excel

Мастер работает с таблицами Excel, которые ранее назывались списками. Для запуска мастера курсор должен находиться внутри таблицы.

Если мастер не доступен, то следует создать таблицу Excel.

Для этого следует выделить диапазон и выбрать команду Microsoft Excel "Вставка, Таблица".

Вставка таблицы Excel

Шаг 1. Выбор провайдера

На данном шаге выполняется выбор провайдера для подключения к базе данных.

Мастер слияния данных из Microsoft Excel в базу данных - выбор провайдера подключения

Комментарии к различным провайдерам приведены в отдельных разделах справки:

Шаг 2. Подключение к базе данных

На этом этапе выбирается целевая база данных.

Мастер слияния данных из Microsoft Excel в базу данных - выбор базы данных

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

Шаг 3. Выбор целевой таблицы

На этом шаге определяется целевая таблица базы данных для сохранения данных.

Мастер слияния данных из Microsoft Excel в базу данных - выбор целевой таблицы

Шаг 4. Проверка и исполнение скрипта публикации

Перед выполнением скрипт можно изменить.

Для выполнения скрипта следует нажать кнопку "Выполнить".

Если выполнение завершается по тайм-ауту, то время выполнения можно увеличить в диалоге Настройка.

Мастер слияния данных из Microsoft Excel в базу данных - скрипт сохранения данных

В примере использована следующая таблица Excel:

Мастер слияния данных из Microsoft Excel в базу данных - пример данных для сохранения слиянием

Как было указано выше, если таблица не содержит полей первичных ключей, то генерируются только команды вставки.
При этом добавляются только записи, не имеющие совпадений по всем полям.

При наличии первичных ключей, проверка наличия записей в SQL-коде ведется по ним.

Мастер изменения строк подключения

Введение

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

Это очень удобно при переносе сервера, или при настройке приложения на рабочий сервер перед поставкой клиентам.

Шаг 1. Выбор нового подключения

На этом этапе задаются данные нового подключения.

Шаг выбора провайдера обычно пропускается, т.к. автоматически выбираются данные подключения активной таблицы.

Изменение строк подключения к базе данных в Excel - выбор провайдера подключения

Комментарии к различным провайдерам приведены в отдельных разделах справки:

Шаг 2. Подключение к базе данных

На этом этапе выбирается база данных нового подключения.

Изменение строк подключения к базе данных в Excel - подключение к базе данных

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

Шаг 3. Выполнение изменений данных подключения

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

И нажать кнопку "Готово".

Изменение строк подключения к базе данных в Excel - выбор таблиц для изменения

В случае успешной замены выводится количество измененных таблиц.

Изменение строк подключения к базе данных в Excel - сообщение об успешной замене

Мастер установки SaveToDB Framework

Введение

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

Мастер установки SaveToDB Framework позволяет установить, проверить наличие или удалить SaveToDB Framework на всех поддерживаемых платформах баз данных:

  • Microsoft Azure SQL Database
  • Microsoft SQL Server, включая Microsoft SQL Server Express LocalDB
  • Microsoft SQL Server Compact
  • Oracle Database
  • IBM DB2
  • Oracle MySQL
  • SkySQL MariaDB
  • NuoDB
  • PostgreSQL
  • SQLite

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

Мастер установки и удаления SaveToDB Framework включает следующие шаги:

  1. Выбор провайдера подключения.
  2. Подключение к базе данных.
  3. Выбор операции и языка фреймворка.
  4. Проверка и выполнение скрипта.
  5. Проверка результатов выполнения скрипта.

Шаг 1. Выбор провайдера подключения

На данном шаге выполняется выбор провайдера для подключения к базе данных.

Мастер отображает все установленные и доступные для подключения провайдеры.

Мастер установки SaveToDB Framework - выбор провайдера подключения

Комментарии к различным провайдерам приведены в отдельных разделах справки:

Шаг 2. Подключение к базе данных

На данном шаге производится подключение к базе данных.

Мастер, по возможности, выполняет проверку подключения в фоне и активирует кнопку "Далее".

Если кнопка не доступна, то можно провести проверку подключения по кнопке "Тест подключения".

Мастер установки SaveToDB Framework - подключение к базе данных

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

Шаг 3. Выбор операции и языка фреймворка

На данном шаге производится выбор операции и языка SaveToDB Framework.

Таблица отображает статус объектов SaveToDB Framework в выбранной базе данных.

Следует учесть, что для проверки статуса, установки или удаления требуются соответствующие права.

Мастер установки SaveToDB Framework - выбор операции и языка установки

Шаг 4. Проверка и выполнение скрипта

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

Нажмите кнопку "Выполнить" для выполнения операции.

Мастер установки SaveToDB Framework - проверка и выполение скрипта установки

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

Мастер установки SaveToDB Framework - подтверждение установки

Шаг 5. Проверка результатов выполнения скрипта

В окне отображаются результаты выполнения операции.

Мастер установки SaveToDB Framework - проверка результатов выполнения скрипта установки

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

Также можно удалить SaveToDB Framework для установки другой языковой версии.

Шаг 3б. Выбор операции и языка фреймворка

В данном примере SaveToDB Framework был успешно установлен и все объекты найдены.

Операция переключается на удаление, т.к. объекты найдены.

Мастер установки SaveToDB Framework - выбор операции и языка установки

Шаг 4б. Проверка и выполнение скрипта

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

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

Мастер установки SaveToDB Framework - подтвердждение удаления

Шаг 5б. Проверка результатов выполнения скрипта

Мастер установки SaveToDB Framework - проверка результатов выполнения скрипта удаления

Мастер создания книги настройки SaveToDB Framework

Введение

Приложение Microsoft Excel может содержать гораздо больше возможностей, если они настроены в базе данных.

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

Таблицы настройки можно редактировать непосредственно в Microsoft Excel.

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

SaveToDB Framework должен быть установлен в базе данных. Это можно сделать мастером установки SaveToDB Framework.

Мастер создания книги настройки включает следующие шаги:

  1. Выбор провайдера подключения.
  2. Подключение к базе данных.
  3. Проверка наличия объектов SaveToDB Framework.
  4. Генерация книги настройки.

Шаг 1. Выбор провайдера подключения

На данном шаге выполняется выбор провайдера для подключения к базе данных.

Мастер отображает все установленные и доступные для подключения провайдеры.

Генератор книги настройки приложений Excel - выбор провайдера подключения

Комментарии к различным провайдерам приведены в отдельных разделах справки:

Шаг 2. Подключение к базе данных

На данном шаге производится подключение к базе данных.

Мастер, по возможности, выполняет проверку подключения в фоне и активирует кнопку "Далее".

Если кнопка не доступна, то можно провести проверку подключения по кнопке "Тест подключения".

Генератор книги настройки приложений Excel - подключение к базе данных

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

Шаг 3. Проверка объектов настройки

Для генерации книги настройки необходимо, чтобы объекты SaveToDB Framework существовали в базе данных и были доступны для текущих данных подключения.

Если SaveToDB Framework не установлен, то воспользуйтесь Мастером установки SaveToDB Framework.

Если SaveToDB Framework установлен, но не видны объекты, то либо запросите права на объекты у администратора баз данных, либо подключитесь под другим именем пользователя, вернувшись на предыдущий шаг.

Генератор книги настройки приложений Excel - проверка объектов

Шаг 4. Генерация книги настройки

Мастер выполнит генерацию книги настройки.

Каждый объект находится на своем листе.

Для настройки определенных возможностей введите данные в соответствующие таблицу и сохраните их.

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

Генератор книги настройки приложений Excel - сгенерированная книга настройки

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

Введение

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

Элементы форматирования описаны ниже.

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

Если формата в базе данных нет, то объект форматируется по умолчанию. См. ниже.

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

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

Мастер форматов таблиц Microsoft Excel
Кнопка "Сохранить в книге"
Кнопка сохраняет формат таблицы в книге.
Кнопка "Сохранить в БД"
Кнопка сохраняет формат таблицы в базе данных.
Кнопка не доступна, если у пользователя нет прав на процедуру сохранения формата.
Кнопка "Восстановить из книги"
Кнопка восстанавливает формат таблицы из книги.
Кнопка "Восстановить из БД"
Кнопка восстанавливает формат таблицы из базы данных.
Кнопка не доступна, если в базе данных нет сохраненных форматов.
Кнопка "Очистить в книге"
Кнопка удаляет формат таблицы, сохраненный в книге.
Кнопка "Очистить в БД"
Кнопка удаляет формат таблицы в базе данных.
Кнопка не доступна, если у пользователя нет прав на процедуру сохранения формата.
Кнопка "Очистить формат"
Кнопка удаляет форматирование таблицы и условия проверки данных.
Условное форматирование остается без изменений.
Кнопка "Формат по умолчанию"
Кнопка применяет формат по умолчанию к таблице.
См. описание формата по умолчанию ниже.
Если необходимо предварительно очистить текущий формат таблицы, воспользуйтесь кнопкой "Очистить формат".
Кнопка "ОК"
Кнопка закрывает диалог.
Кнопка "Отмена"
Кнопка закрывает диалог.

Форматирование таблицы

Форматирование таблицы включает:

  • Формат ячеек.
  • Условное форматирование.
  • Примененные авто-фильтры.
  • Итоги таблиц.
  • Условия проверки данных.
  • Свойства активного окна.
  • Свойства настройки печати.
  • Колонки с пользовательскими формулами.

Форматирование автоматически сохраняется при переключении запроса и восстанавливается при его повторном подключении.

Форматирование таблицы по умолчанию

Форматирование таблицы по умолчанию включает:

  • Установку ширины колонок по умолчанию, но не более 500 пикселей.
  • Установку ширины колонки номеров строк в 0 пикселей.
  • Установку ширины колонки A в 18 пикселей, если таблица размещена в колонках правее и включены номера строк таблицы.
  • Форматирование колонок типа даты.
  • Установку условий проверки значений для таблиц и представлений, если изменения можно сохранить в базе данных.
  • Условное форматирование колонок, которые не допускают пустых значений.

Мастер окон

Введение

Мастер окон позволяет создавать зависимые окна.

За счет этого в Excel 2007 и Excel 2010 можно легко реализовывать интерфейс master-details.

Эта возможность не работает в Excel 2013 из-за изменения модели управления окнами. 

См. Работа с окнами.

Пункты меню мастера окон

Кнопка "Упорядочить окна"
Кнопка упорядочивает окна активной книги.
Используется алгоритм упорядочивания, отличный от стандартного алгоритма Microsoft Excel.
В настройках плагина можно включить автоматическое упорядочивание.
Кнопка "Добавить окно"
Кнопка позволяет добавить окна в требуемой части активного окна.
Активное и новое окно занимают по половине площади активного окна.

Мастер форм

Введение

Плагин SaveToDB позволяет:

  • Подсвечивать активные строки таблиц.
  • Обновлять именованные ячейки значениями активной строки.
  • Обновлять значения активной строки таблицы при изменении именованных ячеек.
  • Реализовать сценарии обновления зависимых таблиц (master-details).

Это пример использования возможностей:

Example of working with cursors and fields.

Мастер форм позволяет создавать такие формы.

См. полное описание в разделе Работа с полями и курсорами.

Пункты меню мастера форм

Добавить курсор
Добавляет курсор в активную таблицу.
Удалить курсор
Удаляет курсор из активной таблицы.
Добавить поля формы
Добавляет именованные ячейки для отображения и редактирования значений активной строки таблицы.
Удалить поля формы
Удаляет именованные ячейки для отображения и редактирования значений активной строки таблицы.
Очистить именованные ячейки
Удаляет именованные ячейки с ошибочными диапазонами.

Подключение к Microsoft SQL Server

Введение

Плагин SaveToDB к Microsoft Excel позволяет подключаться к таблицам, представлениям и хранимым процедурам всех версий Microsoft SQL Server:

  • Microsoft Azure SQL Database
  • Microsoft SQL Server
  • Microsoft SQL Server Express LocalDB

Этот раздел описывает возможности, специфичные для Microsoft SQL Server.

Выбор провайдера подключения к данным

Пример подключения из Excel к Microsoft SQL Server - выбор провайдера

Microsoft OLE DB Provider for SQL Server входит в состав операционной системы Windows, доступен по умолчанию и позволяет подключаться к Microsoft SQL Server и Microsoft Azure SQL Database.

Это наилучший провайдер для использования в Microsoft Excel.

Для подключения к файлам баз данных, например, с использованием Microsoft SQL Server Express LocalDB, требуется установленный провайдер SQL Server Native Client 11.0.

Подключение к базе данных Microsoft SQL Server

Формат имени сервера: <Имя или IP-адрес сервера>[,<Порт>][\<Имя экземпляра>]

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

Пример подключения к Microsoft Azure SQL Database:

Подключение из Excel к базе данных Microsoft SQL Server

Пример подключения к Microsoft SQL Server по указанному порту:

Пример подключения из Excel к базе данных Microsoft SQL Server

При задании порта для локального сервера следует использовать "localhost" или IP-адрес, т.к. использование "." с портом не работает в Microsoft Excel.

Пример подключения к именованному экземпляру на локальном компьютере:

Пример подключения из Excel к именованному экземпляру Microsoft SQL Server

Пример подключения к файлу базы данных Microsoft SQL Server Express LocalDB:

Подключение из Excel к базе данных SQL Server Express LocalDB

Для подключения к файлам требуется провайдер SQL Server Native Client 11.0 или выше.

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

Подключение из Excel к файлу базы данных SQL Server Express LocalDB

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

Подключение к Microsoft SQL Server Compact

Введение

Плагин SaveToDB к Microsoft Excel позволяет подключаться к файлам баз данных Microsoft SQL Server Compact.

Плагин SaveToDB поддерживает операции загрузки и сохранения данных программным способом, т.к. для работы в Microsoft Excel нет подходящих OLEDB-провайдеров или ODBC-драйверов.

Выбор провайдера подключения

Пример подключения из Excel к базе данных Microsoft SQL Server Compact - выбор провайдера

Microsoft SQL Compact Data Provider поддерживает работу с Microsoft SQL Server Compact 3.5,
а Microsoft SQL Compact Data Provider 4.0 с Microsoft SQL Server Compact 4.0.

Microsoft SQL Compact Data Provider 4.0 включен в пакет установки плагина SaveToDB, что позволяет работать с файлами Microsoft SQL Server Compact 4.0 без установки дополнительного ПО.

Microsoft SQL Server Compact 4.0 можно загрузить со страницы http://www.microsoft.com/en-us/download/details.aspx?id=30709,

Microsoft SQL Server Compact 3.5 SP2 можно загрузить со страницы http://www.microsoft.com/en-us/download/details.aspx?id=5783.

Подключение к файлам баз данных Microsoft SQL Server Compact

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

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

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

Эта возможность используется в мастере публикации или мастере установки SaveToDB Framework for Microsoft SQL Server Compact.

Пример подключения из Excel к базе данных Microsoft SQL Server Compact

Создание базы данных Microsoft SQL Server Compact

Плагин SaveToDB позволяет создавать базы данных Microsoft SQL Server Compact, включая версии 3.5 и 4.0.

Версия определяется на этапе выбора провайдера подключения.

Пример создания базы данных Microsoft SQL Server Compact

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

Файл можно создать с паролем или без.

При использовании пароля поддерживаются следующие варианты шифрования файла:

  • Platform Default - используется алгоритм шифрования AES со 128-битный ключом и алгоритм хеширования SHA с 256-битным ключом.
  • Engine Default - используется алгоритм шифрования AES со 256-битный ключом и алгоритм хеширования SHA с 512-битным ключом.

Подключение к SQLite

Введение

Microsoft Excel поддерживает работу с базами данных SQLite с использованием ODBC драйверов.

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

Выбор провайдера подключения

Пример подключения Excel к базе данных SQLite - выбор провайдера

SQLite Data Provider включен в пакет установки плагина SaveToDB, что позволяет работать с файлами SQLite без установки дополнительного ПО.

ODBC драйвер SQLite можно загрузить со страницы http://www.ch-werner.de/sqliteodbc/.

Подключение к файлам баз данных SQLite

При подключении указывается имя файла. Бесплатная редакция SQLite не поддерживает пароли.

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

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

Эта возможность используется в мастере публикации или мастере установки SaveToDB Framework for SQLite.

 

Пример подключения Excel к базе данных SQLite

Создание базы данных SQLite

Плагин SaveToDB позволяет создавать базы данных SQLite.

Пример создания базы данных SQLite

Бесплатная редакция SQLite по лицензии Public Domain не поддерживает пароли и шифрование.

Подключение к Oracle Database

Введение

Плагин SaveToDB к Microsoft Excel позволяет подключаться к таблицам, представлениям и хранимым процедурам Oracle Database.

Ниже описаны специфические возможности подключения к Oracle Database.

Выбор провайдера подключения

Пример подключения из Excel к Oracle Database - выбор провайдера

Для доступа к Oracle Database требуются установленные компоненты Oracle Database Client.

См. http://www.oracle.com/technetwork/database/enterprise-edition/downloads/

Провайдер Oracle OLE DB Provider является предпочитаемым, т.к. он поддерживает все новые возможности Oracle Database.

Провайдер доступа к Oracle Database от Microsoft не поддерживает новые возможности, к примеру, типы данных CLOB, NCLOB.

Подключение к базе данных Oracle Database

Формат имени сервера: [<Имя или IP-адрес сервера>[:<Порт>]/]<Имя сервиса>

Подключение исключительно по имени сервиса возможно, если сервис сконфигурирован в файле tnsnames.ora.

Подключение от имени sys как SYSDBA или SYSOPER не поддерживается Microsoft Excel.

Пример подключения к сервису Orcl:

Пример подключения из Excel к Oracle Database по имени сервиса

Пример подключения к сервису Orcl на сервере Oracle по порту 1521:

Пример подключения из Excel к Oracle Database по полному имени, порту и имени сервиса

Большинство предыдущих версий 64-разрядных ODBC драйверов доступа к Oracle Database имеют ошибку.

При подключении возникает ошибка "Arithmetic operation resulted in an overflow":

Ошибка подключения к Oracle Database через ODBC драйвер

Решение проблемы является обновление ODBC драйвера доступа к Oracle Database до последней версии.

Также можно воспользоваться провайдером Oracle OLE DB Provider, который не имеет такой ошибки.

Провайдеры Oracle Database 10g имеют ошибку - они не работают с программой, запущенной из каталога, содержащего скобки, например (x86).

Соответственно, 32-разрядный Microsoft Office на 64-разрядной версии Windows, установленный в папку "Program Files (x86)", работать не будет.

При подключении в этом случае выдается ошибка ORA-12154:

Ошибка подключения к Oracle Database ORA-12154

См. решение проблемы ниже.

Решение проблемы доступа к Oracle Database 10g из-за скобок в пути

Провайдеры доступа Oracle Database 10g имеют ошибку - они не работают с программой, запущенной из каталога, содержащего скобки, например (x86).

Соответственно, 32-разрядный Microsoft Office на 64-разрядной версии Windows, установленный в папку "Program Files (x86)", не позволяет подключиться к Oracle Database.

Лучший способ исправления ошибки - создание символической ссылки без скобок на каталог со скобками и создание нового ярлыка запуска Microsoft Excel.

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

mklink /D "c:\Program Files x86" "C:\Program Files (x86)"

Далее следует создать ярлык для запуска Microsoft Excel, например для Excel 2010:

"C:\Program Files x86\Microsoft Office\Office14\EXCEL.EXE"

и для Excel 2007:

"C:\Program Files x86\Microsoft Office\Office12\EXCEL.EXE"

Недостаток данного решения - то, что Microsoft Excel для работы с Oracle Database придется всегда открывать по ярлыку, а не простым открытием книги.

Альтернативой является переустановка Microsoft Office в каталог без скобок.

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

rd "c:\Program Files x86"

Подключение к IBM DB2

Введение

Плагин SaveToDB к Microsoft Excel позволяет подключаться к таблицам, представлениям и хранимым процедурам IBM DB2.

Ниже описаны специфические возможности подключения к IBM DB2.

Выбор провайдера подключения

Пример подключения из Excel к базе данных IBM DB2 - выбор провайдера

Для доступа к базам данных IBM DB2 требуется установленный IBM OLE DB Provider for DB2 или Microsoft OLE DB Provider for DB2.

См. IBM Data Server Client Packages на http://www.ibm.com/software/data/db2/linux-unix-windows/download.html
и Microsoft OLEDB Provider for DB2 на http://www.microsoft.com/en-us/download/details.aspx?id=16978.

Провайдер от IBM является предпочитаемым, т.к. провайдер от Microsoft лицензирован только при использовании Microsoft SQL Server Enterprise Edition.

Подключение к базе данных IBM DB2

Формат имени сервера: <Имя или IP-адрес сервера>[:<Порт>]

Пример подключения к базе данных SAMPLE на сервере DB2:

Пример подключения из Excel к базе данных IBM DB2

Пример подключения к базе данных SAMPLE на сервере DB2 по порту 50000:

Пример подключения из Excel к базе данных IBM DB2

Подключение к MySQL

Введение

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

Ниже описаны специфические возможности подключения к MySQL.

Выбор провайдера подключения

Пример подключения из Excel к базе данных MySQL - выбор провайдера

Для доступа к MySQL можно использовать два типа провайдеров:

  • MySQL ODBC Driver.
  • MySQL Data Provider for .NET.

ODBC-драйвер можно скачать со страницы http://dev.mysql.com/downloads/connector/odbc/.

ODBC-драйверы полностью поддерживаются в Microsoft Excel и являются предпочтительными.

Желательно использовать Unicode-версию ODBC драйвера для MySQL, т.к. ANSI-версия может иметь проблемы с национальными кодировками.

Провайдер MySQL Data Provider for .NET является встроенным и не требует дополнительных установок.
Но работа с MySQL через этот провайдер возможна только при использовании плагина SaveToDB, т.к. он не поддерживается Microsoft Excel.

Подключение к базе данных MySQL

Формат имени сервера: <Имя или IP-адрес сервера>[;port=<Порт>]

Пример подключения к базе данных test на сервере localhost:

Пример подключения из Excel к базе данных MySQL

Пример подключения к базе данных test на сервере localhost по порту 3306:

Пример подключения из Excel к базе данных MySQL

Подключение к NuoDB

Введение

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

Выбор провайдера подключения

Пример подключения из Excel к базе данных NuoDB - выбор провайдера

NuoDB ADO.NET Driver (NuoDB Data Provider) интегрирован в плагин SaveToDB и не требует установки дополнительных компонент.
Работа с NuoDB возможна только с использованием плагина SaveToDB, т.к. Microsoft Excel не поддерживает работу с использованием .NET провайдеров.

Вы можете загрузить последнюю версию NuoDB ADO.NET Driver с сайта http://www.nuodb.com.

ODBC подключение не поддерживается.

Подключение к базе данных NuoDB

Формат имени сервера: <Имя или IP-адрес сервера>[:<Порт>]

Пример подключения к базе данных test на сервере localhost:

Пример подключения из Excel к базе данных NuoDB

Пример подключения к базе данных test на сервере localhost по порту 48004:

Пример подключения из Excel к базе данных NuoDB

Подключение к PostgreSQL

Введение

Плагин SaveToDB к Microsoft Excel позволяет подключаться к таблицам, представлениям и функциям PostgreSQL.

Ниже описаны специфические возможности подключения к PostgreSQL.

Выбор провайдера подключения

Пример подключения из Excel к базе данных PostgreSQL - выбор провайдера

Для доступа к PostgreSQL можно использовать два типа провайдеров:

  • PostgreSQL ODBC Driver.
  • Npgsql .NET PostgreSQL Data Provider.

ODBC-драйвер можно скачать со страницы http://www.postgresql.org/ftp/odbc/versions/msi/.

ODBC-драйверы полностью поддерживаются в Microsoft Excel. Но они не позволяют подключаться к функциям, которые возвращают курсоры.

Провайдер Npgsql .NET PostgreSQL Data Provider является встроенным и не требует дополнительных установок.
Но работа с PostgreSQL через этот провайдер возможна только при использовании плагина SaveToDB, т.к. он не поддерживается Microsoft Excel.

Подключение к базе данных PostgreSQL

Формат имени сервера: <Имя или IP-адрес сервера>[;port=<Порт>]

Пример подключения к базе данных test на сервере localhost:

Пример подключения из Excel к базе данных PostgreSQL

Пример подключения к базе данных test на сервере localhost по порту 5432:

Пример подключения из Excel к базе данных PostgreSQL

Подключение к веб-источникам данных

Введение

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

Поддерживаются следующие виды веб-источников:

  • Веб-сервисы, включая веб-сервисы OData.
  • Веб-страницы.

Поддерживаются форматы HTML, XML, JSON, CSV.

Поддерживаются следующие способы аутентификации: Windows, Basic, Forms, OAuth 1.0 и OAuth 2.0.

Поддерживаются провайдеры: Google, Facebook, LinkedIn, Twitter, Windows Live, Yahoo, Yahoo API Key.

SaveToDB Enterprise позволяет сохранять данные веб-сервисов OData из Microsoft Excel, если сохранение поддерживается веб-сервисом.

Можно использовать Мастер сохранения данных слиянием для сохранения данных в базу данных.

Также можно настроить сохранение данных в базу данных по кнопке "Сохранить".

Выбор провайдера

Для подключения к веб данным следует выбрать Gartle Web Data Provider.

Подключение из Excel к веб-данным - выбор провайдера

Подключение к веб-источнику данных

Шаг подключения к веб-источникам отличается от подключения к базе данных:

Подключение из Excel к веб-данным - ввод адреса и параметров подключения

На данном шаге следует ввести:

  • URL запроса.
  • Сервисный URL (Service URL).
  • Провайдер авторизации (OAuth Provider).
  • Область действия (Scope).
  • Значение поля Accept.

После ввода url плагин SaveToDB пытается в фоне определить остальные параметры.
Если плагин не может их определить, или необходимо ввести иные параметры, их можно ввести вручную.

В любой момент можно нажать кнопку "Тест подключения" и проверить возможность подключения с указанными данными.

Кнопка "Далее" доступна только для веб-сервисов OData, т.к. далее можно выбрать интересующий объект веб-сервиса.

Для остальных веб-источников активируется кнопка "Готово", т.к. данные конкретного url и будут вставлены в Microsoft Excel.

URL

В целом, url запроса можно просто вставить из браузера.

Для http-запросов также поддерживается переопределение параметров. См. ниже.

В конец url можно также добавить параметры Pages и RootPath. См. ниже.

Сервисный URL

Сервисный url однозначно определен только для веб-сервисов OData. Это корневой адрес веб-сервиса, который выдает сервисный документ (Service Document).

Для обычных веб-сервисов или веб-страниц сервисный url это адрес веб-области, требующий авторизации.

На одном веб-сайте может быть несколько областей, требующих различной авторизации. Эти области и есть сервисные url.

Такие области нельзя определить всегда однозначно точно. Поэтому, возможно, потребуется ручная установка сервисного url.

Ничего страшного в ошибках указания сервисного url нет. Максимум потребуется ввести данные авторизации для других url этого же сайта.

Провайдер авторизации

Плагин поддерживает следующие способы аутентификации:

  1. Windows
  2. Basic
  3. Forms
  4. OAuth 1.0
  5. OAuth 2.0

Первые три способа определяются полностью автоматически и не требуют выбора.
Способ аутентификации OAuth определяется автоматически по веб-сайту url.

Можно вручную указать или, наоборот, убрать выбор провайдера OAuth.

Область действия

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

Accept

Значение поля можно изменить на конкретное значение, если подключение в режиме Auto не получается.

Переопределение параметров http-запросов

Параметры веб-запросов определяются автоматически по url запроса.

Например: http://finance.yahoo.com/q/hp?s=GOOG+Historical+Prices

Данный url содержит один параметр s, в котором задается тикер акции (GOOG) и суффикс "+Historical+Prices".

Для запроса желательно задавать только тикер акции.

Соответственно, можно переопределить параметры запроса в форме {<Имя параметра>=<Значение по умолчанию>}

В приведенном выше примере следует вставить такой url: http://finance.yahoo.com/q/hp?s={Symbol=GOOG}+Historical+Prices

Соответственно, запрос содержит параметр Symbol, который отображается на ленте и позволяет менять запрос.

Параметры парсера

;Pages=<количество страниц>

Задает количество страниц для заданного url.

SaveToDB попробует определить адреса следующих страниц в загруженных данных и загрузить их.
Это возможно не всегда.

Пример загрузки данных опционов с Yahoo! Finance за все даты экспирации:

http://finance.yahoo.com/q/op?s={Symbol=AAPL};pages=20

;RootPath=<путь корневого элемента вывода>

Задает путь корневого элемента вывода.

Для XML или JSON, корневым будет считаться первый элемент, у которого полное имя колонки заканчивается на заданное значение.

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

Для JSON можно указать несколько корневых элементов, разделенных запятыми.

Для HTML указывается номер таблицы на листе, а не имя колонки.
Чтобы найти нужный номер таблицы, можете просто перебрать значения ;rootPath=1, ;rootPath=2 и т.д.

Пример загрузки данных опционов с Google Finance:

http://www.google.com/finance/option_chain?q={Symbol=AAPL}&authuser=0&output=json;RootPath=calls,puts;pages=2

Примеры загрузки финансовой отчетности с Google Finance (Income Statement, Balance, CashFlow):

https://www.google.com/finance?q={Symbol=AAPL}&fstype=ii;RootPath=2
https://www.google.com/finance?q={Symbol=AAPL}&fstype=ii;RootPath=4
https://www.google.com/finance?q={Symbol=AAPL}&fstype=ii;RootPath=6
https://www.google.com/finance?q={Symbol=AAPL}&fstype=ii;RootPath=3
https://www.google.com/finance?q={Symbol=AAPL}&fstype=ii;RootPath=5
https://www.google.com/finance?q={Symbol=AAPL}&fstype=ii;RootPath=7

;CollapsedNodes=<узел>[,...]

Задает имена узлов, которые включают значения дочерних узлов.
При этом для дочерних узлов отдельные колонки не создаются.

Опция доступна только для XML.

Пример:

;CollapsedNodes=passages

;SkippedNodes=<узел>[,...]

Задает имена узлов, которые исключаются из вывода.

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

Опция доступна только для XML.

Пример:

;SkippedNodes=.type

;IgnoredTags=<тег>[,...]

Задает теги, которые игнорируются, и их значения включаются в родительские колонки.

Общий сценарий - исключение тегов форматирования текста.

Опция доступна только для XML.

Пример:

;IgnoredTags=hlword

;NoSourceHeaders=true

Опция отключает использование заголовков HTML таблиц в качестве имен колонок.

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

Пример:

;NoSourceHeaders=true

;AsIs=true

Опция отключает специальные преобразования известных источников данных, например дат в виде timestamp с Yahoo Finance.

Пример:

;AsIs=true

;RowValues=true

В данном режиме парсеры XML или JSON выводят все данные исходного документа в строках в виде пар ключ-значение.

Пример:

;RowValues=true

Выбор объекта подключения

Данный шаг используется для выбора объектов веб-сервисов OData.

В Списке запросов можно выбрать контейнер объектов и далее уже сам объект.

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

Подключение из Excel к OData - выбор объекта OData

Ввод параметров запроса

На данном шаге можно ввести значения параметров запроса.

Для объектов FunctionImport веб-сервисов OData параметры определяются автоматически.

Для http-запросов параметры определяются из url или форматных вставок переопределения параметров, как описано выше.

Подключение из Excel к OData - ввод параметров

Далее работа с данными веб-запросов аналогична работе с обычными объектами баз данных.

Подключение к текстовым файлам

Введение

Плагин SaveToDB к Microsoft Excel позволяет подключаться к текстовым файлам.

Например, веб-страница может быть сохранена в файл и загружена в Microsoft Excel.
Это удобно, если веб-сервер не поддерживает прямое подключение к веб-странице, а только экспорт данных.

Поддерживаются форматы данных: HTML, XML, JSON, CSV.

Мастер подключения плагина SaveToDB выгодно отличается от диалога Microsoft Excel:

  • Мастер позволяет единообразно подключаться к файлам любых типов.
  • Данные из файла можно обновлять по кнопке "Обновить".
  • Можно добавлять формулы к таблице загруженных данных.
  • Можно выбирать кодовую страницу файла данных.

Можно использовать Мастер сохранения данных слиянием для сохранения данных в базу данных.

Также можно настроить сохранение данных в базу данных по кнопке "Сохранить".

Выбор провайдера

Для подключения к веб данным следует выбрать Gartle Text Data Provider.

Подключение из Excel к текстовому файлу - выбор провайдера

Подключение к текстовому файлу

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

Выбираются только имя файла и кодовая страница:

Подключение из Excel к текстовому файлу - выбор файла и кодировки

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

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