В этой статье рассмотрим использование Google Sheets в качестве источника данных для разработки отчетов и дашбордов в Stimulsoft.
Google Sheets — это облачный сервис электронных таблиц от Google. Он работает прямо в браузере, не требует установки программ, а все документы автоматически сохраняются в Google Диске. По сути, это аналог Microsoft Excel, но с акцентом на совместную онлайн-работу. В Stimulsoft каждый лист Google Sheets может использоваться как отдельная таблица данных, на основе которой можно построить отчет или дашборд. Получить данные можно как с общедоступного Google Sheets, так и с ограниченным доступом – разница лишь в необходимости указания параметров авторизации.
После этого в окне Выбор данных (Select Data) отобразятся доступные таблицы (листы), которые можно использовать для разработки отчетов и дашбордов.
Stimulsoft не имеет отношения к проекту Google Cloud Console, однако на момент написания статьи, алгоритм создания проекта выглядит следующим образом:
Теперь нужно скопировать значения Client ID и Client Secret и вставить их в окне создания соединения. Нажать кнопку ОК в окне создания нового соединения. После чего в окне Выбор данных, необходимо будет выбрать таблицы, которые необходимо использовать для разработки отчетов и дашбордов.
Таким образом, можно достаточно легко получать данные из сервиса Google Sheets и на основе этого разрабатывать отчеты и дашборды.
Адаптер данных для Google Sheets
Использовать источник данных Google Sheets можно только в генераторе для платформы .NET. В генераторе отчетов для JavaScript, PHP, Python, Java данный источник не поддерживается. В Stimulsoft BI Designer адаптер устанавливается автоматически при создании источника Google Sheets или открытии отчета с этим источником. При встраивании компонентов Stimulsoft в проект достаточно добавить NuGet-пакет Stimulsoft.Data.GoogleSheets.Получение данных из общедоступных Google Sheet
Создание Google Sheet-источника данных осуществляется фактически точно так же, как и любого другого:- Откройте Словарь данных;
- Выберите команду Новый источник данных (New Data Source) из меню Создать (New);
- На вкладке Google следует выбрать пункт Google Sheets;
- В параметре Общий доступ (General Access) выберите значение Общедоступная ссылка (Anyone with the Link);
- В поле параметра Spreadsheet Id / Url следует вставить ссылку на Google Sheets;
- Нажмите OK.
После этого в окне Выбор данных (Select Data) отобразятся доступные таблицы (листы), которые можно использовать для разработки отчетов и дашбордов.
Получение данных из Google Sheet с ограниченным доступом
Алгоритм создания источника данных аналогичен, но в окне соединения параметр Общий доступ необходимо установить в значение Ограниченный (Restricted). В этом случае, кроме ссылки на Google Sheets, потребуется указать Client ID и Client Secret.Stimulsoft не имеет отношения к проекту Google Cloud Console, однако на момент написания статьи, алгоритм создания проекта выглядит следующим образом:
- Перейти в Google Cloud Console;
- В верхнем меню следует выбрать Select a project - New Project;
- Затем указать название проекта;
- Далее нажать кнопку Create;
- Далее перейти в APIs & Services - Library - Google Sheets API;
- Выбрать пункт APIs & Services - Credentials;
- Далее создать Credentials, вызвав команду Create Credentials - OAuth client ID;
- Также следует указать название приложения;
- Сохранить изменения;
- Выбрать тип приложения: Desktop app (для локальных приложений) или Web application (если будет использоваться в веб-приложении);
- Нажать кнопку Create;
- После создания появится окно с вашими данными: Client ID и Client Secret.
Теперь нужно скопировать значения Client ID и Client Secret и вставить их в окне создания соединения. Нажать кнопку ОК в окне создания нового соединения. После чего в окне Выбор данных, необходимо будет выбрать таблицы, которые необходимо использовать для разработки отчетов и дашбордов.
Таким образом, можно достаточно легко получать данные из сервиса Google Sheets и на основе этого разрабатывать отчеты и дашборды.