Använd en anslutningsreferens i en lösning med Microsoft Dataverse

Ett anslutningsprogram är en proxy eller en omslutning runt ett API som gör det möjligt för den underliggande tjänsten att tala med Microsoft Power Automate, Microsoft Power Apps och Azure Logic Apps. Det gör det möjligt för användare att ansluta sina konton och använda en uppsättning fördefinierade åtgärder och utlösare när de skapar sina program och arbetsflöden.

En anslutning är lagrade autentiseringsuppgifter för ett anslutningsprogram, till exempel OAuth-autentiseringsuppgifter för SharePoint-anslutningsprogram.

En anslutningsreferens är en lösningskomponent som refererar till en anslutning för ett specifikt anslutningsprogram. Både lösningsmedvetna arbetsyteappar och operationer inom en lösningsmedvetet flöde till en anslutningsreferens i stället för direkt till en anslutning. Under lösningsimport till en målmiljö tillhandahålls en anslutning för alla anslutningsreferenser så att alla referensflöden kan aktiverad automatiskt efter att importen är klar. Om du vill ändra en specifik anslutning som är associerad med en arbetsyteapp eller ett flöde redigerar du referenskomponenten för anslutningar i lösningen.

Lägg till anslutningsreferenser i en lösning

Anslutningsreferenser kan läggas till en lösning på olika sätt:

  • När du använder lösningsutforskaren för att skapa en ny anslutningsreferens i en lösning.

  • Importera en lösning. Om du vill lära dig mer går du till Importera lösningar.

  • När du bygger dina arbetsyteappar och flöden som definieras i en Microsoft Dataverse-lösning.

Anteckning

  • Arbetsyteappar och flöden hanterar anslutningar på ett annat sätt. För flöden används anslutningsreferenser för alla anslutningar, medan de endast används för anslutningar som är delade (inte OAuth), till exempel SQL Server-autentisering. Mer information: Säkerhet och typer av autentisering
  • En anslutningsreferens skapas automatiskt när du skapar nya anslutningar från flödet och arbetsyteappdesigners.
  • Arbetsyteappar och flöden som läggs till från lösningar utanför systemet uppgraderas inte automatiskt för att använda anslutningsreferenser.
  • Anslutningsreferenser associeras endast med arbetsyteappar när en datakälla läggs till i programmet. För att uppgradera program måste du ta bort anslutningen från programmet och sedan lägga till en anslutning som innehåller en associerad anslutningsreferens.

Lägga till en anslutningsreferens med lösningsutforskaren manuellt

  1. Logga in på Power Apps eller Power Automate.

  2. Välj Lösningar i det vänstra fönstret. Om objektet inte finns i sidopanelsfönstret väljer du ... Mer och markerar sedan det objekt du vill använda.

  3. Skapa en ny eller öppna en befintlig lösning.

  4. I kommandofältet, välj Ny > Mer > Anslutningsreferens.

  5. I rutan Ny anslutningsreferens anger du följande information. Obligatoriska kolumner visas med en asterisk (*).

    • Visningsnamn: Ange ett unikt och användbart namn för att skilja denna anslutningsreferens från andra.
    • Lägg till en beskrivning: Ange text som beskriver anslutningen.
    • Anslutningsprogram: Välj en befintlig anslutning i listan, t.ex. på skärmbilden här. Du kan också välja Nytt om du vill skapa en ny anslutning för anslutningsreferensen. När du har skapat en ny anslutning väljer du Uppdatera så att anslutningen markeras i listan.
    • Anslutningsprogram: Välj ett befintligt anslutningsprogram beroende på vilket anslutningsprogram du valt eller välj Ny anslutning för att skapa en.
  6. Välj Skapa.

    Skärmbild av ny anslutningsreferenspanel.

Namngivning av anslutningsreferens

Anslutningens visningsnamn bör vara unika så att olika anslutningsreferenser kan refereras enbart efter namn. Som standard inkluderar målkontakten i ett anslutningsreferensnamn, det aktuella lösningsnamnet för sammanhanget och ett slumpmässigt suffix anges för att säkerställa unikheten. Du kan ändra anslutningsreferensnamnet till något unikt och något som förklarar vad det ska användas till.

Återanvända anslutningar i ett lösningsflöde

Flöden som skapas utanför en lösning används anslutningsprogram direkt. För flöden som skapas i en lösning används anslutningsreferenser och anslutningsreferenser pekar vid anslutningen. Om du vill återanvända en anslutning i ett lösningsflöde måste du först skapa en anslutningsreferens som pekar på anslutningen.

Uppdatera ett flöde så att anslutningsreferenser används i stället för anslutningar

När ett flöde inte finns i en lösning används anslutningarna. Om det flödet sedan läggs till i lösningen används anslutningarna initialt. Det går att uppdatera flöden genom att använda anslutningsreferenser i stället för anslutningar på ett av två sätt:

  1. Om flödet exporteras i en ohanterad lösning och importeras tas anslutningarna bort och ersätts med anslutningsreferenser.

  2. När ett lösningsflöde öppnas kommer flödeskontrollen på flödesinformationssidan att visa en varning till Använd anslutningsreferenser. Varningsmeddelandet innehåller en åtgärd för att Ta bort anslutningar så att anslutningsreferenser kan läggas till. Om du väljer den åtgärden tas anslutningarna bort från utlösaren och åtgärderna i flödet och gör att anslutningsreferenser kan markeras och skapas.

Automatisk användning av anslutningsreferenser i ett lösningsflöde

När en åtgärd läggs till i ett lösningsflöde försöker Power Automate återanvända befintliga anslutningsreferenser från den aktuella lösningen eller andra lösningar innan du skapar en ny anslutningsreferens. Se till att anslutningsreferensen finns i samma lösning som flödet genom att skapa eller lägga till en anslutningsreferens i samma lösning och referera till den anslutningsreferensen från flödet.

Dela anslutningar med en annan användare så att flöden kan aktiveras

När ett flöde aktiveras måste den användaren som aktiverar flödet äga alla anslutningar eller ha tillstånd att använda alla anslutningar i flödet. Detta sker vanligtvis genom att flödesägaren skapar anslutningarna i alla anslutningsreferenser som används i flödet. Om en annan användare än flödesägaren tillhandahåller anslutningarna för ett flöde måste flödet aktiveras av den som äger de anslutningarna eller också måste anslutningarna delas med användaren som aktiverar flödet.

Anteckning

OAuth-anslutningar kan endast explicit delas med en användare som representerar ett huvudkonto för tjänsten.

Manuell delning av anslutningar för flödesaktivering

Du kan dela anslutningarna genom att följa stegen nedan.

  1. Gå till Power Apps och välj miljön som innehåller anslutningen.

  2. Välj Anslutningar i vänster navigeringsfönster och därefter den anslutning du vill dela. Om objektet inte finns i sidopanelsfönstret väljer du ... Mer och markerar sedan det objekt du vill använda.

  3. Från menyn, välj Dela.

  4. I delningsskärmen anger du namnet på användaren (tjänstens huvudnamn) som ska aktivera flödet.

  5. För behörigheterna, välj Kan använda.

  6. Välj Spara för att slutföra att delningen.

Automatiserad delning av anslutningar för flödesaktivering

Om du vill automatisera delning av anslutningar använder du åtgärden Redigera tilldelning av anslutningsroll på Power Apps anslutningen för utvecklare.

Skärmbild på exempel på delning av en anslutning.

Gränser

  • Anslutningsreferenser sparas nu asynkront. Till skillnad från förhandsgranskningsperioden finns det inte längre en gräns för hur många flöden som kan referera till samma anslutningsreferens. När anslutningsreferenser uppdateras visas en informationsbanderoll som länkar till en panel med asynkron uppdateringsinformation.
  • Det finns heller ingen begränsning för antalet åtgärder i varje flöde som kan associeras med anslutningsreferensen.
  • Arbetsyteappar detekterar inga anslutningsreferenser på anpassade anslutningsprogram. Du kan lösa problemet på följande sätt: När en lösning har importerats till en miljö måste programmet redigeras för att kunna tas bort den och sedan lägga till den anpassade anslutningen för anslutningsprogrammet igen. Obs! Om detta program finns i en hanterad lösning skapas ett ohanterat lager om du fortsätter att redigera programmet. Mer information: Lösningslager

Kända problem

I det här avsnittet beskrivs kända problem med anslutningsreferenser.

Miljökopiering bryter anslutningsreferenser för anpassade anslutningsprogram

Anpassade anslutningsprogram använder en miljöspecifik identifierare för att referera till ett anpassat anslutningsprogram. När du har kopierat en miljö måste en ny anslutningsreferens skapas till det nya anpassade anslutningsprogrammet. Program och flöden som fortfarande använder de gamla anslutningsreferenserna måste sedan åtgärdas.

Anpassade anslutningsprogram måste importeras i en separat lösning från dess anslutningsreferenser

Anpassade anslutningsprogram måste importeras i en separat lösning, före anslutningsreferenser eller flöden. Exportera en lösning som först endast innehåller det anpassade anslutningsprogrammet.

Vanliga frågor och svar

Hur åtgärdar jag ett fel av typen "Ogiltig anslutning"?

Om anslutningsreferensen anges som "ogiltig" och ett rött utropstecken visas på sidan för flödesinformation, innebär det att den underliggande anslutningen drabbats av felstatus. När detta inträffar kontrollerar du och åtgärdar den underliggande anslutningen genom att uppdatera anslutningen eller byta ut anslutningen.

Vad innebär felet ConnectionAuthorizationFailed? Varför kan jag inte aktivera ett flöde?

Felet "ConnectionAuthorizationFailed" anger att användaren som försöker aktivera flödet inte har behörighet till minst en (1) av de anslutningar som flödet använder. Välj bland följande lösningar för att åtgärda problemet:

  • Användarna som äger anslutningarna måste dela alla anslutningar med användaren som aktiverar flödet.
  • Om en användare äger alla anslutningar i flödet kan den användaren aktivera flödet.

När flödet har aktiverats av anslutningsägaren har flödet behörighet att använda dessa anslutningar. Från och med då kan alla flödets medägare aktivera flödet.

Kan ett flöde aktiveras av ägaren till anslutningarna och sedan överlåtas till en annan användare?

Ja. När ett flöde är aktiverat av ägaren till de anslutningar som används av flödet får flödet explicit behörighet att använda dessa anslutningar. Medägarna av flödet kan sedan inaktivera och aktivera flödet efter behov.

Behörigheter som beviljats appar och flöden med en anslutning kan ses på informationssidan för den anslutningen i Appar som använder den här anslutningen och Flödar med denna anslutning.

Om flödet redigeras för att lägga till nya åtgärder som använder ytterligare anslutningsreferenser med nya anslutningar måste ägaren till de nya anslutningarna antingen först aktivera själva flödet eller dela anslutningarna med den ägare som aktiverar flödet. Mer information finns i: Dela appresurser

Se även

Anslutningsprogram

Anteckning

Kan du berätta om dina inställningar för dokumentationsspråk? Svara i en kort undersökning. (observera att undersökningen är på engelska)

Undersökningen tar ungefär sju minuter. Inga personuppgifter samlas in (sekretesspolicy).