Inspeccionar la tabla fuente
Comience con una tabla CSV cuyo encabezado sea id,nombre,activo y cuyas dos filas sean 001,Ada,true y 002,Bo,false. La herramienta integrada de CSV a JSON convierte cada fila de datos en un objeto codificado por el encabezado. Esto es útil para ver la estructura, pero no asuma que ha decidido lo que significan los campos. Un identificador como 001 a menudo debería permanecer en texto; al obligarlo a usar el número 1 se pierden los ceros iniciales. La palabra verdadero puede ser un valor booleano en un esquema de destino o el texto literal que ingresó un usuario. Escriba esos tipos de campos antes de importar.
Verifique la gramática CSV antes que los tipos
Los campos CSV pueden contener comas, comillas y saltos de línea cuando se citan según el dialecto utilizado. Una división ingenua en cada coma puede cambiar las columnas y hacer que una dirección o título válido parezca dos campos. RFC 4180 describe un formato común, pero las exportaciones reales varían en cuanto a delimitador, manejo de comillas, presencia de encabezado y codificación de caracteres. Si una hoja de cálculo utiliza punto y coma o tabulaciones, seleccione o transforme ese formato deliberadamente en lugar de enviarlo a un analizador de solo comas. Verifique que cada fila tenga la cantidad esperada de campos y que los nombres de los encabezados sean únicos.
- Cabecera CSV y dos filas
- Matriz JSON con dos objetos
- API: comprobar id, active y celdas vacías
Elige la forma receptora
Una matriz JSON mantiene juntos los dos objetos de fila y es conveniente para una solicitud por lotes pequeños. JSON Lines coloca un valor JSON completo en cada línea y puede adaptarse a una secuencia o a un sistema que procese registros de forma independiente. Una cadena de consulta URL suele ser un conjunto de parámetros cortos, no un transporte para tablas de hojas de cálculo arbitrarias. La API de destino decide qué forma es válida. La herramienta JSON-array-to-lines cambia el marco sin inventar un esquema, y la conversión debe preservar los dos objetos si cada línea es JSON válida.
Resolver valores faltantes y especiales
Una celda CSV vacía puede significar una cadena vacía, un valor desconocido o ningún valor; esos no son equivalentes en todas las API. Una celda activa en blanco no debería volverse falsa automáticamente. Los números con una coma decimal, las fechas escritas sin zona horaria y los identificadores con ceros a la izquierda necesitan un manejo explícito antes de la importación. Utilice una fila de prueba que contenga una coma entre comillas, una celda en blanco y un carácter que no sea ASCII para ver qué conserva el convertidor. Verifique los campos obligatorios documentados de la API y rechace las filas que no se puedan representar fielmente en lugar de adivinar en silencio.
Validar el viaje de ida y vuelta y el destino.
Después de la conversión, inspeccione el JSON en busca de dos objetos, tres claves esperadas y valores con los tipos previstos. Convierta una copia nuevamente a CSV para notar cambios en las citas o el orden de los campos; una tabla visualmente similar no garantiza bytes de origen idénticos. Envíe solo un pequeño lote de prueba a una API real cuando su esquema y autorización estén listos. Las herramientas MultiVerto se ejecutan en su navegador y ayudan a examinar la representación, pero no pueden verificar un contrato API remoto ni autorizar una importación. Conserve la exportación original y una asignación escrita de cada columna a cada campo de destino para una auditoría posterior.