Logo de Think²Think²
Entrar

Guías

CSV o JSON: conserva el significado al entregar datos

Que un archivo se abra no demuestra que se haya leído bien. Un separador incorrecto puede convertir todas las columnas en una; una importación con tipos inferidos puede cambiar 0012 por 12. Acuerda el contrato antes de pedir al colaborador que use los datos.

Lista de espera; no garantiza acceso inmediato ni plan gratuito.

Situaciones para revisar

Una tabla plana contiene identificadores con ceros iniciales y campos vacíos.

Declara ID como texto y el significado de cada vacío. En JSON, usa una cadena como "0012" y distingue "", null y campo ausente. En CSV, acuerda el significado del campo vacío y comprueba cómo importa los tipos el receptor.

El formato no decide por sí solo si falta información o si el valor es una cadena vacía. Se conserva la convención en vez de inferir que el cliente no tiene ese dato.

Una nota incluye comas, comillas o saltos de línea.

En CSV aplica delimitación y escape adecuados: un campo con coma se entrecomilla y una comilla interna se duplica. JSON tiene sus propias reglas de escape. Comprueba encabezados, número de columnas y valores después de parsear, no solo por vista previa.

No se fragmenta una nota en columnas nuevas. Las comillas CSV permiten representar una coma dentro de un campo, pero no protegen universalmente frente a fórmulas al abrir el archivo en una hoja de cálculo.

Un registro contiene listas de productos, booleanos y datos anidados.

Valora JSON para conservar objetos, arrays y tipos; CSV puede ser conveniente para una tabla plana si se acuerda cómo representar relaciones. No conviertas estructuras automáticamente sin un contrato y comprobación.

La elección responde a quien recibe y valida los datos, no a que un formato sea siempre superior. El contenido se trata como datos, nunca como código o instrucciones.

Cómo evaluar el trabajo

  1. Define un diccionario: campo, tipo, obligatoriedad, significado de vacío/null/ausencia y estructura. JSON distingue esos valores sintácticamente, pero su significado de negocio requiere acuerdo. CSV no define un null universal.
  2. Declara separador, encabezado, codificación y reglas de escape. RFC4180 describe CSV con comas y reconoce diferencias entre implementaciones; no todos los archivos llamados CSV usan el mismo delimitador. Acuerda UTF-8 y confirma el receptor. RFC8259 exige UTF-8 en JSON intercambiado entre sistemas abiertos.
  3. Ensaya con datos ficticios en un entorno aislado y compara la estructura parseada con lo esperado. Una hoja puede inferir tipos o interpretar fórmulas al abrir CSV: no ejecutes contenido y valida la protección para la aplicación concreta, sin prometer una mitigación universal. En Think², los grupos/contexto, modelos compatibles y herramientas autorizadas, junto con el computador que puede tener cada colaborador, permiten organizar el trabajo; no acreditan por sí solos una importación o integración particular. Las acciones externas requieren aprobación.
  4. Plantilla de intercambio: formato/codificación/separador/tipos/vacíos/receptor/comprobaciones. Ejemplo ficticio CSV con coma: id,alias,nota 0012,,"Entrega, revisar" JSON equivalente: [{"id":"0012","alias":"","nota":"Entrega, revisar"}] En un ensayo local con csv.DictReader y json.loads, los registros resultantes son iguales bajo este contrato: id es el texto «0012», alias es cadena vacía y nota contiene una coma. El ensayo con separador incorrecto no produce la estructura esperada. No demuestra cómo se comportará cualquier importador ni es una integración Think². El valor de nota se trató como dato y no se ejecutó como código.

Preguntas frecuentes

¿CSV siempre usa punto y coma o siempre usa coma?

No lo deduzcas de la extensión. RFC4180 describe comas, pero hay otros dialectos. Declara el delimitador y verifica columnas y valores con el receptor.

¿Un campo CSV vacío equivale a null?

No universalmente. Define la convención. JSON permite null y cadena vacía por separado, además de ausencia del campo; esa distinción sintáctica no decide su significado de negocio.

¿Entrecomillar CSV evita fórmulas y conserva todos los tipos?

No. Las comillas delimitan campos y escapes, pero una hoja puede inferir tipos e interpretar fórmulas. Importa identificadores como texto y valida el manejo de contenido no confiable para la aplicación concreta.

Fuentes y alcance

  • RFC4180 — CSV — RFC informativo sobre CSV con comas, escape, encabezado y MIME; no un único dialecto universal.
  • RFC8259 — JSON — Sintaxis, tipos y UTF-8 en intercambios entre sistemas abiertos; no semántica de negocio de null.
  • OWASP — CSV Injection — Riesgos de interpretar celdas como fórmulas y límites de mitigaciones; no prueba de protección de una aplicación concreta.

Sigue explorando

Lista de espera; no garantiza acceso inmediato ni plan gratuito.