Usar variables de entorno de origen de datos en "canvas apps"

En este artículo, obtendrá información sobre el uso de variables de entorno de origen de datos, en aplicaciones de lienzo. Puede usar variables de entorno de origen de datos ya existentes o crearlas automáticamente al conectar a los datos.

Usar variables de entorno de origen de datos preexistentes

Puede reutilizar variables de entorno en otras aplicaciones e incluso diferentes tipos de recursos, como flujos en la nube. Es posible que quiera crearlos primero dentro de la solución y usarlos más adelante al crear canvas apps y flujos en la nube. En los pasos siguientes se usa SharePoint Online como ejemplo.

  1. Siga los pasos anteriores para Crear manualmente una variable de entorno en una solución.
  2. Edite o cree una aplicación canvas a partir de su solución.
  3. Agregue un nuevo origen de datos para SharePoint online.
  4. Seleccione la pestaña Avanzado. Verá una lista filtrada de variables de entorno disponibles a las que tiene acceso y que coinciden con el parámetro que se establece. Por ejemplo, al seleccionar el sitio de SharePoint, la lista contiene variables de entorno de origen de datos con Connector como SharePoint y Tipo de parámetro como Sitio. Lo mismo ocurre cuando se seleccionan listas de SharePoint para un sitio determinado. Si no aparece una variable existente, consulte Limitaciones y solución de problemas.
  5. Seleccione las variables de entorno deseadas y luego seleccione Conectar.

Importante

  • Si se selecciona una variable de entorno de una solución diferente, existirá una dependencia en la solución que contiene la variable de entorno. Por lo tanto, asegúrese de:
    • Agregar la variable de entorno a su solución actual antes de exportar.
    • Asegúrese de que la solución que contiene la variable de entorno se importa en el entorno de destino antes de importar su solución actual.

Crear automáticamente variables de entorno de origen de datos al conectarse a datos

Esta opción proporciona simplicidad y garantiza que las variables de entorno siempre se usan para los orígenes de datos, como SharePoint Online. Sin embargo, algunos clientes prefieren proporcionar sus propios nombres de esquema y, por lo tanto, deberían crearlos a partir de soluciones.

Nota:

Las aplicaciones de lienzo preexistentes no usa automáticamente las variables de entorno de origen de datos. Elimine el origen de datos de la aplicación y vuelva a agregarlo siguiendo los pasos anteriores para actualizar estas aplicaciones para que usen variables de entorno.

  1. Edite o cree una aplicación canvas a partir de su solución.

  2. Seleccione Configuración>General y habilite la configuración para Crear automáticamente variables de entorno al agregar orígenes de datos.

  3. Agregue un Nuevo origen de datos para SharePoint online.

  4. Seleccione un sitio de SharePoint, una o varias listas y, a continuación, Conectar.

    Nota:

    Para evitar la creación de variables de entorno duplicadas, se le pedirá que use la variable de entorno existente cuando se identifiquen duplicados. Puede borrar la opción para usar la variable de entorno existente si desea crear un duplicado.

  5. Seleccione Guardar.

Limitaciones y solución de problemas

Una variable de entorno puede existir en el entorno sin aparecer en el selector de orígenes de datos de Canvas Studio. Compruebe las siguientes restricciones cuando no encuentre una variable.

Limitaciones del selector de Canvas Studio

Esta limitación se aplica al seleccionar variables de entorno de origen de datos para conectores compatibles, incluidos SharePoint y SQL Server. Para SQL Server, se aplica a los tipos de conexión que admiten variables de entorno de origen de datos, como Microsoft Entra conexiones.

El selector de orígenes de datos de Canvas Studio recupera solo la primera página de definiciones de variables de entorno y valores que coinciden con el conector seleccionado y el tipo de parámetro seleccionado. No obtiene las páginas siguientes. Cada solicitud de Dataverse devuelve hasta 5000 registros coincidentes, por lo que es posible que algunas variables no aparezcan en la pestaña Opciones avanzadas o en sus resultados de búsqueda. La búsqueda de una variable que falta no la recupera de una página posterior.

Esta limitación es para el selector, no es un límite de 5.000 variables de entorno en Dataverse. El recuento pertinente es el número de definiciones o valores que coinciden para cada petición, no el número total de variables en todos los conectores del entorno.

Para mitigar esta limitación, reutilice las variables existentes y quite las variables obsoletas después de comprobar sus dependencias. No elimine las variables que las aplicaciones o flujos siguen usando. Si no puede reducir el número de variables, considere un entorno más pequeño que contenga las variables y las aplicaciones que necesita. El mover variables a soluciones diferentes dentro del mismo entorno no reduce el número de variables de ese entorno.

Comprobaciones de configuración específicas de SharePoint

Además de la limitación de paginación que se aplica a través de conectores compatibles, las variables de SharePoint deben cumplir estos requisitos de configuración:

  • Una variable de sitio necesita un valor actual no vacío o un valor predeterminado que contenga la dirección URL del sitio de SharePoint. El selector no enumera las variables de sitio cuando ambos valores están vacíos.
  • El valor de una variable de lista debe coincidir con el identificador único (GUID) de una lista devuelta para el sitio y la conexión seleccionados, no el nombre para mostrar de la lista. Compruebe que la conexión tiene acceso a la lista y que la variable contiene su identificador.

Consulte también

Crear aplicación de lienzo desde cero usando Dataverse.
Usar variables de entorno en flujos en la nube de soluciones de Power Automate
Vista general de variables de entorno

  • Se actualizó por última vez el