En KF nada es un callejón sin salida. Todo lo que entra vuelve a salir en un formato que otra cosa puede leer, y los formatos que la gente ya tiene — hojas de cálculo, listas de materiales — entran sin volver a teclearlos.
Tres formatos, elegidos por la extensión del fichero:
| Extensión | Qué es |
|---|---|
.csv | Una exportación de hoja de cálculo. La forma habitual de traer una BOM o una lista de requisitos |
.xlsx | Un libro de Excel, leído directamente |
.tgz / .gz | Un paquete KF — ítems y sus adjuntos, tal como los produce Export all |
Solo title es obligatoria. Todo lo demás es opcional, y cualquier columna que KF
no reconozca se conserva como atributo declarado en lugar de descartarse.
| Columna | Se convierte en | |
|---|---|---|
title | El título del ítem | |
code | Su código (x0), la clave duradera. Un código existente actualiza ese ítem en vez de crear uno nuevo | |
class | m objeto, a acción, e evento, i documento | |
tags | Etiquetas separadas por espacios, incluidas las de estado como done | |
type | Uno o varios códigos, separados por espacio, coma o ` | `. Cada uno crea un enlace de tipo |
doc | El cuerpo en Markdown | |
| cualquier otra | Un atributo declarado, accesible por la API y visible en el ítem |
Esa regla de code es la útil: exportar una BOM, editarla en una hoja de cálculo y
volver a importarla actualiza en lugar de duplicar.
Un CSV es plano y una BOM no lo es. Dos marcadores lo resuelven:
> desciende — las filas siguientes cuelgan de la fila recién creada< sube un nivelAsí, un conjunto anidado se importa desde una sola hoja, en el orden en que una persona lo escribiría de forma natural.
| Formato | Qué se obtiene |
|---|---|
| CSV | La tabla AMFE; el registro de cumplimiento; cualquier listado |
| XLSX | La tabla AMFE; el registro de cumplimiento |
| JSON | Un subárbol completo — {root, items[], links[]} |
| OGDL | El mismo subárbol en el formato propio de KF |
| Paquete TGZ | Ítems y sus adjuntos, para mover un cuerpo de trabajo entre instancias |
| SVG | Árbol de fallos, árbol de componentes, árbol de tipos, Gantt |
| XML de MS Project | El Gantt, como fichero schemas.microsoft.com/project auténtico |
| iCalendar | Tareas como eventos de calendario (RFC 5545) |
| A través de las vistas de impresión — A4 vertical, A4 apaisado, diapositivas, documentación |
Toda exportación CSV y XLSX lleva una cabecera de procedencia: qué base de datos, qué compilación, qué filtro la produjo y cuándo. Una hoja de cálculo reenviada dos veces y renombrada una todavía puede decir de dónde vino.
Dos casos aparecen constantemente.
Ida y vuelta de una BOM. Exporte el árbol de componentes en CSV, trabájelo en la herramienta en la que se lo envió su proveedor, vuelva a importarlo. Los códigos hacen que sea una actualización.
Entregar evidencia. Un auditor quiere el registro en su propio expediente, ordenado
a su manera. Register CSV se lo da, con la cabecera de procedencia adjunta, de modo
que lo que examinó sea demostrable meses después y no solo durante la reunión. Véase
auditoría.