Active Admin Import 使用教程

Active Admin Import 使用教程

active_admin_import:paperclip: active_admin_import is based on activerecord-import gem - the most efficient way to import for ActiveAdmin项目地址:https://gitcode.com/gh_mirrors/ac/active_admin_import

项目介绍

active_admin_import 是一个基于 activerecord-import 的 Active Admin 导入工具，旨在提供高效、快速的 CSV 导入功能。它支持验证、批量插入和编码处理，适用于 Active Admin 和 Rails 项目。

项目快速启动

安装

1. 在 Gemfile 中添加以下行：

   gem "active_admin_import", '2.1.2'
   

2. 执行以下命令安装 gem：

   bundle
   

配置

在 Active Admin 资源文件中配置导入功能：

ActiveAdmin.register Post do
  active_admin_import validate: true,
                      template_object: ActiveAdminImport::Model.new(
                        hint: "文件将按以下格式导入: 'body', 'title', 'author'",
                        csv_headers: ["body", "title", "author"]
                      )
end

应用案例和最佳实践

案例1：导入 ISO-8859-1 编码的文件

ActiveAdmin.register Post do
  active_admin_import validate: true,
                      template_object: ActiveAdminImport::Model.new(
                        hint: "文件编码为 ISO-8859-1",
                        force_encoding: "ISO-8859-1"
                      )
end

案例2：自动检测文件编码

ActiveAdmin.register Post do
  active_admin_import validate: true,
                      template_object: ActiveAdminImport::Model.new(
                        force_encoding: :auto
                      )
end

最佳实践

• 使用 validate: true 确保导入数据前进行验证。
• 使用 template_object 预定义导入格式和编码。

典型生态项目

active_admin_import 依赖于以下生态项目：

• activerecord-import：用于批量插入数据的强大库。
• rchardet：用于自动检测文件编码的库。

这些项目共同构成了 active_admin_import 的高效导入功能。

active_admin_import:paperclip: active_admin_import is based on activerecord-import gem - the most efficient way to import for ActiveAdmin项目地址:https://gitcode.com/gh_mirrors/ac/active_admin_import