Поделиться через

dox42

Соединитель dox42 обеспечивает подключение к очень обширному REST API dox42 и позволяет автоматически создавать документы в потоке со всеми источниками, такими как D365, SharePoint или другие.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Поддержка dox42
URL https://www.dox42.com/Contact
Адрес электронной почты support@dox42.com
Метаданные соединителя
Publisher dox42
Веб-сайт https://www.dox42.com/
Privacy Policy (Политика конфиденциальности) https://www.dox42.com/Privacy
Категории Содержимое и файлы; Данные

dox42 предоставляет мощный и очень обширный REST API. Используя dox42, вы можете автоматически создавать документы с данными из всех источников, таких как D365, SharePoint, SAP или другие. dox42 использует идентификатор Microsoft Entra для проверки подлинности. Верните документ в любом формате, сохраните его в SharePoint, отправьте его по электронной почте, подпишите его в электронном виде, вложите его в виде заметки к сущности и т. д. все это возможно автоматически с помощью dox42.

Предпосылки

Для продолжения вам потребуется следующее:

  • План Microsoft Power Apps или Power Automate
  • Майкрософт Ентра айди
  • Знание HTTP
  • лицензия dox42 (dox42 Online или dox42 Server + dox42 Word/Excel/PowerPoint)
  • Приложение конструктора серверов dox42 (версия 1.0.1.4 или более поздней версии)
  • SharePoint Online

Получение учетных данных

Регистрация приложения Идентификатора Microsoft Entra для соединителя premium

Сначала необходимо зарегистрировать dox42 в качестве приложения в идентификаторе Microsoft Entra. Это позволит соединителю идентифицировать себя в идентификаторе Microsoft Entra, чтобы он смог запросить разрешения на доступ к данным от имени конечного пользователя. Дополнительные сведения об этом см. здесь

Это приложение идентификатора Microsoft Entra должно быть зарегистрировано на портале Azure (https://portal.azure.com), выполнив действия, описанные в главе 6 документации https://www.dox42.com/Download/dox42_DynamicsCRM_Documentation_EN.pdfпо идентификатору Microsoft Entra: Не забудьте добавить следующий код ресурса (URI веб-ответа) в приложение: https://global.consent.azure-apim.net/redirect

На этом этапе у нас есть допустимое приложение Идентификатора Microsoft Entra, которое можно использовать для получения разрешений от конечных пользователей и доступа к документу dox42. Следующим шагом для нас является изменение соединителя premium.

Создание маркеров доступа и идентификаторов извне или в потоках

  • Метод 1

    • С помощью Postman или любого другого средства тестирования API можно создать маркеры доступа и маркеры доступа к идентификаторам Microsoft Entra
    • Затем можно вставить указанный ключ доступа в соответствующее поле "Маркер доступа носителя" соединителя dox42.

  • Метод 2 (рекомендуется)

    • В потоках используйте соединитель HTTP premium для создания маркеров доступа или идентификатора.
    • С помощью Compose можно сохранить маркер в переменной, которую можно использовать в поле "Маркер доступа носителя" соединителя dox42.

  • Для обоих методов можно ознакомиться со следующими статьями:

Recommendations

Мы настоятельно рекомендуем использовать функцию "Безопасные входные и выходные данные" в потоках, поэтому конфиденциальная информация не отображается как чистый текст. Кроме того, Azure Key Vault можно использовать для хранения секретов, паролей и т. д. и легко интегрируется в потоки.

Начало работы с соединителем

  • Для вызова создания документов dox42 вставьте строку запроса, созданную в приложении конструктора серверов dox42, при проектировании потока. Дополнительные сведения см. в документации по пользовательскому соединителю dox42: https://www.dox42.com/Download/dox42_dox42Connector.pdf

  • Примером для такой строки запроса является:

    Operation=GenerateDocument&DocTemplate=c%3A%5Cdox42Server%5Ctemplates%5CHelloWorldTest%5CHelloWorld.docx&InputParam.name=World&ReturnAction.Format=txt&

Создание подключения

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

По умолчанию

Применимо: все регионы

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

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

Имя Тип Description Обязательно
Маркер доступа носителя securestring Маркер доступа носителя или маркер идентификатора для проверки подлинности идентификатора Microsoft Entra

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Вызов службы dox42

Вызов службы dox42

Вызов службы dox42

Идентификатор операции:
dox42_Call

Вызов службы dox42

Параметры

Имя Ключ Обязательно Тип Описание
Доменное имя настроенного сервера dox42
 domainname True string

Доменное имя
Запрос части требуемого вызова службы dox42
 querystring True string

Строка запроса вызова службы
Маркер доступа носителя
 token True string

Маркер доступа носителя для проверки подлинности идентификатора Microsoft Entra
Базовый заголовок accept, оставьте как есть!
 accept string

Базовый заголовок accept