Vytvoření konektoru Power Automate

Článek
12/23/2024

Důležité

Některé nebo všechny tyto funkce jsou k dispozici jako součást vydání verze Preview. Obsah a funkce se mohou změnit.

Tento článek ukazuje partnerům, jak vytvořit konektor Power Automate pro Microsoft Sustainability Manager.

Pokud potřebujete vytvořit konektor šablony Power Query, přejděte na Vytvoření konektoru šablony Power Query.

Krok 1: Vytvoření prostředí

V tomto kroku vytvoříte řešení pro distribuci uživatelům Sustainability Manager, kteří potřebují importovat data pomocí vašeho konektoru.

Vytvořte nové nespravované řešení v Power Apps podle pokynů v části Vytvoření řešení.
Nainstalujte Sustainability Manager do tohoto prostředí.

Krok 2: Přidání záznamu konektoru

V preferovaném textovém editoru vytvořte nový soubor s názvem msdyn_dataconnectors.xml.

Zkopírujte a upravte následující XML, aby odpovídal vašim údajům:

   <msdyn_dataconnectors>
     <msdyn_dataconnector msdyn_dataconnectorid="a1a87c17-40f1-ee11-1fd-6045bdef542d">
       <iscustomizable>1</iscustomizable>
     <msdyn_name>Demo 3P Connector</msdyn_name>
     <msdyn_title>Demo 3P Connector</msdyn_title>
       <msdyn_connectorstatus>700610001</msdyn_connectorstatus>
       <msdyn_connectortype>700610006</msdyn_connectortype>
       <msdyn_description>Demo 3P connector</msdyn_description>
       <msdyn_supportlinkurl>https://www.microsoft.com</msdyn_supportlinkurl>
       <msdyn_logo_text>
       </msdyn_logo_text>
       <msdyn_parameterconfiguration>   
       </msdyn_parameterconfiguration>
     </msdyn_dataconnector>
   </msdyn_dataconnectors>

Parametr	Detaily
msdyn_dataconnectorid	Vygenerujte nové GUID k identifikaci vašeho konektoru, dodržujte formát GUID. V našem příkladu používáme GUID = a1a87c17-40f1-ee11-1fd-6045bdef542d. Váš GUID je váš identifikátor konektoru, který budete potřebovat v pozdějších krocích.
msdyn_name msdyn_title	Změňte Ukázkový 3P konektor na název vašeho konektoru.
msdyn_connectorstatus	Ponechte tuto hodnotu na 700610001. Tato hodnota představuje publikovaný konektor.
msdyn_connectortype	Ponechte tuto hodnotu na 700610006. Tato hodnota představuje typ konektoru. V tomto případě je to hodnota pro konektor Power Automate.
msdyn_description	Přidejte krátký popis svého konektoru.
msdyn_supportlinkurl	Nahraďte text adresou URL, kterou mají uživatelé kontaktovat, pokud se připojení nezdaří. Informace o testování neúspěšných připojení naleznete v části Test zpracování chyb. Bez této adresy URL se váš konektor nemůže zobrazit v Sustainability Manager.
msdyn_logo_text	Pomocí kodéru podle svého výběru zakódujte a uložte obrázek loga do Base 64. Obrázek musí mít 36 × 36 px. Do tohoto parametru vložte kódování base 64.
msdyn_parameterconfiguration	Formulář pověření je reprezentován ve formátu JSON, který Sustainability Manager analyzuje, aby zobrazil uživatelské rozhraní formuláře. Podle potřeby změňte ukázkový JSON uvedený za touto tabulkou a poté jej přidejte do tohoto parametru.

Pro msdyn_parameterconfiguration můžete použít tento ukázkový JSON jako výchozí bod.

Poznámka:

Úplná definice schématu pro msdyn_parameterconfiguration přijde brzy.

{
    "parameterGroups": [
        {
            "label": "Login",
            "fields": [
                {
                    "displayLabel": "Username",
                    "type": "text",
                    "key": "username",
                    "required": true,
                    "description": "Enter the username to login with"
                },
                {
                    "displayLabel": "Password",
                    "type": "text",
                    "key": "password",
                    "mask": true,
                    "required": true
                }
            ]
        },
        {
            "label": "Data extraction parameters",
            "fields": [
                {
                    "displayLabel": "Watermark Date",
                    "type": "datetime",
                    "key": "watermarkDate"
                },
                {
                    "displayLabel": "Organization Unit",
                    "type": "text",
                    "key": "organizationUnit"
                },
                {
                    "displayLabel": "Facility",
                    "type": "text",
                    "key": "facility"
                },
                {
                    "displayLabel": "Installation instructions",
                    "type": "note",
                    "text": "To use this connector, you should first create an environment variable that contains the login credentials. Then create a flow that uses this connector."
                },
                { 
                    "displayLabel": "How to create an environment variable in Azure Key Vault",
                    "type": "link",
                    "url": "https://docs.microsoft.com/azure/azure-functions/functions-how-to-use-azure-function-app-settings#settings"
                }
            ]
         }
   ]
};

Tento JSON se zobrazuje jako:

Krok 3: Vytvořte tok Power Automate

V tomto kroku vytvoříte tok Power Automate pro načtení uživatelských přihlašovacích údajů a pro import, transformaci a uložení dat.

V Power Automate vyberte Vytvořit a potom vyberte Automatizovaný cloudový tok.
Zadejte název toku. V části Vyberte trigger toku vyberte trigger Dataverse Když je přidán, upraven nebo odstraněn řádek.
Vyberte Vytvořit.

Zadejte vlastnosti spouštěče pro Při přidání, změně nebo odstranění řádku podle této tabulky.

Pole	Hodnota
Změnit typ	Přidáno
Název tabulky	Úlohy importu dat
Obor	Organization (Organizace)
Vyberte sloupce	–
Řádky filtru	_msdyn_dataconnector_value eq <GUID, který jste vytvořili dříve>

Použijte akci Získat řádek podle ID k načtení přihlašovacích údajů z Dataverse. Každý import dat, který vytvoříte v Sustainability Manager, má přidružený záznam připojení v tabulce msdyn_dataconnection. Tento záznam datového připojení má vyhledávání v tabulce msdyn_providercredential, která propojuje přihlašovací údaje s připojeními. Tato akce se přečte z tabulky msdyn_dataconnection a poté rozšíří dotaz na msdyn_providercredentialid. Načte také přidružený záznam přihlašovacího údaje propojený s připojením. ID řádku připojení je poskytnuto výstupům spouštěče.
Nyní můžete pomocí funkce Parsovat JSON parsovat JSON přihlašovacího údaje.

Poznámka:

Pokud jste se rozhodli použít Key Vault a vyzvat uživatele k vytvoření přihlašovacích údajů proměnných prostředí, můžete se v tomto článku dozvědět, jak načíst přihlašovací údaje z Key Vault: Použití proměnných prostředí pro tajné klíče Azure Key Vault.
Nyní, když máte přihlašovací údaje k získávání dat uživatelů ze zdroje dat, musíte přidat akce pro načtení dat ze zdroje pomocí konektorů Power Automate. Vaše logika potřebuje pouze získat přírůstková data od posledního úspěšného obnovení. Ke kontrole doby poslední aktualizace můžete použít sloupec msdyn_lastrefresh v tabulce msdyn_dataconnection. Pokud je hodnota null nebo prázdná, můžete předpokládat, že se jedná o první spuštění.
Po načtení dat je transformujte do datového modelu Cloud for Sustainability a uložte je do tabulky CSV. Jedním ze způsobů je přidat akci Vytvořit tabulku CSV. Záhlaví této tabulky je logický název sloupců pro entitu, kterou konektor importuje. Hodnota je buď pevně zakódována, nebo pochází z dat, která jste extrahovali ze zdroje. Příklad:
Vytvořte mapování připojení dat udržitelnosti. Přidejte akci Dataverse k vytvoření nového záznamu v záznamu map datového připojení udržitelnosti.

Před vytvořením tohoto záznamu získejte ID definice dat udržitelnosti pro entitu, která se má zpracovat s konektorem. Chcete-li získat ID definice dat udržitelnosti, na portálu Power Apps vyberte kartu Tabulky . Vyberte všechny tabulky a vyhledejte Definice dat udržitelnosti.

V tomto příkladu vyplňte požadované sloupce spolu se sloupcem mapy. Do sloupce Mapa zadejte libovolný řetězec. ID připojení získáte ze spouštěče.
Vytvořte obnovení připojení, což je instance, ve které bylo připojení spuštěno. V tomto příkladu msdyn_dataimportjobid a msdyn_dataconnectionid pocházejí z výstupu triggeru. msdyn_sustainabilitydataconnectionmapid je ID záznamu, který jste vytvořili dříve.
Aktualizujte záznam připojení tak, aby byl přidružen k úloze importu dat. V tomto příkladu msdyn_dataimportjobid a msdyn_dataconnectionid pocházejí ze spouštěče výstup: /msdyn_dataimportjobs(msdyn_dataimportjobid=<ID úlohy importu dat>).
Nahrajte soubor CSV do záznamu obnovení datového připojení. Přidejte akci k nahrání souboru CSV do záznamu obnovení připojení, který jste dříve vytvořili pomocí akce Dataverse. Váš soubor by neměl mít více než 2 GB.
Spusťte nevázanou akci pomocí akce Dataverse , která spustí import. Zadejte dataimportJobId, které jste obdrželi jako součást spouštěče.