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

V aplikaci Alvao vytvořte aplikační účet reprezentující platformu Power Platform a přidělte mu potřebná oprávnění.
1. V nabídce Administrace - Uživatelé použijte příkaz Nový uživatel. Vyplňte následující pole:
  - Vyplňte následující položky:Jméno a příjmení, např
  - Uživatelské jméno, např. Power Platform
  - Zaškrtněte volbu Application account - Other applications (Účet aplikace - Ostatní aplikace ).
2. V tabulce vyberte vytvořeného uživatele a pomocí tlačítka .. . - Change password (Změnit heslo) nastavte heslo uživatele.
3. Přiřaďte účtu oprávnění ke službám pomocí příkazu Upravit - Oprávnění. Pomocí role Čtenář nebo Správce přidělte oprávnění ke čtení, resp. aktualizaci.
Pro instalaci konektoru v aplikaci Power Automate použijte následující postup. Pro 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. Použijte příkaz Data - Vlastní konektory - Nový vlastní konektor - Importovat soubor OpenAPI
  1. Nastavte název Vlastní konektor, například ALVAO.
  2. Zvolte 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. Klikněte na tlačítko Vytvořit konektor. Další informace naleznete v části Vytvoření vlastního konektoru z definice OpenAPI.
  5. Na stránce Test
    1. Vyberte možnost Nové připojení
      - Zadejte uživatelské jméno a heslo účtu aplikace Power Platform v systému Alvao.
      - Použijte základní ověření.
      - Klikněte na tlačítko Vytvořit připojení.
    2. Jako operaci vyberte GetRequest.
    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.
  6. Nyní se při přidávání operace do toku zobrazí konektor ALVAO na kartě Vlastní v návrháři.

Akce

Název akce	Popis
Create request	Vytvoří nový požadavek.
Get request	Vrátí pole požadavku.
Update request	Aktualizuje pole požadavku.
Create record in request log	Vytvoří nový záznam v protokolu požadavků.
Assign request to solver or solver team	Přiřadí požadavek řešiteli nebo řešitelskému týmu.
Change request state	Převádí požadavek ve stavu požadavku.
Move request to another service	Přesune požadavek do služby.

Další podrobnosti naleznete ve specifikaci rozhraní.

Vlastní pole

Konektor podporuje také čtení a zápis hodnot z/do vlastních polí požadavků. 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 poli Get request akce. Např. pro načtení hodnoty pole TicketCategory použijte výraz:
outputs('Get_request')?['body/customItems/TicketCategory/value']

Chcete-li zapsat hodnotu vlastního pole požadavku, použijte výraz Update request 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"
  }
}

Poznámka

Znak "@" je zdvojen z důvodu escapování

Spouštěče

Pomocí modulu ALVAO Service Desk Custom Apps můžete spouštět tok Power Automate přímo z kódu libovolné aplikace Alvao.

Příklad

Nastavení příkladu:

Přihlaste se na Power Automate a importujte balíček ALVAO.PowerPlatform.FlowTempate.zip, který je součástí balíčku konektoru.
V nabídce Alvao - Administrace - Aplikace použijte příkaz Import a importujte soubor ALVAO.Application.RunFlowOnTicketStateChange.xml.

V Administrace - 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

V aplikaci Power Automate zkopírujte adresu HTTP POST URL z adresy "When an HTTP request is received" trigger of the flow.
V nabídce Alvao - Správa - Procesy vyberte proces, pro jehož požadavky chcete, aby byl tok spuštěn. 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).
V nabídce Administrace - Aplikace povolte ukázkovou 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á, pouze odpovídá kódem 200 a tělem s číslem požadavku.
Poté aplikace zaznamená záznam "Flow was triggered" v podrobném protokolu požadavku.

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