#Importar

#Introdução

Importe dados usando um modelo Excel. Você pode configurar quais campos importar, e o modelo será gerado automaticamente.

#Instruções de Importação

#Campos do Tipo Número

Suporta números e porcentagens. Textos como N/A ou - serão filtrados.

Após a conversão para JSON:

{
  "Número1": 123,
  "Porcentagem": 0.25,
  "Número2": null,
  "Número3": null,
}

#Campos do Tipo Booleano

Textos de entrada suportados (o inglês não diferencia maiúsculas de minúsculas):

• Yes, Y, True, 1, Sim
• No, N, False, 0, Não

Após a conversão para JSON:

{
  "Campo1": false,
  "Campo2": true,
  "Campo3": true,
  "Campo4": true,
  "Campo5": false,
}

#Campos do Tipo Data

Após a conversão para 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 do Tipo Seleção

Tanto os valores das opções quanto os rótulos das opções podem ser usados como texto de importação. Múltiplas opções são separadas por vírgulas (,, ，) ou vírgulas enumerativas (、).

Por exemplo, as opções para o campo Prioridade incluem:

Tanto os valores das opções quanto os rótulos das opções podem ser usados como texto de importação.

Após a conversão para JSON:

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

#Campos de Divisão Administrativa da China

Após a conversão para JSON:

{
  "Região1": ["11","1101"],
  "Região2": ["12","1201"]
}

#Campos de Anexo

Após a conversão para JSON:

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

#Campos do Tipo Relacionamento

Múltiplas entradas de dados são separadas por vírgulas (,, ，) ou vírgulas enumerativas (、).

Após a conversão para JSON:

{
  "Departamento": [1], // 1 é o ID do registro para o departamento chamado "Equipe de Desenvolvimento"
  "Categoria": [1,2], // 1,2 são os IDs dos registros para as categorias intituladas "Categoria1" e "Categoria2"
}

#Campos do Tipo JSON

Após a conversão para JSON:

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

#Tipos de Geometria de Mapa

Após a conversão para JSON:

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

#Formato de Importação Personalizado

Registre um ValueParser personalizado através do método db.registerFieldValueParsers(), por exemplo:

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();

// Quando um campo do tipo=point é importado, os dados serão analisados por PointValueParser
db.registerFieldValueParsers({
  point: PointValueParser,
});

Exemplo de Importação

Após a conversão para JSON:

{
  "Point": [1,2]
}

#Configurações da Ação

• Configure os campos importáveis

• Regras de Vinculação: Exiba/oculte o botão dinamicamente;
• Editar Botão: Edite o título, tipo e ícone do botão;