Utilizar la configuración para proporcionar experiencias de aplicaciones personalizadas

Las configuraciones son componentes de la solución que permiten a creadores y administradores configurar rápidamente aplicaciones para brindar una experiencia personalizada. La configuración se puede utilizar para habilitar o deshabilitar funciones o configurar el comportamiento de las funciones para una sola aplicación o para todas las aplicaciones dentro de un entorno.

La configuración se compone de tres subcomponentes: definición de configuración, valor de entorno de configuración y valor de aplicación de configuración.

Subcomponente	Descripción
Definición de configuración	Los autores de aplicaciones, administradores o socios pueden crear una definición de configuración que incluya propiedades como el nombre, la descripción, el tipo de datos, el valor predeterminado y más. Luego, mediante un código, pueden usar el valor de la configuración para habilitar, deshabilitar o configurar la función que ofrecen. Pueden incluir la definición de configuración en la solución que se utiliza para entregar la función a sus clientes. Ejemplo: El Controlador save asincrónico para aplicaciones basadas en modelos es una característica de Power Apps que usa configuraciones. La configuración es de tipo Sí/No y el valor predeterminado de esta configuración es No. Por lo tanto, de forma predeterminada, la característica Controlador save asincrónico se desactivará para todas las aplicaciones basadas en modelos.
Valor de entorno de configuración	Puede utilizarse un valor de entorno de configuración para reemplazar el valor predeterminado especificado en la definición de configuración. Ejemplo: Ampliando el ejemplo anterior, un administrador de entorno en la organización de un cliente puede agregar un valor de entorno de configuración para la configuración Controlador save asincrónico y configurarlo en Sí. Este valor de entorno de configuración anulará el valor predeterminado y se aplicará a todas las aplicaciones en ese entorno. Esto habilitará la característica Controlador save asincrónico para todas las aplicaciones basadas en modelos en ese entorno.
Valor de la aplicación de configuración	Puede utilizarse un valor de aplicación para reemplazar el valor predeterminado, especificado en la definición de configuración, y el valor de entorno de configuración (si existe). Ejemplo: Una vez más, ampliando el ejemplo anterior, un autor de la aplicación en el mismo entorno anterior puede agregar un valor de aplicación de configuración para el ajuste Controlador save asincrónico para una aplicación que está creando y configurarla en No Este valor de aplicación de configuración reemplazará el valor del entorno de configuración y se aplicará solo a esa aplicación. Esto habilitará la característica Controlador save asincrónico para esa única aplicación.

Nota

Para seguir los pasos que se enumeran a continuación debe tener Vista previa de la solución activada. En el área Soluciones de Power Apps, en la barra de comandos, asegúrese de tener Vista previa de la solución activada. Si se muestra Vista previa de la solución desactivada, seleccione la opción para habilitar la vista previa. Para obtener más información: Vista de la solución

Definición de configuración

Una definición de configuración especifica las propiedades base de una configuración. La lista completa de propiedades que se pueden configurar en una definición de configuración se enumeran a continuación. Algunas de estas propiedades no se pueden cambiar una vez creada la configuración.

Propiedad	Descripción
Nombre para mostrar	El nombre que se muestra a los consumidores de la configuración en todas las interfaces de usuario donde se muestran las configuraciones.
Nombre	El nombre exclusivo de la configuración en un entorno. El nombre se genera automáticamente según el nombre para mostrar proporcionado, pero se puede cambiar antes de crear la configuración. Una vez que una configuración se crea el Nombre no se puede cambiar, ya que se puede hacer referencia a él en sus aplicaciones o código. Nombre tiene un prefijo que corresponde al editor de la solución. Este prefijo está destinado a dar a la configuración un nombre único si desea importarla a otra solución o entorno en el futuro (que tendría un prefijo diferente).
Descripción	La descripción ayuda a otros a comprender para qué se utiliza la configuración en todas las interfaces de usuario donde se muestran las configuraciones.
Tipo de datos	El tipo de datos de una configuración controla cómo se almacena el valor de la configuración. El tipo de datos se puede establecer en Número, Cadena o Sí/No. El tipo de datos no se puede cambiar una vez creada la configuración.
Valor predeterminado	El valor predeterminado está disponible después de seleccionar un Tipo de datos. Especifica el valor de la configuración que se utilizará a menos que sea reemplazado por un valor de entorno de configuración o un valor de aplicación de configuración.
Se puede cambiar el valor para	Un ajuste se puede anular en uno de los niveles siguientes: Entorno y aplicación permite que tanto el valor del entorno de configuración como los valores de aplicación de configuración reemplacen el valor predeterminado. Solo entorno permite que solo el valor del entorno de configuración reemplace el valor predeterminado. Solo aplicación permite que solo los valores de aplicación reemplacen el valor predeterminado. Ninguno, la configuración no se puede anular.
Nivel de versión	El nivel de versión se usa para informar al marco y a otros usuarios de la configuración acerca del estado de la característica con la que se usa la configuración. El nivel de versión se puede establecer en Disponible en general o Versión preliminar.
URL de información	Un vínculo a documentación para ayudar a los consumidores de la configuración a entender el propósito de la configuración. Se utilizará como vínculo Más información en todas las interfaces de usuario donde se muestran las configuraciones.

Agregar una nueva definición de configuración

1. Inicie sesión en Power Apps.
2. En el panel de navegación, seleccione Soluciones. Si el elemento no se encuentra en el panel lateral, seleccione …Más y, a continuación, el elemento que desee.
3. En la lista de soluciones, abra la solución a la que desea agregar la configuración.
4. En la barra de comandos, seleccione Nuevo > Más > Configuración> Definición de configuración.
5. En el diálogo Nueva configuración, proporcione valores para cada una de las propiedades según sus requisitos. Para obtener información sobre cómo las propiedades de la definición de configuración, vaya a: Definición de configuración
6. Cuando haya terminado de proporcionar valores para las propiedades, seleccione Guardar.

Agregar una definición de configuración existente

1. Inicie sesión en Power Apps.
2. En el panel de navegación, seleccione Soluciones. Si el elemento no se encuentra en el panel lateral, seleccione …Más y, a continuación, el elemento que desee.
3. En la lista de soluciones, abra la solución a la que desea agregar la configuración.
4. En la barra de comandos, seleccione Agregar existente > Más > Configuración.
5. En el diálogo Agregar definición de configuración existente, seleccione una o más configuraciones que desee agregar.
6. Cuando haya terminado de seleccionar la configuración, seleccione Siguiente
7. En el cuadro de diálogo Definición de configuración seleccionada, para cada ajuste que haya seleccionado, tendrá la opción de Incluir definición de configuración. También puede Incluir valor de entorno de configuración para cada configuración, si existe.
8. Seleccione Agregar para agregar la definición de configuración y/o los valores del entorno de configuración.

Actualizar una definición de configuración

1. Inicie sesión en Power Apps.
2. En el panel de navegación, seleccione Soluciones. Si el elemento no se encuentra en el panel lateral, seleccione …Más y, a continuación, el elemento que desee.
3. En la lista de soluciones, abra la solución en la que creó la configuración.
4. En la vista de árbol, seleccione Configuración > Definiciones de configuración.
5. Seleccione la definición de configuración que quiera actualizar.
6. En el cuadro de diálogo Editar configuración, actualice los valores de cualquiera de las propiedades que desee cambiar.
   Tenga en cuenta que algunas propiedades no se pueden actualizar después de que se haya creado una configuración. Además, en la mayoría de los casos no podrá actualizar las definiciones de configuración que no sean de su propiedad.
7. Cuando haya terminado de actualizar valores para las propiedades, seleccione Guardar.

Quitar una definición de configuración

1. Inicie sesión en Power Apps.
2. En el panel de navegación, seleccione Soluciones. Si el elemento no se encuentra en el panel lateral, seleccione …Más y, a continuación, el elemento que desee.
3. En la lista de soluciones, abra la solución en la que creó la configuración o a la que se la agregó.
4. En la vista de árbol, seleccione Configuración > Definiciones de configuración.
5. Seleccione la definición de configuración que desee quitar.
6. En la barra de comandos, seleccione Quitar > Quitar de esta solución.
   Quitar de esta solución quita la definición de configuración de la solución actual, pero seguirá siendo parte de la solución predeterminada o de cualquier otra solución a la que se haya agregado.

Eliminar una definición de configuración

1. Inicie sesión en Power Apps.
2. En el panel de navegación, seleccione Soluciones. Si el elemento no se encuentra en el panel lateral, seleccione …Más y, a continuación, el elemento que desee.
3. En la lista de soluciones, abra la solución en la que creó la configuración o a la que se la agregó.
4. En la vista de árbol, seleccione Configuración > Definiciones de configuración.
5. Seleccione la definición de configuración que desee eliminar.
6. En la barra de comandos, seleccione Quitar > Eliminar de este entorno.
   Eliminar de este entorno elimina la definición de configuración del entorno actual y ya no será parte de ninguna solución en ese entorno. Solo puede eliminar definiciones de configuración que le pertenezcan.

Valor de entorno de configuración

Un valor de entorno de configuración sirve para reemplazar el valor predeterminado de la configuración en todas las aplicaciones de un entorno. Utilice un valor de entorno de configuración cuando el valor predeterminado de la configuración no sea el que desea utilizar para las aplicaciones de su entorno.

Agregar un nuevo valor de entorno de configuración

1. Inicie sesión en Power Apps.

2. En el panel de navegación, seleccione Soluciones. Si el elemento no se encuentra en el panel lateral, seleccione …Más y, a continuación, el elemento que desee.

3. En la lista de soluciones, abra la solución a la que desea agregar el valor de entorno de configuración.

4. Si la definición de configuración está disponible en la solución:

   1. Seleccione la definición de configuración.
   2. En el diálogo Editar valor de configuración , en la sección Establecer valor de entorno, seleccione Nuevo valor.
   3. Proporcione el valor y luego seleccione Guardar.

   Si la definición de configuración no está disponible en la solución:

   1. En la barra de comandos, seleccione Nuevo > Más > Configuración> Valor de entorno de configuración.
   2. Seleccione la configuración para la que desea agregar el valor de entorno de configuración y luego seleccione Agregar.
   3. En el diálogo Nuevo valor de entorno de configuración , en la sección Establecer valor de entorno, seleccione Nuevo valor.
   4. Proporcione el valor y luego seleccione Guardar.

Agregar un valor de entorno de configuración existente

1. Inicie sesión en Power Apps.

2. En el panel de navegación, seleccione Soluciones. Si el elemento no se encuentra en el panel lateral, seleccione …Más y, a continuación, el elemento que desee.

3. En la lista de soluciones, abra la solución a la que desea agregar el valor de entorno de configuración.

4. Si la definición de configuración está disponible en la solución:

   1. Seleccione la definición de configuración.
   2. En el diálogo Editar valor de configuración , en la sección Establecer valor de entorno, seleccione Agregar valor existente.
   3. Actualice el valor si es necesario y luego seleccione Guardar.

   Si la definición de configuración no está disponible en la solución:

   1. En la barra de comandos, seleccione Agregar existente > Más > Configuración.
   2. En el diálogo Agregar definición de configuración existente, seleccione una o más configuraciones para las que desee agregar valores de entorno de configuración.
   3. Cuando haya terminado de seleccionar la configuración, seleccione Siguiente
   4. En el cuadro de diálogo Definición de configuración seleccionada, para cada ajuste que haya seleccionado, tendrá la opción de Incluir definición de valor de entorno de configuración, si existe. También puede Incluir definición de configuración para cada configuración, si lo desea.
   5. Seleccione Agregar para agregar valores de entorno de configuración y/o definiciones de configuración.

Actualizar un valor de entorno de configuración

1. Inicie sesión en Power Apps.
2. En el panel de navegación, seleccione Soluciones. Si el elemento no se encuentra en el panel lateral, seleccione …Más y, a continuación, el elemento que desee.
3. En la lista de soluciones, abra la solución a la que agregó el valor de entorno de configuración.
4. En la vista de árbol, seleccione Configuración > Valores de entorno de configuración.
5. Seleccione el valor de entorno de configuración que quiera actualizar.
6. En el diálogo Editar configuración , en la sección Establecer valor de entorno, actualice el valor y luego seleccione Guardar.

Quitar un valor de entorno de configuración

1. Inicie sesión en Power Apps.
2. En el panel de navegación, seleccione Soluciones. Si el elemento no se encuentra en el panel lateral, seleccione …Más y, a continuación, el elemento que desee.
3. En la lista de soluciones, abra la solución en la que creó la configuración o a la que se la agregó.
4. En la vista de árbol, seleccione Configuración > Valores de entorno de configuración.
5. Seleccione el valor de entorno de configuración que quiera quitar.
6. En la barra de comandos, seleccione Quitar > Quitar de esta solución.
   Quitar de esta solución quita el valor de entorno de configuración de la solución actual, pero seguirá siendo parte de la solución predeterminada o de cualquier otra solución a la que se haya agregado.

Eliminar un valor de entorno de configuración

1. Inicie sesión en Power Apps.
2. En el panel de navegación, seleccione Soluciones. Si el elemento no se encuentra en el panel lateral, seleccione …Más y, a continuación, el elemento que desee.
3. En la lista de soluciones, abra la solución en la que creó la configuración o a la que se la agregó.
4. En la vista de árbol, seleccione Configuración > Valores de entorno de configuración.
5. Seleccione el valor de entorno de configuración que quiera eliminar.
6. En la barra de comandos, seleccione Quitar > Eliminar de este entorno.
   Eliminar de este entorno elimina el valor de entorno de configuración del entorno actual y ya no será parte de ninguna solución en ese entorno.

Valor de la aplicación de configuración

Valor de la aplicación de configuración sirve para reemplazar el valor predeterminado de la configuración y cualquier valor de entorno de configuración para una sola aplicación. Utilice un valor de aplicación de configuración cuando el valor de entorno de configuración no sea el que desea utilizar para la aplicación. Si no existe un valor de entorno de configuración, utilice el valor de aplicación de configuración cuando el valor predeterminado de la configuración no sea el que desea utilizar para la aplicación.

Nota

Para seguir los pasos que se enumeran a continuación, debe utilizar el nuevo diseñador de aplicaciones. Actualmente, el diseñador de aplicaciones solo muestra configuraciones de la plataforma Power Apps. Para configuraciones ajenas a la plataforma, use el explorador de soluciones como se describe a continuación.

Agregar o actualizar un valor de aplicación de configuración con el diseñador de aplicaciones

1. Abra la aplicación para la que desea agregar el valor de aplicación de configuración en el diseñador de aplicaciones.
2. Seleccione Configuración en la barra de comandos.
3. En el cuadro de diálogo Configuración, seleccione la pestaña Características o Próximamente.
   La pestaña Características muestra todas las configuraciones que tienen el nivel de versión establecido en Disponible en general. La pestaña Próximamente muestra todas las configuraciones que tienen el nivel de versión establecido en Versión preliminar.
4. Agregue o actualice un valor de aplicación para la configuración que desee.
5. Guarde y publique la aplicación.

Eliminar un valor de aplicación de configuración con el diseñador de aplicaciones

1. Abra la aplicación para la que desea quitar el valor de aplicación de configuración en el diseñador de aplicaciones.
2. Seleccione Configuración en la barra de comandos.
3. En el cuadro de diálogo Configuración, seleccione la pestaña Características o Próximamente.
4. Seleccione Restablecer al valor del entorno junto al valor de la aplicación de configuración que desea eliminar. Esto hace que el valor de configuración retroceda al valor del entorno de configuración, si existe. Si no existe ningún valor de entorno de configuración, retrocederá al valor predeterminado de la configuración.
   Tenga en cuenta que la opción de Restablecer al valor del entorno solo se muestra si se agregó previamente un valor de aplicación de configuración para esa configuración.
5. Guarde y publique la aplicación.

Agregar o actualizar un valor de aplicación de configuración con el explorador de soluciones

1. Inicie sesión en Power Apps.
2. En el panel de navegación, seleccione Soluciones. Si el elemento no se encuentra en el panel lateral, seleccione …Más y, a continuación, el elemento que desee.
3. En la lista de soluciones, abra la solución a la que desea agregar el valor de aplicación de configuración.
4. Si la definición de configuración o el valor del entorno de configuración no están disponibles en la solución, agregue uno de ellos. Vaya a Agregar una definición de configuración existente o Agregar un valor de entorno de configuración existente.
5. Seleccione la definición de configuración o el valor del entorno de configuración.
6. En el diálogo Editar valor de configuración, en la sección Establecer valores de la aplicación, busque la aplicación para la que desea agregar el valor de la aplicación de configuración. Tenga en cuenta que con el explorador de soluciones solo puede agregar valores de aplicación de configuración para las aplicaciones que se encuentran en la solución actual.
7. Proporcione el valor y seleccione Guardar.
8. Para que el valor de aplicación de configuración surta efecto, tendrá que volver a publicar la aplicación utilizando el diseñador de aplicaciones o el explorador de soluciones.

Eliminar un valor de aplicación de configuración con el explorador de soluciones

1. Inicie sesión en Power Apps.
2. En el panel de navegación, seleccione Soluciones. Si el elemento no se encuentra en el panel lateral, seleccione …Más y, a continuación, el elemento que desee.
3. En la lista de soluciones, abra la solución de la que desea eliminar el valor de aplicación de configuración.
4. Si la definición de configuración o el valor del entorno de configuración no están disponibles en la solución, agregue uno de ellos. Más información: Agregar una definición de configuración existente o Agregar un valor de entorno de configuración existente.
5. Seleccione la definición de configuración o el valor del entorno de configuración.
6. En el diálogo Editar valor de configuración, en la sección Establecer valores de la aplicación, busque la aplicación para la que desea eliminar el valor de la aplicación de configuración. Tenga en cuenta que con el explorador de soluciones solo puede quitar valores de aplicación de configuración para las aplicaciones que se encuentran en la solución actual.
7. Seleccione ... junto al valor de la aplicación de configuración y luego seleccione Restablecer al entorno.
8. Seleccione Guardar.
9. Para que la eliminación del valor de aplicación de configuración surta efecto, tendrá que volver a publicar la aplicación utilizando el diseñador de aplicaciones o el explorador de soluciones.

Obtener o actualizar un valor de configuración mediante código

Para conocer los métodos disponibles, vaya a Obtener o actualizar un valor de configuración usando la API del cliente.

Consulte también

Para desarrolladores:

• Función RetrieveSetting
• Acción SaveSettingValue