Vlastní konektor Power Platform

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

Instalace

1. Rozhodněte, který authentication režim bude konektor používat: OAuth 2.0 (doporučeno) nebo Základní autentizace.
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 Správa - Uživatelé, použijte příkaz Nový uživatel. Vyplňte následující pole:
      • Jméno a příjmení, např.: Power Platform
      • Uživatelské jméno, např.: Power Platform
      • V Aplikačním účtu, pro OAuth 2.0 vyberte možnost Microsoft Entra aplikace. Pro základní autentizaci zkontrolujte možnost Ostatní aplikace.
   2. V případě základní autentizace, vyberte vytvořeného uživatele v tabulce a použijte příkaz ... - Změnit heslo k nastavení hesla uživatele.
   3. Přiřaďte role účtu pomocí příkazu Upravit - Řešitelský tým služby. Použijte role čtenáře nebo role správce k udělení oprávnění pro čtení nebo aktualizaci příslušně.
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 svůj REST API vystavený na internetu, potřebujete se připojit prostřednictvím lokální datové brány. Pro nastavení brány viz Instalovat on-premises datovou bránu.

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

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

         • Vyberte Poskytovatel 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 vygenerované Redirect URL do seznamu URL ve zaregistrované aplikaci v MS Entra.

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

      7. Na Teststránce:

         1. Vyberte Nové připojení:
            • Vyberte metodu autentizace a poskytněte přístupové údaje podle potřeby.
            • 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áváte operaci do svého toku, můžete vidět ALVAO konektor na záložce Vlastní v návrháři.

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

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

Příklad:

1. Přihlaste se do Power Automate a importujte balíček ALVAO.PowerPlatform.FlowTemplate.zip, který je součástí konektorového balíčku.
2. V Alvao - Správa - Aplikace použijte příkaz Import k importu souboru ALVAO.Application.RunFlowOnTicketStateChange.xml.
3. V Správa - Vlastní pole vytvořte nové vlastní pole entity stavu požadavku:

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

4. V Power Automate zkopírujte HTTP POST URL z "When an HTTP request is received" trigger of the flow.
5. V Alvao - Správa - Procesy vyberte proces, pro který chcete, aby požadavky spouštěly flow. Použijte příkaz Upravit - Pracovní postup, vyberte konkrétní stav, klikněte na ikonu Upravit stav a v sekci Ostatní vložte URL spouště do pole Run flow (URL).
6. V Správa - Aplikace, povolte vzorovou aplikaci.

Aplikace spustí tok vždy, když požadavek přejde do stavu požadavku 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 požadavku. Poté aplikace zaznamená v podrobném protokolu požadavku záznam "Tok byl spuštěn".