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 Microsoft Power Apps, las soluciones de Microsoft Dataverse realizan un seguimiento de esos cambios. Las soluciones de Dataverse le ayudan a mover las personalizaciones de la barra de comandos, la aplicación y los componentes relacionados entre los entornos de Microsoft Power Platform, como desarrollo, prueba y producción.

Cuando crea su primer comando mediante el diseñador de la barra de comandos, elige un tipo de comando. Esa elección determina si necesitará una biblioteca de componentes. La biblioteca de componentes es necesaria si usa Power Fx para las propiedades Visibilidad u OnSelect del comando. El siguiente cuadro de diálogo le permite elegir entre Power Fx y JavaScript para la lógica de comandos:

No se requiere una biblioteca de componentes si el comando usa solo JavaScript. Sin embargo, puede crear una biblioteca de componentes en cualquier momento para usar Power Fx; para ello, seleccione Ejecutar fórmula o Mostrar en condición en el panel de propiedades del comando. Al hacerlo, se le pedirá que cree la biblioteca de componentes.

Lo mejor es crear una solución Dataverse personalizada para su aplicación y los activos relacionados. Si la aplicación está en una solución personalizada, la biblioteca de componentes también lo está. De lo contrario, se colocan en la solución predeterminada de Common Data Services. El nombre de la biblioteca de componentes es una combinación del nombre de la aplicación y DefaultCommandLibrary. La siguiente imagen muestra una solución con aplicaciones, flujos y bibliotecas de componentes:

Si personaliza las barras de comandos en varias aplicaciones usando Power Fx, cada aplicación tendrá una biblioteca de componentes correspondiente.

Cada biblioteca de componentes tendrá un componente para cada fórmula de Power Fx utilizada en los comandos de la barra. Otras propiedades, como las etiquetas de visualización, los iconos y la información sobre herramientas, forman parte de la configuración de las aplicaciones basadas en modelos. Comprender cómo se hace el seguimiento de estos componentes en las soluciones de Dataverse es importante porque las personalizaciones pueden perder la sincronización entre entornos. Por ejemplo, los cambios realizados directamente en un entorno de prueba después de importar una solución administrada pueden dar lugar a una discrepancia.

Si un comando de la barra de comandos no muestra los últimos cambios, compruebe las capas de solución para ver si hay algún cambio no administrado que esté bloqueando la visibilidad. En el explorador de soluciones, seleccione la biblioteca de componentes y Avanzado > Ver capas de soluciones. La siguiente imagen muestra un ejemplo de capa no administrada sobre una solución administrada.

En este ejemplo, alguien ha hecho un cambio no administrado en el entorno. Como resultado, la importación de actualizaciones no se aplicará hasta que se elimine la capa no administrada.

Haga siempre cambios en su entorno de desarrollo para evitar que haya capas no administradas no deseadas. También puede evitar las personalizaciones configurando las propiedades administradas de la biblioteca de componentes para que no permita las personalizaciones:

La desactivación de las personalizaciones impide la edición de las fórmulas de Power Fx para Visibilidad y OnSelect, pero no limita las actualizaciones en otras propiedades del comando, como Display Label. Esta restricción solo entra en vigor después de exportar la solución como administrada e importarla a otro lugar. Si intenta cambiar la biblioteca de componentes después de importarla como administrada, aparecerá el siguiente error:

Soporte técnico de localización

Después de personalizar una barra de comandos, es posible que desee traducir sus etiquetas para los usuarios de otros idiomas. Para hacerlo:

1. En el explorador de soluciones, seleccione Traducciones > Exportar traducciones.
2. Una vez finalizada la exportación, se descarga un archivo ZIP.
3. Extraiga y abra el archivo CrmTranslations.xml en Excel.
4. En la hoja Etiquetas localizadas, baje hasta donde Nombre de entidad contiene "appaction".
5. Cada comando puede incluir varias entradas para propiedades como texto, información sobre herramientas y descripción. Escriba las traducciones en la columna de idioma correspondiente, como 1034 para español.

Cuando haya terminado, guarde el archivo y comprima los archivos de traducción. A continuación, use Traducción > Importar traducciones para actualizar la solución. Repita este proceso al actualizar etiquetas o añadir comandos.

Con las soluciones de Dataverse, podemos mover las personalizaciones de la barra de comandos entre entornos y hacer un seguimiento de estas. Además, administran las dependencias, lo que garantiza que elementos como la biblioteca de componentes no se eliminen si la aplicación aún los necesita. Confirme siempre que tanto la aplicación como la biblioteca de componentes estén en la misma solución personalizada antes de exportar, para evitar que falten dependencias.