Connection reference

Wat is een connection reference?

Een connection reference is een component in een Power Platform-solution die verwijst naar een connection voor een bepaalde connector. Een solution-aware flow of app bindt aan de reference, niet rechtstreeks aan de opgeslagen verbinding.

Die extra laag maakt een oplossing verplaatsbaar. In ontwikkeling kan de reference naar een testaccount wijzen. Bij import in productie koppel je dezelfde reference aan een productieconnection zonder iedere actie in de flow te wijzigen.

Connection references worden in Dataverse bewaard en horen bij solutions. Flows buiten een solution gebruiken doorgaans connections rechtstreeks.

Connector, connection en connection reference

Een connector beschrijft welke triggers en acties een dienst aanbiedt. De SharePoint-connector weet bijvoorbeeld hoe lijsten, bestanden en sites via de onderliggende API worden aangesproken.

Een connection bevat de opgeslagen aanmeldcontext voor die connector. Dat kan een gebruikersidentiteit, service principal of andere ondersteunde authenticatie zijn.

Een connection reference is de solutioncomponent die zegt welke connection de onderdelen van de oplossing gebruiken. De reference bevat niet zelf het wachtwoord of token.

Een environment variable lost een ander probleem op. Die bewaart configuratie die per omgeving kan verschillen, zoals een site-URL, lijst-ID of API-basisadres. Veel implementaties hebben zowel connection references als environment variables nodig.

Een implementatievoorbeeld

Een solution bevat een cloud flow die documenten uit SharePoint leest en een record in Dataverse maakt. De flow gebruikt één connection reference voor SharePoint en één voor Dataverse.

In de ontwikkelomgeving wijzen die references naar testconnections. Bij import in de testomgeving kiest het implementatieproces connections met toegang tot de testsite en testdatabase. In productie worden productie-identiteiten gekoppeld.

De flowdefinitie blijft gelijk. Alleen de references en configuratiewaarden verschillen. Daardoor hoeft niemand na iedere import tientallen acties handmatig opnieuw aan te melden.

Na de import moet de eigenaar of implementatie-identiteit alle gebruikte connections mogen gebruiken. Een geldige reference naar een verlopen of ontoegankelijke connection blijft een fout opleveren.

De rol van connection references in ALM

Solutions verpakken flows, apps en afhankelijke componenten. Connection references maken de externe verbindingen van die componenten expliciet en vervangbaar per doelomgeving.

Dat ondersteunt een vaste route van ontwikkeling naar test en productie. Deployment settings kunnen vooraf vastleggen welke connection-ID bij iedere reference hoort. Een pipeline kan die waarden tijdens import toepassen.

Maak references doelgericht. Twee flows die onder dezelfde beheerde identiteit dezelfde SharePoint-site gebruiken, kunnen een reference delen. Processen met verschillende rechten of eigenaars horen niet automatisch dezelfde connection te gebruiken.

Identiteit en beveiliging

Kies de uitvoeridentiteit op basis van het bedrijfsproces. Een persoonlijke connection kan stoppen wanneer de eigenaar vertrekt, het wachtwoord wijzigt of toegang verliest. Een ondersteunde service principal kan geschikter zijn voor een centrale achtergrondflow.

Een technische identiteit krijgt alleen de rechten die nodig zijn. De connection reference beperkt die rechten niet; ze verwijst alleen naar de connection. Controleer bronrechten, connectorbeleid en flowdeling afzonderlijk.

Deel connections niet breder dan nodig. Documenteer eigenaar, doel en rotatieprocedure. Geheime waarden horen in ondersteunde secretopslag, niet in de naam of beschrijving van de reference.

Problemen opsporen

Een Invalid Connection-fout betekent vaak dat de onderliggende connection verlopen, verwijderd of niet beschikbaar is. Controleer eerst welke reference de mislukte actie gebruikt en welke connection eraan gekoppeld is.

Na import kan een reference nog geen geldige connection hebben of kan de gebruiker die de flow activeert onvoldoende rechten hebben. Controleer ook of nieuwe connectoracties een extra reference hebben aangemaakt die niet in de implementatieconfiguratie staat.

Gebruik unieke, beschrijvende namen. Een lijst met references die allemaal SharePoint gevolgd door een willekeurig nummer heten, maakt diagnose en implementatie onnodig moeilijk.