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

Un conector é un proxy ou un envoltorio arredor dunha API que permite que o servizo subxacente fale con Microsoft Power Automate, Microsoft Power Apps e Aplicacións lóxicas de Azure. Ofrece unha forma para que os usuarios conecten as súas contas e usen un conxunto de accións e activadores predefinidos para crear as súas aplicacións e fluxos de traballo.

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

A 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 conscientes de solucións como as operacións dentro dun fluxo consciente de solucións enlázanse a unha referencia de conexión en lugar de directamente a unha conexión. Durante a importación da solución a un contorno de destino, ofrécese unha conexión para todas as referencias de conexión, polo que calquera fluxo de referencia pode activarse automáticamente 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 estás usando o explorador de solucións para crear unha nova referencia de conexión nunha solución.

• Cando importas unha solución. Para obter máis información, vai a Importar solucións.

• Implícitamente cando creas as túas aplicacións de lenzo e fluxos que se definen 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óns para todos os conectores, mentres que as aplicacións de lenzo só as usan para conexións compartidas de xeito implícito (non 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 cando crea novas conexións a partir dos deseñadores de aplicacións de fluxo e lenzo.
• 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.

Engade manualmente unha referencia de conexión mediante o explorador de solucións

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

2. No panel esquerdo, seleccione Solucións. Se o elemento non está no panel lateral, seleccione …Máis e, a seguir, seleccione o elemento que desexe.

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

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

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

   • Nome de visualización: insira un nome único e útil para diferenciar esta referencia de conexión doutras.
   • Engadir unha descrición: Insira o texto que describe a conexión.
   • Conector: Seleccione un conector existente da lista como na captura de pantalla aquí. Tamén pode seleccionar Novo para crear unha nova conexión para esta referencia de conexión. Unha vez que remate de crear unha nova conexión, seleccione Actualizar para seleccionar a súa conexión da lista.
   • Conexión: Baséase no Conector que seleccionou, 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 exclusividade. Considere axustar o nome de referencia da conexión a algo único e algo que explique para que se usará.

Reutiliza as 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.

Actualiza 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, continuará utilizando 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 comprobador de fluxos da páxina de detalles do fluxo mostrará un aviso para Usar referencias de conexión. A mensaxe de advertencia 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ón, 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.

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

Cando un fluxo está activado (activado), o usuario que activa o fluxo 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, entón o fluxo debe ser activado polo propietario desas conexións ou as conexións deben compartirse co usuario que está activando o fluxo.

Nota

As conexións OAuth só se poden compartir explícitamente cun usuario que represente a un principal do servizo.

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

Podes compartir conexións cos seguintes pasos.

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

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

3. No menú, selecciona Compartir.

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

5. Para obter os permisos, seleccione Pode usar.

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

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

Para automatizar o uso compartido de conexións, utiliza a acción Editar a asignación de funcións de conexión no conector Power Apps for Makers.

Límites

• Agora as referencias de conexión gárdanse de forma asíncrona. A diferenza do período de vista previa, xa non existe un límite para cantos fluxos poden facer referencia á mesma referencia de conexión. Cando se actualizan as referencias de conexión, aparece un banner de información que enlaza a un panel que contén detalles de actualización asíncrona.
• Tampouco hai límite para o 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 referencias de conexión nos conectores personalizados. Para evitar esta limitación, despois de importar unha solución a un contorno, a aplicación debe editarse para eliminar e, a continuación, ler a conexión do conector personalizado. Teña en conta que se esta aplicación está nun solución administrada, ao editar a aplicación crearase unha capa non xestionada. Máis información: Capas de solución

Problemas coñecidos

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

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

Os conectores personalizados usan un identificador específico do entorno para facer referencia a un conector personalizado. Despois dunha operación de ambiente de copia, debe crearse unha nova referencia de conexión ao novo conector personalizado. Despois, haberá que corrixir calquera aplicación ou fluxo que utilice as antigas referencias de conexión.

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 de que se produzan referencias ou fluxos de conexión. Exporta primeiro unha solución que conteña só o conector personalizado.

Preguntas máis frecuentes

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

Se a referencia de conexión aparece como "non válida" onde aparece un signo de exclamación vermello na páxina de detalles do fluxo, isto significa que a conexión subxacente está en mal estado. Cando isto ocorre, comproba e corrixe a conexión subxacente actualizando a conexión ou substitúe a conexión.

Cal é o erro ConnectionAuthorizationFailed? Por que non podo activar (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, seleccione unha das seguintes resolucións:

• Os usuarios propietarios das conexións deben compartir todas as conexións co usuario activando (activando) o fluxo.
• Se un usuario posúe todas as conexións do fluxo, entón ese usuario pode activar (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 activar o fluxo.

O propietario das súas conexións pode activar un fluxo e transferir a propiedade a outro usuario?

Si. Cando un fluxo é activado (activado) polo propietario das conexións utilizadas polo fluxo, entón o fluxo obtén permiso explícito para usar esas conexións. Os copropietarios do fluxo poden entón desactivar e activar o fluxo 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 Aplicacións que usan esta conexión e Fluxos que usan esta pestanas de conexión .

Se o fluxo se edita para engadir novas accións que utilicen referencias de conexión adicionais con conexións novas, entón o propietario desas novas conexións deberá activar o propio fluxo inicialmente ou compartir as conexións co propietario que activa o fluxo. Máis información: Comparte 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 de 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índo o uso compartido.

Consulte tamén

Conectores

Nota

Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)

Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).