Brug en brugerdefineret connector fra et flow

Bemærk

Dette emne er en del af en serie af selvstudier om oprettelse og anvendelse af brugerdefinerede connectorer i Azure Logic Apps, Power Automate og PowerApps. Sørg for at læse oversigten over brugerdefinerede connectorer for at forstå processen.

I dette emne skal du opbygge et basisflow, der anvender den brugerdefinerede connector, du har oprettet i et tidligere emne. Flowet udløses, når et element føjes til en SharePoint-liste, og flowet bruger den brugerdefinerede connector til at kalde Cognitive Services-Tekstanalyse-API. Connectoren returnerer synspunktresultatet (0 til 1) for teksten i listeelementet, og flowet skriver resultatet tilbage til listen. På følgende billede vises det færdige flow:

Færdigt flow for synspunktsanalyse

Forudsætninger

Oprette SharePoint-listen

Du skal først oprette en simpel liste med tre kolonner i SharePoint Online. På denne liste gemmes filmanmeldelsesdata, som flowet analyserer for synspunkter. Du kan finde flere oplysninger om SharePoint-lister under Introduktion til lister i SharePoint-dokumentationen.

  1. Vælg Ny og derefter Liste i SharePoint Online.

    Oprette ny SharePoint-liste

  2. Angiv navnet Filmanmeldelser, og vælg derefter Opret.

    Angive navn til ny liste

    Listen oprettes med standardfeltet Titel.

    Liste over projektanmodninger

  3. Vælg ikonet for nyt element og derefter Enkelt tekstlinje.

    Tilføje en enkelt tekstlinje

  4. Angiv navnet Anmeldelse, og vælg derefter Gem.

  5. Gentag trin 3. og 4. for at føje endnu en kolonne til listen: Brug datatypen Tal og navnet Score.

Opret et flow ud fra listen

SharePoint Online giver mulighed for at oprette flow direkte fra en liste, så vi bruger denne tilgang. Du kan oprette det samme flow fra flow.microsoft.com.

  1. På SharePoint-listen skal du vælge Flow og derefter Opret et flow.

    Opret et flow

  2. Vælg Vis flere i ruden til højre.

    Vis flere flow

  3. Vælg skabelonen Når et nyt element tilføjes i SharePoint, fuldføres en brugerdefineret handling.

    Brugerdefineret handling for SharePoint

    Den brugerdefinerede handling i dette tilfælde kalder API'en via den brugerdefinerede connector.

  4. Kontrollér, at du er logget på SharePoint med den rette konto, og vælg derefter Fortsæt.

    SharePoint-connectortilladelser

  5. I flow.microsoft.com skal du vælge Rediger. Du bør nu kunne SharePoint-webstedet og den liste, hvor du startede Opret et flow-processen.

    Bekræft websted og liste

Tilføj den brugerdefinerede connector

Der blev oprettet et grundlæggende flow i Power Automate med en udløser, der aktiveres, når der føjes et element til SharePoint-listen. Nu skal du tilføje handlinger, der skal udføres på baggrund af det element, der tilføjes.

  1. Vælg Nyt trin og derefter Tilføj en handling.

  2. Søg efter den connector, du har oprettet, og vælg den handling, der er knyttet til den pågældende connector.

    Vælg SentimentDemo -handling

    Navnet på og beskrivelsen af handlingen stammer fra oplysninger, du angav, da du oprettede connectoren.

  3. Angiv værdier for alle felter.

    Connectorparametre

    Parameter Værdi
    Sprog "en"
    Id "1"
    Tekst SharePoint-feltet Anmeldelse (fra dialogboksen Dynamisk indhold)

    Id kræves, fordi connectoren kan håndtere flere dokumenter. I disse eksempler sender du ét dokument ad gangen. I et produktionsflow kan Sprog- og ID-værdier komme fra en liste eller en anden datakilde.

  4. Vælg Nyt trin og derefter Tilføj en handling.

  5. Tilføj handlingen SharePoint - Opdater element, og angiv værdier for alle felterne.

    Handlingen Opdater listeelement

    Parameter Værdi
    Webstedsadresse Adressen på det SharePoint Online-websted, hvor du startede Opret et flow-processen.
    Listenavn Den liste, hvor du startede Opret et flow-processen
    Id SharePoint-feltet ID
    Titel SharePoint-feltet Titel
    Gennemse SharePoint-feltet Anmeldelse
    Score Feltet score i brugerdefineret connector

    Når du tilføjer det dynamisk indhold for feltet Score, skal du bemærke, at Power Automate tilføjer objektbeholderen Anvend på alle, fordi den registrerer, at den brugerdefinerede connector accepterer flere dokumenter. Dit flow sender kun ét ad gangen, men det er godt, at flowet matcher funktionerne i connectoren.

    Anvend på alle

    Det færdige flow bør nu ligne følgende billede:

    Færdigt flow for synspunktsanalyse

  6. Angiv et navn på dit flow, f.eks. Synspunktsanalyse, og vælg derefter Opret flow og Udført.

Test flowet

Nu, hvor flowet er færdigt, er det tid til at teste det ved at føje anmeldelser til SharePoint-listen og se, hvordan flowet reagerer.

  1. Vælg Hurtig redigering på SharePoint Online-listen.

    SharePoint-listen Hurtig redigering

  2. Føj to anmeldelser til listen (én negativ og én positiv), og vælg derefter Udført.

    Hurtig redigering er udført

    Parameter Foreslået værdi
    Titel (positiv) Min yndlingsfilm
    Anmeldelse (positiv) "Jeg nød den nye film efter en lang dag"
    Titel (negativ) En anden film
    Anmeldelse (negativ) "Den værste film, jeg længe har set"
  3. I flow.microsoft.com skal du vælge Mine flows og derefter vælge det flow, du har oprettet.

    Vælg nyt flow

  4. Når du ser på KØRSELSHISTORIK, bør du kunne se to kørsler, én for hver anmeldelse du har føjet til listen.

    Kørselshistorik

  5. Opdater browseren på SharePoint-listesiden for at se de scorer, flowet har tilføjet.

    Scorer, der er tilføjet fra flow

Nu er du helt færdig! Dette er et enkelt flow, men det opnår kraftfuld funktionalitet ved at kunne kalde Cognitive Services via en brugerdefineret connector.

Næste trin

Del connectoren i din organisation, og/eller få connectoren certificeret, så folk uden for din organisation kan bruge den: