FireCMS 数据导入插件

此插件可直接从 FireCMS 界面导入数据到 Firestore 收藏 。 它在收藏视图中添加了导入按钮,提供了从CSV或JSON文件中大量添加或更新数据的简单方法.

安装

npm install @firecms/data_import
# or
yarn add @firecms/data_import

特征

• 从 CSV 或 JSON 格式导入数据到 Firestore 收藏
• 在导入前验证数据,以确保完整性
• 与 FireCMS 分析活动合并
• 支持大宗数据的创建和更新

基本用途

import React from "react";
import { FireCMS } from "@firecms/core";
import { useImportPlugin } from "@firecms/data_import";


export default function App() {

    // Basic setup with default options
    const importPlugin = useImportPlugin();

    return <FireCMS
        name={"My Online Shop"}
        plugins={[importPlugin]}
        authentication={myAuthenticator}
        collections={myCollections}
        firebaseConfig={firebaseConfig}
    />;
}

高级配置

您可以用这些选项自定义导入行为 :

const importPlugin = useImportPlugin({
    // Track import events
    onAnalyticsEvent: (event, params) => {
        console.log("Import event:", event, params);
        // Example events: "import_started", "import_completed", "import_error"
    }
});

配置选项

与导出整合

对于完整的数据管理解决方案,同时使用导入和导出插件:

import { useImportPlugin } from "@firecms/data_import";
import { useExportPlugin } from "@firecms/data_export";

// Set up both plugins
const importPlugin = useImportPlugin();
const exportPlugin = useExportPlugin();

// Add both to your FireCMS app
return (
    <FireCMS
        // ...other props
        plugins={[importPlugin, exportPlugin]}
    >
        {/* ... */}
    </FireCMS>
);

补充说明

• 导入功能在导入前会根据您的收藏计划验证数据
• 从 JSON 导入复杂数据类型( 地图、 数组、 引用) 时支持
• 从 CSV 导入时, 类型转换按照您的计划进行
• 大量进口货物分批加工,以避免防火店的限制