Guía de asignación de propiedades personalizadas del pipeline de proyectos

Cuando una tarea del pipeline pasa a una etapa configurada para crear un proyecto, Fluid crea automáticamente el nuevo proyecto copiando los detalles de la acción de origen.
Esta guía explica cómo el sistema asigna las propiedades personalizadas de la acción a los campos del proyecto, y cómo garantizar que sus tableros de pipeline estén configurados para una transferencia de datos precisa y consistente.

1. Disponibilidad de la función – La creación de proyectos a través del pipeline solo está disponible cuando el indicador de función Show Project Pipeline está habilitado y el usuario tiene acceso de nivel Editor en el tablero de la acción.

2. Creación de la plantilla del proyecto – Cuando una tarea del pipeline activa la creación de un proyecto, Fluid convierte la acción en un modelo de configuración de proyecto mediante

3. Copia de propiedades personalizadas – Fluid copia las propiedades personalizadas en dos pasadas:

   • Campos mapeados: Las propiedades conocidas (por ejemplo, fechas, metodología, propietarios) se promueven a campos del proyecto.

   • Todas las demás propiedades: Garantiza que cualquier propiedad restante de la acción también se transfiera, para que no se pierda ningún dato.

4. Creación final del proyecto – El proyecto se crea y se guarda en el sistema. Se registra un enlace de referencia entre la acción de origen y el nuevo proyecto en Action.PipelineGuid.

Fluid reconoce y promueve automáticamente ciertas propiedades personalizadas a campos de proyecto de primer nivel. Estas se detectan por el nombre de la clave o la etiqueta visible (sin distinguir mayúsculas de minúsculas).

A continuación se muestran las asignaciones actualmente admitidas.

Valores predeterminados de fecha:

• Sin fecha de inicio ni de fin → inicio = hoy, fin = en blanco

• Solo fecha de fin (futura) → inicio = hoy

• Solo fecha de fin (pasada) → inicio = fin

• Solo fecha de inicio → fin queda en blanco

• Fin antes que inicio → fin queda en blanco

Los campos de texto y las listas desplegables solo se transfieren si contienen valores válidos o reconocidos.

Los campos de persona se vinculan mediante el ID de usuario. Cuando es válido, el usuario se agrega automáticamente a la función de equipo correspondiente en el nuevo proyecto.

• Rich Text – Transfiere el texto con formato (ValueHtml) para conservar el diseño y el estilo.

• Weighted Options – Elimina cualquier prefijo numérico (por ejemplo, “10 - High”) y conserva solo la etiqueta (“High”).

Cualquier propiedad personalizada que no aparezca explícitamente en la lista anterior igualmente se transfiere al nuevo proyecto como una propiedad personalizada del proyecto.
Esto garantiza que incluso los campos nuevos o específicos del cliente sigan estando disponibles bajo Prop.<Key> en el registro del proyecto.

Si alguna propiedad no se puede convertir (por ejemplo, una referencia de usuario no válida), Fluid registra el problema en la consola de trabajos y en los registros del sistema.
Las propiedades restantes continúan procesándose, lo que garantiza que un valor incorrecto nunca detenga la creación del proyecto.

• Show Project Pipeline – Habilita la creación de proyectos basada en pipeline.

• Show Project Templates – Es necesario si desea extraer información de plantilla o metodología desde las propiedades personalizadas de la acción.

Al diseñar tableros de pipeline:

• Use nombres de propiedad coherentes entre acciones y proyectos.

• Asegúrese de que las listas desplegables coincidan con los catálogos de proyecto configurados (por ejemplo, tipos, portafolios).

• Habilite las funciones Show Project Pipeline y Show Project Templates.

• Revise periódicamente sus asignaciones para alinearlas con nuevas configuraciones o convenciones de nomenclatura.

Si sigue estas pautas, sus pipelines crearán proyectos sin inconvenientes — con una asignación de datos precisa y una trazabilidad completa desde la acción original.