Administración del ciclo de vida de las aplicaciones de la barra de comandos

Completado

Al personalizar una barra de comandos en una aplicación basada en modelo de Power Apps, las soluciones de Microsoft Dataverse realizan un seguimiento de sus personalizaciones. Las soluciones de Dataverse son la forma de transportar las personalizaciones de la barra de comandos, la aplicación y los componentes de la solución relacionados de un entorno de Power Platform a otro, como entre desarrollo y prueba y producción.

Al crear su primer comando desde el diseñador de la barra de comandos, deberá elegir un tipo de comando que determinará si se necesita una biblioteca de componentes. La biblioteca de componentes es necesaria si usa la lógica Power Fx para la Visibilidad o el OnSelect del comando. El siguiente es el cuadro de diálogo que le permite elegir Power Fx o JavaScript para su lógica de comandos.

Captura de pantalla de la elección del tipo de comando

No necesita bibliotecas de componentes si solo usa JavaScript. Sin embargo, puede crear una biblioteca de componentes en cualquier momento para usar Power Fx, seleccionando Ejecutar fórmula o Mostrar con condición desde la fórmula en el panel de propiedades de comandos. Cuando realice ese cambio, aparecerá una indicación para crear la biblioteca de componentes.

Por lo general, lo mejor es crear una solución personalizada para su aplicación y los activos relacionados. Si su aplicación está en una solución de Dataverse personalizada, la biblioteca de componentes también estará en la misma solución. De lo contrario, su aplicación y la biblioteca de componentes estarán en la Solución predeterminada de Common Data Services. El nombre de la biblioteca de componentes usará el nombre de su aplicación, junto con DefaultCommandLibrary. A continuación, se muestra una solución con una tabla, una aplicación y una biblioteca de componentes.

Captura de pantalla de la biblioteca de componentes de la solución

Si ha personalizado la barra de comandos en varias aplicaciones y ha utilizado Power Fx, cada una debería tener una biblioteca de componentes correspondiente.

La biblioteca de componentes tendrá un componente para cada fórmula de Power Fx utilizada para los comandos de la barra de comandos. Otras propiedades, como las etiquetas de visualización, los íconos y la información sobre herramientas, son independientes y forman parte de la definición de las aplicaciones basadas en modelos. Cuando una solución de Dataverse sigue estos recursos, es esencial entenderlo, ya que puede afectar a cómo cambia el transporte entre entornos de Power Platform. Si no va con cuidado, es posible que los dos recursos de la solución (que, en conjunto, forman una definición de comando) estén desincronizados en un entorno de destino al hacer cambios directamente en ese entorno. Por ejemplo, si mueve su solución como administrada desde un entorno de desarrollo a un entorno de prueba y luego realiza cambios directamente en el entorno de prueba. La falta de sincronización también puede ocurrir si alguien publica una aplicación y usted la importa a su entorno de desarrollo y la personaliza. Las futuras versiones actualizadas del creador de la aplicación con cambios en la barra de comandos no tendrán visibles estos cambios porque usted ha creado su capa de solución de personalización.

Si no puede ver los cambios más recientes de los comandos de la barra de comandos, puede comprobar las capas de soluciones para ver si se ha realizado un cambio no administrado que impide sean visibles en su última versión. Para lograr esto, seleccione la biblioteca de componentes en el explorador de soluciones y seleccione Avanzado > Ver capas de soluciones. El siguiente es un ejemplo de una biblioteca de componentes donde se realizó una actualización por encima de la solución administrada.

Captura de pantalla de las capas de solución

En este ejemplo, debido a que alguien realizó un cambio de capa no administrada en este entorno, si importa actualizaciones, no estarán activas en este entorno hasta que elimine el cambio de capa no administrada.

Lo mejor es realizar cambios solo en su entorno de desarrollo y evitar crear involuntariamente capas de cambios por encima de la solución importada. También puede marcar una biblioteca de componentes como no personalizable actualizando el ajuste de propiedad administrada de la biblioteca de componentes.

Captura de pantalla de la opción de menú de propiedades administradas

El ajuste de propiedad administrada le permite deshabilitar la personalización de la biblioteca de componentes.

Captura de pantalla de la propiedad permitir personalizaciones

La desactivación de las personalizaciones impide la personalización de las fórmulas de Visibilidad y OnSelect, pero no impide los cambios en otras propiedades de los comandos, como Mostrar etiqueta. Cuando está habilitado, surte efecto solo después de exportar su solución como administrada e importarla a otro entorno. Si intenta modificarlo después de importarlo como administrado, se le impedirá hacerlo y aparecerá el siguiente error.

Captura de pantalla del mensaje de error al guardar la biblioteca de componentes

Soporte técnico de localización

Después de personalizar la barra de comandos para agregar comandos, es posible que desee traducir sus etiquetas a otros idiomas. Para proporcionar traducciones para los comandos, realice los siguientes pasos:

  • En el explorador de soluciones, seleccione Traducciones > Exportar traducciones.

  • Una vez finalizada la exportación, se descarga, en la carpeta de descargas predeterminada de su explorador, un archivo comprimido (zip) de las traducciones exportadas, que contiene las etiquetas exportadas.

  • Extraiga el archivo XML del archivo comprimido (.zip).

  • Abra el archivo CrmTranslations.xml en Excel.

  • Seleccione la hoja denominada Etiquetas localizadas.

En la hoja Etiquetas localizadas, desplácese hacia abajo, hasta donde el nombre de la entidad contiene "appaction". Cada comando de la barra de comandos puede tener varias líneas que representan cada una de las propiedades, como texto, información sobre herramientas y descripción. Para cada botón, proporcione las traducciones como se muestra a continuación en la columna de la hoja de trabajo 1034 (español).

Captura de pantalla del archivo de traducción

Cuando haya finalizado los cambios, guarde el archivo y comprima los archivos en un nuevo archivo comprimido. Utilice la opción del menú Traducción Importar > traducciones para actualizar las traducciones en la solución de Dataverse. Repita este proceso al actualizar etiquetas o agregar comandos a las barras de comandos.

Las soluciones de Dataverse son importantes para permitir que las personalizaciones de las barras de comandos se sigan y transporten desde un entorno a otro. Las soluciones también juegan un papel importante para garantizar las dependencias entre los componentes de la solución. Las dependencias evitan errores, como eliminar una biblioteca de componentes de la que depende la aplicación para sus expresiones de barra de comandos de Power Fx. A medida que comience a realizar personalizaciones de las barras de comandos, tómese un minuto para asegurarse de que está trabajando en una solución personalizada y de que la aplicación y la biblioteca de componentes están juntas. De este modo, al exportar la solución, no tendrá que preocuparse de resolver las dependencias que falten.