Usar unha referencia de conexión nunha solución con Microsoft Dataverse

Un conector é un proxy ou un encapsulador arredor dunha API que permite que o servizo subxacente se comunique con Microsoft Power Automate, Microsoft Power Apps e Azure Logic Apps. Ofrece unha forma para que os usuarios conecten as súas contas e empreguen un conxunto de accións e disparadores predefinidos para crear as súas aplicacións e fluxos de traballo.

Unha conexión é unha credencial de autenticación almacenada para un conector, por exemplo OAuth credencial para o SharePoint conector.

Unha referencia de conexión é un compoñente da solución que contén unha referencia a unha conexión sobre un conector específico. Tanto as aplicacións de lenzo sensibles á solución como as operacións dentro dun fluxo sensible á solución vínculanse a unha referencia de conexión en lugar de directamente a unha conexión. Durante a importación da solución nun ambiente de destino, ofrécese unha conexión para todas as referencias de conexión, de xeito que calquera fluxo de referencia se poida activar automaticamente despois de que se complete a importación. Para cambiar unha conexión específica asociada a unha aplicación de lenzo ou fluxo, edite o compoñente de referencia de conexión dentro da solución.

Engadir referencias de conexión a unha solución

As referencias de conexión pódense engadir a unha solución de diferentes xeitos:

• Cando se usa o explorador de solucións para crear unha nova referencia de conexión nunha solución.

• Ao importar unha solución. Para obter máis información, vaia a Importar solucións.

• Implicitamente cando creas as túas aplicacións de lenzo e fluxos que están definidos nunha Microsoft Dataverse solución.

Nota

• As aplicacións e os fluxos de lenzo manexan as conexións de forma diferente. Os fluxos usan referencias de conexión para todos os conectores, mentres que as aplicacións de lenzo só as usan para conexións compartidas implicitamente (que non son OAuth), como a autenticación de SQL Server. Máis información: Seguridade e tipos de autenticación
• Créase automaticamente unha referencia de conexión ao crear novas conexións desde o deseñador de fluxos ou Power Apps Studio.
• As aplicacións de lenzo e os fluxos engadidos desde solucións externas non se actualizarán automaticamente para usar referencias de conexión.
• As referencias de conexión asócianse a aplicacións de lenzo só no momento en que se engade a orixe de datos á aplicación. Para actualizar aplicacións debe eliminar a conexión da aplicación e despois engadir unha conexión que conteña unha referencia de conexión asociada.

Engadir manualmente unha referencia de conexión usando o explorador de solucións

1. Iniciar sesión en Power Apps ou Power Automate.

2. No panel esquerdo, seleccione Solucións. Se o elemento non está no panel lateral, selecciona …Máis e despois selecciona o elemento que queres.

3. Cree unha solución nova ou abra unha existente.

4. Na barra de comandos, seleccione Nova>Máis>Referencia de conexión.

5. No panel Nova referencia de conexión , introduza a seguinte información. As columnas requiridas márcanse cun asterisco (*).

   • Nome para mostrar: Introduza un nome único e útil para axudar a diferenciar esta referencia de conexión doutras.
   • Engadir unha descrición: Introduza texto que describa a conexión.
   • Conector: Seleccione un conector existente da lista, como se mostra na captura de pantalla. Tamén podes seleccionar Nova para crear unha nova conexión para esta referencia de conexión. Unha vez que remates de crear unha nova conexión, selecciona Actualizar para seleccionala da lista.
   • Conexión: En función do Conector seleccionado, seleccione unha conexión existente ou seleccione Nova conexión para crear unha.

6. Seleccione Crear.

   

Nomenclatura da referencia da conexión

O nome para mostrar dunha referencia de conexión debe ser único, polo que as diferentes referencias de conexión pódense diferenciar só polo nome. Por defecto, un nome de referencia de conexión inclúe o conector de destino, o nome da solución actual para o contexto e un sufixo aleatorio para garantir a singularidade. Considere axustar o nome de referencia da conexión a algo único e algo que explique para que se usará.

Reutilizar conexións nun fluxo de solucións

Os fluxos creados fóra dunha solución usan directamente conexións. Os fluxos creados nunha solución usan Referencias de conexión e os puntos de referencia de conexión na conexión. Para reutilizar unha conexión dentro dun fluxo de solución, primeiro cómpre crear unha referencia de conexión que apunte a esa conexión.

Actualizar un fluxo para usar referencias de conexión en lugar de conexións

Cando un fluxo non está nunha solución, usa conexións. Se ese fluxo se engade á solución, seguirá usando conexións inicialmente. Os fluxos pódense actualizar para usar referencias de conexións en lugar de conexións dunha de dúas maneiras:

1. Se o fluxo se exporta nunha solución non xestionada e se importa, as conexións eliminaranse e substituiranse por referencias de conexión.

2. Cando se abre un fluxo de solución, o verificador de fluxo na páxina de detalles do fluxo mostrará un aviso para Usar referencias de conexión. A mensaxe de aviso contén unha acción para Eliminar conexións para que se poidan engadir referencias de conexión. Ao seleccionar esa acción, eliminaranse as conexións do disparador e as accións do fluxo e permitirá seleccionar e crear referencias de conexións.

Uso automático de referencias de conexión nun fluxo de solución

Cando se engade unha acción a un fluxo de solucións, Power Automate tentará reutilizar as referencias de conexión existentes da solución actual ou doutras solucións antes de crear unha nova referencia de conexión. Para asegurarse de que a referencia de conexión está dentro da mesma solución que o fluxo, cree ou engada unha referencia de conexión na mesma solución e faga referencia a esa referencia de conexión do fluxo.

Compartir conexións con outro usuario para que se poidan activar os fluxos

Cando un fluxo está activado (habilitado), o usuario que o activa debe posuír ou ter permiso para usar todas as conexións do fluxo. Isto normalmente conséguese facendo que o propietario do fluxo cree as conexións dentro de todas as referencias de conexión que usa o fluxo. Se un usuario que non sexa o propietario do fluxo proporciona as conexións nun fluxo, o fluxo debe ser activado polo propietario desas conexións ou as conexións deben compartirse co usuario que está a activar o fluxo.

Nota

OAuth As conexións só se poden compartir explicitamente cun usuario que represente unha entidade de servizo.

Uso compartido manual de conexións para a activación do fluxo

Compartir conexións pódese conseguir cos seguintes pasos.

1. Vaia a Power Apps e seleccione o entorno que contén a conexión.

2. Selecciona Conexións no panel de navegación esquerdo e, a seguir, selecciona a conexión que queres compartir. Se o elemento non está no panel lateral, selecciona …Máis e despois selecciona o elemento que queres.

3. No menú, selecciona Compartir.

4. Na pantalla de uso compartido, introduza o nome do usuario (principal de servizo) que activará o fluxo.

5. Para os permisos, selecciona Pode usar.

6. Para completar a compartición, selecciona Gardar.

Uso compartido automatizado de conexións para a activación do fluxo

Para automatizar o uso compartido de conexións, use a acción Editar asignación de roles de conexión no conector Power Apps para creadores.

Límites

• As referencias de conexión agora gárdanse de forma asíncrona. A diferenza do período de vista previa, xa non hai límite para cantos fluxos poden facer referencia á mesma referencia de conexión. Cando se actualizan as referencias de conexión, aparece un banner informativo que liga a un panel que contén detalles de actualización asíncrona.
• Tampouco hai límite no número de accións en cada fluxo que se poden asociar coa referencia de conexión.
• As aplicacións de lenzo non recoñecen as referencias de conexión nos conectores personalizados. Para solucionar esta limitación, despois de importar unha solución a un ambiente, débese editar a aplicación para eliminar e, a seguir, ler a conexión do conector personalizado. Ten en conta que, se esta aplicación está nunha solución xestionada, ao continuar coa edición da aplicación crearase unha capa non xestionada. Máis información: Capas da solución

Problemas coñecidos

Esta sección describe os problemas coñecidos coas referencias de conexión.

O ambiente de copia rompe as referencias de conexión para os conectores personalizados

Os conectores personalizados usan un identificador específico do ambiente para facer referencia a un conector personalizado. Despois dunha operación de copia do ambiente, débese crear unha nova referencia de conexión para o novo conector personalizado. Entón, calquera aplicación ou fluxo que empregue as referencias de conexión antigas deberá ser corrixido.

Os conectores personalizados deben importarse nunha solución separada das súas referencias de conexión.

Os conectores personalizados deben importarse nunha solución separada, antes das referencias ou fluxos de conexión. Exporta primeiro unha solución que conteña só o conector personalizado.

FAQ

Como podo corrixir un erro de "Conexión non válida"?

Se a referencia de conexión se mostra como "non válida" e aparece un signo de exclamación vermello na páxina de detalles do fluxo, isto significa que a conexión subxacente está nun estado incorrecto. Cando isto ocorra, comprobe e corrixa a conexión subxacente actualizando a conexión ou substitúaa.

Cal é o erro de erro de autorización de conexión? Por que non podo activar un fluxo?

O erro "ConnectionAuthorizationFailed" indica que o usuario que tenta activar o fluxo non ten permisos para polo menos unha das conexións que está a usar o fluxo. Para resolver a situación, escolla unha das seguintes solucións:

• Os usuarios propietarios das conexións deben compartir todas as conexións co usuario que activa o fluxo.
• Se un usuario posúe todas as conexións do fluxo, ese usuario pode activar o fluxo.

Unha vez que o propietario das conexións activou o fluxo, o fluxo ten permisos para usar esas conexións. A partir dese momento, calquera copropietario do fluxo pode activalo.

Pode o propietario das súas conexións activar un fluxo e logo transferir a propiedade a outro usuario?

Si. Cando un fluxo é activado (habilitado) polo propietario das conexións que usa o fluxo, o fluxo obtén permiso explícito para usar esas conexións. Os copropietarios do fluxo poden activalo e desactivalo segundo sexa necesario.

Os permisos concedidos ás aplicacións e aos fluxos que usan unha conexión pódense ver na páxina de detalles desa conexión nas pestanas Aplicacións que usan esta conexión e Fluxos que usan esta conexión .

Se o fluxo se edita para engadir novas accións que usan referencias de conexión adicionais con novas conexións, o propietario desas novas conexións debe activar inicialmente o fluxo el mesmo ou compartir as conexións co propietario que activa o fluxo. Máis información: Compartir recursos da aplicación

Pódese transferir a propiedade dunha referencia de conexión a outro usuario?

A propiedade dunha referencia de conexión non se pode transferir a outro usuario desde a área Solucións en Power Apps (make.powerapps.com).

Non obstante, o explorador de solucións clásico pódese usar para cambiar os privilexios dunha referencia de conexión, incluído o uso compartido.

Consulte tamén

Conectores