Vlastní konektor výkonové platformy

Pomocí konektoru Power Platform můžete k automatizaci akcí v systému Alvao nebo k integraci systému Alvao s jinými aplikacemi použít aplikace Power Automate, Power Apps nebo Azure Logic Apps.

Instalace

1. Rozhodněte, který režim ověřování bude konektor používat: OAuth 2.0 (doporučeno) nebo Základní ověřování.
2. Pro OAuth 2.0 vyberte ve svém Microsoft Entra stávající aplikaci nebo zaregistrujte 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. Přiřaďte účtu role pomocí příkazu Edit - Service team roles . 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. U Power Apps a Azure Logic Apps je 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 požadavku existujícího požadavku.
         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 můžete pomocí modulu ALVAO Asset Management Custom Apps nebo ALVAO Service Desk Custom Apps spustit tok Power Automate přímo z kódu libovolné aplikace.

Příklad:

1. Přihlaste se do aplikace Power Automate a importujte balíček ALVAO.PowerPlatform.FlowTemplate.zip, který je součástí balíčku konektoru.
2. V části Alvao - Administration - Applications importujte pomocí příkazu Import soubor ALVAO.Application.RunFlowOnTicketStateChange.xml.
3. V Administrace - Vlastní pole vytvořte nové vlastní pole entity o stavu požadavku:

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

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

Aplikace spustí tok vždy, když tip přejde do stavu tipu s URL spouštěče v poli Spustit tok (URL). Tok nic nedělá, ale odpovídá kódem 200 a tělem s číslem tipu. Poté aplikace zaznamená v podrobném protokolu tiketu záznam "Tok byl spuštěn".