Плагин JD Cloud для докинга отчетов - FineReport Справка | Разработка отчетов | Использование отчетов | Учебные пособия

Отчет Докинг Jandao Cloud Plugin

1. Обзор

1.1 Версия

Версия FineBI	Версия пакета JAR	Версия плагина
5.0	2020-08-04	V1.9

1.2 Сценарии применения

Jandao Cloud - это профессиональный инструмент для сбора данных и управления данными. Он позволяет вам создать собственную платформу управления данными с помощью онлайн-сбора данных, анализа данных и совместной работы.

FineBI устанавливает "Report Docking Jandao Cloud Plugin", который может обеспечить стыковку данных с Jandao Cloud и предоставить клиентам лучшие решения для работы с данными.

Примечание: Плагин не поддерживает стыковку с Jandao Cloud Exclusive версией на данный момент.

1.3 Функциональный профиль

Данные из Jandao Cloud могут быть извлечены в частное хранилище с помощью FineBI. И FineBI будет обновляться с обновлением данных Jandao Cloud, когда Jandao Cloud будет включена в режим push.

1.4 Сравнение программ

Этап сравнения	Вариант 1	Вариант 2
Введение в программу	Метод, описанный в этой статье, достигается установкой плагина "Report Docking to Jandao Cloud". Когда Jandao Cloud открывает push, данные в частном хранилище будут обновлены с учетом обновления данных в Jandao Cloud.	Эта статья не является введениемАлгоритм ввода данных из облака Jandao в продукте FineDataLink, который получает данные из определенной формы облака Jandao через регулярные промежутки времени.
Куда уходят данные	Синхронизация данных только с базой данных MySQL	Данные могут быть синхронизированы с более чем тридцатью типами источников данных, как показано ниже: Типы источников данных, поддерживаемых Data Development Базы данных, поддерживающие "запись данных" в формыПримечание: Jandao Cloud Output Calculator может выводить обработанные данные в форму Jandao Cloud для использования Jandao Cloud.
При поддержке Jandawun	Только публичное облако	Поддержка публичных облаков и собственных версий
обработка данных	Данные в Jandao Cloud извлекаются непосредственнов базу данных MySQL через FineBI.	1）Поддержка настройки и изменения данных облака Jandao перед синхронизацией данных 2） Поддержка визуального разбора массива формата json
эксплуатация и обслуживание (O&M)	-	Полная поддержка выполнения задач и устранения ошибок, а также восстановление после сбоев и устранение неполадок в случае возникновения ошибок.

2. Операционные шаги

Необходимо обратить внимание на следующие моменты:

1) Если проект BI существует в %BI_HOME%/webapps/webroot/WEB-INF/lib/commons-codec-1.6.jar, вам необходимо удалить его.

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

3) Если вам нужно передавать данные, адрес сервера FineBI должен быть настроен для внешней сети.

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

4) В настоящее время плагин поддерживает только базы данных MySQL.

2.1 Установка плагинов

Напишите на почту info@biconsult.ru, чтобы получить плагин.

Об установке плагинов см. раздел: Управление плагинами

После того как плагин установлен и включен по умолчанию, администратор входит в систему принятия решений и нажимает на "Management System > Jandao Cloud Docking", что позволяет войти на страницу конфигурации. Как показано на рисунке ниже:

2.2 Создание ключа API в JD Cloud

В случае входа в Jandao Cloud и покупки, на следующем рисунке показано, что вы можете просмотреть API ключ Jandao Cloud, т.е. Jandao Cloud Key, если вы не видите API ключ, нажмите на Create API Key, чтобы сделать это. Если вы не видите API-ключ, нажмите кнопку Создать API-ключ:

2.3 Включение функции Data Push для Jandao Cloud Forms

Data Push (Webhook) может передавать данные формы на сервер FineBI, введение и использование функции описано в файле справки JD Cloud: Data Push

Примечание: Если требуется передача данных, адрес сервера FineBI должен быть настроен для внешней сети.

1) После создания формы перейдите в раздел "Расширения " и нажмите "Data Push > New Data Push", как показано на следующем рисунке:

2) Выберите "FineReport Server" в позиции "Target Server", заполните адрес сервера, формат адреса: http: //主机名:端口/工程名/decision/view/report?op=fs_jdy.

Примечание 1: Имя хоста в адресе указывает на доменное имя или IP-адрес интернет-хоста, к которому можно получить доступ через внешнюю сеть, после чего следует "/project name/decision/view/report?op=fs_jdy".

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

Примечание 2: Пожалуйста, заполняйте адрес сервера строго в соответствии с форматом адреса, указанным в документе, при этом суффикс "/view/report?op=fs_jdy" не может быть опущен.

Пример:

http://116.48.6.212:8080/webroot/decision/view/report?op=fs_jdy

http://eqg5xg.natappfree.cc/webroot/decision/view/report?op\=fs\_jdy, где порт 80 по умолчанию опущен.

Щелкните Test Connection Successful и сохраните его.

3) Настройка завершена, как показано ниже:

Примечание: Этот шаг должен быть успешным, чтобы форма работала, если толчок не удался, Jandao Cloud повторит попытку до 5 раз. Если 5 повторных попыток подряд окажутся неудачными, data push будет отключен для этой формы, а администратор будет уведомлен об этом сообщением. Администратору нужно будет перезапустить data push в настройках data push для продолжения отправки данных.

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

2.4 Подключаемая синхронизация данных формы

2.4.1 Настройка ассоциации для первой синхронизации данных

1) Администратор входит в систему принятия решений, нажимает "Management System>Jandao Cloud Docking>Data Synchronisation>Configuration Association", заполняет ключ Jandao Cloud, заполняет информацию частной базы данных: включая драйвер, адрес, имя пользователя, пароль, в примере используется база данных MySQL, как показано на следующем рисунке:

Необходимо обратить внимание на следующие моменты:

• Частные библиотеки пока поддерживают только базы данных MySQL.
• Формат "адреса" таков: jdbc:mysql://IP:номер порта/<имя базы данных>.
• Синхронизация базы данных MySQL с текстом, содержащим эмодзи, приведет к ошибке, поэтому сначала необходимо изменить кодировку базы данных MySQL на utf8mb4.
• Если данные, переданные Jandao Cloud, являются массивом, FineBI преобразует их в строку, и они должны быть разделены символами ",".

2) Нажмите "Начать подключение", после успешного подключения нажмите "Начать синхронизацию", после чего появится сообщение "Синхронизация успешна", как показано на рисунке ниже:

3) После успешной синхронизации вы увидите, что статус изменился на "Успешная ассоциация", и в то же время формы в JD Cloud также синхронизируются с личной библиотекой, как показано на рисунке ниже:

Примечание: Некоторые таблицы, синхронизируемые с базой данных MySQL, содержат поле _childid, которое представляет собой идентификатор текущей дочерней формы; _id представляет собой идентификатор родительской формы.

2.4.2 Изменение имен таблиц частных библиотек

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

2.4.3 Синхронизация форм или данных формы

Как только Jandao Cloud настроен на push, формы синхронизируются в режиме реального времени. Если вы не настроили push и установили только связанную библиотеку в Data Decision Platform, вам нужно будет вручную нажать на кнопку, чтобы синхронизировать обновления форм.

Настройки синхронизации показаны ниже:

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

2.5 Оперативный мониторинг

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

3. больше функциональности

3.1 Настройка хранилища

1) Конфигурационная информация, связанная с частной библиотекой, хранится в файле jdyconfig.xml, xml в папке, где находится плагин, например: /WEB-INF/plugins/plugin-com.fr.plugin.third.integrate.jdy-1.0/jdyconfig.xml

2) Соответствие между формой и названием таблицы хранится в базе данных (в синхронизированной базе данных MySQL )

После успешной настройки частной библиотеки в базу данных добавляется новая таблица JDY_CONFIG (с цифровым номером, если она уже существует, начиная с 0) со следующей структурой:

поле	скрытый смысл
id	первичный ключ
jdyformid	Jandao облако форма id
jdyformname	Название формы Jandao Cloud
frtablename	Имя таблицы частной библиотеки

3) Соответствие между ID и реальным именем поля таблицы хранится в базе данных (в синхронизированной базе данных MySQL).

В базу данных добавляется новая таблица JDY_FIELD_CONFIG (с цифровым номером, если она уже существует, начиная с 0) со следующей структурой таблицы:

поле	скрытый смысл
id	первичный ключ
jdyformid	Jandao облако форма id
jdyfieldid	Jandao облако поле id
jdyfieldname	Название поля Jandao Cloud

В таблице JDY_FIELD_CONFIG существуют следующие фиксированные идентификаторы полей:

Идентификатор поля	скрытый смысл
создатель	автор
программа обновления	модератор
удалитель	ремувер
createTime	Время подачи
updateTime	время обновления
deleteTime	Время удаления
flowState	состояние процесса
ext	Расширенные поля

4. Предостережения

4.1 Сбой в базе данных MySQL

Если база данных MySQL, используемая для создания отчетов, содержит ошибки, см. раздел: Решение проблемы ошибок в базе данных MySQL на китайском языке.

4.2 Запрет API-запросов к зарезервированным адресам

Описание проблемы

Когда данные проталкиваются, происходит сбой с ошибкой: отправка API-запросов на зарезервированные адреса запрещена. Как показано на рисунке ниже:

Анализ причин

Адрес сервера отчетов FineBI не является экстрасетью.

Рецепт

При пересылке данных адрес сервера FineBI должен быть настроен для внешней сети. Если сервер находится в интрасети, необходимо настроить уровень пересылки, в конфигурации сервера пересылки Jane Dao cloud network whitelist, конкретные ip и доменные имена Jane Dao cloud можно уточнить у технического персонала FanSoft. Контакты технической поддержки: "Сервисная платформа>Онлайн поддержка", телефон "400-811-8890".

4.3 Неправильные параметры

Описание проблемы

Ошибка в ассоциации конфигурации отчета: неверный параметр. Как показано на рисунке ниже:

Анализ причин

Облачный ключ Jandao заполнен неверно.

Рецепт

Обратитесь к разделу 2.2 данного документа, чтобы скопировать правильный ключ Jandao Cloud.

4.4 Сбой синхронизации без данных

Описание проблемы

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

Рецепт

Кодировка базы данных установлена на utf-8. Подробности см. в разделе 2.3 документации по настройке внешней базы данных MySQL5.