#Importar

#Introducción

Permite importar datos utilizando una plantilla de Excel. Puede configurar qué campos desea importar y la plantilla se generará automáticamente.

#Instrucciones de Importación

#Campos de Tipo Numérico

Admite números y porcentajes. El texto como N/A o - se filtrará.

Después de la conversión a JSON:

{
  "Número 1": 123,
  "Porcentaje": 0.25,
  "Número 2": null,
  "Número 3": null,
}

#Campos de Tipo Booleano

El texto de entrada admitido (el inglés no distingue entre mayúsculas y minúsculas) es:

• Yes, Y, True, 1, 是
• No, N, False, 0, 否

Después de la conversión a JSON:

{
  "Campo 1": false,
  "Campo 2": true,
  "Campo 3": true,
  "Campo 4": true,
  "Campo 5": false,
}

#Campos de Tipo Fecha

Después de la conversión a JSON:

{
  "DateOnly": "2023-01-18T00:00:00.000Z",
  "Local(+08:00)": "2023-01-18T14:22:22.000Z",
  "GMT": "2023-01-18T22:22:22.000Z",
}

#Campos de Tipo Selección

Tanto los valores de las opciones como las etiquetas de las opciones pueden utilizarse como texto de importación. Varias opciones se separan con comas (, ，) o con el signo de pausa (、).

Por ejemplo, las opciones para el campo Prioridad incluyen:

Tanto los valores de las opciones como las etiquetas de las opciones pueden utilizarse como texto de importación.

Después de la conversión a JSON:

[{ Prioridad: 'high' }, { Prioridad: 'low' }];

#Campos de División Administrativa de China

Después de la conversión a JSON:

{
  "Región 1": ["11","1101"],
  "Región 2": ["12","1201"]
}

#Campos de Archivo Adjunto

Después de la conversión a JSON:

{
  "Archivo Adjunto": [
    {
      "filename": "logo.png",
      "title": "logo.png",
      "extname": ".png",
      "url": "https://www.nocobase.com/images/logo.png"
    }
  ]
}

#Campos de Tipo Relación

Múltiples entradas de datos se separan con comas (, ，) o con el signo de pausa (、).

Después de la conversión a JSON:

{
  "Departamento": [1], // 1 es el ID de registro para el departamento llamado "Equipo de Desarrollo"
  "Categoría": [1,2], // 1,2 son los IDs de registro para las categorías tituladas "Categoría 1" y "Categoría 2"
}

#Campos de Tipo JSON

Después de la conversión a JSON:

{
  "JSON": {"key":"value"}
}

#Tipos de Geometría de Mapa

Después de la conversión a JSON:

{
  "Point": [1,2],
  "Line": [[1,2], [3,4]],
  "Polygon": [[1,2], [3,4], [1,2]],
  "Circle": [1,2,3]
}

#Formato de Importación Personalizado

Registre un ValueParser personalizado a través del método db.registerFieldValueParsers(), por ejemplo:

import { BaseValueParser } from '@nocobase/database';

class PointValueParser extends BaseValueParser {
  async setValue(value) {
    if (Array.isArray(value)) {
      this.value = value;
    } else if (typeof value === 'string') {
      this.value = value.split(',');
    } else {
      this.errors.push('Value invalid');
    }
  }
}

const db = new Database();

// Al importar un campo de tipo `point`, los datos serán analizados por `PointValueParser`.
db.registerFieldValueParsers({
  point: PointValueParser,
});

Ejemplo de Importación

Después de la conversión a JSON:

{
  "Point": [1,2]
}

#Configuración de la Acción

• Configure los campos importables

• Reglas de Enlace: Muestre u oculte el botón dinámicamente;
• Editar Botón: Edite el título, el tipo y el icono del botón;