Интеграция WeChat (New WeChat Enterprise) - Справочная документация FineReport|Разработка отчетов|Использование отчетов|Учебные пособия

Интеграция WeChat с предприятиями (новый WeChat Enterprise)

1. Обзор

1.1 Версия

Версия FineBI	Плагин для управления WeChat	Плагин для мобильных презентаций HTML5
6.0	V11.0	V11.0

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

Установка плагина WeChat Management для интеграции WeChat
В настройках вывода планировщика с таймером можно настраивать и отправлять сообщения microsoft
Поддержка интеграции нескольких приложений

Примечание: Примеры представляют собой шаги интеграции в среде развертывания, не являющейся частной.

1.3 Примечания

Предостережения 1

BI-сервер должен быть доступен из внешней сети и должен быть адресом домена, а не IP-адресом. Пример адреса домена http://xxx.xxx.com: xxx/webroot/decision. Если это http://IP:xxx/webroot/decision, то интеграция с microsoft невозможна.

Предостережения 2

BI-сервер должен иметь доступ к экстрасети, если BI-сервер находится в интрасети и не может получить доступ к серверу WeChat, необходимо настроить прокси-сервер, ссылка на конфигурацию прокси-сервера:WeChat Nail Integration Environment Preparation 4.3 Server Private Deployment

2. Предварительная подготовка

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

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

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

2.2 Настройка среды

(1) Не рекомендуется выполнять интеграцию WeChat в локальном проекте, рекомендуется развернуть BI-проект на сервере tomcat, см. развертывание сервера tomcat для выполнения интеграции WeChat.

(2) в конфигурации интеграции, вы должны сначала завершить конфигурацию сетевого окружения, обратитесь к документу: WeChat Nail интеграции среды подготовки

3. Новые приложения

3.1 Фон WeChat для создания приложений

1）После того как администратор войдет в Enterprise WeChat, нажмите "Создать приложение" на вкладке "Управление приложениями", как показано на рисунке ниже:

2) Загрузите "Логотип" приложения, заполните "Название приложения" и "Описание приложения". Установите "Видимый диапазон" (должен быть отдел) и нажмите "Создать приложение" после настройки.

Примечание: Если "Видимая область" - это не отдел, а отдельный пользователь WeChat, информация о пользователе не будет видна в разделе "Управление WeChat > Управление участниками" платформы, поскольку организация справа пуста, а пользователь принадлежит отделу, поэтому он также пуст.

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

3.2 Получение параметров приложения

После успешного создания приложения WeChat необходимо обратить внимание на два параметра:

параметрический	скрытый смысл
CorpID	Идентификатор предприятия
Секрет	код авторизации

3.2.1 CorpID

Нажмите на "Мой бизнес", чтобы просмотреть идентификатор бизнеса, как показано ниже:

Примечание: Корпоративный логотип и аббревиатура могут быть изменены.

3.2.2 Секрет

1) Нажмите на "Управление приложениями" и щелкните на созданных приложениях, как показано ниже:

2) Нажмите, чтобы просмотреть Секрет, как показано ниже:

4. управление WeChat платформы

После установки плагина, описанного в разделе 2.1, войдите в систему Data Decision System с правами администратора и нажмите "Управление системой > Управление WeChat", как показано ниже:

4.1 Управление приложениями

4.1.1 Установка адреса сервера

Вы должны установить "Адрес сервера отчетов" и сохранить его, как показано ниже. Если вы его не установите, могут возникнуть проблемы при проталкивании, например: http: //域名:端口号/webroot/decision.

Примечание: Пожалуйста, используйте доменное имя второго уровня или выше, и необходимо пройти ICP 备案.

4.1.2 Новые корпоративные приложения WeChat

Нажмите "New WeChat App", введите соответствующие "Enterprise App Name", "CorpID" и "Secret", полученные в разделе 3.2, и нажмите OK, как показано на рисунке ниже:

Примечание: Заполните стандартную информацию, имя корпоративного приложения, CorpID, Secret не могут быть пустыми, а имя приложения не может быть продублировано в других приложениях.

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

4.2 Настройка ярлыков приложений

4.2.1 Переход агента WeChat

Экстранет-среда:

Адреса прокси-серверов не нужно задавать для сред экстрасети.

Интранет-среда:

Если BI-сервер настроен в интрасети, необходимо настроить адрес прокси-сервера для доступа к microsoft.

1) Сначала оцените сервер отчетов, пинг qyapi.weixin.qq.com, можно пинговать через, "Weixin управления > приложение ярлык конфигурации > адрес прокси-сервера" не нужно заполнять.

2) пинг не работает, найдите конфигурацию прокси-сервера nginx forward proxy, конфигурация прокси следующая:

  
  
 server { listen 8113; // wechat proxy server port server_name 10.2.  
  
 2.3; // wechat proxy server IP location / { proxy_  
  
 redirect off; proxy_pass https://qyapi.weixin.qq.com;// домен прокси-сервера wechat &nbsp.  
  
; } } location = /favicon.ico { log_  
  
 not_found off; } }

3) Конфигурация платформы

Введите правильный "Адрес прокси-сервера" в текстовое поле, нажмите "Проверить соединение и сохранить", когда соединение будет успешным, появится сообщение "Connection Successful", как показано на рисунке ниже:

Примечание: Когда клиенту необходимо настроить прокси-сервер, вы можете заполнить адрес соответствующего прокси-сервера в конфигурации ярлыка здесь, конкретная конфигурация прокси-сервера может быть обращена к: WeChat Nail Integration Environment Preparation, Section 4.

4.2.2 Быстрая конфигурация домашнего приложения

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

Быстрая настройка домашних приложений:

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

Если клиент хочет использовать настроенную домашнюю страницу для прямого входа в BI-платформу и отображения мобильного каталога, ему достаточно нажать на кнопку WeChat "One Click Configuration", и url будет заполнен автоматически без каких-либо дополнительных действий со стороны пользователя.

Операционная процедура:

1) Выберите "имя корпоративного приложения", которое необходимо настроить, и нажмите "Конфигурация одним щелчком", чтобы быстро настроить приложение типа домашней страницы, что не требует от пользователей перехода в бэкэнд WeChat для повторной настройки. Как показано на рисунке ниже:

(2) Если ссылка на домашнюю страницу и меню приложения WeChat пустые до настройки, после "Настройки в один клик" вы можете войти в только что созданное приложение WeChat в разделе 3, установить меню и добавить ссылку на домашнюю страницу в "Доверенное доменное имя", "Домашняя ссылка приложения" и "Пользовательское меню". Как показано на рисунке ниже:

4.2.3 Генерация ссылок WeChat

Можно сгенерировать два типа микрософтовых ссылок: одна - для единого входа в каталог платформы, другая - для единого входа в шаблон.
При создании ссылки обязательно выберите соответствующее "Имя приложения предприятия".
Сценарии применения: 1) Настройка главной страницы приложения; 2) Планирование по времени на последнем шаге "Обработка файлов > Уведомление клиента" нажимает "Пользовательская ссылка". Вы можете обратиться к документу: Шаги настройки задачи планирования по времени;

4.2.3.1 Генерация ссылок WeChat

1) Создайте ссылку WeChat для доступа к платформе принятия решений

Выберите "Имя корпоративного приложения", связанная страница - "Decision Platform", нажмите "Generate Link" и нажмите "Copy", как показано ниже:

2) Создайте ссылку microsoft для доступа к определенному шаблону

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

Отдельные шаблоны можно настроить для "BI Dashboards" и "Reports":

Если для одного шаблона выбрана "BI Dashboard":

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

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

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

Примечание 2: Об управлении отделами пользователей см. в разделе: Управление пользователями.

При выборе шаблона в разделе "Отчеты" для одного шаблона: обратитесь к разделу 4.2.3 Настройки отдельных шаблонов интеграции Enterprise WeChat на платформе отчетов.

3) Создание пользовательских ссылок

Генерируйте ссылки на легкие приложения, которые можно получить в WeChat.

Сначала выберите "Enterprise App Name", сгенерируйте "Custom Link" и заполните ссылку, сгенерированную в "Mobile Light App ". Затем нажмите "Generate Link" и скопируйте ее. Как показано на рисунке ниже:

Сгенерированные ссылки:

4.2.3.2 Установка ссылки на главную страницу приложения

Перейдите в новое приложение WeChat, созданное в разделе 3, и установите "App Home", как показано ниже:

3) Нажмите кнопку Set Web Address в Workbench App Home, вставьте ссылку WeChat, сгенерированную в BI-платформе, и нажмите OK. Как показано на рисунке ниже:

4) В "Пользовательском меню" нажмите "Настройки", заполните главное меню, установите содержание меню для перехода на веб-страницу, заполните URL (вставленная выше сгенерированная ссылка WeChat), нажмите Сохранить, как показано на следующем рисунке:

Нажмите кнопку Опубликовать, как показано ниже:

5) Нажмите Set Trusted Domain в разделе "Web Authorisation and JS-SDK", введите доверенный домен и нажмите OK. Как показано на рисунке ниже:

4.2.4 Подача заявки на проверку доменного имени

1) Откройте только что созданное приложение в разделе 3, нажмите Применить для домена проверки в разделе Веб-авторизация и JS-SDK и нажмите Загрузить файл, чтобы загрузить файл проверки.

2) Поместите файл проверки txt в корневой каталог. Например:%FineBI_HOME%/webapps/ROOT/. Если вы измените корневую директорию сервера, вам придется внести соответствующие изменения.

Примечание: Локально установленные и развернутые BI и некоторые автономные проекты не имеют путей ROOT. tomcat может создавать свои собственные пути.

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

3) Отметьте файл проверки атрибуции доменного имени, который был загружен, нажмите OK и увидите, что он активирован, что свидетельствует об успешной проверке доменного имени. Как показано на рисунке ниже:

Доверенным доменом в примере является: secure.finedevelop.com:63777

4.2.5 Новые группы WeChat

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

Примечание: Помимо руководителя группы, в ней должно быть не менее 2 участников.

Для получения дополнительной информации см. документацию: Уведомление клиента о расписании - Уведомление APP

После успешного добавления он будет показан на следующем рисунке:

4.3 Управление членством

4.3.1 Методы подбора пользователей

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

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

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

Примечание 2: Предприятие WeChat безопасности политики обновления, предприятие WeChat в userId для пользователя информации интерфейс, больше не возвращается номер мобильного телефона.

Поэтому новым приложениям, созданным после 2022-06-20, не рекомендуется использовать сопоставление номеров мобильных телефонов, вы можете использовать другие функции метода сопоставления, такие как сопоставление микросигналов, но старые приложения это не затрагивает.

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

Примечание 4: Если сопоставление пользователей не удалось, при входе пользователя в систему через Enterprise WeChat единый вход не удастся, и имя пользователя и пароль придется вводить заново.

Микросигнальный матч:

В таблицах Micro Signal Match и Mobile Number Match отображаются одинаковые столбцы.

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

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

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

Примечание: Информация о пользователях не хранится в определенной таблице.

Ручное согласование:

Если метод сопоставления - ручной, в списке пользователей WeChat появится столбец "имя пользователя отчета", нажмите на выпадающее поле, выберите соответствующее имя пользователя отчета для сопоставления вручную. Как показано на рисунке ниже:

Примечание 1: При ручном подборе имя пользователя BI поддерживает выбор опции "Не выбрано".

Примечание 2: Метод ручного сопоставления заключается в том, что пользователи могут свободно выбирать пользователя BI, который соответствует пользователю WeChat, и несколько пользователей WeChat могут быть сопоставлены с одним и тем же пользователем BI.

Пользовательский матч:

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

Когда вы выбираете Custom Matching, внизу появляется дополнительный пункт "Настройки сопоставления", в котором выберите набор данных, имя пользователя WeChat и имя пользователя отчета для сопоставления. Как показано на рисунке ниже:

Примечание: столбец WeChat User заполняется именем пользователя WeChat при пользовательском подборе.

4.3.2 Обновление адресной книги

Нажмите кнопку "Обновить сейчас" слева, чтобы немедленно обновить содержимое адресной книги. Вы также можете установить таймер для обновления.
Нажмите кнопку "Установить автообновление", чтобы вызвать окно настройки и установить частоту обновления.

Примечание 1: Если метод сопоставления пользователей - "Сопоставление микросигналов" или "Сопоставление номеров мобильных телефонов", если пользователь добавляет, удаляет или изменяет пользователей BI или добавляет, удаляет или изменяет пользователей WeChat в фоновом режиме, необходимо вручную синхронизировать обновление адресной книги.

Примечание 2: Если метод сопоставления пользователей - "Ручное сопоставление" или "Пользовательское сопоставление", если пользователь добавляет, удаляет или изменяет пользователей BI или добавляет, удаляет или изменяет пользователей WeChat в фоновом режиме, обновлять синхронизацию не нужно.

5. просмотр результатов

После завершения интеграции пользователи смогут просматривать проекты и панели FineBI на ПК и мобильных устройствах WeChat.

5.1 WeChat для предприятий

Перейдите в Enterprise WeChat, нажмите Workbench, выберите FineBI WeChat Integration, и пользователь увидит каталоги, которые можно просматривать в пределах его полномочий, как показано на следующем рисунке:

5.2 Личный WeChat

Приведенное выше описание является эффектом на предприятии WeChat.

В обычном WeChat можно отсканировать QR-код, а номер предприятия появится в обычном WeChat, где вы сможете просматривать содержимое главной страницы или получать push-сообщения.

1) В разделе "Контакты" нажмите кнопку WeChat Invitation, чтобы пригласить внимание и отсканировать QR-код, чтобы присоединиться к этому бизнесу. Как показано на рисунке ниже:

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

Если установлен флажок "Всегда переходить на домашнюю страницу в плагине WeChat", push-сообщения не будут приниматься.
Если вы не установите флажок "Всегда переходить на домашнюю страницу в плагине WeChat" и отключите "Получать сообщения только в Enterprise WeChat" в разделе "Enterprise WeChat Me > Настройки > Уведомление о новом сообщении", личный WeChat сможет получать push-сообщения, а вы сможете проверять содержимое push-сообщений и настраивать пользовательское меню, как показано на рисунке ниже:

6. Передача сообщений WeChat

1） Перейдите в раздел [[Общие] Задание времени для отправки сообщений в приложение](https://help.finereport.com/doc-view-1387.md) и выберите уведомление WeChat на шаге "Обработка файлов", как показано на следующем рисунке:

(2) Пользователи Enterprise WeChat могут получать сообщения, войдя в Enterprise WeChat. Как показано на рисунке ниже:

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

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

7.1 Открытые белые списки интранета

При интеграции WeChat некоторые клиенты используют интранет-среду, в которой не все веб-страницы доступны, но убедитесь, что вы можете получить доступ к домену WeChat: https://qyapi.weixin.qq.com.

7.2 Эффект WeChat для ПК или мобильных устройств предприятия

Пользователи надеются, что после интеграции Enterprise WeChat, когда они будут использовать PC Enterprise WeChat, они смогут показывать эффект ПК, а не мобильный.

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

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

2 (2).png

7.3 Сетевые аномалии

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

Интеграция WeChat предприятия показана на следующем рисунке, когда в платформе создается новое приложение WeChat:

Когда вы добавляете CorpID и другую информацию, он продолжает сообщать об ошибке: network exception, please check the network configuration or access_token is empty, incorrectly set corpId and secret, как показано на следующем рисунке:

2) Решения

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

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

7.4 Ошибка входа в код WeChat

Проблемные явления:

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

报错.png

Причина проблемы:

На платформе пользователь не привязан к номеру мобильного телефона.

Решение:

1) Вы можете войти на платформу, чтобы сначала привязать свой номер мобильного телефона;

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

7.5 Единый вход в WeChat работает медленно

Проблемные явления:

От нажатия кнопки приложения до отображения каталога в WeChat проходит 3 с. На местном уровне это обычно занимает 3-4 секунды.

Причина проблемы:

Помимо влияния сети и производительности мобильного телефона, на скорость работы одноточечника также влияет передача данных и загрузка страницы js. Загрузка страницы H5 имеет следующие трудоемкие моменты: один из них - запрос js ресурсов, в целом от 1 до 2 секунд, а затем браузер загружает ресурсы в память, около 200 миллисекунд, и, наконец, графический рендеринг также требует некоторого времени, что приводит к медленной загрузке страницы.

8. Решение проблем с интеграцией WeChat

(1) настроена ли среда: подготовка среды интеграции микробукв

(2) использование инструментов для устранения всех видов общих (единый вход сбой, синхронизация контактов сбой, сообщение толчок сбой) проблемы: микро письмо ногтей отладки инструментов, микро письмо ногтей толчок / один / синхронизации сбой через журнал позиционирования

(3) Ошибки в "Управлении приложениями" на странице "Управление WeChat"; ошибки в расписании отправки сообщений по времени; сетевые аномалии и т. д.: ошибки в списке прикрепленных приложений WeChat

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