Оформление
Справочная документация FineReport|Разработка отчетов|Использование отчетов|Учебные пособия
Инструмент для отладки WeChat Nail
1. Обзор
1.1 Сценарии применения
Решает различные проблемы, возникающие в процессе интеграции WeChat, значительно повышая эффективность работы. Например, в процессе интеграции WeChat, если вы обнаружите, что сеть не может получить доступ к услугам WeChat, не может синхронизировать адресную книгу, не может получить сообщение push и т. д., вы можете использовать инструмент отладки WeChat для обнаружения аномалий, и на основе аномалий выяснить причину, чтобы помочь пользователю найти направление решения.
1.2 Функциональный профиль
Обеспечить WeChat / Nail отладки инструмент, открытый режим отладки, способный отображать журнал отладки содержание. Отладка функции следующим образом:
- основное свойство
- единая регистрация
- сообщение
- Определение расхода времени на запрос
1.3 Вход в интерфейс отладки
Страница отладки WeChat
Добавьте /url/weixin/start/debugger после адреса сервера BI, чтобы войти на страницу отладки WeChat.
Страница отладки Nail
Добавьте /url/dingtalk/start/debugger после адреса сервера BI, чтобы перейти на страницу отладки.
1.4 Предостережения
Для WeChat Management Plugin и Pinned Management Plugin
- Версия до V11.0.68: WeChat и Nail могут получить доступ к интерфейсу отладки, перейдя по ссылке.
- V11.0.68 и более поздние версии: доступ к старому порталу отладки WeChat Pin будет перенаправлен на страницу "WeChat Management/Pin Management", и вы сможете использовать его, переключившись на "Debugging Tools".
| Интеграционные плагины | ссылка доступа |
|---|---|
| Управление WeChat | Добавьте /url/weixin/start/debugger в адрес платформы. |
| Управление Nail | Добавьте /url/dingtalk/start/debugger к адресу платформы. |
Поскольку в мобильную версию интегрирован тот же "инструмент отладки", в этой статье в качестве примера рассматривается плагин управления булавками.
2. Отладка WeChat
2.1 Вход в интерфейс отладки
1) Войдите в интерфейс отладки WeChat: http: //secure.finedevelop.com:63778/webroot/decision/url/weixin/start/debugger, откроется страница, как показано ниже:
Отлаживаемым содержимым являются: основные свойства, единый вход, push-сообщения и определение времени, прошедшего с момента запроса. Как показано на рисунке ниже:
Примечание: Пожалуйста, заполните информацию в соответствии с нормами, каждый параметр не может быть пустым.
Примечание: Поддерживается тестирование группы corpid&secret, которой нет в списке приложений, и отладка основных атрибутов, она может правильно вывести Token, отдел и адрес сервера, но доверенное имя домена выдает сообщение "WeChat приложение не было добавлено на данный момент, и доверенное имя домена пусто".
2.2 Основные свойства
2.2.1 Роль в обнаружении
Контрольная точка: просмотр доступа к информации о пользователе.
Функция: Убедитесь, что параметры, сеть и соответствующее приложение WeChat настроены правильно.
2.2.2 Операционные шаги
Используйте параметры, используемые в разделе "Управление WeChat", чтобы добавить приложения WeChat для тестирования. После нажатия кнопки " Начать тестирование " явление при нормальной конфигурации показано на рисунке ниже:
2.2.3 Обнаружение аномалий
Исключение 1: Если токен не получен, будет выдано сообщение об ошибке.
Возможная причина 1: Неполадки в сети, пользовательская среда может не иметь доступа к серверу WeChat. Решение: Необходимо устранить неполадки в сети;
Возможная причина 2: Используемые параметры WeChat неверны, включая, но не ограничиваясь: ① идентификатор и секрет не совпадают; ② соответствующий секрет был сброшен, так что оригинальный секрет не может быть использован; ③ соответствующее секретное приложение было удалено/деактивировано.
Исключение 2: Если полученный список пользователей департамента пуст
Возможная причина 1: Диапазон видимости не установлен для соответствующего приложения;
Возможная причина 2: Область видимости установлена на одного пользователя (обычно выбирается отдел или тег), но в настоящее время область видимости не поддерживает выбор только пользователей для получения информации о пользователе.
2.3 Единая регистрация
2.3.1 Роль в обнаружении
Проверьте, правильно ли подобран пользователь и верна ли единая ссылка пользователя.
2.3.2 Операционные шаги
Переключите отладочный контент для единого входа, больше пользователей WeChat и домашней страницы / меню ссылка два параметра, введите соответствующую информацию, нажмите на начало теста, отображение результатов теста информации: Token, отчет пользователя информации. При нормальных обстоятельствах страница отладки показана на рисунке ниже:
2.3.3 Обнаружение аномалий
Если результаты отладки не соответствуют действительности, необходимо проверить, нет ли проблем с параметрами заполнения, не настроено ли соответствие, или генерация url не является правильной, конфигурация доверенного доменного имени не является правильной и т.д., конкретный справочный документ: Enterprise WeChat (новый WeChat Enterprise) Integration
2.4 Push-сообщения
2.4.1 Операционные шаги
Переключите содержимое отладки на сообщения, дополнительные параметры пользователя, нажмите Start Detection, введите соответствующую информацию, страница отладки при нормальных обстоятельствах выглядит следующим образом:
Для каждого теста из приложения WeChat в WeChat будет отправлено тестовое сообщение, как показано ниже:
2.4.2 Обнаружение аномалий
Если вы не можете получить тестовое сообщение, это может быть проблемой на стороне приложения WeChat, например, на телефоне не включен прием сообщений, в фоновом режиме WeChat блокируются запросы и т.д.
2.5 Определение прошедшего времени запроса
2.5.1 Роль в обнаружении
В некоторых сценариях медленного доступа к клиенту можно использовать инструмент обнаружения для проверки времени запроса, потребляемого на клиентской среде, чтобы определить, влияет ли сеть на фактическое использование.
2.5.2 Процедура
Выберите "Обнаружить время запроса" и нажмите "Начать обнаружение". Как показано на рисунке ниже:
3. Отладка контактов
3.1 Вход в интерфейс отладки
1) Войдите в интерфейс отладки: http: //secure.finedevelop.com:63778/webroot/decision/url/dingtalk/start/debugger, откроется страница, как показано ниже:
Отлаживаемое содержимое: получение access_token, проверка белого списка ip, определение времени выполнения запроса. Как показано на рисунке ниже:
Примечание: Пожалуйста, заполните информацию в соответствии с нормами, каждый параметр не может быть пустым.
Примечание: Используйте управление выводами для добавления подключенных приложений, используемых для проверки параметров, подробности см. в документе: плагины для управления выводами
3.2 Получение access_token
3.2.1 Роль инспекции
Убедитесь, что сеть работает.
3.2.2 Операционные шаги
Используйте управление прикрепленными приложениями, чтобы добавить прикрепленное приложение, используемое для тестирования параметров, явление при нормальной конфигурации показано на рисунке ниже:
3.2.3 Проверка на наличие аномалий
Если токен не получен, вероятно, в сети произошли сбои, пользовательская среда может не иметь доступа к серверу Nail, необходимо проверить сетевую ситуацию.
3.3 Проверка белого списка ip-адресов
3.3.1 Роль инспекции
Функция: Проверяет, есть ли ip в белом списке.
Сценарий: Nail приложение будет проверять белый список IP при добавлении, если Nail фон управления не настроен с этим IP, приложение не будет добавлен успешно, но должны заполнить конкретные, что IP, часто это экспорт IP не знаю, как получить.
С помощью этой функции вы можете проверить конфигурацию белого списка перед добавлением прикрепленного приложения, если IP нет в белом списке, соответствующий IP будет распечатан в результате обнаружения, так что вы можете напрямую скопировать IP на сторону прикрепленного фонового приложения, чтобы нормально добавить.
3.3.2 Операционные шаги
Проверьте белый список IP-адресов приложения Nail с помощью параметра Nail. Если выходной IP-адрес текущего тестового сервера был добавлен в конфигурационную информацию приложения Nail, отобразится следующий рисунок:
3.4 Определение прошедшего времени запроса
Процедура аналогична WeChat. Дополнительные сведения см. в разделе 3.5.