Gestão do ciclo de vida de aplicações de biblioteca de documentos (ALM)

Uma biblioteca de componentes é um tipo especial de aplicação de tela que pode conter um ou mais componentes de tela. Estes componentes da biblioteca podem então ser utilizados por todas as outras aplicações de tela no ambiente. Esta capacidade permite-lhe criar componentes partilhados reutilizáveis em todas as aplicações num ambiente, ao contrários dos componentes ao nível da aplicação que estão restringidos a uma aplicação.

Para utilizar um componente de uma biblioteca de componentes, primeiro, tem de importar o componente para a aplicação de tela. Depois de importado, pode adicionar o componente para qualquer ecrã da aplicação. Quaisquer atualizações na definição do componente da biblioteca de componentes irão pedir-lhe que reveja e incorpore a alteração a pedido ou quando a aplicação for aberta para edição. As bibliotecas de componentes e as aplicações dependentes também podem ser movidas para outro ambiente utilizando soluções do Microsoft Dataverse padrão.

Nota

Neste artigo, o termo "importar" refere-se à importação de um componente de uma biblioteca de componentes para uma aplicação e não deve ser confundido com a importação de uma solução para o Dataverse.

Quando um componente de uma biblioteca de componentes é importado para uma aplicação de tela, a definição desse componente é copiada para a definição da aplicação de tela. Depois de uma definição de componente ter sido importada, a aplicação é "autónoma" no que diz respeito a essa definição de componente. O criador de aplicações pode optar por editar o componente e criar instâncias locais do componente na aplicação. Neste momento não existe ligação direta à biblioteca de componentes de onde o componente originou. Esta caraterística autónoma também se aplica se a aplicação de tela for migrada para um ambiente diferente onde a biblioteca de componentes não está presente. Pode continuar a criar instâncias da definição do componente importado dentro das aplicações no ambiente de destino e as aplicações podem continuar a ser publicadas e reproduzidas. Neste caso, não serão pedidas ou recebidas novas atualizações na aplicação consumidora.

Para manter a relação da aplicação para a biblioteca de componentes, certifique-se de que utiliza a biblioteca de componentes para efetuar alterações ao componente, em vez de editar o componente na aplicação consumidora.

Suporte a soluções de aplicações de tela e bibliotecas de componentes

Consistente com as outras dependências de objetos da solução, se uma aplicação de tela importar um componente de tela de uma biblioteca de componentes, terá uma dependência nessa biblioteca de componentes. Para mover uma aplicação para o novo ambiente, terá de empacotar a biblioteca de componentes dentro da mesma solução ou instalá-la como um pré-requisito. A dependência da aplicação para a biblioteca de componentes é mantida no ambiente de destino. Posteriormente, quando uma biblioteca de componentes com o componente atualizado é importada utilizando uma solução para o ambiente de destino, as aplicações existentes obterão as novas definições do componente utilizando o fluxo de atualização de componentes normal.

Criar e exportar biblioteca de componentes numa solução

Pode criar uma biblioteca de componentes diretamente a partir da solução ou adicioná-la a uma solução existente.

Quando uma biblioteca de componentes é guardada num ambiente que tenha o Dataverse disponível, a biblioteca de componentes é adicionada automaticamente à solução predefinida. É gerado um nome lógico exclusivo para a biblioteca de componentes com o prefixo Editor CDS Predefinido. Este comportamento é para garantir que o sistema da solução está a ciente da respetiva presença e pode associar as dependências das aplicações que utilizam o nome lógico da biblioteca de componentes.

Nota

As bibliotecas de componentes criadas antes da implementação da caraterística ALM da biblioteca de componentes precisam de ser editadas, publicadas e o editor tem de ser fechado explicitamente antes de serem ativadas para as capacidades ALM. Pode verificar a prontidão da ALM da biblioteca de componentes pela presença na solução predefinida.

As bibliotecas de componentes dentro de uma solução também suportam as propriedades geridas Permitir personalizações que regem o comportamento da biblioteca de componentes no ambiente de destino.

Se desativar esta definição e exportar a solução para um ambiente de destino, não conseguirá editar a biblioteca de componentes.

Dependências de bibliotecas de componentes

As aplicações que utilizam componentes da biblioteca de componentes serão marcados como dependentes da infraestrutura de soluções. Este comportamento aplica-se a todas as aplicações que são adicionadas a qualquer solução do Dataverse num determinado ambiente. Pode ainda criar aplicações fora de soluções, mas essas aplicações não terão dependências de solução. Posteriormente, poderá adicionar estas aplicações a soluções para as tornar parte da solução ALM.

Se importar uma solução que apenas tenha uma aplicação que utilize um componente de uma biblioteca de componentes, mas excluir a biblioteca de componentes, verá a seguinte mensagem:

"Falha ao importar devido a dependências em falta para <app name>".

Neste caso, pode optar por instalar primeiro a solução de biblioteca de componentes, ou agrupar a biblioteca de componentes com a solução que contém a aplicação de tela. Qualquer um dos passos assegurará que a aplicação terá a dependência criada no ambiente de destino.

Quando a biblioteca é atualizada e uma versão do componente mais recente é importada através das soluções, a aplicação obterá uma notificação e receberá as atualizações quando a aplicação for aberta para edição.

Nota

Se a propriedade gerida da biblioteca de componentes Permitir personalizações estiver desativada, a biblioteca de componentes não pode ser editada no ambiente de destino.

As dependências são calculadas com base no estado publicado mais recente de uma aplicação. Se restaurar uma versão mais antiga da aplicação que não utiliza um componente de biblioteca, a dependência será removida da aplicação e da solução. A importação de um componente para uma aplicação a partir de uma biblioteca de componentes sem o utilizar também cria uma dependência, uma vez que o componente de biblioteca não utilizado permanece disponível na aplicação para utilização futura.

Dica

A edição de um componente a partir de uma biblioteca de componentes dentro da aplicação de consumo cria uma cópia local. Neste momento, o componente de biblioteca continua disponível para utilização através do painel Inserir. Para remover completamente a dependência, elimine o componente de Inserir > Biblioteca de componentes > ... (reticências) > Remover da aplicação.

Melhores práticas e resolução de problemas

• Limite o número de componentes numa biblioteca a 20 para obter desempenho ideal. Planeie e crie previamente várias bibliotecas de componentes, uma vez que o número de componentes nas suas bibliotecas irá provavelmente crescer ao longo do tempo. Esta abordagem também irá reduzir o payload de soluções à medida que as aplicações são movidas pelo ambiente.

• Existe um atraso desde quando a biblioteca de componentes é publicada para quando fica disponível para a aplicação e pode demorar até 5 minutos.

• Se a aplicação não conseguir receber a atualização do componente de biblioteca no ambiente de destino onde a solução está instalada, verifique através das ações abaixo:

  • As alterações feitas a uma biblioteca de componentes num ambiente de destino residem na camada superior de um componente. Subsequentemente, estas personalizações definem o comportamento de runtime do componente. Para remover estas personalizações não geridas, consulte Remover uma camada não gerida.
  • Determine o nome lógico da biblioteca de componentes a partir da vista da solução. Utilize a solução predefinida se a biblioteca não for adicionada explicitamente à solução.
  • Transfira a aplicação utilizando o componente de biblioteca para o computador local utilizando Ficheiro > Guardar como > Este computador. Mude o nome do ficheiro transferido para ter uma extensão .zip e deszipe o pacote. Abra o ficheiro Properties.json e, em seguida, pesquise pela palavra-chave "LibraryDependencies". Deverá ver um nome lógico de biblioteca correspondente.
  • Se estiver a consumir a solução, verifique se a aplicação de tela identificou corretamente as bibliotecas de componentes como dependências de solução. Se a solução não identificar corretamente as bibliotecas de componentes como dependências de solução, isso significa que a dependência da aplicação para a ligação à biblioteca de componentes não foi criada corretamente. Neste caso, consulte o fornecedor da solução para resolver o problema.
  • Se for o editor da solução, verifique se as bibliotecas de componentes são guardadas com o nome lógico da biblioteca na solução e que é a mesma que a referenciada no pacote .msapp da biblioteca de componentes.

• A exportação da solução exporta sempre a versão mais recente da biblioteca de componentes. Por isso, atualize sempre as aplicações com a versão de componente mais recente antes de as exportar através de soluções. Esta ação assegura que as aplicações têm a mesma versão de componente que está disponível na versão mais recente da biblioteca de componentes. As aplicações e bibliotecas são consideradas como sincronizadas entre si quando são movidas para um ambiente de destino pela primeira vez; e, consequentemente, não lhe é pedido que esteja disponível qualquer atualização quando editar a aplicação.

Consulte também

• Componentes de tela
• Biblioteca de componentes
• Mapear campos de entrada de um componente
• Adicionar multimédia a um componente
• Fórmulas de comportamento para componentes
• Power Apps component framework
• Adicionar componentes de tela a uma página personalizada numa aplicação condicionada por modelo

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).