Anvende en brugerdefineret connector fra en Power Apps-app

I dette emne skal du opbygge en basisapp, der anvender den brugerdefinerede connector, du har oprettet i et tidligere emne. Appen tager tekstinput og bruger derefter den brugerdefinerede connector til at kalde Cognitive Services-Tekstanalyse-API. Connectoren returnerer synspunktscoreen (0 til 1) for teksten, og appen viser den som en procentdel. På følgende billede vises den færdige app:

Forudsætninger

• Et Power Apps-abonnement.
• Grundlæggende erfaring med opbygning af apps i Power Apps. Du kan finde flere oplysninger under Oprette en app fra bunden.
• Den brugerdefinerede connector, du har oprettet i et af disse emner:
  • Opret en brugerdefineret connector fra OpenAPI-definition
  • Opret en brugerdefineret connector fra en Postman-samling
  • Oprette en brugerdefineret connector fra bunden

Opret appen, og tilføj den brugerdefinerede connector

Det første, du skal gøre, er at oprette en app fra bunden og derefter oprette forbindelse til den brugerdefinerede connector, du har oprettet i et tidligere emne.

1. På make.powerapps.com skal du vælge Start fra bunden > (telefon) > Opret denne app.

   

2. Vælg Opret forbindelse til data på app-lærredet.

3. Vælg den forbindelse, du har oprettet i et tidligere emne (f.eks. "SentimentDemo"), i panelet Data.

4. Gem appen med navnet Sentiment Analysis.

Tilføje kontrolelementer i appen

Du skal nu opbygge brugergrænsefladen for appen, så du kan skrive tekst, sende den pågældende tekst til API' og modtage et svar.

1. Tilføj et rektangelikon som titellinje, og tilføj derefter etiketten "Sentiment Analysis".

   

2. Tilføj etiketten "Skriv din tekst, klik derefter på Hent score", og tilføj derefter et kontrolelement til tekstinput.

   

3. Tilføj en knap med teksten "Hent score".

   

4. Tilføj etiketten "Synspunktscoren er". I næste afsnit skal du tilføje en formel for at fuldføre denne etiket.

   

Tilføj formler for at skabe funktionsmåde

Med dataforbindelsen og brugergrænsefladen på plads kan du nu tilføje Power Apps-formler, der styrer appens funktionsmåde. Formlerne kalder API'en ved hjælp af den brugerdefinerede connector, lagrer resultatet i en samling (en variabel i tabelformat) og viser derefter det formaterede resultat i appen.

1. Vælg den knap, du har oprettet, og angiv derefter egenskaben OnSelect for knappen til navnet på connectoren (inklusive punktummet).

   SentimentDemo.
   

   Power Apps giver dig en indstilling for automatisk fuldførelse af DetectSentiment, fordi den brugerdefinerede connector gør dette tilgængeligt.

2. Indstil nu egenskaben OnSelect for knappen til følgende formel.

   ClearCollect(sentimentCollection, SentimentDemo.DetectSentiment(
       {id:"1", language:"en", text:TextInput1.Text}).documents.score)
   

   Denne formel henter synspunktscoren fra API'en og gemmer den i en samling:

   1. Formlen kalder DetectSentiment-funktionen med de tre parametre, der eksponeres af den brugerdefinerede connector: id, language og text. Vi angiver værdier for de to første direkte i formlen og henter værdien for Text fra kontrolelementet til tekstinput (du kan også trække de to første værdier fra et andet sted i en app).

   2. Funktionen returnerer en score for hvert dokument, som du sender. I vores eksempler sender vi ét dokument ad gangen. Scoren går fra 0 (negativ) til 1 (positiv).

   3. Formlen kalder derefter funktionen ClearCollect for at fjerne eventuelle eksisterende værdier fra sentimentCollection og tilføje værdien fra score.

3. Vælg den etiket, du har oprettet, og angiv derefter egenskaben Tekst for etiketten til følgende formel.

   "The sentiment score is " & Round(First(sentimentCollection).score, 3) * 100 & "%"
   

   Denne formel henter synspunktscoren fra samlingen og formaterer og viser den:

   1. Funktionen First() returnerer den første (og i dette tilfælde den eneste) post i sentimentCollect og viser feltet score (det eneste felt), der er knyttet til posten.

   2. Funktionen Round() afrunder scoren til tre decimaler. I resten af formlen formateres resultatet som en procentdel, og der tilføjes visse oplysninger for konteksten.

Test appen

Kør nu den færdige app for at sikre, at den fungerer som forventet.

1. Vælg øverst til højre for at køre appen.

2. Indtast et udtryk i kontrolelementet for tekstinput, og vælg Hent score. Synspunktscoren skal blive vist i løbet af et par sekunder.

Den færdige app ligner følgende billede:

Det er en enkel app, men den 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:

• Dele din connector
• Certificere din connector