Vlastní konektor výkonové platformy

S konektorem Power Platform můžete použít Power Automate, Power Apps, nebo Azure Logic Apps pro automatizaci akcí v Alvao nebo pro integraci Alvao s jinými aplikacemi.

Montáž

1. Rozhodněte, který režim authentication bude konektor používat: OAuth 2.0 (doporučeno) nebo základní autentizace.
2. Pro OAuth 2.0, ve svém Microsoft Entra zvolte existující aplikaci nebo register novou aplikaci pro konektor.
3. V Alvao, vytvořte účet aplikace představující Power Platform a udělte jí potřebná oprávnění.
   1. V Administrace - Uživatelé, použijte příkaz New user'. Vyplňte následující pole:
      • Jméno a příjmení, např.: Power Platform
      • Uživatelské jméno, např.: Power Platform
      • V účtu aplikace, pro OAuth 2.0 se podívejte na aplikaci Microsoft Entra . Pro základní autentizaci zkontrolujte ostatní aplikace .
   2. V případě základní autentizace, vyberte vytvořeného uživatele v tabulce a použijte ... - Změnit heslo příkaz pro nastavení uživatelského hesla.
   3. Assign roles to the account with the Edit - Service team roles command. Používejte Role čtečky nebo roli Správce obsahu pro udělit oprávnění ke čtení nebo aktualizaci.
4. Chcete-li nainstalovat konektor v Power Automate, použijte následující postup. Pro Power Apps a Azure Logic Appsje postup podobný.
   1. Stáhnout a rozbalit archiv ALVAO.PowerPlatform.CustomConnector.zip.
   2. Přihlaste se k Power Automate.
   3. Klikněte na tlačítko Více - Objevte vše.
   4. Použijte Data - vlastní konektory - Nové vlastní rozhraní - importovat OpenAPI souborpříkaz.

      1. Nastavte Název vlastního konektoru, např. ALVAO.

      2. Vyberte soubor ALVAO.PowerPlatform.CustomConnector.swagger.yaml ze staženého archivu a klikněte na Pokračovat.

      3. Na obecnékartě:

         • NahrátALVAO.PowerPlatform.CustomConnector.icon.png jako ikona.
         • Nastavena barva pozadí ikony na #FFFF.
         • Nastavte Host a Základní URL na Alvao REST API url.
         Poznámka

         Pokud nemáte REST API vystaveno internetu, musíte se připojit přes vstupní data bránu. Pro nastavení brány viz Instalace datové brány v obchodech.

      4. Na kartě Zabezpečení vyberte výše zvolený režim ověřování.

      5. Používáte-li OAuth 2.0:

         • Vyberte poskytovatele identity jako Azure Active Directory (Microsoft Entra ID).
         • Nastaveno ID klienta na vaší registrované aplikaci.
         • Nastavte URL dokumentu na URL vaší aplikace Alvao.
         • Po vytvoření vlastního konektoru přidejte vygenerovanou Přesměrovací URL do seznamu URL v registrované aplikaci v MS Entra.

      6. Klikněte na tlačítko Vytvořit konektor. Více informací naleznete v Vytvořit vlastní konektor z OpenAPI definice.

      7. Na Teststránce:

         1. Vyberte Nové připojení:
            • Vyberte metodu ověřování a v případě potřeby poskytněte přístup .
            • Klikněte na tlačítko Vytvořit spojení.
         2. Jako operaci vyberte GetTicket.
         3. Zadejte ID tiketu existujícího tiketu.
         4. Klikněte na tlačítko Testovat.
         5. Stavový kód 200 by měl být vrácen.

      8. Nyní, když přidáte operaci k vašemu toku, můžete vidět konektor ALVAO na záložce Vlastní v designéru.

Rozšířené spouštěče

Kromě spouštěčů podporovaných konektorem, s modulem ALVAO Asset Management Custom Apps nebo ALVAO Service Desk Custom Apps modul, můžete také aktivovat tok energie Automate přímo z kódu Alvao application.

Příklad:

1. Přihlaste se do Power Automate a importujte balíček ALVAO. owerPlatform.FlowTemplate.zip, která je součástí balíčku konektoru.
2. V Alvao - Administrace - Applications, použijte příkaz Import k importu ALVAO.Application.RunFlowOnTicketStateChange.xml souboru.
3. V Administrace - Vlastní pole vytvořte nové vlastní pole entity o stavu tiketu:

Název	Typ	Délka	Stupeň úvěrové kvality 1	Sloupec
Spustit průtok (URL)	nvarchar	2048	TiketStateCust	RunFlowUrl

4. Automaticky při vypnutí, zkopíruje HTTP POST URL z "Když je přijat požadavek HTTP" spouštěč toku.
5. V Alvao - Administrace - Processes, vyberte proces , pro který chcete spouštět tok. Použijte příkaz Editace - Řešení procesu , vyberte konkrétní stav, klikněte na ikonu Upravit stav a vOther vložte aktivační URL do pole Spustit tok (URL).
6. V Administrace - Aplikace, povolte vzorovou aplikaci.

Aplikace spustí tok při každém přechodu tiketu do stavu s aktivační URL v poli Spustit tok (URL) Tok nedělá nic jiného, než odpovídá s kódem 200 a s číslem tiketu. Poté aplikace zaznamenává záznam "Flow byl spuštěn" v podrobném logu tiketu.