# @getnuvo/importer-angular 中文文档

规范地址：https://npmcn.com/package/%40getnuvo/importer-angular/

版本：3\.6\.3
npm 元数据更新时间：2025-12-08T09:29:27.136Z
中文译文更新时间：2026-11-16T06:29:40.728Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40getnuvo/importer-angular
原文对照：https://npmcn.com/package/%40getnuvo/importer-angular/?lang=original
项目主页：https://ingestro.com/
源码仓库：https://github.com/getnuvo/nuvo-adapters

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：12.4 MB，7 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 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
- 首次发布：2025-04-22T05:19:02.320Z
- 最新版本发布：2025-12-08T09:29:26.948Z
- 近 30 天下载量：3168（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 3 个）

## 中文简介

角新进口商适配器

## 安装

```sh
npm install @getnuvo/importer-angular
```

也可以使用：`pnpm add @getnuvo/importer-angular`、`yarn add @getnuvo/importer-angular`、`bun add @getnuvo/importer-angular`

## README

[![nuvo logo](https://general-upload.ingestro.com/nuvo_logo_with_text.svg)](https://ingestro.com/)

# @ getnuvo/ 导入方形

[![npm latest package](https://img.shields.io/npm/v/@getnuvo%2Fimporter-angular?color=5c8ef2&label=npm@latest)](https://badge.fury.io/js/@getnuvo%2Fimporter-angular) [![API status](https://img.shields.io/uptimerobot/ratio/m792354517-acd98c6100961072cc093759?color=2fa659&label=uptime)](https://status.ingestro.com/)

> \[注\] 这个 `@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相兼容,包括支持无区变化检测.

## 开始

保证你签了我们 [用户平台](https://dashboard.ingestro.com/) 并且可以使用您的新证钥匙.

### 安装

在您的工程中添加nuvo :

**无 :**

```bash
npm install @getnuvo/importer-angular
```

**线条 :**

```bash
yarn add @getnuvo/importer-angular
```

### 基本执行

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

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

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

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

在HTML文件中添加nuvo组件.

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

定义组件文件中的属性 .

```ts
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` 每个栏.
-   **关于结果**: 处理导入数据结果的回调函数.

关于进口商的设立和定制的全面指南,参见: [第一步](https://docs.ingestro.com/sdk/start/) 文档.

## 高级配置

### 设置配置( S)

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

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

关于组合选项的详细清单,请访问 [设置配置( S)](https://docs.ingestro.com/sdk/settings/) 页 次.

### 目标数据模型(TDM)

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

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

学习更多定义您的 TDM 在 [列/ 目标数据模型](https://docs.ingestro.com/sdk/columns/) 文档.

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

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

探索这些职能在 [清理函数](https://docs.ingestro.com/sdk/cleaning-functions/) 打开 [数据处理器](https://docs.ingestro.com/sdk/data-handler) 医生.

### 动态导入

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

有关实施细节,参见 [动态导入](https://docs.ingestro.com/sdk/dynamic-import/) 文档.

### 造型和赛明

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

学习更多关于样式选项 [样式](https://docs.ingestro.com/sdk/styling/) 节.

### 多语种支助

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

有关本地化的更多信息,请访问 [多语种支助](https://docs.ingestro.com/sdk/multi-language/) 打开 [语言](https://docs.ingestro.com/sdk/settings#language) 页 次.

## 处理结果

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

关于处理结果的详情,见本文件附件 [结果(产出)](https://docs.ingestro.com/sdk/results/) 文档.

## 发布注释

通过审查我们,不断更新最新的特性、改进和错误修正 [发布注释](https://docs.ingestro.com/sdk/release-notes/)。 。 。 .

## 学习更多

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

-   试试看 [代码框](https://codesandbox.io/p/devbox/naughty-firefly-6nyy8z) - 测试和调整进口商的行动.
-   拜访我们 [知识库](https://dashboard.ingestro.com/knowledge-base) 深潜到设置、数据模型、清洁功能等等.

## 支助

如有问题或需要协助,请联系我们 [财务问题](https://docs.ingestro.com/sdk/faq) 或联系我们的支援小组 [支持@ingestro.com](mailto:support@ingestro.com)。 。 。 .

## 常见问题

### @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 和提交记录判断。

