dox42

Łącznik dox42 zapewnia połączenie z bardzo rozbudowanym interfejsem API REST dox42 i umożliwia automatyczne generowanie dokumentów w przepływie z danymi ze wszystkich źródeł, takich jak D365, SharePoint lub inne.

Ten łącznik jest dostępny w następujących produktach i regionach:

Dox42 udostępnia zaawansowany i bardzo rozbudowany interfejs API REST. Za pomocą polecenia dox42 można automatycznie generować dokumenty z danymi ze wszystkich źródeł, takich jak D365, SharePoint, SAP lub inne. dox42 używa identyfikatora Entra firmy Microsoft do uwierzytelniania. Zwróć dokument w dowolnym formacie, zapisz go w programie SharePoint, wyślij go pocztą e-mail, podpisz elektronicznie, dołącz go jako notatkę do jednostki itp. wszystko to jest możliwe automatycznie z dox42.

Wymagania wstępne

Aby kontynuować, musisz wykonać następujące czynności:

• Plan usługi Microsoft Power Apps lub Power Automate
• Microsoft Entra ID
• Znajomość protokołu HTTP
• licencja dox42 (dox42 Online lub dox42 Server + dox42 Word/Excel/PowerPoint Dodatki)
• aplikacja dox42 Server Designer (wersja 1.0.1.4 lub nowsza)
• SharePoint Online

Jak uzyskać poświadczenia

Rejestrowanie aplikacji Microsoft Entra ID dla łącznika Premium

Najpierw musimy zarejestrować aplikację dox42 jako aplikację w identyfikatorze Entra firmy Microsoft. Pozwoli to łącznikowi zidentyfikować się jako identyfikator Entra firmy Microsoft, aby mógł poprosić o uprawnienia dostępu do danych w imieniu użytkownika końcowego. Więcej informacji na ten temat można znaleźć tutaj

Ta aplikacja Microsoft Entra ID musi być zarejestrowana w witrynie Azure Portal (https://portal.azure.com), wykonując kroki opisane w rozdziale 6 dokumentacji dox42 Microsoft Entra ID: https://www.dox42.com/Download/dox42_DynamicsCRM_Documentation_EN.pdf. Nie zapomnij dodać następującego identyfikatora URI odpowiedzi internetowej do aplikacji: https://global.consent.azure-apim.net/redirect

W tym momencie mamy prawidłową aplikację Microsoft Entra ID, która może służyć do uzyskiwania uprawnień od użytkowników końcowych i uzyskiwania dostępu do generowania dokumentów dox42. Następnym krokiem jest zmodyfikowanie łącznika Premium.

Generowanie tokenów dostępu i identyfikatorów na zewnątrz lub w przepływach

• Metoda 1

  • Za pomocą narzędzia Postman lub dowolnego innego narzędzia do testowania interfejsu API można wygenerować tokeny dostępu identyfikatora Entra firmy Microsoft i tokeny identyfikatorów
  • Następnie możesz wkleić ten klucz dostępu do odpowiedniego pola "Token dostępu elementu nośnego" łącznika dox42

• Metoda 2 (zalecana)

  • W przepływach użyj łącznika HTTP Premium, aby wygenerować tokeny dostępu lub identyfikatora
  • Za pomocą polecenia "Redaguj" możesz zapisać token w zmiennej, która może być używana w polu "Token dostępu elementu nośnego" łącznika dox42

• W przypadku obu metod można zapoznać się z następującymi artykułami:

  • https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
  • https://docs.microsoft.com/en-us/azure/databricks/dev-tools/api/latest/aad/app-aad-token

Rekomendacje

Zdecydowanie zalecamy korzystanie z funkcji "Bezpieczne dane wejściowe/wyjściowe" w przepływach, dzięki czemu żadne poufne informacje nie są widoczne jako zwykły tekst. Ponadto usługa Azure Key Vault może służyć do przechowywania wpisów tajnych, haseł i tak dalej i łatwo integrować się z przepływami.

Wprowadzenie do łącznika

• W przypadku wywoływania generowania dokumentu dox42 wstaw ciąg zapytania wygenerowany w aplikacji dox42 Server Designer podczas projektowania przepływu. Aby uzyskać więcej informacji, postępuj zgodnie z naszą dokumentacją łącznika niestandardowego dox42: https://www.dox42.com/Download/dox42_dox42Connector.pdf

• Przykładem takiego ciągu zapytania jest:

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

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Limity ograniczania

Akcje

dox42 Service Call