@getnuvo/importer-angular

中文文档
3.6.3发布于 2025/12/08TypeScriptES Module近 30 天下载 3168

角新进口商适配器

中文使用文档
文档目录15 节
  1. 特征
  2. 开始
  3. 安装
  4. 基本执行
  5. 高级配置
  6. 设置配置( S)
  7. 目标数据模型(TDM)
  8. 清理数据处理器函数( D)
  9. 动态导入
  10. 造型和赛明
  11. 多语种支助
  12. 处理结果
  13. 发布注释
  14. 学习更多
  15. 支助

nuvo logo

@ getnuvo/ 导入方形

npm latest package API status

[注] 这个 @getnuvo/importer-angular 软件包是之前的 nuvo-angular 软件包. 您可以继续使用 2.x 版本 nuvo-angular我们建议迁移到 @getnuvo/importer-angular 3.x版本,以利用最新的特征和改进.

nuvo 数据导入器 Angular SDK

无 利用AI来简化向您的应用程序导入复杂而无结构的文件.

整合新数据导入器,为您的客户提供直观有效的数据导入体验.

特征

  • AI 功率列和选项映射: 自动将导入的数据列与您的系统的目标数据模型相匹配,精简导入过程.
  • 自定义清理函数: 执行自定义逻辑,在导入工作流程中验证并转换数据.
  • 支持多个文件格式:处理各种文件类型,包括CSV,TSV,XLS,XLSX,JSON,XML,和PDF.
  • 动态导入能力: 启动任何步骤的导入程序,容纳不同的数据来源和工作流程.
  • 造型和赛明: 方便地调整进口商的外观,以符合您的应用程序的设计.
  • 多语种支助:定制并本地化接口文本,以适应全球用户群.
  • 宽角版本支持:与Angular 12通过Angular 21相兼容,包括支持无区变化检测.

开始

保证你签了我们 用户平台 并且可以使用您的新证钥匙.

安装

在您的工程中添加nuvo :

无 :

npm install @getnuvo/importer-angular

线条 :

yarn add @getnuvo/importer-angular

基本执行

下面是一个基本例子,说明如何将 NuvoImporter 在您的角应用程序中组件 :

将新导入模块添加到模块文件

import { NuvoImporterModule } from '@getnuvo/importer-angular';

@NgModule({
  declarations: [AppComponent],
  imports: [NuvoImporterModule, BrowserModule, AppRoutingModule],
  providers: [],
  bootstrap: [AppComponent],
})
export class AppModule {}

在HTML文件中添加nuvo组件.

<nuvo-importer
  [licenseKey]="licenseKey"
  [settings]="settings"
  [onResults]="onResults.bind(this)"
/>

定义组件文件中的属性 .

export class AppComponent implements OnInit {
  settings!: SettingsAPI;
  licenseKey!: string;

  ngOnInit(): void {
    this.licenseKey = 'Your License Key';
    this.settings = {
      identifier: 'product_data',
      columns: [
        {
          label: 'Product ID',
          key: 'product_id',
        },
        {
          label: 'Article Name',
          key: 'article_name',
        },
      ],
    };
  }

  onResults(results, errors, complete, logs) {
    console.log('Imported Data:', results);
    console.log('Errors:', errors);
    console.log('Import Logs:', logs);
    complete(); // Finalize the import process
  }
}

举例来说:

  • 许可证钥匙: 您唯一的新证密钥 .
  • 设置: 进口商的配置对象.
  • 标识符: 用于识别导入实例的独特字符串.
  • 栏: 定义目标数据模型(TDM) label 财务报告和审定财务报表 key 每个栏.
  • 关于结果: 处理导入数据结果的回调函数.

关于进口商的设立和定制的全面指南,参见: 第一步 文档.

高级配置

设置配置( S)

这个 settings 属性允许您调整进口商的行为和外观。 可配置的关键选项包括:

  • 输入类型: 指定所支持的文件类型(例如, ['csv', 'xls', 'json']) (中文(简体) ).
  • 模式: 确定进口商是否以某种方式经营(true)或内线(false) (中文(简体) ).

关于组合选项的详细清单,请访问 设置配置( S) 页 次.

目标数据模型(TDM)

使用 columns 数组 settings。每栏可包括:

  • 标签: UI中显示的方便用户的名称.
  • 键: 列的技术标识符.
  • 说明: 有关栏目的补充资料.
  • 备忘: 组合同义词或缩写来帮助绘图算法.
  • 审定:规则如需要的字段,独有性,regex图案,和跨栏的依赖性.

学习更多定义您的 TDM 在 列/ 目标数据模型 文档.

清理数据处理器函数( D)

实施自定义清理和数据处理器功能(召回功能),在导入过程中转换并验证数据. 这些功能可以校正日期格式,丰富条目,将导入的数据与外部数据库进行比较,等等.

探索这些职能在 清理函数 打开 数据处理器 医生.

动态导入

动态导入特性允许您从任何步骤开始导入进程,并使用各种数据格式。 这种灵活性能够与不同的工作流程和数据来源相融合.

有关实施细节,参见 动态导入 文档.

造型和赛明

自定义 nuvo 进口商的外观以匹配您的应用程序设计 。 修改主题,调整显示模式,并启用或禁用特定特性来创建无缝用户体验.

学习更多关于样式选项 样式 节.

多语种支助

这个 i18nOverrides 财务报告和审定财务报表 language 特性允许您自定义和本地化应用程序默认语言密钥,确保导入者与您的用户语言偏好保持一致.

有关本地化的更多信息,请访问 多语种支助 打开 语言 页 次.

处理结果

这个 onResults callback 函数提供对已清理数据的访问,允许您定义如何处理和存储数据.

关于处理结果的详情,见本文件附件 结果(产出) 文档.

发布注释

通过审查我们,不断更新最新的特性、改进和错误修正 发布注释。 。 。 .

学习更多

探索如何用真实的例子和详细指南从nuvo中取出最多的:

  • 试试看 代码框 - 测试和调整进口商的行动.
  • 拜访我们 知识库 深潜到设置、数据模型、清洁功能等等.

支助

如有问题或需要协助,请联系我们 财务问题 或联系我们的支援小组 支持@ingestro.com。 。 。 .

版本与发布记录

@getnuvo/importer-angular 共发布 17 个版本,首次发布于 2025/04/22;过去 12 个月发布了 3 个版本。

版本发布日期距今
3.6.3latest2025/12/0811 个月前
3.6.22025/12/0811 个月前
3.6.02025/11/1811 个月前
3.5.62025/11/141 年前
3.5.52025/11/031 年前
3.5.42025/10/291 年前

关于 @getnuvo/importer-angular 的常见问题

@getnuvo/importer-angular 是什么?

角新进口商适配器

如何安装 @getnuvo/importer-angular?

在项目目录运行 npm install @getnuvo/importer-angular,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:@angular/common(^12.0.0 || ^13.0.0 || ^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0 || ^21.0.0)、@angular/core(^12.0.0 || ^13.0.0 || ^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 || ^20.0.0 || ^21.0.0)、@emotion/css(^11.10.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@getnuvo/importer-angular 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@getnuvo/importer-angular 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@getnuvo/importer-angular 可以商用吗?

@getnuvo/importer-angular 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@getnuvo/importer-angular 的下载量有多少?

根据 npm 官方下载统计,@getnuvo/importer-angular 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,168 次,日均约 106 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@getnuvo/importer-angular 还在维护吗?

最新版本 3.6.3 发布于 2025/12/08(11 个月前);至今共发布 17 个版本,其中过去 12 个月发布了 3 个;首次发布于 2025/04/22。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。