Gerenciamento do ciclo de vida do aplicativo da barra de comandos
Ao personalizar uma barra de comandos em um aplicativo baseado em modelo do Microsoft Power Apps, as soluções do Microsoft Dataverse rastreiam essas alterações. As soluções do Dataverse ajudam a mover personalizações da barra de comandos, o aplicativo e componentes relacionados entre ambientes do Microsoft Power Platform, como desenvolvimento, teste e produção.
Ao criar seu primeiro comando usando o designer da barra de comandos, você escolhe um tipo de comando. Essa escolha determina se a biblioteca de componentes é necessária. Uma biblioteca de componentes será necessária se você usar o Power Fx para as propriedades Visibility ou OnSelect do comando. A caixa de diálogo a seguir permite que você escolha entre Power Fx e JavaScript para a lógica de comando:
Uma biblioteca de componentes não será necessária se o comando usar apenas JavaScript. No entanto, você pode criar uma biblioteca de componentes a qualquer momento para usar o Power Fx, bastando selecionar Executar fórmula ou Mostrar na condição no painel de propriedades do comando. Ao fazer isso, será solicitado que você crie a biblioteca de componentes.
É melhor criar uma solução personalizada do Dataverse para seu aplicativo e ativos relacionados. Se o aplicativo estiver em uma solução personalizada, a biblioteca de componentes também estará. Caso contrário, eles serão colocados na Solução Padrão Common Data Services. O nome da biblioteca de componentes combina o nome do seu aplicativo com DefaultCommandLibrary. A imagem seguinte mostra uma solução que inclui aplicativos, fluxos e bibliotecas de componentes:
Se você personalizar barras de comandos em vários aplicativos usando o Power Fx, cada aplicativo terá sua própria biblioteca de componentes correspondente.
Cada biblioteca de componentes contém um componente para cada fórmula do Power Fx usada em comandos da barra de comandos. Outras propriedades, como rótulos de exibição, ícones e dicas de ferramentas, fazem parte da configuração do aplicativo baseado em modelo. Entender como esses componentes são rastreados nas soluções do Dataverse é importante porque as personalizações podem ficar fora de sincronia entre os ambientes. Por exemplo, as alterações feitas diretamente em um ambiente de teste após a importação de uma solução gerenciada podem resultar em uma incompatibilidade.
Se um comando da barra de comandos não mostrar as alterações mais recentes, veja as camadas de solução para verificar se uma alteração não gerenciada está bloqueando a visibilidade. No gerenciador de soluções, selecione a biblioteca de componentes e, em seguida, Avançado > Ver Camadas de Solução. A imagem a seguir mostra um exemplo de camada não gerenciada sobre uma solução gerenciada:
Neste exemplo, alguém fez uma alteração não gerenciada no ambiente. Consequentemente, a importação das atualizações não será aplicada até que a camada não gerenciada seja removida.
Sempre faça alterações em seu ambiente de desenvolvimento para evitar camadas não gerenciadas indesejadas. Você também pode impedir personalizações definindo as propriedades gerenciadas da biblioteca de componentes para que elas não permitam personalizações:
Desabilitar personalizações impede a edição de fórmulas do Power Fx em Visibility e OnSelect, mas não restringe atualizações em outras propriedades do comando, como Display Label. Essa restrição só entra em vigor após exportar a solução como gerenciada e importá-la em outro local. Se você tentar alterar a biblioteca de componentes após a importação dela como gerenciada, o seguinte erro será exibido:
Suporte à localização
Depois de personalizar uma barra de comandos, talvez você queira traduzir seus rótulos para usuários em outros idiomas. Para isso:
- No gerenciador de soluções, selecione Traduções > Exportar traduções.
- Depois que a exportação for concluída, um arquivo ZIP será baixado.
- Extraia e abra o arquivo
CrmTranslations.xmlno Excel. - Na planilha Rótulos Localizados, role para baixo até as linhas em que Nome da Entidade contém "appaction".
- Cada comando pode incluir várias entradas para propriedades como texto, dica de ferramenta e descrição. Insira traduções na coluna do idioma apropriado, como 1034 para espanhol.
Quando terminar, salve o arquivo e compacte os arquivos de tradução. Em seguida, use Tradução > Importação traduções para atualizar a solução. Repita esse processo ao atualizar rótulos ou adicionar comandos.
As soluções do Dataverse ajudam a rastrear e mover personalizações da barra de comandos entre ambientes. Elas também gerenciam dependências, garantindo que componentes como a biblioteca de componentes não sejam removidos se ainda forem necessários pelo aplicativo. Sempre confirme se o aplicativo e a biblioteca de componentes estão na mesma solução personalizada antes de exportar para evitar a falta de dependências.