Power Platform connector

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

Instalace

1. Rozhodněte, jaký režim ověřování bude konektor používat: OAuth 2.0 (doporučeno) nebo základní ověření.
2. Pro OAuth 2.0 vyberte v aplikaci Microsoft Entra existující aplikaci nebo zaregistrujte novou aplikaci pro konektor.
3. V Alvao vytvořte účet aplikace reprezentující Power Platform a přidělte jí potřebná oprávnění.
   1. V nabídce 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 poli Účet aplikace zaškrtněte pro OAuth 2.0 možnost Aplikace Microsoft Entra. Pro základní ověření zaškrtněte možnost Ostatní aplikace .
   2. V případě základního ověření vyberte vytvořeného uživatele v tabulce a použijte tlačítko . ... - Změnit heslo nastavte heslo uživatele.
   3. Přiřaďte účtu role pomocí příkazu Upravit - Role servisního týmu. Použijte roli Čtenář, resp. roli Správce pro udělení oprávnění ke čtení, resp. aktualizaci.
4. Pro instalaci konektoru v aplikaci Power Automate použijte následující postup. Pro webovou stránku Power Apps a Azure Logic Appsje postup podobný.
   1. Stáhněte a rozbalte archiv ALVAO.PowerPlatform.CustomConnector.zip.
   2. Přihlaste se k webu Power Automate.
   3. Klepněte na tlačítko More - Discover all (Více - Objevit vše ).
   4. Použijte příkaz Data - Vlastní konektory - Nový vlastní konektor - Importovat soubor OpenAPI
      1. Nastavte název Vlastní konektor, například ALVAO.
      2. Zvolte možnost ALVAO.PowerPlatform.CustomConnector.swagger.yaml soubor ze staženého archivu a klikněte na tlačítko Pokračovat.
      3. Na kartě Obecné
         • Nahrát ALVAO.PowerPlatform.CustomConnector.icon.png jako ikonu.
         • Nastavte barvu pozadí ikony na #FFFFFF.
         • Nastavte Hostitelskou a základní adresu URL na adresu Alvao REST API url.
         Poznámka

         Pokud nemáte adresu REST API vystavenou internetu, musíte se připojit prostřednictvím lokální datové brány. Nastavení brány naleznete v části Instalace lokální datové brány
      4. Na kartě Zabezpečení vyberte výše zvolený režim ověřování.
      5. Při použití OAuth 2.0
         • Identity Provider vyberte Azure Active Directory (Microsoft Entra ID).
         • Nastavte ID klienta na vaši registrovanou aplikaci Entra ID.
         • Nastavte adresu URL zdroje na URI vaší aplikace Alvao ID.
         • Po vytvoření vlastního konektoru přidejte vygenerovanou adresu URL přesměrování do seznamu adres URL v registrované aplikaci v MS Entra.
      6. Klikněte na tlačítko Vytvořit konektor. Další informace naleznete v části Vytvoření vlastního konektoru z definice OpenAPI.
      7. Na stránce Testování
         1. Vyberte možnost Nové připojení
            • Vyberte metodu ověřování a v případě potřeby zadejte přístupové údaje.
            • Klikněte na tlačítko Vytvořit připojení.
         2. Jako operaci vyberte GetTicket.
         3. Zadejte ID existujícího požadavku.
         4. Klikněte na tlačítko Testovací operace.
         5. Měl by se vrátit stavový kód 200.
      8. Nyní se při přidávání operace do toku zobrazí konektor ALVAO na kartě Vlastní v návrháři.

Akce

Další podrobnosti naleznete ve specifikaci rozhraní.

Vlastní pole

Konektor podporuje také čtení a zápis hodnot z/do vlastních polí požadavku. Vlastní pole nelze popsat v obecné definici konektoru, takže pro jejich zpracování je třeba použít následující techniky

Chcete-li přečíst hodnotu vlastního pole požadavku, použijte výrazy v příkazu Get ticket akce. Např. pro načtení hodnoty pole TicketCategory použijte výraz:
outputs('Get_ticket')?['body/customItems/TicketCategory/value']

Chcete-li zapsat hodnotu do vlastního pole požadavku, použijte výraz Update ticket akci s vlastní specifikací JSON. Např. pro zápis hodnoty "monitor failure" do pole TicketCategory použijte tuto specifikaci v poli Vlastní položky

{
  "TicketCategory": {
    "@@odata.type": "#Alvao.Rest.Api.Models.SD.CustomItem",
    "name": "TicketCategory",
    "value": "monitor failure"
  }
}

Spouštěče

V tocích Power Automate jsou k dispozici následující spouštěče podporované konektorem.

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

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

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 nabídce Alvao - Správa - Aplikace použijte příkaz Importovat a importujte soubor ALVAO.Application.RunFlowOnTicketStateChange.xml.
3. V Správa - Vlastní pole vytvořte nové vlastní pole entity Stav požadavku

   Název	Typ	Délka	Tabulka	Sloupec
   Průběh (URL)	nvarchar	2048	TicketStateCust	RunFlowUrl

4. V aplikaci Power Automate zkopírujte adresu HTTP POST URL z adresy "When an HTTP request ipožadavkyived" trigger of the flow.
5. V nabídce Alvao - Správa - Procesy vyberte proces, pro jehož požadavky chcete spouštět tok. Použijte příkaz Upravit - Řešení procesu, vyberte konkrétní stav, klikněte na ikonu Upravit stav a v sekci Ostatní vložte URL adresu spouštěče do pole Spustit tok (URL).
6. V nabídce Správa - Aplikace povolte ukázkovou aplikaci.

Aplikace spustí tok vždy, když požadavek přejde do stavu s URL spouštěče v poli Spustit tok (URL ).
Tok nic nedělá, pouze odpovídá kódem 200 a tělem s číslem požadavku.
Poté aplikace zaznamená záznam "Flow was triggered" do podrobného protokolu požadavku.

Nenašli jste co jste hledali? Zeptejte se našeho týmu technické podpory.