# @aehrc/sdc-assemble 中文文档

规范地址：https://npmcn.com/package/%40aehrc/sdc-assemble/

版本：2\.0\.3
npm 元数据更新时间：2026-09-10T06:21:35.752Z
中文译文更新时间：2026-11-05T19:36:34.960Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40aehrc/sdc-assemble
原文对照：https://npmcn.com/package/%40aehrc/sdc-assemble/?lang=original
项目主页：https://github.com/aehrc/smart-forms#readme
源码仓库：https://github.com/aehrc/smart-forms

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

- 包体积（解压后）：246 kB，27 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2023-09-01T04:36:12.373Z
- 最新版本发布：2026-09-10T06:21:35.418Z
- 近 30 天下载量：34617（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 1 个）

## 中文简介

执行从 HL7 FHIR SDC (Structured Data Caption) 规格中的模块化格式的 $组装操作 : [http://hl7.org/fhir/uv/sdc/modular.html (中文(简体) )](http://hl7.org/fhir/uv/sdc/modular.html)

## 安装

```sh
npm install @aehrc/sdc-assemble
```

也可以使用：`pnpm add @aehrc/sdc-assemble`、`yarn add @aehrc/sdc-assemble`、`bun add @aehrc/sdc-assemble`

## README

# SDC- 联盟

字型参考文件执行 [$组装](http://hl7.org/fhir/uv/sdc/OperationDefinition/Questionnaire-assemble) 从操作 [HL7 FHIR 结构数据采集规格](http://hl7.org/fhir/uv/sdc/ImplementationGuide/hl7.fhir.uv.sdc) 并设计用于 [模块调查表](http://hl7.org/fhir/uv/sdc/modular.html#modular-questionnaires)。 。 。 .

## 使用量

您需要执行以下接口:

`InputParameters` - 组装操作输入参数

```ts
{
    resourceType: 'Parameters'
    parameter: [ 
      {
        name: 'questionnaire',
        resource: YOUR_QUESTIONNAIRE_RESOURCE
      }
    ]
} 
```

  

`FetchQuestionnaireCallback` - 从您的 FHIR 服务器获取资源的回调

```ts
function fetchQuestionnaireCallback (canonicalUrl: string, requestConfig: any) {
  const { endpoint, token } = requestConfig;
  return axios.get(`${endpoint}/Questionnaire?url=${canonicalUrl}`, {
    method: 'GET',
    headers: { Accept: 'application/json+fhir; charset=utf-8', Authorization: `Bearer ${token}`, }
  });
};
```

这两套接口都需要作为论据用于 `assemble()` 函数.

### 地方发展说明

建议在网络应用或服务范围内运行此图书馆,如果您正在本地开发. 这个库同时编译到CommonJS和ES模块,因此在网络框架和以节点为基础的后端之间使用它没有问题.

要编译代码, 使用 `npm run compile`。 。 。 . 要查看更改, 使用 `npm run watch`。 。 。 .

注意: 不使用 `tsc` 或者说 `tsc -w` 因为它只会被编译到ES模块中,这意味着它不会与基于CommonJS的应用合作.

## 执行样本

我们在表格服务器上使用这个模块作为微观服务 https://smartforms.csiro.au/api/fhir/Question/$assemble.

可找到一个执行样本 [这里](https://github.com/aehrc/smart-forms/blob/main/services/assemble-express/src/index.ts#LL43C4-L46C2)

## 常见问题

### @aehrc/sdc-assemble 是什么？

执行从 HL7 FHIR SDC \(Structured Data Caption\) 规格中的模块化格式的 $组装操作 : http://hl7\.org/fhir/uv/sdc/modular\.html \(中文\(简体\) \)

### 如何安装 @aehrc/sdc-assemble？

在项目目录运行 npm install @aehrc/sdc-assemble，或使用 pnpm add / yarn add / bun add。

### @aehrc/sdc-assemble 支持 TypeScript 吗？

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

### @aehrc/sdc-assemble 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @aehrc/sdc-assemble 可以商用吗？

@aehrc/sdc-assemble 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @aehrc/sdc-assemble 的下载量有多少？

根据 npm 官方下载统计，@aehrc/sdc-assemble 在 2026/10/05 – 2026/11/03 这 30 天内被下载 34,617 次，日均约 1,154 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aehrc/sdc-assemble 还在维护吗？

最新版本 2\.0\.3 发布于 2026/09/10（1 个月前）；至今共发布 13 个版本，其中过去 12 个月发布了 1 个；首次发布于 2023/09/01。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。