Delen via


Een aangepaste connector gebruiken vanuit een logische app

Notitie

Dit onderwerp maakt deel uit van een reeks zelfstudies over het maken en gebruiken van aangepaste connectors in Azure Logic Apps, Power Automate en Power Apps. Zorg ervoor dat u Overzicht van aangepaste connectors leest om het proces te begrijpen.

In dit onderwerp bouwt u een elementaire logische app op die de aangepaste connector gebruikt die u in een eerder onderwerp hebt gemaakt. De logische app wordt geactiveerd wanneer een item wordt toegevoegd aan een SharePoint-lijst. Vervolgens gebruikt de logische app dan de aangepaste connector om de Cognitive Services Text Analytics API aan te roepen. De connector retourneert de gevoelsscore (0 tot 1) voor de tekst in het lijstitem en de logische app schrijft de score terug naar de lijst. De voltooide logische app wordt in de volgende afbeelding weergegeven:

Voltooide logische app van sentimentanalyse

Vereisten

De SharePoint-lijst maken

U maakt eerst een eenvoudige lijst met drie kolommen in SharePoint Online. Deze lijst bevat filmrecensiegegevens die de logische app analyseert op gevoel. Zie Inleiding tot lijsten in de SharePoint-documentatie voor meer informatie over SharePoint-lijsten.

  1. Ga naar uw SharePoint Online-site en kies Nieuw en vervolgens Lijst.

    Nieuwe SharePoint-lijst maken

  2. Voer de naam "Filmbeoordelingen" in en kies vervolgens Maken.

    Naam opgeven voor nieuwe lijst

    De lijst wordt gemaakt, met het standaardveld Titel.

    Lijst Projectaanvragen

  3. Kies Pictogram Nieuw item en vervolgens Eén tekstregel.

    Veld Eén tekstregel toevoegen

  4. Voer de naam "Beoordeling" in en kies vervolgens Opslaan.

  5. Herhaal stap 3 en 4 om een andere kolom toe te voegen aan de lijst: gebruik het gegevenstype Getal en de naam "Score".

Een logische app maken

Nu u een lijst hebt om mee te werken, maakt u een logische app in de Azure-portal.

  1. Meld u aan bij de Azure-portal met de referenties van uw Azure-account.

  2. Kies in het hoofdmenu van Azure de optie Nieuw > Enterprise-integratie > Logische app.

    Logische app maken

  3. Geef onder Logische app maken details over uw logische app zoals hier getoond. Kies, als u klaar bent, de optie Vastmaken aan dashboard > Maken.

    Geef details van de logische app op

    Instelling Weergegeven als Beschrijving
    Meetcriterium SentimentAnalysis De naam voor uw logische app
    Abonnement <uw-Azure-abonnementnaam> De naam van uw Azure-abonnement
    Resourcegroep Mijn-eerste-LA-RG De naam voor de Azure-resourcegroep die wordt gebruikt om gerelateerde bronnen te ordenen
    Locatie US - oost 2 De regio waar u de informatie over uw logische app kunt opslaan

    Opmerking: uw logische app en aangepaste connector moeten in dezelfde regio bestaan.

    Log Analytics Uit Laat de instelling voor registratie in het diagnoselogboek op Uit staan.
  4. Nadat Azure uw app heeft geïmplementeerd, wordt de Logic Apps Designer geopend en wordt een pagina weergegeven met een introductievideo en veelgebruikte triggers. Kies onder Sjablonen de optie Lege logische app.

    Sjablonen Lege logische app kiezen

De trigger en aangepaste connector toepassen

Nadat de logische app is gemaakt, voegt u een trigger toe die wordt geactiveerd wanneer een item wordt toegevoegd aan de SharePoint-lijst. Vervolgens voegt u een actie toe die moet worden ondernomen op basis van het toegevoegde item.

  1. Zoek of selecteer in Logic Apps Designer de optie SharePoint en vervolgens de trigger SharePoint - wanneer een item wordt gemaakt.

    Trigger SharePoint - Item maken

  2. Meld u desgevraagd aan met uw referenties voor SharePoint.

  3. Voer waarden in voor de SharePoint-trigger.

    Parameter voor trigger SharePoint - Item maken

    Parameter Weergegeven als
    Siteadres <uw-SharePoint-siteadres>
    Lijstnaam Filmrecensies
    Interval 10
    Frequentie Tweede
  4. Kies Nieuwe stap en vervolgens Een actie toevoegen.

  5. Zoek naar de aangepaste connector SentimentDemo die u hebt gemaakt en kies vervolgens de actie die aan die connector is gekoppeld.

    De actie SentimentDemo kiezen

    De naam en beschrijving voor de actie zijn afkomstig van informatie die u hebt opgegeven bij het maken van de connector.

  6. Voer een naam in voor de verbinding en de API-sleutel.

    Verbindingsnaam en API-sleutel

    Parameter Weergegeven als
    Naam verbinding Bijvoorbeeld de naam: SentimentDemoConnection.
    API-sleutel De API-sleutel voor de Text Analytics API. Ga voor meer informatie naar Een API-sleutel ophalen.
  7. Voer waarden in voor alle velden.

    Parameters voor connector

    Parameter Weergegeven als
    Taal en
    Id 1
    Text Het SharePoint-veld Beoordeling (in het dialoogvenster Dynamische inhoud)

    Id is vereist omdat met de connector meerdere documenten kunnen worden verwerkt. In onze voorbeelden verzenden we één document tegelijk. In een logische app voor productie zijn de waarden Taal en id mogelijk afkomstig uit een lijst of andere gegevensbron.

  8. Kies Nieuwe stap en vervolgens Een actie toevoegen.

  9. Voeg de actie SharePoint - Item bijwerken toe en voer waarden in voor alle velden.

    Actie Lijstitem bijwerken

    Parameter Weergegeven als
    Siteadres <uw-SharePoint-siteadres>
    Lijstnaam Filmrecensies
    Id Het SharePoint-veld Id
    Titel Het SharePoint-veld Titel
    Beoordelen Het SharePoint-veld Beoordeling
    Score Het veld Score voor de aangepaste connector

    Wanneer u de dynamische inhoud toevoegt aan het veld Score, ziet u dat in Logic Apps een container Toepassen op elke wordt toegevoegd, omdat wordt gedetecteerd dat de aangepaste connector meerdere documenten accepteert. Uw connector verzendt slechts één tegelijk, maar het is een goede zaak dat de logische app dezelfde mogelijkheden biedt als de connector.

    Toepassen op elke

    De voltooide logische app moet er nu uitzien als in de volgende afbeelding:

    Voltooide logische app van sentimentanalyse

  10. Kies boven aan de Logic Apps Designer de optie Uitvoeren.

De logische app testen

Nu de logische app is voltooid, is het tijd om deze te testen door beoordelingen toe te voegen aan de SharePoint-lijst, en te kijken hoe de logische app reageert.

  1. Ga naar uw SharePoint Online-lijst en kies Snel bewerken.

    Snel SharePoint-lijst bewerken

  2. Voeg twee beoordelingen toe aan de lijst (één negatieve en één positieve) en kies vervolgens Gereed.

    Snel bewerken gereed

    Parameter Voorgestelde waarde
    Titel (positief) Mijn favoriete film
    Beoordeling (positief) Ik heb na een lange dag genoten van de nieuwe film
    Titel (negatief) Een andere film
    Beoordeling (negatief) e slechtste film die ik in tijden heb gezien
  3. Kies terug in de Azure-portal de optie Overzicht om de uitvoeringsgeschiedenis van deze logische app te bekijken. U ziet, als het goed is, twee uitvoeringen—één voor elke beoordeling die u hebt toegevoegd aan de lijst. Kies Uitschakelen om Azure-resources op te slaan nadat u deze logische app hebt voltooid.

    Uitvoergeschiedenis

  4. Ga terug naar de pagina met de SharePoint-lijst en vernieuw de browser om de scores te zien die de logische app heeft toegevoegd.

    Scores toegevoegd vanuit logische app

Dat was alles! Dit is een eenvoudige logische app, maar met een krachtige functionaliteit, omdat de app in staat is Cognitive Services aan te roepen via een aangepaste connector.

Volgende stappen

Deel de connector binnen uw organisatie en/of zorg ervoor dat de connector wordt gecertificeerd zodat personen buiten de organisatie deze kunnen gebruiken:

Feedback geven

We stellen feedback over problemen met ons connectorplatform of ideeën voor nieuwe functies zeer op prijs. Om feedback te geven, gaat u naar Problemen melden of hulp krijgen met connectoren en selecteer uw feedbacktype.