Criação de Projetos e Sincronização de Cartões com Projetos

Pipeline de Processo – Sincronização de Propriedades com Projetos

Dan Justin 16 de ago de 2026

Quando um Process Board é configurado como um Project Pipeline, as propriedades personalizadas definidas nos itens de processo (cartões/tarefas) podem fluir automaticamente para o projeto vinculado. Essa sincronização abrange tanto as propriedades personalizadas (estendidas) quanto as propriedades de projeto de primeira classe (campos integrados como Portfolio, Tier e Owner).

Este artigo explica quando e como a sincronização ocorre, quais campos do projeto ela afeta e como nomear as propriedades personalizadas dos itens de processo para que sejam mapeadas corretamente para os campos de projeto de primeira classe.

Quando a Sincronização Ocorre?

A sincronização de propriedades ocorre em dois cenários:

1. Criação de Projeto (Pipeline Create)

Quando um cartão é movido para uma coluna configurada com o modo Create Project, o sistema:

Cria um novo projeto a partir do cartão.
Copia as propriedades personalizadas correspondentes do cartão para as propriedades personalizadas do novo projeto.
Copia as propriedades personalizadas correspondentes para os campos de primeira classe do projeto (ex.: Portfolio, Tier, Owner).
Calcula as datas de início/término do projeto a partir das propriedades personalizadas Start Date e End Date do cartão.
Copia os documentos anexados ao cartão para o novo projeto.

2. Sincronização Contínua (Pipeline Sync)

Quando um cartão é movido para (ou atualizado dentro de) uma coluna configurada com o modo Create ou Sync, e já existe um projeto vinculado, o sistema:

Mescla as propriedades personalizadas do cartão nas propriedades personalizadas do projeto (atualizando os valores que foram alterados).
Copia as propriedades personalizadas correspondentes para os campos de primeira classe do projeto.
Copia os documentos do cartão para o projeto.
Publica uma mensagem de notificação listando quais propriedades foram alteradas.

Nota: A sincronização é executada como um processo em segundo plano. As alterações são atribuídas ao usuário que moveu o cartão.

Como Funciona a Correspondência de Propriedades

Sincronização de Propriedades Personalizadas (Estendidas)

As propriedades personalizadas são correspondidas por nome de Chave ou Rótulo entre o item de processo e as definições de propriedades personalizadas do projeto. Se um item de processo tiver uma propriedade personalizada com a mesma chave ou rótulo que uma propriedade personalizada do projeto, o valor é copiado. A correspondência não diferencia maiúsculas de minúsculas.

Sincronização de Propriedades de Primeira Classe

Além da sincronização de propriedades personalizadas, o sistema inspeciona cada propriedade personalizada do item de processo e verifica se sua Chave ou Rótulo corresponde a um campo de projeto de primeira classe conhecido. A correspondência é:

Sem distinção de maiúsculas/minúsculas – "Portfolio", "portfolio" e "PORTFOLIO" são todos correspondentes.
Sem distinção de espaços em branco – "Start Date", "StartDate" e "start date" são todos correspondentes (os espaços são removidos antes da comparação).
Verificada tanto na Chave quanto no Rótulo da propriedade – qualquer um pode corresponder.
Consciente de alterações – durante a sincronização contínua, apenas as propriedades cujos valores diferem dos valores atuais do projeto são reportadas como alteradas.

Suporte a Opções em Cascata

Se uma propriedade personalizada for uma Opção em Cascata, cada nível da cascata é avaliado de forma independente. A Chave e o Rótulo de cada nível da cascata são comparados com os nomes de propriedades de primeira classe listados abaixo. Isso permite que uma única propriedade de opção em cascata (ex.: uma cascata de "Hierarquia Organizacional") defina o Portfolio no nível 1, o Sub-Portfolio no nível 2 e o Driver no nível 3, por exemplo.

Referência de Propriedades de Primeira Classe

As tabelas abaixo listam todos os campos de projeto de primeira classe que o mecanismo de sincronização pode definir, agrupados por tipo de dado. Para habilitar o mapeamento automático, nomeie a Chave ou o Rótulo da propriedade personalizada do item de processo para corresponder ao valor mostrado na coluna Chave / Rótulo de Propriedade a Corresponder.

Propriedades de Texto / Opção / Texto Rico / Opção com Valor

Chave de Propriedade a Corresponder	Notas
`Discretionary`	O valor deve corresponder a uma das opções discricionárias configuradas.
Nome do campo Tier ¹	O valor deve corresponder a um tier configurado.
`Project Type`	O valor deve corresponder a um tipo de projeto configurado.
`Project Category`	O valor deve corresponder a uma categoria de projeto configurada.
`Funding Source`	O valor deve corresponder a uma fonte de financiamento configurada.
`Methodology`	O valor deve corresponder a uma metodologia configurada. Também limpa qualquer template previamente atribuído.
`Template`	O valor deve corresponder ao nome de um template de projeto configurado. Também limpa qualquer metodologia previamente atribuída. Requer que o recurso Project Templates esteja habilitado.
`Requirements`	Texto livre.
`Description`	Texto livre. Se o projeto já tiver uma descrição, o novo valor é acrescentado (separado por uma linha em branco), não substituído.
Nome do campo Cost Centre ¹	O valor deve corresponder a um código de centro de custo configurado. O valor de exibição (código + nome) é armazenado no projeto.
Nome do campo Proposed Solution ¹	Texto livre.
Nome do campo External Reference ¹	Texto livre.
Nome do campo Secondary External Reference ¹	Texto livre.
Nome do campo Portfolio ¹	O valor deve corresponder ao nome de um portfolio configurado.
Nome do campo Sub-Portfolio ¹	O valor deve corresponder ao nome de um sub-portfolio configurado.
Nome do campo Business Driver ¹	O valor deve corresponder a um driver configurado.

Propriedades de Data

Chave / Rótulo de Propriedade a Corresponder	Notas
`Implementation Date`	Valor de data.
`Start Date`	Usado somente durante a criação do projeto (por meio da lógica de cálculo de datas, não pela sincronização de primeira classe).
`End Date`	Usado somente durante a criação do projeto (por meio da lógica de cálculo de datas, não pela sincronização de primeira classe).

Propriedades Numéricas

Chave de Propriedade / Rótulo para Correspondência	Observações
`Amortization Period`	Valor numérico (inteiro).

Propriedades Sim/Não

Chave de Propriedade / Rótulo para Correspondência	Observações
`Cap Eligible`	Booleano – defina o valor como `true` ou `false`.

Propriedades de Seletor de Projeto

Chave de Propriedade / Rótulo para Correspondência	Observações
`Reporting Program`	Deve referenciar um projeto/programa válido por ID.

Propriedades de Pessoa

Chave de Propriedade / Rótulo para Correspondência	Observações
Nome do campo Proprietário ¹	Adiciona a pessoa à lista de proprietários do projeto. Duplicatas são ignoradas.
Nome do campo GP Principal ¹	Adiciona a pessoa à lista de GPs do projeto. Duplicatas são ignoradas.
Nome do campo Editores ¹	Adiciona a pessoa à lista de editores do projeto. Duplicatas são ignoradas.
Nome do campo Responsável de Negócio ¹	Adiciona a pessoa à lista de responsáveis de negócio do projeto. Duplicatas são ignoradas.
Nome do campo Executivo ¹	Adiciona a pessoa à lista de executivos do projeto. Duplicatas são ignoradas.

¹ Nomes de campos configuráveis – Esses rótulos são definidos na configuração de Admin > Configuração do seu espaço de trabalho. A tabela abaixo mostra os padrões típicos. Verifique a configuração do seu espaço de trabalho para os valores reais.

Valores Padrão Típicos de Nome de Campo

Configuração	Padrão Típico
Nome do campo Nível	`Tier`
Nome do campo Centro de Custo	`Cost Center`
Nome do campo Solução Proposta	`Proposed Solution`
Nome do campo Referência Externa	`External Reference`
Nome do campo Referência Externa Secundária	`Secondary Reference`
Nome do campo Portfólio	`Portfolio`
Nome do campo Sub-Portfólio	`Sub-Portfolio`
Nome do campo Direcionador de Negócio	`Driver`
Nome do campo Proprietário	`Owner`
Nome do campo GP Principal	`Project Manager`
Nome do campo Editores	`Editor`
Nome do campo Responsável de Negócio	`Business Owner`
Nome do campo Executivo	`Executive`

Notificações de Alteração

Quando uma sincronização contínua detecta que uma ou mais propriedades foram alteradas, uma mensagem de notificação é publicada no canal do projeto e no canal do cartão. A mensagem inclui:

O nome do cartão de origem.
Uma lista com todos os nomes de propriedades que foram alteradas (tanto propriedades personalizadas quanto propriedades de primeira classe).
O usuário que acionou a sincronização.
Um link para abrir o cartão e um link para abrir o projeto.

Se documentos também foram copiados, uma notificação separada lista os nomes dos arquivos copiados.

Observações Importantes Sobre o Processo de Sincronização

Data de Início e Data de Término são tratadas separadamente durante a criação do projeto por meio de uma lógica dedicada de cálculo de datas (não por meio da sincronização de propriedades de primeira classe). Elas não são substituídas durante a sincronização contínua por esse mecanismo.
A descrição é acrescentada, não substituída – se o projeto já tiver uma descrição, o valor sincronizado é acrescentado após uma linha em branco. Todos os outros campos de texto são substituídos.
Propriedades somente leitura no item de processo (modo de visibilidade definido como "Somente Leitura para Todos") são excluídas da sincronização.
A validação é aplicada – a sincronização só definirá um campo de primeira classe se o valor existir nas opções configuradas do espaço de trabalho (por exemplo, um valor de Nível deve corresponder a um nível configurado). Valores inválidos são ignorados silenciosamente.
Propriedades de pessoa devem conter um ID de usuário válido. O sistema localiza o usuário e o adiciona à lista de funções apropriada no projeto. Se o usuário já estiver atribuído a essa função, ele não será adicionado novamente.
Nomeie a Chave ou o Rótulo da sua propriedade personalizada para corresponder aos valores nas tabelas de referência acima. A correspondência não diferencia maiúsculas de minúsculas e ignora espaços, portanto "ExternalReference", "External Reference" e "external reference" funcionam da mesma forma.
Use Opções em Cascata para mapear vários campos de primeira classe a partir de uma única propriedade. Por exemplo, uma opção em cascata com níveis nomeados Portfolio, Sub-Portfolio e Driver definirá os três campos do projeto a partir de uma única propriedade do cartão.