Branch (Projeto): federar por porções menores

Visão geral

Branches são amplamente usados no contexto de modelos federados, especialmente para geração de modelos federados em formato NWD. Ao selecionar um branch, você define quais pastas e modelos compõem aquela porção federada.

Nota Um branch pode conter todos os modelos do projeto ou apenas áreas específicas, ajudando a criar federados menores para consumo local e compartilhamento conforme necessário.

Como a aba Branch se organiza

Ao abrir a aba Branch no contexto do projeto, há duas seções principais: à esquerda, a árvore do projeto; à direita, a lista de branches do projeto em formato de tabela.

Na lista de branches, cada branch tem nome, descrição e estado (status). Também pode existir a ação Delete para remover um branch, conforme permissão.

Criar um novo branch

Passos

1. No painel da direita (lista de branches), role até o fim da tabela.
2. Use o comando Add para incluir um novo branch na lista.
3. Preencha os detalhes do novo branch (nome, descrição e status).
4. Selecione o branch recém-criado.
5. No painel da esquerda (árvore), selecione as pastas e modelos que devem compor o branch.

Nota Por padrão, novos modelos não são incluídos automaticamente em branches. Se você quiser automatizar essa inclusão para um branch principal, veja Include New Models em #include-new-models.

Include New Models

Include New Models permite definir um branch para receber automaticamente todos os novos modelos adicionados ao projeto. Quando essa opção estiver como Yes em um branch, todo modelo criado no projeto será automaticamente incluído nesse branch.

Nota Esse comportamento se aplica apenas à criação de novos modelos. Atualizações em modelos já existentes não disparam inclusão automática.

Configurar Include New Models

1. Na lista de branches, escolha o branch que deve funcionar como principal ou consolidado.
2. No branch selecionado, defina Include New Models como Yes.
3. Se já existir outro branch com Include New Models = Yes, desative nele antes de ativar no novo branch.
4. Ao criar um novo modelo no projeto, após a confirmação da criação, o modelo será incluído automaticamente no branch configurado.

Atenção Apenas um branch por projeto pode permanecer com Include New Models = Yes.

Editar nome e descrição

Passos

1. Na tabela de branches, localize o branch desejado.
2. Dê duplo clique no campo de nome ou descrição.
3. Edite o valor diretamente no campo.

Permissões e status do branch

O status do branch indica se ele será processado para gerar histórico de modelos federados. Quando ativo, o status aparece em verde; quando inativo, em cinza.

Ativar ou desativar um branch

1. Na tabela de branches, localize o branch desejado.
2. Clique no ícone do status para alternar entre ativo e inativo.

Atenção Para modificar o status, é necessário ter permissão (mencionado como administrador do projeto). Para detalhes de permissões, ver [Permissões, papéis e disciplinas](/tutorials/iforge-cde/ui-navigation/permissions-roles-disciplines).

Excluir um branch

Passos

1. Na tabela de branches, localize o branch desejado.
2. Use a ação Delete para deletar o branch (quando disponível).

Atenção A disponibilidade de Delete depende de permissão do usuário.

Definir o conteúdo do branch (pastas e modelos)

Para incluir modelos no federado de um branch, selecione o branch na lista e use a árvore do projeto para definir quais pastas e modelos irão compor aquela porção.

Passos

1. No painel da direita, clique no branch desejado.
2. No painel da esquerda (árvore), visualize os itens associados ao branch selecionado.
3. Selecione as pastas e os modelos que devem compor o branch.

Como branches afetam o processamento

Branches ajudam o sistema a identificar o que deve ser processado para compor modelos federados e para inclusão no iForge® Compass. Modelos e arquivos fora de qualquer branch tendem a não ser processados e ficam apenas armazenados e versionados.

Nem todo arquivo na árvore precisa compor o modelo federado. A inclusão em um branch funciona como indicação do que deve ser processado, enquanto outros arquivos podem permanecer apenas como referência e armazenamento.

Nota Para reduzir manutenção manual em um branch principal, use Include New Models em #include-new-models.

Quando um modelo não aparece no federado

Verificações iniciais

1. Verifique se o modelo está incluído em algum branch.
2. Se não estiver em nenhum branch, adicione o modelo ao branch desejado para que ele passe a ser processado e incluído no iForge® Compass e no modelo federado NWD associado.

Nota Se você configurou Include New Models = Yes, a inclusão automática ocorre apenas para modelos novos e somente após a confirmação da criação do modelo.

Referências cruzadas

Este tema tem referências cruzadas com as abas [Review](/tutorials/iforge-cde/project/review), Compare, [Tree](/tutorials/iforge-cde/project/tree) e [Dashboard](/tutorials/iforge-cde/project/dashboard). Para permissões no projeto, consulte [Permissões, papéis e disciplinas](/tutorials/iforge-cde/ui-navigation/permissions-roles-disciplines).