Brug en brugerdefineret connector fra en logikapp

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

Forudsætninger

• Et Office 365 Business Premium-abonnement, eller tilmeld dig en gratis prøveversion

• Grundlæggende erfaring med opbygning af logikapps. Du kan finde flere oplysninger under Bygge din første arbejdsproces til en logikapp.

• 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

• Hvis den brugerdefinerede connector får adgang til ressourcer i det lokale miljø ved hjælp af datagatewayen i det lokale miljø, skal du konfigurere gatewayinstallationen, så der er adgang til de tilsvarende udgående IP-adresser på administrerede connectors. Alle logiske apps i samme område bruger de samme IP-adresseintervaller. Du kan finde flere oplysninger under Installere datagateway i det lokale miljø for Azure Logic Apps – Kontrollér eller juster kommunikationsindstillinger.

Oprette SharePoint-listen

Du skal først oprette en simpel liste med tre kolonner i SharePoint Online. På denne liste gemmes filmanmeldelsesdata, som logikappen 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.

   

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

   

   Listen oprettes med standardfeltet Titel.

   

3. Vælg og derefter 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 en logikapp

Nu, hvor du har en liste, du kan arbejde med, skal du oprette en logikapp i Azure-portalen.

1. Log på Azure-portalen ved hjælp af din Azure-kontos legitimationsoplysninger.

2. Brug Azure-hovedmenuen til at vælge Ny > Virksomhedsintegration > Logikapp.

   

3. Angiv oplysninger om din logikapp, der er vist her, under Opret logikapp. Når du er færdig, skal du vælge Fastgør til dashboard > Opret.

   

   Indstilling	Værdi	Beskrivelse
   Navn	Synspunktsanalyse	Navnet på din logikapp
   Abonnement	<navn-på-Azure-abonnement>	Navnet på dit Azure-abonnement
   Ressourcegruppe	Min-første-LA-RG	Navnet på den Azure-ressourcegruppe, der bruges til at organisere relaterede ressourcer
   Lokation	Østlige USA 2	Det område, hvor du kan gemme oplysninger om din logikapp Bemærk: Din logikapp og brugerdefinerede connector skal være i det samme område.
   Log Analytics	Fra	Bevar indstillingen Fra for diagnosticeringslogføring.

4. Når Azure har installeret din app, åbnes designeren i Logic Apps, og der vises en side med en introduktionsvideo samt ofte anvendte udløsere. Vælg Tom logikapp under Skabeloner.

   

Tilføj udløseren og den brugerdefinerede connector

Med oprettet logikapp skal du tilføje en udløser, der aktiveres, når der føjes et element til SharePoint-listen. Derefter tilføjer du en handling, der skal udføres på baggrund af det element, der tilføjes.

1. I Logic Apps-designeren kan du søge efter eller vælge SharePoint og derefter udløse SharePoint - når et element oprettes.

   

2. Log på med dine legitimationsoplysninger til SharePoint, hvis du bliver bedt om det.

3. Angiv værdier for SharePoint-udløseren.

   

   Parameter	Værdi
   Webstedsadresse	<din-SharePoint-webstedsadresse>
   Listenavn	Filmanmeldelser
   Interval	10
   Hyppighed	Anden

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

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

   

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

6. Angiv et navn til forbindelsen og API-nøglen.

   

   Parameter	Værdi
   Forbindelsesnavn	Et navn f.eks. SentimentDemoConnection.
   API-nøgle	API-nøglen til Tekstanalyse-API'en. Du kan finde flere oplysninger under Hente en API-nøgle.

7. Angiv værdier for alle felter.

   

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

   Id kræves, fordi connectoren kan håndtere flere dokumenter – i vores eksempler sender vi ét dokument ad gangen. I en logikapp til produktion kan Sprog- og ID-værdier komme fra en liste eller en anden datakilde.

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

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

   

   Parameter	Værdi
   Webstedsadresse	<din-SharePoint-webstedsadresse>
   Listenavn	Filmanmeldelser
   Id	SharePoint-feltet ID
   Titel	SharePoint-feltet Titel
   Gennemse	SharePoint-feltet Anmeldelse
   Score	Feltet score i brugerdefineret connector

   Når du tilføjer det dynamiske indhold for feltet Score, skal du bemærke, at Logic Apps tilføjer objektbeholderen For alle, fordi den registrerer, at den brugerdefinerede connector accepterer flere dokumenter. Din connector sender kun ét ad gangen, men det er godt, at logikappen matcher funktionerne i connectoren.

   

   Den færdige logikapp skulle nu ligne følgende billede:

   

10. Vælg Kør i toppen af Logic Apps-designeren.

Test logikappen

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

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

   

2. Føj to anmeldelser til listen (én negativ og én positiv), og vælg derefter 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. Tilbage i Azure-portalen skal du vælge Oversigt for at se kørselshistorikken for denne logikapp. Du bør se to kørsler – én for hver anmeldelse, du har føjet til listen. Hvis du vil gemme Azure-ressourcer, når du er færdig med denne logikapp, skal du vælge Deaktiver.

   

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

   

Nu er du helt færdig! Dette er en simpel logikapp, 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