Guia de Mapeamento de Propriedades Personalizadas do Pipeline de Projetos

Quando uma tarefa de pipeline avança para um estágio configurado para criar um projeto, o Fluid automaticamente cria o novo projeto copiando os detalhes da ação de origem.
Este guia explica como o sistema mapeia propriedades personalizadas de ações para campos de projeto — e como garantir que seus quadros de pipeline estejam configurados para uma transferência de dados precisa e consistente.

1. Disponibilidade do Recurso – A criação de projetos pelo pipeline só está disponível quando o sinalizador de recurso Mostrar Pipeline de Projetos está habilitado e o usuário possui acesso de nível Editor no quadro da ação.

2. Criando o Modelo de Projeto – Quando uma tarefa de pipeline aciona a criação de um projeto, o Fluid converte a ação em um modelo de configuração de projeto usando

3. Copiando Propriedades Personalizadas – O Fluid copia as propriedades personalizadas em duas etapas:

   • Campos mapeados: Propriedades conhecidas (ex.: datas, metodologia, responsáveis) são promovidas para campos de projeto.

   • Todas as outras propriedades: Ensures any remaining action properties are also transferred, so no data is lost.

4. Criação Final do Projeto – O projeto é criado e salvo no sistema. Um link de referência entre a ação de origem e o novo projeto é registrado em Action.PipelineGuid.

O Fluid reconhece e promove automaticamente determinadas propriedades personalizadas para campos de projeto de primeira classe. Elas são detectadas pelo nome da chave ou rótulo de exibição (sem distinção entre maiúsculas e minúsculas).

Abaixo estão os mapeamentos atualmente suportados.

Padrões de Data:

• Sem data de início ou término → início = hoje, término = em branco

• Somente data de término (futura) → início = hoje

• Somente data de término (passada) → início = término

• Somente data de início → término deixado em branco

• Término antes do início → término deixado em branco

Campos de texto e listas suspensas só são transferidos se contiverem valores válidos ou reconhecidos.

Os campos de pessoa são vinculados usando o ID do usuário. Quando válido, o usuário é automaticamente adicionado à função de equipe relevante no novo projeto.

• Rich Text – Transfere texto formatado (ValueHtml) para preservar o layout e a estilização.

• Weighted Options – Remove qualquer prefixo numérico (ex.: "10 - High") e mantém apenas o rótulo ("High").

Qualquer propriedade personalizada não listada explicitamente acima ainda é transferida para o novo projeto como uma propriedade personalizada do projeto.
Isso garante que mesmo campos novos ou específicos do cliente permaneçam disponíveis em Prop.<Key> no registro do projeto.

Se alguma propriedade não puder ser convertida (por exemplo, uma referência de usuário inválida), o Fluid registra o problema no console de tarefas e nos logs do sistema.
As propriedades restantes continuam sendo processadas — garantindo que um valor inválido nunca interrompa a criação do projeto.

• Show Project Pipeline – Habilita a criação de projetos baseada em pipeline.

• Show Project Templates – Necessário se você deseja obter informações de template ou metodologia a partir de propriedades personalizadas de ação.

Ao projetar quadros de pipeline:

• Use nomes de propriedades consistentes entre ações e projetos.

• Certifique-se de que as listas suspensas correspondam aos catálogos de projetos configurados (ex.: tipos, portfólios).

• Habilite as funcionalidades Show Project Pipeline e Show Project Templates.

• Revise regularmente seus mapeamentos para alinhá-los com novas configurações ou convenções de nomenclatura.

Seguindo essas diretrizes, seus pipelines criarão projetos de forma integrada — com mapeamento preciso de dados e rastreabilidade completa a partir da ação original.