KB: Atualizar componentes gerenciados existentes para um novo tipo de componente e modelo

Detalhes da solução

Componentes existentes exigem uma nova estrutura

Os componentes gerenciados existentes podem precisar ser atualizados quando uma organização substitui os tipos e modelos de componentes de exemplo por configurações personalizadas. Os componentes devem então ser migrados para o novo tipo de componente, modelo e estrutura de pastas. Ao reestruturar componentes, é importante considerar os diferentes requisitos e pontos de partida envolvidos. Assim, um processo rígido passo a passo nem sempre é adequado.

Os tipos de componentes controlam a organização e os modelos

Os tipos de componentes geralmente estão associados a um modelo de componente e a uma estrutura de pastas padrão. Os modelos de componentes definem conjuntos de parâmetros, visibilidade dos parâmetros, valores padrão e configurações de parâmetros obrigatórios. Atualizar um tipo de componente frequentemente exige atualizar o modelo e a estrutura de pastas associados para manter a consistência em todo o Workspace.

Abordagens disponíveis para reestruturar componentes

• Ative um novo Workspace sem dados de exemplo e crie tipos de componentes, modelos e estruturas de pastas personalizados. Observe que essa opção não é viável se você já tiver criado dados de projetos em uso no seu Workspace atual.
   
• Atualize os modelos e tipos de componentes existentes antes de criar componentes. 
  
• Crie um novo tipo de componente, modelo e estrutura de pastas e, em seguida, atualize os componentes existentes para a nova configuração usando a edição em lote.

Atualize componentes usando a edição em lote

1. Crie o novo tipo de componente, modelo e estrutura de pastas.
   
2. Revise os modelos antigo e novo para garantir a consistência dos parâmetros. A correspondência entre os nomes e os tipos dos parâmetros ajuda a evitar parâmetros duplicados e reduz o trabalho de limpeza após a migração. Parâmetros adicionais são aceitáveis, mas os parâmetros principais devem permanecer consistentes sempre que possível. Ao criar novos parâmetros no modelo, evite marcá-los como obrigatórios, a menos que os dados correspondentes sejam inseridos manualmente. 
    
3. Valide o processo em um pequeno lote de componentes de teste antes de atualizar uma biblioteca de componentes maior.
4. Mova os componentes existentes da estrutura de pastas antiga para a nova no Explorer.
    
5. Abra os componentes migrados para edição em lote
   
6. Na seção Models and Parameters, clique em Add e selecione Template: None. Isso converte os parâmetros do modelo existente em parâmetros de usuário.
    
7. Clique em Add novamente e selecione o novo modelo de componente
8. Quando solicitado, confirme a atualização do tipo de componente para todos os componentes selecionados. O novo modelo substitui os parâmetros de usuário pelos nomes de parâmetros do modelo e adiciona os parâmetros recém-definidos.
    
9. Execute as atualizações em lotes, começando pelos componentes no estado do ciclo de vida Draft antes de atualizar os componentes em outros estados do ciclo de vida.
10. Verifique se os estados do ciclo de vida são preservados durante as operações de liberação de componentes realizadas pelo editor em lote.
11. Após validar com sucesso os componentes migrados, remova os tipos de componentes, modelos e itens relacionados obsoletos para evitar confusão.

Observações adicionais

• A movimentação de componentes e o gerenciamento dos estados do ciclo de vida podem ser realizados de forma incremental.
• Inconsistências nos parâmetros entre os modelos antigo e novo podem exigir limpeza manual usando ferramentas de edição em lote. Link

Referências

• Edição de componentes em lote
• Modelos de componentes
• Tipos de componentes