Este artículo describe cómo formatear datos en un archivo Excel o CSV para importarlos para agregar o actualizar registros en forma masiva en una aplicación.

Para su referencia, este artículo también proporciona un archivo de muestra que muestra el formato adecuado para cada tipo de campo. Para comprobar el formato adecuado para cada tipo de campo, consulte la siguiente sección y descargue el archivo de muestra.
Archivo de muestra con el formato adecuado para cada tipo de campo

Se recomienda usar nombres de campo para los nombres de columna (la primera fila) en el archivo para la importación. El archivo se puede importar incluso si no se especifican nombres de campo; sin embargo, en ese caso, se requerirá asignar manualmente la correspondencia entre las columnas del archivo y los campos de la aplicación al importarlo. Especificar los nombres de campo en la primera fila del archivo es beneficioso, ya que, al hacerlo, Kintone asignará automáticamente la correspondencia entre columnas y campos.

Si bien es posible ingresar manualmente los nombres de los campos en la primera fila de un archivo usted mismo, se recomienda que use la opción de menú "Exportar a archivo" en la pantalla "Vista" de la aplicación para exportar los datos de la aplicación a un archivo. Al hacer esto, se exportarán los nombres de campo de la aplicación a un archivo, independientemente de si hay registros registrados en la aplicación. Esto es más fácil que ingresar directamente los nombres de los campos en su archivo, y también puede evitar errores de entrada. Por este motivo, se recomienda exportar primero los datos de la aplicación a un archivo y usar el archivo exportado como base para editar datos.
Exportación de datos a un archivo

En su archivo para importar, cada registro debe almacenarse en una sola fila.

Sin embargo, si los registros contienen una tabla, utilice tantas filas como haya en la tabla para ingresar los datos de cada registro. Para obtener más detalles, consulte la página siguiente.
Preparación de un archivo para agregar/actualizar registros con tablas

Cada tipo de campo tiene requisitos de formato específicos que deben cumplirse para que los datos de un archivo se importen a los campos de una aplicación. Haciendo referencia a la información proporcionada a continuación, especifique los datos en su archivo de acuerdo con el formato requerido por cada tipo de campo.

• Ingrese el texto que desea importar en el campo.
• Si desea importar texto de varias líneas en un campo Área de texto, ingrese varias líneas de texto en su archivo usando saltos de línea.

Introduzca valores numéricos en cualquiera de los siguientes formatos:

• Entero
• Decimal
• Numero negativo
  Ejemplo: "-1,23"
• Número exponencial
  Ejemplo: "1.20E+03" en el archivo está registrado como "1200" en la aplicación.

Introduzca datos para el campo en Formato HTML.

• Utilice columnas separadas para cada opción e ingrese "Nombre del campo [Nombre de Opción]" en la primera fila de cada columna.
  Ejemplo: Si la aplicación tiene un campo "Viajado por" con las opciones "Tren" y "Autobús", "Viajado por [Tren]" y "Viajado por [Autobús]" deben ingresarse en la primera fila de las columnas correspondientes.
• Introduzca "1" en la celda de la opción que se va a seleccionar. La celda de la opción que no se va a seleccionar debe dejarse vacía.

Utilice una columna por campo e ingrese el nombre de la opción que se seleccionará.

• Si su archivo para importar es un archivo de Excel, los datos para este tipo de campo se pueden ingresar en cualquier formato de fecha que se reconozca como fecha en Excel.
• Si su archivo para importar es un archivo CSV, ingrese datos para este tipo de campo en cualquiera de los siguientes formatos:
  • AAAA-MM-DD (Ejemplo: 2022-4-1)
  • AAAA/MM/DD (Ejemplo: 1/4/2022)
  • AAAAMMDD (Ejemplo: 20220401)
  • AA/MM/DD (Ejemplo: 22/4/1)
  • MM/DD/AAAA (Ejemplo: 01/04/2022)
  • DD/MM/AA (Ejemplo: 1/4/22)
  • DD/MM/AAAA (Ejemplo: 04/01/2022)
  • DD/MM/AA (Ejemplo: 4/1/22)
• meses y días de un solo dígito se pueden ingresar en formato de uno o dos dígitos. Por ejemplo, puede ingresar "4" o "04" para indicar abril.
  Sin embargo, al introducir valores en formato "AAAAMMDD" en archivos CSV, utilice el formato de dos dígitos. Por ejemplo, introduzca "04" para indicar abril.
• Puede ingresar fechas entre las 00:00 (UTC) del 1 de enero de 1000 y las 23:59 (UTC) del 31 de diciembre de 9999.
• Si se omite la parte del día, se supone que se especifica 1 como el día.
  Ejemplo: "2022/01" se convierte en "2022/01/01" cuando el archivo se importa a la aplicación.
• Si se omiten el mes y el día, se supone que se especifica el 1 de enero como mes y día.
  Ejemplo: "2022" se convierte en "2022/01/01" cuando el archivo se importa a la aplicación.

• Si su archivo para importar es un archivo de Excel, los datos para este tipo de campo se pueden ingresar en cualquier formato de hora que se reconozca como hora en Excel.
• Si su archivo para importar es un archivo CSV, ingrese datos para este tipo de campo en cualquiera de los siguientes formatos:
  • HH:MM AM/PM
    Ejemplo: "23:02"
  • HH:MM
    Ejemplo: "23:02"
• horas y los minutos de un solo dígito se pueden introducir en formato de uno o dos dígitos. Por ejemplo, puede introducir "8" o "08" para indicar las ocho en punto.
• La parte de los segundos no se importará incluso si está incluida en los datos.
  Ejemplo: "11:01:25" se convierte en "11:01".
• Si se omite la parte de los minutos, se supone que se especifica 0 como minutos.
  Ejemplo: "11" se convierte en "11:00".

Al ingresar datos de los campos Fecha y hora en un archivo, asegúrese de tener en cuenta lo siguiente.

• La parte de segundos no se importará, aunque esté incluida en los datos.
• Si se omite la parte de la hora, se asumirá que se especifica 00:00 como la hora.
  Ejemplo: "2022/01/11" se convierte en "2022/01/11 00:00" cuando el archivo se importa a la aplicación.

Si su archivo para importar es un archivo de Excel, los datos para este tipo de campo se pueden ingresar en cualquier formato de fecha y hora que se reconozca como fecha y hora en Excel.

En el caso de los archivos CSV, la fecha va seguida de la hora, separada por un espacio.
Ejemplo: "2022/01/11 11:01"

Introduzca los datos en uno de los siguientes formatos:

• AAAA-MM-DD HH24:NN (Ejemplo: "2022-12-20 23:20")
• AAAA-MM-DDTHH24:NN (Ejemplo: "2022-12-20T23:20")
• AAAA-MM-DDTHH24:NNZ (Ejemplo: "2022-12-20T23:20Z")
• AAAAMMDDHH24NN (Ejemplo: "202212202320")
• AAAA/MM/DD HH12:NN AM/PM (Ejemplo: "2022/12/20 11:20 PM")
• AAAA/MM/DD HH24:NN (Ejemplo: "2022/12/20 23:20")
• MM/DD/AAAA HH12:NN AM/PM (Ejemplo: "20/12/2022 23:20")
• MM/DD/AAAA HH24:NN (Ejemplo: "20/12/2022 23:20")
• DD/MM/AAAA HH12:NN AM/PM (Ejemplo: "20/12/2022 11:20 PM")
• DD/MM/AAAA HH24:NN (Ejemplo: "20/12/2022 23:20")

El manejo de zonas horarias durante la importación de archivos varía dependiendo de si los datos en el campo Fecha y hora de su archivo CSV, TXT o TSV incluyen información de zona horaria.

• Al utilizar la nueva pantalla de importación de archivos:
  Los valores de fecha y hora se registran utilizando la zona horaria especificada en el archivo.
• Al utilizar la pantalla de importación de archivos clásica:
  Los valores de fecha y hora se registran utilizando la zona horaria especificada en el archivo.
  Si bien puede establecer una zona horaria en la pantalla Importar desde arch., esta configuración se ignorará.

• Al utilizar la nueva pantalla de importación de archivos:
  Los valores de fecha y hora se registran según la zona horaria establecida en el perfil del usuario importador.
• Al utilizar la pantalla de importación de archivos clásica:
  Los valores de fecha y hora se registran utilizando la zona horaria especificada en la pantalla Importar desde arch..

• Introduzca una URL que comience con "http://" o "https://".
• La URL puede contener los siguientes caracteres:
  • Caracteres alfabéticos (mayúsculas y minúsculas)
  • números arábigos
  • Los siguientes caracteres especiales:
    -_.!~*'():@&=+$,;?/#%
    Es posible que algunos caracteres especiales no se puedan utilizar en determinadas partes de la URL.

• Introduzca un número de teléfono.
• Los números de teléfono se pueden ingresar con o sin guiones.

• Introduzca una dirección de correo electrónico con el siguiente formato: "local-part@domain".
• La parte local puede contener los siguientes caracteres:
  • Caracteres alfabéticos (mayúsculas y minúsculas)
  • números arábigos
  • Los siguientes caracteres especiales:
    .!#$'%&*+/=?^_-`{}|~
• El dominio puede contener los siguientes caracteres:
  • Caracteres alfabéticos (mayúsculas y minúsculas)
  • números arábigos
  • Los siguientes caracteres especiales:
    .-

• Ingrese el nombre de inicio de sesión del usuario que se seleccionará.

• Si desea que se seleccionen varios usuarios en el campo, ingrese sus nombres de inicio de sesión con saltos de línea entre cada nombre de inicio de sesión.
  • Si está editando su archivo para importarlo usando Excel u otro software de hoja de cálculo, ingrese los nombres de inicio de sesión de los usuarios en una sola celda y sepárelos usando saltos de línea.
  • Si está editando su archivo CSV para importarlo usando un editor de texto, ingrese los nombres de inicio de sesión de los usuarios como un valor único (campo) en el archivo y sepárelos usando saltos de línea.
    
• Si desea registrar un usuario invitado, ingrese "guest/" al comienzo de la dirección de correo electrónico del usuario invitado (nombre de inicio de sesión).

• Ingrese el código de departamento del departamento a seleccionar.

• Si desea seleccionar varios departamentos en el campo, ingrese sus códigos de departamento con saltos de línea entre cada código de departamento.

  • Si está editando su archivo usando Excel u otro software de hoja de cálculo, ingrese los códigos de departamento en una sola celda y sepárelos usando saltos de línea.
  • Si está editando su archivo CSV para importarlo usando un editor de texto, ingrese los códigos de departamento como un valor único (campo) en el archivo y sepárelos usando saltos de línea.

• Ingrese el código de grupo del grupo a seleccionar.

• Si desea seleccionar varios grupos en el campo, ingrese sus códigos de grupo con saltos de línea entre cada código de grupo.

  • Si está editando su archivo usando Excel u otro software de hoja de cálculo, ingrese los códigos de grupo en una sola celda y sepárelos usando saltos de línea.
  • Si está editando su archivo CSV para importarlo usando un editor de texto, ingrese los códigos de grupo como un valor único (campo) en el archivo y sepárelos usando saltos de línea.

• Introduzca los valores del campo que está configurado como campo Clave en la configuración del campo Búsqueda en la aplicación.
  Ejemplo: si desea importar valores a un campo llamado "Nombre del empleado" que tiene un campo de una aplicación diferente llamado "Nombre" especificado como campo Clave en su configuración, ingrese valores del campo "Nombre" en su archivo para importar.
• Al importar el archivo, se recuperan los valores de los campos especificados en "Asignaciones de campos" en la configuración de campos de Búsqueda. Por lo tanto, no es necesario introducir los valores en el archivo.

• Al actualizar registros existentes mediante la importación de archivos:
  Si desea especificar números de registro en su Clave de actualización (anteriormente llamada Clave para la actualización masiva), ingrese los números de registro de los registros que desea actualizar en el archivo para importar.
• Al crear nuevos registros mediante la importación de archivos:
  No ingrese números de registro en la fila de registros nuevos que se agregarán.

Si sus números de registro contienen un código de aplicación, introdúzcalos sin él. (Por ejemplo, si un número de registro aparece como "kintone-1", introdúzcalo solo como "1"). Para obtener información sobre los códigos de aplicación, consulte la página siguiente.
Establecer un código de aplicación

• Introduzca el nombre de la categoría que desea especificar.
• Si desea especificar varias categorías, ingrese el nombre de cada categoría en una línea separada.
  • Si está editando su archivo usando Excel u otro software de hoja de cálculo, ingrese los nombres de las categorías en una sola celda y sepárelos usando saltos de línea.
  • Si está editando su archivo CSV para importarlo usando un editor de texto, ingrese los nombres de las categorías como un valor único (campo) en el archivo y sepárelos usando saltos de línea.

Utilice columnas separadas para cada campo dentro de la tabla. Utilice tantas filas como haya en la tabla para ingresar datos para los campos dentro de la tabla.

• Ingrese los datos en la primera columna de su archivo de la siguiente manera:
  • En la primera fila, ingrese "Nueva bandera de registro".
  • Introduzca un asterisco (*) en la fila donde comienzan los datos de cada registro y deje las demás filas en blanco. Los datos desde una fila con un asterisco (*) hasta la fila superior a la siguiente con un asterisco (\*) se consideran datos de un solo registro.
• En el escenario donde se actualizan datos de registros existentes, si desea agregar filas a una tabla existente en un registro, inserte filas en el archivo e ingrese en estas filas los datos que se registrarán en los campos de las nuevas filas de la tabla.
  Si las filas insertadas no son la primera fila del registro, deje la primera columna (la columna "Bandera de nuevo registro") en blanco.
• Cuando actualiza datos de tablas en registros existentes, su archivo para importar debe contener datos de todos los campos de la tabla, incluidos los datos de campos que no se deben actualizar. Como excepción, su archivo para importar no necesita contener datos de campos que se volverán a calcular o recuperar nuevamente.

Para un valor de campo Creado por o Actualizado por, ingrese un nombre de inicio de sesión de usuario.

Los campos Creado por y Actualizado por se manejan de manera diferente a otros campos durante la importación de archivos.

• Al actualizar registros existentes mediante la importación de archivos:
  Los valores de los campos Creado por y Actualizado por no se pueden actualizar con los valores del archivo. El resultado tras la importación es el siguiente:
  • Los valores Creado por no se actualizan. Se conservan los valores originales.
  • Los valores del campo Actualizado por" no se actualizan con los valores del archivo. En su lugar, este campo se actualiza automáticamente con el nombre del usuario que importó el archivo.
• Al crear nuevos registros mediante la importación de archivos:
  • Registros se actualizan con los valores del archivo.
  • Si se selecciona (Ninguno), los campos Creado por y Actualizado por se establecerán para el usuario que importó el archivo.

No puede especificar los siguientes valores y usuarios.

• Un valor distinto del nombre de inicio de sesión
• Múltiples usuarios
• Un usuario que no existe
• Un usuario inactivo o eliminado
• Un usuario que no utiliza Kintone
• Un usuario en el departamento para el cual no tiene permiso de visualización
• (Si la aplicación de destino de la importación del archivo pertenece a un espacio para invitados) Un usuario invitado que no es miembro del espacio para invitados

Los campos Fecha/hora creación y Fecha/hora de actualización se manejan de manera diferente a otros campos durante la importación de archivos.

• Al actualizar registros existentes mediante la importación de archivos:
  Los valores de los campos Fecha/hora creación y Fecha/hora de actualización no se pueden actualizar con los valores del archivo. El resultado tras la importación es el siguiente:
  • Los valores de los campos Fecha/hora creación no se actualizan. Se conservan los valores originales.
  • Los valores Fecha/hora de actualización no se actualizan. En su lugar, este campo se actualiza automáticamente con la fecha y hora de importación del archivo.
• Al crear nuevos registros mediante la importación de archivos:
  • Registros se actualizan con los valores del archivo.
  • Si se selecciona (Ninguno), los campos Fecha/hora creación y Fecha/hora de actualización se establecerán en la fecha y hora en que se importó el archivo.

Al ingresar datos de los campos Fecha/hora creación o Fecha/hora de actualización en un archivo, asegúrese de tener en cuenta lo siguiente.

• Introduzca la fecha y hora anterior a la fecha y hora en que se importó el archivo.
• La parte de segundos no se importará, aunque esté incluida en los datos.
• Si se omite la parte de la hora, se asumirá que se especifica 00:00 como la hora.
  Ejemplo: "2014/01/11" se convierte en "2014/01/11 00:00" cuando el archivo se importa a la aplicación.

Los datos de este tipo de campo se pueden ingresar en cualquier formato de fecha y hora que se reconozca como fecha y hora en Excel.

En el caso de los archivos CSV, la fecha va seguida de la hora, separada por un espacio.
Ejemplo: "2022/1/12 11:26"

Introduzca los datos en uno de los siguientes formatos:

• AAAA-MM-DD HH24:NN (Ejemplo: "2022-12-20 23:20")
• AAAA-MM-DDTHH24:NN (Ejemplo: "2022-12-20T23:20")
• AAAA-MM-DDTHH24:NNZ (Ejemplo: "2022-12-20T23:20Z")
• AAAAMMDDHH24NN (Ejemplo: "202212202320")
• AAAA/MM/DD HH12:NN AM/PM (Ejemplo: "2022/12/20 11:20 PM")
• AAAA/MM/DD HH24:NN (Ejemplo: "2022/12/20 23:20")
• MM/DD/AAAA HH12:NN AM/PM (Ejemplo: "20/12/2022 23:20")
• MM/DD/AAAA HH24:NN (Ejemplo: "20/12/2022 23:20")
• DD/MM/AAAA HH12:NN AM/PM (Ejemplo: "20/12/2022 11:20 PM")
• DD/MM/AAAA HH24:NN (Ejemplo: "20/12/2022 23:20")

El manejo de zonas horarias durante la importación de archivos varía dependiendo de si los datos en los campos Fecha/hora creación y Fecha/hora de actualización de su archivo CSV, TXT o TSV incluyen información de zona horaria.

• Al utilizar la nueva pantalla de importación de archivos:
  Los valores de fecha y hora se registran utilizando la zona horaria especificada en el archivo.
• Al utilizar la pantalla de importación de archivos clásica:
  Los valores de fecha y hora se registran utilizando la zona horaria especificada en el archivo.
  Si bien puede establecer una zona horaria en la pantalla Importar desde arch., esta configuración se ignorará.

• Al utilizar la nueva pantalla de importación de archivos:
  Los valores de fecha y hora se registran según la zona horaria establecida en el perfil del usuario importador.
• Al utilizar la pantalla de importación de archivos clásica:
  Los valores de fecha y hora se registran utilizando la zona horaria especificada en la pantalla Importar desde arch..

Consulta la siguiente página para resolver el error y luego intenta importar el archivo nuevamente.
Qué hacer si falla la adición o actualización masiva de registros

Para su referencia, este artículo proporciona un archivo de muestra que muestra el formato adecuado para cada tipo de campo. Para comprobar el formato adecuado para cada tipo de campo, descargue el siguiente archivo con ejemplos para todos los campos. (Solo disponible en japonés).
muestra_todos_los_campos_app.csv