Bygg en Power Automate-kobling
Viktig!
Noen av eller alle disse funksjonene er tilgjengelig som en del av en forhåndsversjon. Innholdet i og funksjonaliteten kan endres.
Denne artikkelen viser partnere hvordan de kan opprette en Power Automate-kobling for Microsoft Sustainability Manager.
Hvis du må bygge en Power Query-malkobling, går du til Bygg en Power Query-malkobling.
Trinn 1: Opprett et miljø
I dette trinnet oppretter du en løsning som skal rulles ut til Sustainability Manager-brukere som må importere data med koblingen.
Opprett en ny uadministrert løsning i Power Apps ved å følge instruksjonene i Opprett en løsning.
Installer Sustainability Manager i det miljøet.
Trinn 2: Opprett en koblingsoppføring
I det foretrukne tekstredigeringsprogrammet oppretter du en ny fil med navnet msdyn_dataconnectors.xml.
Kopier og endre følgende XML slik at den passer detaljene dine:
<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>Parameter Detaljer msdyn_dataconnectorid Generer en ny GUID for å identifisere koblingen ved å gå til GUID-format. I eksemplet vårt bruker vi GUID = a1a87c17-40f1-ee11-1fd-6045bdef542d. GUID-en er koblingsidentifikatoren, som du trenger i senere trinn. msdyn_name
msdyn_titleEndre Demo 3P-kobling til navnet på koblingen din. msdyn_connectorstatus La denne verdien være 700610001. Denne verdien representerer en publisert kobling. msdyn_connectortype La denne verdien være 700610006. Denne verdien representerer typen kobling. I dette tilfellet er det verdien for en Power Automate-kobling. msdyn_description Legg til en kort beskrivelse av koblingen. msdyn_supportlinkurl Bytt ut teksten med nettadressen du vil at brukerne skal kontakte hvis tilkoblingen mislykkes. Hvis du vil ha informasjon om testing av mislykkede tilkoblinger, kan du gå til Test for feilhåndtering. Koblingen kan ikke vises i Sustainability Manager uten denne nettadressen. msdyn_logo_text Bruk en koder du velger, til å kode og lagre logobildet i Base 64. Bildet må være 36 x 36 piksler. Lim inn base 64-kodingen i denne parameteren. msdyn_parameterconfiguration Legitimasjonsskjemaet vises i JSON, som Sustainability Manager analyseres for å vise brukergrensesnittet for skjemaet. Endre JSON-eksemplet som er angitt etter denne tabellen, og legg den deretter til i denne parameteren. For msdyn_parameterconfiguration kan du for eksempel bruke JSON-eksempelet som startpunkt.
Merk
Den fullstendige skjemadefinisjonen for msdyn_parameterconfiguration kommer snart.
{ "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" } ] } ] };JSON vises som:
Trinn 3: Opprett en Power Automate-flyt
I dette trinnet oppretter du en Power Automate-flyt for å hente brukerlegitimasjon og importere, transformere og lagre data.
I Power Automate velger du Opprett og velg deretter Automatisert skyflyt.
Angi et flytnavn. Under Velg flytens utløser velger du Dataverse-utløseren Når en rad legges til, endres eller slettes.
Velg Opprett.
Angi egenskapene for utløseren for Når en rad legges til, endres eller slettes i henhold til denne tabellen.
Felt Verdi Endre type Lagt til Tabellnavn Dataimportjobber Område Organisasjonen Velg kolonner Ikke tilgjengelig Filtrer rader _msdyn_dataconnector_value eq <GUID du opprettet tidligere> Legg til en Hent en rad etter ID-handling for å hente legitimasjon fra Dataverse. Hver dataimport du oppretter i Sustainability Manager, har en tilknyttet tilkoblingsoppføring i tabellen msdyn_dataconnection. Datatilkoblingsoppføringen har et oppslag til tabellen msdyn_providercredential, som kobler legitimasjon til tilkoblinger. Denne handlingen leser fra tabellen msdyn_dataconnection og utvider deretter en spørring på msdyn_providercredentialid. Den tilknyttede legitimasjonsoppføringen som er koblet til tilkoblingen, lastes også inn. ID-en for tilkoblingsraden leveres med utløserutdataene.
Du kan nå bruke funksjonen Analyser JSON til å analysere JSON for legitimasjonen.
Merk
Hvis du bestemte deg for å bruke Key Vault og ber brukerne om å opprette legitimasjoner for lagring av miljøvariabler, kan du se denne artikkelen for å lære hvordan du henter legitimasjonen fra Key Vault: Bruk miljøvariabler for Azure Key Vault-hemmeligheter.
Nå som du har legitimasjonen for å hente brukernes data fra datakilden, må du legge til handlinger for å hente data fra kilden ved hjelp av Power Automate-koblinger. Logikken trenger bare å hente trinnvise data siden sist vellykkede oppdatering. Du kan bruke kolonnen msdyn_lastrefresh i tabellen msdyn_dataconnection til å kontrollere siste oppdateringstid. Hvis verdien er null eller tom, kan du anta at det er første kjøring.
Når du har hentet dataene, transformerer du dem til Cloud for Sustainability-datamodell og lagrer dem i en CSV-tabell. En måte er å legge til en Opprett CSV-tabell-handling. Toppteksten for denne tabellen er det logiske navnet på kolonnene for enheten som koblingen importerer. Verdien er enten hardkodet eller kommer fra dataene du hentet ut fra kilden. Eksempel:
Opprett en Sustainability-datatilkoblingstildeling. Legg til en Dataverse-handling for å opprette en ny oppføring i oppføringen for Sustainability-tilkoblingstildelinger.
Før du oppretter denne oppføringen, må du hente definisjons-ID-en for bærekraftsdata for enheten som skal brukes på koblingen. Hvis du vil hente definisjons-ID-en for bærekraftsdata, Velg kategorien Tabeller i portalen Power Apps . Velg alle tabellene, og søk etter Definisjon av bærekraftsdata .
I dette eksemplet fyller du ut de obligatoriske kolonnene sammen med tildelingskolonnen. Angi en hvilken som helst streng i Tildel-kolonnen. Du får tilkoblings-ID-en fra utløseren.
Opprett en tilkoblingsoppdatering, som er forekomsten en tilkobling kjørte. I dette eksemplet kommer msdyn_dataimportjobid og msdyn_dataconnectionid fra utløserutdataene. msdyn_sustainabilitydataconnectionmapid er ID-en til oppføringen du opprettet tidligere.
Oppdater tilkoblingsoppføringen for å knytte den til dataimportjobben. I dette eksemplet kommer msdyn_dataimportjobid og msdyn_dataconnectionid fra utløser utdata: /msdyn_dataimportjobs(msdyn_dataimportjobid=<dataimport-jobb-ID>).
Last opp CSV-filen til oppdateringsoppføringen for datatilkoblingen. Legg til en handling for å laste opp CSV-filen til oppdateringsoppføringen for tilkoblingen du opprettet tidligere med Dataverse-handlingen. Filen skal ikke være over 2 GB.
Utløser den ubundne handlingen ved hjelp av en handling, som utløser importen Dataverse . Angi dataimportJobId som du mottok som en del av utløseren.
