PartsBox 用户指南

简介

什么是 PartsBox？

PartsBox 是一个用于管理电子元器件库存、BOM 定价和生产的在线工具。它为整个电子制造过程提供了一个集中平台——从采购和储存组件到构建项目和跟踪输出。

主要功能包括：

• 库存管理：跟踪电子元器件、库存水平和存储位置，支持链接电子元器件（带有制造商部件号）、本地电子元器件、元电子元器件和子组件电子元器件。
• BOM 定价：使用来自在线分销商的最新报价为您的物料清单定价，支持价格折扣、货币转换、MOQ 和本地供应商报价。
• 生产：从 BOM 构建项目，具有单阶段和多阶段构建、子组件、序列号跟踪和完整的构建历史记录。
• 批次控制：跟踪从来源到生产中使用的特定批次的电子元器件，具有双向可追溯性，用于质量控制和法规遵从。
• 采购：创建和管理采购订单，跟踪订单状态，并将电子元器件接收到库存中。
• ID Anything™：PartsBox 中的每个对象（电子元器件、批次、存储位置、构建、订单、项目）都分配了一个独特的、紧凑的代码，可以打印为 QR 标签，使用移动设备扫描，并用于 CAD 工具中的 BOM 匹配。结合每台设备的序列号跟踪，这实现了从生产到现场服务的全生命周期可追溯性。
• 条形码扫描和标签打印：扫描条形码以快速查找电子元器件并添加库存，并打印存储位置和批次的标签。
• CAD 集成：从 KiCad、Altium Designer 和其他 EDA 工具导入 BOM。
• API：对您的电子元器件数据库的编程访问，以便与其他系统集成。
• 报告：库存估值、低库存警报和其他报告。

设计理念

PartsBox 旨在快速、不显眼且易于使用。界面响应迅速——搜索元器件、检查库存和管理项目都会立即发生。多个用户可以同时工作，更改对所有人实时可见。

与传统的 ERP（企业资源规划）或 MRP（物料需求规划）工具不同，PartsBox 易于引入并集成到现有工作流程中，摩擦极小。目标是提供一个工具，帮助您保持井然有序和高效，而不会妨碍您。

入门

本节将引导您了解 PartsBox 的基础知识：创建存储位置、添加元器件、进货以及构建您的第一个项目。每个步骤都建立在前一个步骤的基础上，到最后您将拥有一个带有定价 BOM 的工作项目。本指南的后面部分将更详细地介绍每个主题。

创建存储位置

在添加电子元器件之前，至少设置一个存储位置来表示您的组件将物理存放的位置。导航到顶部菜单中的“存储”，然后点击“创建”。默认选项卡是“单个”，它创建一个位置。

输入您的存储位置的名称（例如，第一个盒子的“b01”，或架子隔间的“shelf-A1”），然后单击“创建”。您以后随时可以添加更多位置，包括带隔间的盒子的位置网格。

有关命名存储位置的建议，请参阅“库存和存储”下的“存储位置”部分。

创建元器件

导航到顶部菜单中的“元器件”，然后点击“创建”。您将看到元器件类型的选择：关联元器件、本地元器件和元元器件。

如果您的元器件有制造商元器件编号 (MPN)，请选择“链接元器件”。在“匹配确切元器件名称”字段中输入 MPN，然后单击“匹配”。PartsBox 将搜索您的元器件并显示匹配结果及其规格和数据表链接。从列表中选择正确的匹配项，然后单击“创建元器件”。

如果您的组件没有 MPN（通用电阻器、PCB、定制机械部件），请选择“本地电子元器件”并输入名称。

有关元器件类型的更多详细信息，请参阅“元器件”下的“什么是元器件？”部分。

添加库存

创建电子元器件后，您需要添加库存以表示您手头拥有的物理组件。导航到电子元器件的详细信息页面，然后点击左侧菜单中的“添加库存”。

库存向导有三个步骤：

1. 数量和定价：输入您拥有的数量。（可选）选择价格类型（每个电子元器件或整个批次）并输入您支付的金额。
2. 存储位置：选择您之前创建的存储位置。
3. 额外信息：（可选）添加注释（例如，“初始库存”或订单参考）。

点击“添加库存”进行确认。

有关库存管理的更多信息，请参阅“库存和存储”下的“库存”部分。

创建项目

PartsBox 中的项目代表物料清单 (BOM)。导航到顶部菜单中的“项目”，然后点击“创建”。输入您的项目名称（和可选的描述），然后点击“创建项目”。

将元器件添加到项目

打开您新创建的项目并导航到“BOM”选项卡。单击“添加元器件条目”以打开元器件选择器。搜索您之前创建的元器件，选择它，然后确认。该元器件将以默认数量 1 添加到 BOM 中。然后，您可以单击该条目以展开它并调整数量、添加位号或配置其他字段。

通过导入 BOM 创建项目

如果您已经有从CAD工具（KiCad、Altium、Eagle或任何其他可以导出CSV的工具）导出的BOM，您可以通过导入它来创建一个项目。导航到“项目”并点击“导入”。上传您的CSV或TSV文件。

PartsBox 将解析文件并显示预览。如果需要，调整字段分隔符和字符编码，直到预览看起来正确。然后使用每列上方的下拉菜单将每列映射到适当的 BOM 字段。“猜测”按钮通常可以自动正确映射，但始终检查结果。最重要的映射是“数量”、“元器件”和“位号”。

映射列后，PartsBox 将尝试自动将每个 BOM 条目与数据库中的元器件匹配。与元器件匹配的条目显示元器件名称；未匹配的条目突出显示。如果您从前面的步骤创建了元器件，并且 BOM 包含相同的 MPN，它将自动匹配。

要手动匹配未匹配的条目，请单击它以展开条目详细信息。在“元器件匹配”部分中，单击“匹配到现有元器件”以打开元器件选择器并选择正确的元器件。如果需要，您也可以直接从那里创建一个新元器件。

对映射和匹配满意后，输入项目名称并单击“导入”。

有关BOM导入、匹配和管理条目的更多详细信息，请参阅“项目和BOM”下的“使用BOM”部分。

使用数据

PartsBox 广泛使用表格来显示和管理数据。许多功能——例如在表格内搜索、过滤、表格配置、批量操作、自定义字段、标签和附件——在不同类型的数据（元器件、批次、存储位置、订单、项目、BOM 条目和构建）中一致地工作。本节描述这些横切功能。

表格

PartsBox 中的表格是交互式的且功能丰富。它们支持搜索、过滤、列配置、排序、批量选择以及导出为 PDF 或 CSV。表格设置按表格记住，因此您的首选项在会话之间保持不变。下面描述的功能适用于应用程序中的大多数表格。

表格内搜索

除了主电子元器件搜索框（在“电子元器件”部分中描述）之外，整个应用程序的大多数表格中都提供了搜索功能。这些表格内搜索框提供精确匹配功能，帮助您快速缩小显示的行数。只需在表格上方的搜索框中输入即可过滤其内容。搜索会考虑所有可见列中的值。

筛选

PartsBox 中的大多数表格都支持高级过滤功能，允许您快速缩小显示数据的范围以匹配特定标准。过滤系统高度可配置，支持复杂的逻辑条件。本节将指导您完成在 PartsBox 中创建、使用和管理过滤器的过程。

对表格应用过滤器

要过滤表格中的数据，请按照以下步骤操作：

• 找到您要过滤的表格右上角的过滤器图标。
• 单击过滤器图标以打开该表格的过滤器配置屏幕。
• 使用“添加条件”或“添加多个条件”按钮添加过滤条件。您可以使用逻辑 AND/OR 运算符组合多个条件。
• 对于每个过滤条件，选择一个字段，选择一个条件，然后输入一个值。
• 定义过滤条件后，单击屏幕底部的“应用过滤器”按钮将过滤器应用于表格。

要快速删除表中当前应用的所有过滤器，请使用“删除所有过滤器”按钮。如果您计划将来重复使用该过滤器，请务必在删除之前将其保存为预设。

定义筛选条件

筛选条件是筛选器的构建块。每个条件由字段、条件和值组成：

• 字段：从列表中选择要用于过滤的字段。可用字段将根据表格及其显示的数据而有所不同。例如，“[存储] 标签”表示分配给存储位置的标签。
• 条件：选择符合您过滤要求的条件。可用条件列表取决于所选字段类型。例如，如果您选择“[存储] 标签”，您将看到诸如“包含所有这些标签”、“包含任何这些标签”和“不包含任何这些标签”等条件。
• 值：输入条件应匹配的值。根据字段类型，它可以是标签列表（对于标签字段）、文本字符串、数字或数字范围（区间）。

您可以使用逻辑 AND/OR 运算符组合多个筛选条件。PartsBox 支持嵌套条件，允许您通过添加单个条件或在每个 AND/OR 语句下组合多个 AND/OR 条件来创建复杂的筛选逻辑。

输入数值

在过滤条件中输入数值时，为了方便起见，您可以使用单位前缀。只需输入前缀而无需输入单位。例如，使用“22u”代替“22μF”，使用“10k”代替“10kΩ”。请注意，前缀区分大小写，因此“m”和“M”代表不同的值。

PartsBox 支持以下单位前缀：

• T: 太 (tera, 10¹²⁾
• G: 吉 (giga, 10⁹⁾
• M: 兆 (mega, 10⁶⁾
• k: 千 (kilo, 10³⁾
• d: 分 (deci, 10^-1)
• c: 厘 (centi, 10^-2)
• m: 毫 (milli, 10^-3)
• u 或 μ: 微 (micro, 10^-6)
• n: 纳 (nano, 10^-9)
• p: 皮 (pico, 10^-12)
• f: 飞 (femto, 10^-15)

管理过滤器预设

PartsBox 允许您将过滤器保存为预设，这些预设可以是个人的，也可以在公司内部共享。此功能使您能够快速加载复杂的过滤器，并定义对组织中每个人都有用的过滤器。

要管理您的筛选器预设：

• 使用“加载预设”按钮将以前保存的过滤器预设应用到当前表格。
• 点击“保存预设”将当前过滤器配置保存为新预设。选择将其保存为个人预设还是公司范围的预设。
• 点击“管理预设”以访问其他预设管理选项：
  • 删除不需要的预设
  • 复制现有预设
  • 在您的个人预设和公司预设之间复制或移动预设

快速访问过滤器预设

当您将筛选配置保存为预设时，它们会出现在表格标题的下拉菜单中。这提供了对常用筛选器的快速访问，并使不同视图之间的切换更加高效。

当基于标签或名称时，过滤器预设的功能类似于类别。与每个项目仅属于一个类别的严格类别系统不同，预设通过允许项目同时出现在多个过滤视图中提供了更大的灵活性。这种方法为您提供了类别的组织优势，而没有其典型的局限性。

表格配置预设

除了过滤器预设外，PartsBox 还允许您将表格列配置保存并共享为预设。当组织中的不同用户需要以一致的布局查看相同的列时，或者当您希望针对不同任务在不同的列排列之间快速切换时，这非常有用。

表格配置预设存储了列的选择、顺序及其相对宽度。与筛选预设一样，它们可以保存为个人预设（仅对您可见）或全公司预设（与您组织中的所有用户共享）。

要将表格配置保存为预设：

• 单击表头中的表格配置图标（列图标）进入配置模式。
• 根据需要添加、删除和排列列。您可以拖动列边缘来调整它们的大小。
• 使用配置面板底部的“另存为预设”按钮。
• 输入预设的名称，并选择将其保存为个人预设还是公司范围的预设。
• 单击“保存”进行确认。

要加载已保存的表格配置预设：

• 使用表头中出现的“加载配置预设...”下拉菜单（当预设可用时）。 - 从列表中选择一个预设。个人预设在其名称旁边显示“（个人）”，公司预设显示“（公司）”。 - 表格将立即更新以显示保存的列配置。

您还可以通过点击表格配置图标并使用“管理预设”按钮来管理您的预设，以：

• 通过单击名称重命名预设
• 删除不再需要的预设
• 复制预设以创建变体
• 在个人和公司集合之间复制预设
• 将预设从个人移动到公司（反之亦然）

表格配置预设对于需要在不同用户之间保持一致视图的团队特别有帮助，例如确保每个人在导出数据或查看库存时看到相同的列。

表格导出

PartsBox 中的大多数表格都可以使用表格页脚中的“导出”按钮导出为 PDF 或 CSV。导出包括与当前搜索和过滤条件匹配的所有行，使用当前配置的列。

每个表格都有两个独立的列配置：一个用于显示，一个用于导出。导出通常需要与屏幕上看到的不同的列集，因此这些是独立维护的。当您进入表格配置模式（通过点击表格标题中的列图标）时，左侧的选择器可让您在编辑显示配置和导出配置之间切换。如果您发现导出的数据与屏幕上看到的不匹配，请检查导出列配置——它可能设置为不同的列。

PDF 导出产生高质量的输出，其中包含包含文档标题和您的公司徽标（如果在“设置”>“常规”中上传，请参阅“组织和访问”部分）的标题，以及具有适合打印的格式的表格数据。表格列中存在的图像和 URL 包含在 PDF 导出中。缩略图在适用的情况下内联显示。

CSV 导出生成适合在电子表格和其他工具中使用的标准逗号分隔文件。

对多个项目的操作

PartsBox 中的许多表格支持选择多个项目并对它们执行批量操作。这种模式在电子元器件、批次、存储位置、订单、项目、BOM 条目和构建中一致地工作。

要选择项目，请使用每行旁边的复选框。应用程序会在您搜索和过滤时记住您的选择，因此您可以随着时间的推移建立选择，而不会丢失以前选择的项目。使用表头中的复选框选择或取消选择所有可见项目。选择项目后，使用“选定...”菜单访问可用操作。具体操作因您正在处理的数据类型而异——有关详细信息，请参阅相关部分。

自定义字段

自定义字段提供了一种灵活的方式来存储和组织 PartsBox 中各种对象的结构化数据。自定义字段可以添加到元件、批次、存储位置、订单、项目、项目 (BOM) 条目和构建中。

与备注或评论不同，自定义字段是结构化的，已编入索引以供搜索，并可用于整个应用程序中的表格列和筛选。这允许您定义和存储特定于您的组织需求、工作流程或行业要求的附加属性。

如何使用自定义字段的一些示例：

• 对于元器件：经销商元器件编号、可靠性级别、环境合规状态
• 对于存储位置：温度范围、ESD 保护级别、所有权信息、MSL 级别
• 对于批次：供应商批号、到期日期、质量检查状态
• 对于订单：批准状态、运输方法、海关文件
• 对于项目：项目经理、开发阶段、监管批准
• 对于构建：批号、生产线标识符、质量控制状态

自定义字段完全集成到 PartsBox 界面中，可以是：

• 作为列添加到表格视图中
• 在 PDF 或 CSV 表格导出中导出
• 用于搜索
• 用于过滤器

批量自定义字段操作

处理多个项目时，您可以对自定义字段执行批量操作：

• 设置自定义字段：一次在所有选定项目上添加或更新自定义字段值
• 重命名自定义字段：在所有选定项目上更改自定义字段名称
• 删除自定义字段：从所有选定项目中删除自定义字段

要使用这些操作：

• 使用复选框在表格中选择多个项目
• 使用批量操作菜单选择自定义字段操作
• 按照提示完成操作

这些批量操作适用于元件、批次、存储位置、订单、项目、项目条目和构建。

标签

标签提供了一种强大而灵活的方式来对 PartsBox 中的数据进行分类和组织。通过将标签应用于各种对象，如元器件、存储位置、项目、订单、批次和构建，您可以快速查找和过滤特定的数据子集。

应用标签

可以从信息/编辑屏幕分配标签，也可以通过选择多个项目并使用“选择”菜单中的“添加/删除标签...”选项来分配标签。

添加标签时，只需输入标签名称，无需前导 # 字符。一个对象可以附加任意数量的标签。

使用标签搜索

标签在搜索和过滤数据方面起着重要作用。当您在搜索框中输入标签（以 # 字符开头）时，PartsBox 将限制搜索结果为已分配该特定标签的对象。

请记住，标签是精确匹配的。如果您在搜索框中输入多个标签，则对象必须具有所有指定的标签才能包含在结果中。

元件自动标签

PartsBox 会根据电子元器件的规格自动为您的电子元器件生成自动标签。这些自动标签是独立于您手动分配的标签创建的，因此如果您分配了与自动标签同名的标签，您不必担心冲突。

自动标签提供了一种无需人工操作即可对元器件进行分类的便捷方式。它们确保具有相似规格的元器件被自动分组在一起，从而更容易查找和管理它们。

附件

PartsBox 允许将任意文件附加到元件、批次、项目、存储位置、订单、本地报价和构建中。此功能对于保持所有相关信息的组织性和易于访问非常有用。您可能想要附加的一些常见文件示例包括：

• 电子元器件的数据手册
• 机械零件的 3D CAD 模型
• 订单的发票和装箱单
• 质量控制文件和测试报告
• 产品照片和图像
• 应用笔记和参考设计
• 合格证书 (CoC) 和材料安全数据表 (MSDS)

通过将这些文件直接附加到 PartsBox 中的相关项目，您可以确保重要信息始终触手可及。无需担心命名约定、目录结构或记住文件存储在服务器上的位置。

附件安全地存储在云端，可以从任何地方访问。

查看带有附件的项目的详细信息页面时，您将看到所有附加文件的列表。单击文件名会将附件下载到您的计算机。您还可以重命名附件，或者如果不再需要它们，可以将其删除。

通过利用 PartsBox 的附件功能，您可以将所有重要文档整理好并连接到库存中的相关项目。这节省了时间，并确保团队中的每个人都能访问他们需要的信息。

元器件

什么是元器件？

PartsBox 专注于电子元件，因此“元件”是一个基本概念。一个元件代表一个电子或机械组件。有几种类型的元件：

• 关联元器件适用于具有制造商元器件编号 (MPN) 的电子元器件。如果元器件具有 MPN 并且您可以在线找到它，请选择此选项。您将立即获得描述、数据手册链接、制造商网站链接、元器件规格、缩略图，并且 PartsBox 将能够从分销商处获取有关此元器件的定价和可用性信息。
• 本地元器件适用于所有其他物品：通用和无名电子元器件、PCB、定制元器件、机械元器件以及任何没有确切元器件编号的物品。
• 元器件组将可互换的元器件（彼此的精确替代品）分组。
• 子装配元器件是构建项目的结果，并与项目 1:1 对应。

请注意，对于通用和无名元件（例如 DIP 封装的无名 NE555），通常最好使用本地元件。NE555 有数百个版本，您的特定版本可能与别人的略有不同。因此，仅对完全匹配的元件使用关联元件（例如，如果您有来自 Texas Instruments 的 'NE555PWG4'，请关联它）。

元件是抽象的：它们描述了组件，但在您添加实际库存之前，它们并不代表实物。即使没有库存的元件也是有用的——例如，您可以将它们添加到项目 (BOM) 中以获取项目的定价。

关联元器件有两个名称：本地（内部）名称和官方 MPN。在免费的业余爱好者计划中，本地名称必须与 MPN 相同。在商业计划中，可以使用两个名称，并且本地名称可以与 MPN 不同。可以通过重命名元器件来更改本地名称。

除了名称或制造商等标准属性外，元件还可以具有自定义字段/属性（在支持此功能的计划中）。像“备注”字段一样，这些字段可用于存储任何数据，但方式更加结构化。一些使用示例包括分销商、分销商零件编号、供应商元件 URL、重量或容器皮重。自定义字段已编入索引以供搜索。

添加元器件

创建元器件

要添加新元器件，请导航至主菜单中的“元器件”部分，然后使用“创建”按钮打开创建元器件对话框。

“元器件类型”字段决定将创建的元器件种类：

• “链接电子元器件”：用于具有唯一制造商部件号 (MPN) 的组件。
• “本地电子元器件”：用于通用组件和任何其他需要跟踪的内容。
• “元电子元器件”：当您需要创建一个代表几个等效电子元器件选项（替代品）的虚拟电子元器件时使用。

创建关联元件

搜索关联元器件有两种方法：

• 匹配确切的组件名称 (MPN)：电子元器件名称的开头必须匹配（前缀搜索）。例如，'TPS40210' 将匹配 'TPS40210DGQ'。这是匹配组件的首选方法。
• 搜索：这是一种模糊搜索，对于像 'adafruit 1063' 这样的查询很有用。

输入搜索词并点击“匹配”或“搜索”后，将显示结果。选择完全符合您要求的元件，密切注意命名的细微变化，因为它们可能表示实际元件的显着差异。当您选择一个结果时，将显示其规格，如果可用，每个元件旁边都会提供数据表链接。

对于商业用户，可以立即将本地（内部/公司）零件编号分配给关联元件。

创建本地元件

创建本地元器件时，只有元器件名称是必需的；所有其他字段都是可选的。

某些计划允许上传数据表、图像、CAD模型和其他信息并将其附加到元器件上。这是在创建元器件之后完成的。

创建元元件

要创建一个元组元器件，请提供名称以及可选的封装和描述。新创建的元组元器件将是空的，这意味着它不包含任何成员元器件（替代品）。这些需要稍后添加，可以通过使用元组元器件信息屏幕上的“添加元器件”按钮，或者在主元器件表中选择多个元器件并使用“已选 | 添加到元组元器件”选项。

将现有元件转换为元元件

如果您有一个现有的元件，其中包含库存、报价和使用历史记录，并且您想将其转换为元元件，您可以直接转换它，而无需创建一个新的空元元件。当您意识到一直使用的某个元件实际上应该代表一组可互换的替代品时，这非常有用。

如果一个元器件还不是元元器件，不是子装配，并且没有归档，则可以将其转换为元元器件。

如何转换：

• 转到元器件的信息屏幕
• 单击“其他操作”
• 单击“转换为元器件组”
• 查看预览，显示将更新多少项目和列表条目
• （可选）重命名元器件组（默认为原始元器件名称）
• （可选）选中“将替代品作为成员包含在内”以将现有替代品添加为元器件组成员
• 如果元器件有附件，（可选）选中“将附件移动到元器件组”
• 单击“转换”

转换过程中会发生什么：

• 使用指定的名称创建一个新的元元件
• 原始元件成为新元元件的成员
• 复制到元元件的字段：名称、描述、备注、封装、标签和自定义字段
• CAD 字段（KiCad 符号/封装/引用，Altium 库引用/封装）被移动到元元件并从原始元件中移除
• 如果元件有图像，它将被复制到元元件（两者都保留图像）
• 附件可选择移动到元元件（如果您勾选该选项）
• 当前项目条目和列表条目将更新为引用元元件
• 指向此元件的其他元件的替代品引用将更新为引用元元件
• 如果选中“包含替代品作为成员”，所有有效的替代品将成为新元元件的成员
• 条目上的锁定报价将被清除

保持不变的内容：

• 库存、批次和报价保留在原始元件（现在是元元件的成员）中
• 构建历史条目保持不变（它们引用构建时的元件）
• 条目级替代品引用不会更改（这些特定于每个条目）

在所有项目中全局替换元件

当某个元器件过时或停产时，您可能希望在所有项目中将其替换为不同的元器件。您可以使用“在项目中替换”操作一步完成此操作，而不是单独编辑每个项目条目。

如何替换：

• 转到元器件的信息屏幕（您要替换的元器件）
• 单击“其他操作”
• 单击“在项目中替换”
• 使用元器件选择器选择替换元器件
• 如果您希望更新各个条目上的替代品引用，请（可选）选中“同时替换条目级替代品引用”
• 单击“替换”

替换期间会发生什么：

• 所有引用此元器件的当前项目条目都将更新为引用替换元器件
• 受影响条目上的锁定报价将被清除（因为元器件已更改，以前锁定的报价不再适用）
• 如果选中“同时替换条目级替代品引用”，则指向此元器件的任何条目级替代品引用都将更新为指向替换元器件

保持不变的内容：

• 原始元器件本身不会被修改或删除——它及其所有数据仍保留在您的元器件列表中
• 元器件级替代品不会更改
• 列表条目（采购列表）不受影响
• 构建历史记录条目保持不变（它们引用构建时的元器件）

在选定项目中替换元器件

如果您只想在特定项目中替换元器件，而不是在所有项目中替换，您可以使用批量选择从项目列表中进行操作。

如何在选定项目中替换：

• 转到项目列表
• 使用复选框选择一个或多个项目
• 点击“已选...”
• 点击“替换电子元器件...”
• 选择源电子元器件（您要替换的电子元器件）——电子元器件选择器被过滤为仅显示在所选项目中实际使用的电子元器件
• 选择替换电子元器件
• （可选）选中“同时在条目级替代品引用中替换”
• 点击“替换”

当元件替换仅适用于某些项目，或者您想逐个项目逐步推出替换时，这很有用。

应用与全局替换相同的行为：受影响条目上的锁定报价将被清除，列表条目和构建历史记录不受影响，原始元器件不会被修改或删除。

搜索元器件

搜索是 PartsBox 中的一项基本功能，可让您快速找到所需的电子元器件。主搜索框位于“电子元器件”部分的顶部。

元件搜索引擎采用模糊匹配，这意味着即使您的搜索词不完全匹配，仍会显示相关结果。为了帮助您快速识别最相关的匹配项，精确结果会使用不同的背景颜色与部分匹配项在视觉上区分开来。

搜索元件时，搜索范围包括以下字段：

• 名称
• MPN (制造商零件编号，如果与名称不同)
• 制造商
• 描述
• 封装
• 元件备注
• 所有自定义字段

除了按关键字搜索外，您还可以使用标签进行搜索。要按标签搜索，只需输入 # 字符，后跟标签名称。标签是精确匹配的，如果您输入多个标签，则元件必须具有所有指定的标签才能包含在结果中。

为了获得更大的灵活性，您可以在搜索查询中结合关键字和标签。这允许您创建高度针对性的搜索，帮助您准确找到所需内容，即使在庞大而复杂的元器件数据库中也是如此。

除了主要的元器件搜索之外，整个应用程序中的大多数表格都有自己的搜索功能。有关详细信息，请参阅“使用数据”下的“表内搜索”部分。

删除元件

有两种删除元器件的方法：

• 从元器件信息屏幕，进入“其他操作”并单击“删除元器件”按钮。
• 从元器件表中，选择多个元器件并在“选定...”菜单中选择“删除...”操作。

删除元器件是一项破坏性操作，除非您要删除从未在构建中使用过且从未添加过任何库存的新创建元器件，否则不建议这样做。当您删除元器件时，PartsBox 将无法解析过去构建历史中对该元器件的引用。通常，请避免删除已在构建中使用的元器件。

大多数情况下，最好将元器件归档（见下文）。

归档元器件

已归档的零件将不会显示在常规表格和搜索中，这可以防止它干扰正常使用。它仍将在“零件 | 已归档”表中可用，并将保持在构建历史记录中可见。

要归档元件，请转到元件信息屏幕中的“其他操作”，然后单击“归档元件”按钮。

被归档的元件应该没有库存（无论是现有库存还是已订购）。归档有库存的元件通常是不合逻辑的。即使归档的元件不会出现在标准表格和搜索中，它们仍然会影响报告，例如元件价值报告或存储位置价值报告。因此，您不能归档具有现有库存的元件。在归档之前，您必须先手动移除该元件的库存和/或从订单中移除该元件。

对于您不想在日常数据库操作中看到的元件，建议采用归档方法。仅删除那些错误创建且从未被使用过的元件。

对多个元件的操作

有关选择和操作多个项目的一般信息，请参阅“使用数据”下的“对多个项目的操作”部分。特定于元器件的操作如下所述：

• 添加/删除标签：批量编辑选定元器件的标签。您可以添加新标签或删除现有标签，从而更轻松地对元器件进行分类和组织。
• 添加到项目：将选定的元器件添加到特定的项目/BOM。系统将提示您选择目标项目。
• 添加到元器件组：将选定的元器件添加到现有的元器件组或创建一个新的元器件组。元器件组将可互换的元器件（替代品）分组。
• 添加到采购列表：当您需要订购选定的元器件时，将它们添加到采购列表中。
• 设置低库存水平：一次性设置所有选定元器件的低库存阈值。这些阈值可帮助您维持充足的库存。
• 设置元器件损耗：设置选定元器件的损耗参数。损耗说明了制造过程中预期的电子元器件损失。
• 下载为 CSV：将选定元器件的列表导出为 CSV（逗号分隔值）文件，以便在电子表格或其他外部工具中使用。
• 删除：从您的 PartsBox 数据库中永久删除选定的元器件。将出现确认提示以防止意外删除。考虑归档元器件而不是删除它们。
• 取消全选：清除当前选择，而不对选定的元器件执行任何操作。

替代品

在电子制造中，一个元件通常有可用的替代品：即功能相当且可以互换使用的元件。PartsBox 提供了几种定义替代品的方法，每种方法都有其自己的语义和用例。

Meta-元器件

组合元器件（Meta-parts）允许您将多个替代元器件（称为成员元器件）归为一个名称。此名称随后可用于项目和 BOM 中。组合元器件是逻辑分组，提供其所有成员元器件库存的汇总视图。它们还支持在组合元器件级别进行低库存警报。

使用元元器件的一个很好的例子是像“TPS61161DRVR”和“TPS61161DRVT”这样的组件。它们是同一个元器件，只是包装不同。通过创建一个名为“TPS61161DRV”的元元器件并在您的 BOM 中使用该名称，您可以像管理单个元器件一样管理它们的库存。“TPS61161DRV”元元器件将显示两种包装变体的合并库存。

元件替代品

元件替代品提供了一种指示可以使用不同元件代替当前元件的方法。与元元件不同，元件替代品不提供任何库存分组。每个元件的库存仍然是独立管理的。

元件替代品对于无源元件特别有用，因为无源元件通常具有功能等效物，您不一定希望将其作为单个库存项目进行管理。通过定义元件替代品，您可以指示在每个项目、BOM 条目和采购清单条目中，全局使用另一个元件代替当前元件。

BOM 替代品

有时，某个元器件可以替换项目中的特定 BOM 条目，但不一定能在其他任何地方替换。这就是 BOM 替代品发挥作用的地方。

BOM 替代品允许您为项目中的特定 BOM 条目定义替代元器件。此替代仅适用于该特定 BOM 条目，不影响该元器件在其他项目或 BOM 中的使用。

组合替代品

在构建或购买时，PartsBox 会结合有关上述所有类型替代品的信息，为给定的 BOM 条目或购买清单条目生成所有可能替代品的综合列表。

这一强大的功能确保您在采购和使用元器件方面拥有最大的灵活性，同时仍能严格控制您的库存和构建。

通过使用元元件、元件替代品和 BOM 替代品，您可以优化库存管理，降低缺货风险，并确保即使特定元件无法获得，您的项目也能构建。

查看元器件信息时，“在项目中使用的”部分显示引用该元器件的所有项目——不仅作为 BOM 条目中的主要元器件，而且还显示它作为 BOM 替代品或作为项目中使用的元器件组成员出现的位置。这也可以配置为表格列。

元件的默认存储位置

许多元件都有一个专用的“家”位置，它们应该始终存放在那里。PartsBox 允许您为任何元件分配默认存储位置，这提供了两个好处：

• 自动预选：向设置了默认位置的元器件添加库存时，该位置将在存储位置选择器中自动预选。这节省了时间并减少了意外将元器件存储在错误位置的机会。
• 强制执行：或者，您可以将默认位置标记为强制。启用后，该元器件的库存只能添加到默认位置，从而完全防止错误。

要为元器件设置默认存储位置：

• 导航到元器件的详细信息页面
• 转到“设置”
• 从下拉列表中选择默认存储位置
• （可选）选中“位置是强制的”以强制执行该位置

默认存储位置下拉列表仅显示可以接受该元器件的位置。已满、已归档或受限的位置（例如已包含不同元器件的单元件位置）将不会出现在列表中。

添加库存时，如果元器件设置了默认位置，PartsBox 将在存储位置选择器中突出显示该位置。如果该位置是强制性的，其他选项将被禁用，以确保元器件进入其指定位置。

此功能特别适用于：

• 具有专用料盒或抽屉的元器件 - 需要受控存储的高价值元器件 - 必须存储在特定环境条件下的元器件 - 确保多人添加库存时的一致性

元器件损耗

在使用 SMT（表面贴装技术）贴片机组装电子设备的过程中，一定比例的元器件（组件）不可避免地会丢失或被拒收。这是由于自动化组装过程固有的局限性和缺陷造成的。

此外，这些机器中使用的编带供料器的机械设计要求在机器可以自动从编带拾取元件之前，必须存在最小长度的编带，称为“引带”。此引带中包含的元件实际上未被使用，并导致了整体元件损耗。

元件损耗，也称为元件浪费，是规划生产和管理库存时要考虑的重要因素。未能考虑损耗可能会导致意外短缺和生产延误。

PartsBox 允许您为每个元器件单独定义损耗参数，确保您的库存和订单数量考虑到这些预期损失。当您使用 PartsBox 构建或定价项目和 BOM 时，应用程序会自动考虑定义的损耗参数。它根据项目的需求和预期损失计算所需的元器件总数，确保您有足够的库存或订单数量来完成构建。

PartsBox 提供了两种指定损耗的方法：

• 基于百分比的损耗：此参数表示在制造过程中预计损失的元器件百分比。典型的损耗率在0.1%到3%之间，具体取决于元器件类型和您的生产工艺细节。例如，如果您将某个元器件的损耗百分比设置为1%，而您的项目需要1000个单位，PartsBox将计算额外的10个单位以弥补预期损失。 - 基于数量的损耗：此参数允许您指定应始终保留的额外元器件的最小数量，无论基于百分比的计算结果如何。这对于卷带包装的元器件特别有用，因为需要一定长度的引导材料才能将元器件送入贴片机。通过设置基于数量的损耗，您可以确保始终有足够的元器件来满足此最低要求。

要为单个元器件设置损耗参数，请导航至元器件的详细信息页面并找到损耗设置。您可以根据需要输入百分比和/或数量值。

如果您需要同时为多个元件设置损耗参数，PartsBox 的批量编辑功能使其变得简单：

• 在元器件表中，选中要修改的元器件旁边的复选框。您还可以使用表头中的选择复选框来选择当前显示在表中的所有元器件。
• 选择所需的元器件后，打开“选择”菜单并选择“设置元器件损耗...”。
• 在损耗设置对话框中，输入要应用于所选元器件的百分比和/或数量值。
• 单击“应用”以更新所有选定元器件的损耗参数。

不能直接为元元件设置损耗，元元件用于对可互换的元件进行分组。在对包含元元件的项目进行定价时，PartsBox 将使用元元件内所有单个元件的最大损耗值。在构建项目时，实际损耗将根据构建时从元元件组中选择的具体元件进行计算。

库存和存储

库存

在 PartsBox 中创建元件后，您可以添加库存来表示该电子元件的实物库存。库存代表您手头已有或将来可以使用的元件的实际有形副本。

单个元器件可以在多个位置拥有库存。这在处理卷盘元器件时特别有用。通常，您可能希望在一个位置保留整卷，而在另一个位置存储少量剪切带。在与合同制造商合作时，跨不同位置跟踪库存也被证明是有价值的，因为它允许您监控位于办公室之外的库存。

PartsBox有意将元器件和库存的概念分开。您可以将元器件视为可能包含实际组件（库存）的容器。零库存的元器件具有重要用途：

• 它们指示需要订购什么。
• 它们允许您跟踪待处理的订单。
• 您的项目 (BOM) 可能会使用您实际没有库存的电子元器件，但您的制造商会有。
• 它们允许您将来从 CAD 工具导入 BOM，自动将 BOM 条目与电子元器件匹配。

PartsBox 将库存历史视为具有有限编辑选项的永久记录。您始终可以删除最近的条目，但无法删除较旧的条目，也无法修改其数量。这种方法确保了库存数据随时间的完整性和可追溯性。

批次

在 PartsBox 中，批次代表特定的一批或一次发货的电子元件，可追溯到已知来源。批次控制是一项可选功能，允许对元件库存进行更详细的跟踪和管理。

启用批次控制后，给定元件的所有库存将分为不同的批次。添加新库存时会创建一个批次，确保每批组件都与特定批次相关联。这允许区分可能在不同时间或从不同供应商采购的相同元件。

例如，考虑一个 100nF 电容器，您有一个来自一个供应商的 5000 件完整卷盘，以及来自另一个供应商的 100 件切割带条。如果没有批次控制，PartsBox 只会告诉您总共有 5100 件——这两批是无法区分的。有了批次控制，卷盘和切割带条被作为单独的批次进行跟踪，每个批次都有自己的来源、价格和历史记录。您可以确切地看到卷盘和带条上还剩多少件，选择在构建期间消耗哪个批次，并将任何质量问题追溯到其特定来源。

批次可以关联各种数据：

• 名称：批次的唯一标识符，通常与来源或获取日期有关
• 描述：有关批次的更多详细信息，例如供应商信息或特定特征
• 备注：有关批次的说明，可能与将来参考有关
• 标签：可用于过滤批次以进行显示或在为构建选择元器件来源时使用的标签
• 附件：相关文档，例如发票、检查报告或测试结果

通过使用批次控制，PartsBox 能够在整个库存管理过程中精确跟踪元件。这对于管理保质期有限的元件、确保质量问题发生时的可追溯性或遵守监管要求特别有用。

当元件在构建期间被消耗或在存储位置之间转移时，会记录特定批次，从而维护每个批次使用的完整历史记录。这种详细的跟踪允许在出现问题时更容易地识别和隔离问题。

PartsBox 中的批次控制为电子元件库存提供了额外的控制层和可见性，从而实现更高效、更准确的元件管理。

存储位置

存储位置是可以存放组件的地方。它可以是房间、抽屉、架子、盒子、盒子内的隔间，或您能想到的任何其他东西。

组织您的存储

最重要的原则是：不要试图按类型对元器件进行分类。一种常见的本能是将所有电阻器放在一起，所有电容器放在一起，依此类推——但这会随着库存的增长产生不断的重组工作，并且无法扩展。相反，让PartsBox跟踪所有物品的位置。当新货物到达时，将元器件放在物理上合适的位置。PartsBox将始终准确告诉您在哪里可以找到任何元器件。

以下是一些在实践中效果很好的常见方法：

• 按尺寸分类的盒子：保留几个不同尺寸的盒子。当元器件到达时，将袋子或卷盘放在有空间且适合包装的任何盒子中。一条切割带放在一个小盒子里，一个完整的卷盘放在架子上或一个更大的盒子里。这简单而高效——您永远不需要重新排列任何东西。
• 每个项目的盒子：如果您正在处理几个项目，请为每个活动项目保留一个盒子，其中包含您需要的元器件。这使得在构建会话中轻松获取所有内容。未分配给项目的元器件进入一般存储。
• 带网格的隔间盒：小型隔间盒（如用于钓具或工艺用品的盒子）非常适合切割带上的 SMD 元器件。使用网格方法将每个隔间创建为存储位置（例如“b01-a1”到“b01-d6”），并将元器件放置在任何有空闲隔间的地方。
• 卷盘架：完整的卷盘不适合小盒子。带有标签位置的架子或机架效果很好。将位置命名为“s01-r1”、“s01-r2”等。
• 样品本：电阻器或电容器样品本可以分别标记为单个位置（例如，电阻器本的“book-r”），因为很容易在书中找到特定值。

这些方法可以自由混合。您可能有一个用于卷盘的架子，几个用于切割带和小型电子元器件的带隔间的盒子，以及桌子上的一个按项目分类的盒子。

命名方案

您可以随意命名您的存储位置，但这里有一个建议的命名方案：

以指示存储类型的字母开头：“b”代表盒子，“s”代表架子，“c”代表柜子，“d”代表抽屉。后面跟着一个两位数，代表特定单元。然后，如果位置有子隔间，请使用网格系统：a1、a2、b1、b2 等等。这会产生诸如“b01-a4”（盒子 1，a 行，4 列）或“s01-r3”（架子 1，卷盘位置 3）之类的名称。使用任何能让您轻松找到电子元器件的方案。

您的存储位置名称可以随时更改，但请仔细选择，因为一旦打印标签，更改它们就会变得稍微困难一些。

与 CM/EMS（合同制造商）合作的公司通常会在其部分存储位置前加上制造商的名称，以便他们可以轻松过滤位置并查看 CM 目前的库存情况。

另一方面，CM/EMS 公司通常会在一些存储位置前加上客户名称，以便为寄售元件提供按客户分类的存储位置。

添加存储位置

要创建新的存储位置，请导航到主菜单中的“存储”部分，然后单击“创建”按钮。PartsBox 提供四种创建存储位置的方法：

• 单个位置：此方法用于创建具有特定名称的单个存储位置。当您只需要添加一个位置（例如单个盒子或架子）时，它很适用。输入所需的位置名称，然后单击“创建”。您还可以将该位置标记为仅用于单个元器件。
• 行：行方法用于创建存储位置的线性阵列，用数字或字母标记。当您有一系列排列成一行的盒子或隔间时，这很有用。指定位置名称的前缀、起始和结束数字或字母，然后单击“创建”。例如，输入前缀“box”，起始数字 1，结束数字 5，将创建名为“box1”、“box2”、“box3”、“box4”和“box5”的位置。
• 网格：网格方法允许您创建存储位置的二维阵列，使用字母或数字表示行和列。这对于在网格状结构中组织存储很方便，例如具有多行和多列的架子。输入前缀、行和列标签，然后单击“创建”。例如，前缀为“shelf”，行标签为“A,B”，列标签为“1,2”，将创建以下位置：“shelf-A1”、“shelf-A2”、“shelf-B1”、“shelf-B2”。
• 3D 网格：3D 网格方法扩展了网格概念，以创建存储位置的三维阵列。这适用于复杂的存储设置，例如具有行和列的多层机架。指定前缀、层、行和列标签，然后单击“创建”。例如，前缀为“rack”，层标签为“1,2”，行标签为“A,B”，列标签为“1,2”，将生成诸如“rack-1-A1”、“rack-1-A2”、“rack-1-B1”、“rack-1-B2”、“rack-2-A1”等存储位置。

创建存储位置后，您可以将元器件分配给它们，从而轻松跟踪库存的物理位置。存储位置在创建后可以重命名，以更好地反映其内容或用途。但是，无法删除存储位置。相反，您可以归档存储位置，这会将其从视图中隐藏，但仍将其（及其历史记录）保留在数据库中。这确保了有关位置及其关联元器件的历史数据得以保存，以供将来参考或审计。

对多个批次的操作

有关选择和操作多个项目的一般信息，请参阅“使用数据”下的“对多个项目的操作”部分。特定于批次的操作如下所述。

与对多个元器件进行操作类似，您可以对多个批次执行操作。在“元器件”部分，选择“批次”按钮以查看列出库存中所有批次的表格。然后，您可以选择要操作的批次，并使用“已选...”菜单来：

• 移动：将所有选定的批次移动到目标存储位置。
• 调整库存计数：更改选定批次的库存计数以匹配物理库存。
• 取消全选：清除当前选择，而不对选定的批次执行任何操作。

如果您选择移动少于整个批次的数量，该批次将被拆分，PartsBox 将要求您提供有关新创建批次的更多信息。当拆分从构建创建的批次时，新批次将在“构建”选项卡中显示原始构建信息，从而保持完整的可追溯性。

批次管理仅在具有批次控制功能的计划中可用。

存储位置中多个库存批次的操作

有关选择和操作多个项目的一般信息，请参阅“使用数据”下的“对多个项目的操作”部分。特定于库存批次的操作如下所述。

即使在没有批次控制的计划中，您也可以对多批次元器件执行操作。但是，在这种情况下，这些操作只能在存储位置内执行。

要查看存储在某个存储位置的零件，请转到“存储”部分并选择一个存储位置。或者，展开表格中的存储位置行以查看存储在那里的零件列表。选择一个或多个零件并使用“已选...”菜单来：

• 移动：将所有选定批次的元器件移动到目标存储位置。 - 调整库存数量：更改选定批次元器件的库存数量以匹配实际物理库存。 - 取消全选：清除当前选择，不对选定批次执行任何操作。

在具有批次控制的方案中，这些操作将正确跟踪批次。如果您选择移动的数量少于整个批次，该批次将被拆分，PartsBox 将要求您提供有关新创建批次的更多信息。

项目和 BOM

项目

PartsBox 中的项目代表物料清单 (BOM)，即构建电子设备或组件所需的元件列表。每个项目对应一个特定的设计或产品。

项目在 PartsBox 中有多种用途：

• 构建设备：当您准备制造设备时，可以从项目创建构建。这会跟踪生产过程，管理库存水平，并确保您拥有所有必需的元器件。
• 成本估算：PartsBox 计算项目 BOM 的价格，提供总元器件成本的估算。这有助于产品定价决策和生产成本管理。
• 子组件：项目可以代表将合并到更大设备或系统中的子组件。当您完成子组件项目时，制造的物品将作为库存可用，可用作其他项目中的元器件。这种分层方法支持管理具有多个组装级别的复杂产品。

向项目添加元器件

PartsBox 提供了几种方便的方法将元件添加到项目中，使您可以高效地填充物料清单 (BOM)。以下是可用的选项：

• 从元器件表中添加多个元器件
  • 导航到元器件表，该表显示库存中所有元器件的列表。
  • 通过单击每个元器件旁边的复选框来选择所需的元器件。
  • 选择所有必需的元器件后，单击元器件表上方的“选择”菜单。
  • 从下拉菜单中，选择“添加到项目...”。
  • 将出现一个对话框，提示您从现有项目列表中选择目标项目并调整每个元器件的数量。
  • 选择适当的项目并单击“添加”以将选定的元器件包含在项目的 BOM 中。
• 从元器件信息屏幕添加单个元器件
  • 使用元器件表中的搜索或过滤选项找到特定的元器件。
  • 单击元器件以打开“元器件信息”屏幕。
  • 在“元器件信息”屏幕上，找到“添加到项目”按钮。
  • 单击此按钮打开一个对话框，您可以在其中选择目标项目并设置数量。
  • 选择所需的项目并单击“添加”以将元器件包含在项目的 BOM 中。
• 从项目 BOM 部分添加元器件
  • 打开要添加元器件的项目。
  • 导航到项目的 BOM 部分。
  • 单击 BOM 部分内的“添加元器件”按钮。
  • 将出现一个用于搜索和选择元器件的对话框。
  • 使用搜索和过滤选项找到所需的元器件。
  • 单击元器件以选择它，然后单击“添加”以将其包含在项目的 BOM 中。

使用 BOM (物料清单)

导入 BOM

PartsBox 可以从许多 CAD/eCAD 软件包导入 CSV 或 TSV 格式的 BOM（物料清单）。您可以通过创建新项目或导入到任何现有项目中来导入 BOM 条目。

要通过导入现有 BOM 创建新项目，请使用“项目”部分中的“导入”按钮。这将提示上传文件。上传从您的 CAD 程序导出的 CSV/TSV 文件。

PartsBox 将尝试解析您的 BOM 并显示初步结果。请先调整“字段分隔符”和“字符编码”选项，直到 BOM 被正确解析并显示前几个示例行。请确保为您的 BOM 正确设置了“第一行包含列名”复选框。

之后，调整从 BOM 列到 PartsBox BOM 字段的映射。有一个“猜测”按钮，它将使用启发式方法尽力猜测列映射，但请务必仔细检查结果。

一旦您映射了所需的列，导入的 BOM 将显示在列映射表下方。

可用的 BOM 字段选项包括：

• 数量：给定行的数量
• 电子元器件：这是 MPN 或描述电子元器件的名称（如 330R）
• 位号：PCB 上此 BOM 条目的一个或多个位号（'C1'），位号的数量应与数量相对应
• 注释：任何有助于理解 BOM 的注释（仅供参考）
• 封装/外壳：CAD 程序理解的电子元器件封装（仅供参考）
• 电子元器件 ID Anything™ 代码：用于使用 ID Anything™ 自动将 BOM 条目与电子元器件匹配
• 电子元器件 CAD 键：用于使用 CAD 键自动将 BOM 条目与电子元器件匹配
• 不贴片 (DNP)：如果不为空，将为此 BOM 行设置 DNP 标志
• 自定义字段...：将 CSV 列映射到条目自定义字段。选择后，会出现第二个下拉菜单，您可以在其中选择现有的自定义字段名称或输入新名称。CSV 列中的值将作为自定义字段存储在导入的 BOM 条目上。
• 忽略：不以任何方式处理此列

为了节省将来导入的时间，您可以将列映射设置保存为预设，以便以后快速访问。

将 BOM 条目匹配到元器件

将 BOM 导入 PartsBox 后，代表元件的每一行都必须与已创建的特定元件匹配。由于存在歧义和潜在的昂贵错误，无法在导入 BOM 时自动创建元件：许多元件具有相同的名称。如果元件已经创建，可以通过以下几种按顺序尝试的方法自动完成匹配：

• ID Anything™ 匹配：如果导入了包含元器件 ID Anything™ 代码的“元器件 ID Anything™”列，并且 ID Anything™ 代码指向数据库中的元器件，则该条目将被匹配。
• CAD 键匹配：如果导入了“元器件 CAD 键”列，并且 BOM 中的 CAD 键与数据库中某个元器件的 CAD 键匹配，则该条目将被匹配。
• 元器件名称匹配：如果“元器件”列与数据库中恰好一个元器件的本地名称或 MPN 匹配，则该条目将被匹配。如果有多个名称匹配，但其中恰好有一个是元器件组，则首选元器件组。

强烈建议将 ID Anything™ 代码或 CAD 键值存储在 CAD 元件数据库中，并在 BOM 中导出这些代码，以获得快速、轻松和精确的匹配。

未匹配到元件的条目将突出显示。对于这些条目，您可以创建其他元件并重试匹配（见下文），或者打开每个条目并手动进行匹配，在此过程中可能还会创建一个新元件。如果您犯了错误，也可以取消匹配条目。

要重试匹配，您可以选择 BOM 中的部分或全部条目，然后使用“选定 | 匹配条目”菜单选项。这将重试所有选定条目的匹配。如果需要，您也可以取消匹配多个条目。

非元器件条目

BOM 条目不仅限于元器件，还可以代表服务或人工，如 PCB 组装、测试或包装。这些条目可以像元器件一样附带报价，从而可以估算整个生产成本，而不仅仅是元器件成本。服务/人工 BOM 条目的报价与元器件报价类似：支持多个价格分段、MOQ 和过期日期，并且可以用任何支持的货币输入报价。

BOM 错误检查

BOM 条目会经过正确性检查，以帮助避免错误并允许结构化 BOM 编辑。给定行项目的数量必须与位号的数量相匹配。例如，数量为 2 且位号为 C1、C2 的 BOM 条目是正确的，但数量为 2 且只有一个位号 C1 的条目很可能是一个错误。发生这种情况时，PartsBox 会显示警告，这也将使合并包含这些错误的 BOM 条目变得不可能。

合并和展开条目

如果多个条目匹配到同一个元件，通常将其合并为单个条目并相应地调整数量和位号是有意义的。这就是“选定 | 合并条目”选项的作用。如果您选择几个引用同一个元件的条目，您可以将它们合并为一个 BOM 条目。

也可以展开 BOM 条目。数量大于 1 的 BOM 条目可以展开为单个条目，每个条目的数量为 1。例如，如果有一个条目包含 RC0805FR-0710KL，数量为 3，位号为 R1,R2,R3，它可以展开为三个条目：

• RC0805FR-0710KL，数量为 1，位号 R1
• RC0805FR-0710KL，数量为 1，位号 R2
• RC0805FR-0710KL，数量为 1，位号 R3

如果您想单独编辑其中一个条目或将其从构建中排除，这很有用。要展开，请在编辑 BOM 条目时单击“展开条目”按钮，或选择多个条目并使用“选定 | 展开条目...”。

反向操作也是可能的：可以选择多个具有相同元件的 BOM 条目，并使用“选定 | 合并条目...”菜单选项。这将把选定的条目合并为一个 BOM 条目，并合并位号。

合并 BOM 条目时，会对 BOM 替代品执行 AND 运算：所选条目的 BOM 替代品集合的交集将成为合并后条目的替代品集合。

在 BOM 的底部可能会有一个关于多个 BOM 行引用相同元件的警告。这不是问题，PartsBox 只是提供了一种方便的方法来对整个 BOM 执行“合并”操作。如果您点击“全部合并”，所有引用相同元件的多个 BOM 行实例都将被处理并合并。

BOM 替代品

在 PartsBox 中编辑物料清单 (BOM) 时，您可以灵活地为单个 BOM 条目添加元件替代品。此功能允许您指定可与主要元件互换使用的替代元件。在构建、定价或采购时，PartsBox 将主要元件及其所有替代品视为同等有效的选择，从而为您在采购组件时提供更大的灵活性。

BOM 替代品的功能类似于元元件中的成员元件（替代品）和单个元件的替代品。但是，有一个关键区别：BOM 替代品是在特定项目中的每个条目基础上配置的，对该特定条目之外没有影响。这种精细的控制使您能够根据每个项目的特定要求定制替代品。

在合并 BOM 进行采购时，PartsBox 采取保守的方法来处理替代品。如果同一个元器件有两个条目但具有不同的替代品集，PartsBox 将仅考虑替代品的 交集 —— 即两个条目共有的替代品。这确保了只有在所有实例中普遍适用于该元器件的替代品才会被用于采购清单。为了说明这一点，让我们看一个例子。假设您有一个 BOM，其中元器件 A 有替代品 B 和 C，另一个 BOM 中元器件 A 有替代品 B 和 D。在这种情况下，PartsBox 不能假设元器件 A 总是 可以用 B、C 或 D 替代。相反，PartsBox 只能确定元器件 A 可以用 B 替代，因为它是两个 BOM 中唯一的共同替代品。

处理 Altium Designer® CSV 导出错误

已知某些版本的 Altium Designer 在处理其生成的 CSV 文件中的双引号 (") 时存在问题。具体来说，这些版本无法正确转义字段值中的双引号。例如，如果字段包含像 0.156" 这样的值，生成的 CSV 文件将不符合标准 CSV 格式规则，从而导致进一步处理或导入出现问题。

为了解决这个问题，因未转义的双引号而遇到 CSV 文件问题的用户有几个手动更正选项：

• 删除双引号： 一种方法是在文本编辑器中打开生成的 CSV 文件，并手动删除字段内的双引号。
• 双写双引号： 另一种方法是在字段内的每个双引号前加上另一个双引号。根据 CSV 标准，这表示双引号是字段值的一部分，而不是分隔符。此方法保留了原始数据，同时使 CSV 文件符合预期的格式标准。

考虑检查 Altium 的软件更新或补丁，这些更新或补丁可能会在未来的版本中解决此问题，从而减少手动调整文件的需要。

报价

来自供应商/分销商的报价可以附加到元件上，以便在为需要该元件的项目定价时使用。报价可以有多个价格分段，以及有效期（截止日期）、最小订购量 (MOQ) 和订购倍数。

项目定价

估算项目成本是生产过程中的重要一步。PartsBox 通过提供全面的定价功能简化了这项任务。要访问此功能，请导航到您希望定价的项目并选择“定价”选项卡。

打开“定价”选项卡后，您将看到主定价表，其中显示了项目元件及其相关成本的详细分类。该表包括元件名称、制造商、MPN（制造商元件编号）、所需数量和每个元件的单价等信息。

定价选项

构建/批次大小是您想要估算价格的单位数量。为了快速访问，提供了一些常用数量，但可以在输入框中输入任何数量。

总单价和总价以大号字体显示在右侧。旁边的展开按钮允许快速比较整个常见生产数量范围内的定价，而无需手动输入。

如果单价和总价旁边有红色感叹号警告标志，则表示 PartsBox 无法计算定价，因为缺少某些信息。有问题的元件在下面的定价表中以红色突出显示。

元件采购选项允许选择元件的来源。“仅本地库存”将只考虑您已有的元件，使用其平均购买价格进行 BOM 定价。“仅购买”将忽略本地库存，仅使用在线价格和库存信息。“使用本地库存，然后购买”将首先用完所有本地库存，如果不够，再考虑在线报价。

请注意，如果您的库存历史记录不包含价格，那么在尝试将本地库存用于项目/BOM 定价时，您将无法获得正确的定价信息。您可以随时返回并编辑库存历史记录以添加价格。

报价筛选选项允许缩小报价列表的范围：

• “仅首选分销商”复选框将排除不在您首选列表中的分销商的报价（人们很少从地球另一端的分销商那里购买）。您可以在“设置”中修改首选分销商列表。
• “仅授权分销商”将仅考虑由制造商授权转售电子元器件的分销商的报价。
• “仅有库存”将仅考虑分销商表示电子元器件有库存的报价。
• “检查库存水平”更深入一层，实际检查分销商库存的电子元器件数量。一些分销商不提供准确的库存信息，因此选中此项将排除他们的报价。

定价表

定价表是 PartsBox 中 BOM 定价功能的核心组件。它提供了项目中所有元件的全面概览，以及它们的定价信息和采购选项。该表使您能够就项目元件的采购做出明智的决定。

定价表中的关键列包括：

• 批次数量：此列显示构建特定数量的项目或 BOM 所需的元器件数量。它考虑了为每个元器件设置的损耗参数。如果配置了损耗，批次数量可能高于您正在构建的单元数量，以考虑生产期间的预期损失。
• 购买数量：此列指示根据选择的采购选项需要购买的实际数量。例如，如果构建需要 100 个元器件，但您在本地库存中有 25 个可用，并且选择了“使用本地库存，然后根据需要购买”选项，则购买数量将为 75。
• 最佳报价：PartsBox 根据您的偏好和供应商规则（请参阅下面的供应商规则部分）自动为每个元器件选择最佳报价。此列显示当前选择的最佳报价。

定价表提供了使用挂锁图标“锁定”元件特定报价的功能。当报价被锁定时，无论定价或可用性发生任何变化，它都将用于计算总体 BOM 价格。

定价表中的每一行都包含一个“排除”复选框，允许您快速从定价计算中排除某个元器件。当您想查看从 BOM 中移除特定元器件的影响时，这很有用。

要查看有关特定元器件可用报价的更多详细信息，您可以使用左侧的人字形图标展开该行。这将显示该元器件的所有报价列表，包括价格、数量分界点和交货时间。

报价选择

PartsBox 会自动为每个链接到在线身份（制造商元器件编号）的 BOM 条目选择最佳（最便宜）的报价。通常每个元器件有 20-40 个可用报价，选择过程很复杂，需要考虑各种因素：

• 价格折扣，每个报价都不同
• 可用性和库存信息
• 最小起订量 (MOQ)
• 订购倍数
• 多种货币

主 BOM 定价表仅显示每个元件的最佳报价。PartsBox 根据“丢弃多余部分的价格”选择此报价——即假设购买的任何多余库存都将被丢弃时支付的价格。这种方法确保选择最具成本效益的选项，即使所需数量低于最小起订量 (MOQ) 或不是订单倍数的倍数。

例如，如果需要 50 个元件，但 MOQ 为 100，PartsBox 将考虑 100 个元件的价格，假设多余的 50 个将被丢弃。如果由于价格分段，此价格仍然具有竞争力，则可能会被选为最佳报价。矛盾的是，有时买得更多反而更便宜。同样，数量会向上取整到最接近的订单倍数进行比较。

报价的排名以及最佳报价会根据构建数量而变化。这使得能够发现新的、意想不到的元器件来源，这些来源在特定数量下具有成本效益。

展开每个报价会显示更多详细信息：

• 包装
• 订购数量
• 订单的预计到达时间 (ETA)
• 工厂交货时间
• 工厂订购倍数

对于元元件、BOM 替代品或元件替代品，会收集所有分组元件的报价。由于这些元件被认为是可互换的，因此报价会被合并，并从整个池中选择最佳报价。

添加本地报价以进行自定义定价和折扣

除了从主要分销商处采购元件外，通常还会收到其他供应商针对特定数量的定制报价，通常带有折扣价格。PartsBox 允许您输入自己的本地报价，然后在定价过程中将其与在线报价一起考虑和排名，从而适应这种情况。

可以通过两种方式添加本地报价：

• 直接从项目定价表中
• 从特定元器件的元器件信息屏幕中

与在线报价一样，本地报价支持任意数量的多个价格分段，以及最小订购量 (MOQ) 和订购倍数。定价算法在确定给定项目的最佳报价时会考虑这些参数。

添加本地报价时，您可以提供其他信息，例如：

• 订单参考或编号
• 报价日期
• 评论
• 过期日期

过期日期特别重要，因为 PartsBox 将在定价期间自动排除任何已过期的报价。如果报价已过期，则不会被考虑。

创建本地报价后，您可以通过点击报价并使用附件部分将文件附加到其中。这对于存储报价单、电子邮件通信或与报价相关的任何其他文档非常有用。

PartsBox 支持本地报价的所有主要货币。它使用最新的汇率将价格转换为您的首选显示货币，同时保留原始价格和货币以供参考。这使您可以处理来自世界各地不同供应商的报价，而无需手动进行货币转换。

货币处理

PartsBox 简化了货币处理。用户可以在设置中选择其首选货币，整个应用程序中的所有价格都将以该货币显示。这使得在处理定价信息时能够获得一致且个性化的体验。

该软件使用欧洲中央银行 (ECB) 的汇率进行准确的货币转换。这些汇率会定期更新。这消除了手动转换货币的需要，并为用户提供最新的定价信息。

手动输入报价时，您可以从任何支持的货币中进行选择。PartsBox 将自动处理货币转换，以用户首选的货币显示价格。此功能适应来自不同供应商和地区的报价，便于比较和分析定价数据。

将定价导出为 PDF

可以使用表格页脚中的“导出”按钮将定价表格导出为 PDF 文档。导出的 PDF 包括项目信息（名称、描述、日期）、显示预设构建数量的单价和总价的价格与数量摘要表、当前选择的构建数量及其单价和总价，以及包含所有电子元器件及其采购信息的完整定价详细信息表。如果已上传公司徽标（请参阅“组织和访问”部分），它将包含在 PDF 标题中。

供应商规则

供应商规则控制当 PartsBox 为 BOM 条目选择最佳报价时考虑哪些经销商和供应商。通过将规则组织到命名的规则组中，您可以创建灵活的采购策略——例如，首选某些供应商，如果他们没有库存，则退回到其他供应商。规则组可以全局应用，也可以锁定到特定项目和采购列表。

创建和管理规则组

要配置供应商规则，请导航到“设置”并选择“供应商规则”。从那里，您可以：

• 添加组：创建一个带有名称和可选描述的新规则组。
• 删除组：删除不再需要的规则组。
• 设为默认 / 清除默认：将规则组设置或清除为全局默认值。全局默认值在任何地方使用，除非在项目或采购清单级别被覆盖。

管理供应商规则需要“修改供应商规则”权限。

在组内配置规则

每个规则组包含一个有序的规则列表。可以使用向上/向下箭头添加、删除和重新排序规则。

每个规则都有一个 购买自 设置，决定考虑哪些供应商：

• 任何供应商：没有供应商限制 — 考虑所有报价。
• 仅本地报价：仅考虑手动输入的本地报价。
• 这些供应商之一：白名单 — 仅考虑所选供应商的报价。
• 任何供应商除外：黑名单 — 排除所选供应商的报价。

每个规则还可以有一个可选的 规则名称/注释 字段用于文档目的。供应商列表由在您的数据库中具有活动报价的供应商填充。

规则如何处理

组内的规则从上到下处理：

1. 第一条规则应用于可用报价。如果产生任何匹配的报价，则使用这些报价——处理停止。 2. 如果规则未匹配任何内容，则尝试下一条规则。 3. 如果所有规则都未能产生任何匹配的报价，则不选择任何报价，并且该条目显示为未定价。

这创建了一个后备链。例如，具有三个规则的规则组可以实现以下策略：

• 规则 1 — 从LCSC或TME购买（首选低成本供应商） - 规则 2 — 从Mouser购买（备选） - 规则 3 — 从任何供应商购买（最后手段）

如果 LCSC 或 TME 有匹配的报价，则使用这些报价。否则，尝试 Mouser。如果 Mouser 也没有报价，则接受任何可用的供应商。

在项目和采购列表中使用供应商规则

供应商规则选择器出现在项目定价选项卡和采购列表中。它列出了所有可用的规则组，全局默认值注释为“（全局默认）”。选择“无规则（接受所有）”将完全禁用供应商过滤。

因为在规则组之间切换是即时的，所以它们也可以作为购买场景。您可以定义几个代表不同采购策略的组，并在它们之间快速切换，以比较每个策略在提交采购决策之前如何影响 BOM 定价。

使用锁定按钮将特定的规则组固定到项目或采购列表。锁定的规则组（显示为“（本地锁定）”）对该项目或列表保持有效，无论全局默认值如何更改。使用解锁返回遵循全局默认值。

供应商规则选择器也出现在单个电子元器件定价视图中，允许您查看不同的规则组如何影响特定电子元器件的报价选择。

采购清单

采购清单是根据每个项目的物料清单 (BOM) 和指定的构建数量，构建一个或多个项目所需的元件的合并清单。它代表了您需要订购以完成计划构建的组件。

要创建采购清单，请将项目添加到购物车，并指定您打算构建的每个项目的数量。然后，PartsBox 会合并各个 BOM，将组件数量乘以构建数量，并将它们合并到一个列表中。此过程会对跨项目的通用组件进行去重，从而生成您需要购买的所有元件的统一列表。

采购清单提供了您采购需求的清晰概览，使管理库存和规划订单变得更加容易。它考虑了您库存中的当前库存水平，指出了需要订购哪些元器件以及数量。

采购清单中的订单数量可以直接编辑。这对于调整数量以满足最小起订量 (MOQ)、利用价格折扣或向上取整到完整卷盘数量非常有用。

一旦您审查并最终确定了您的采购清单，您可以直接从清单创建供应商订单。PartsBox 帮助您根据您的偏好（如价格、可用性和交货时间）选择最佳供应商。如果需要，您可以将采购清单拆分为多个供应商订单，从而优化您的采购流程并降低成本。

生产

构建

构建代表构建项目的结果。它通常对应于一批已制造或正在制造的设备。PartsBox 支持单阶段和多阶段构建，多阶段构建可以处于进行中（尚未完成）状态。

构建项目

构建是 PartsBox 中用于规划和跟踪生产的一项基本功能。它们允许您检查是否有足够数量的元器件（包括损耗），准备您的构建，生成领料单，并从库存中扣除已使用的数量。

构建还提供可追溯性。根据您的订阅计划，构建历史记录会显示每个构建中使用了哪些特定元器件，并提供不同级别的详细信息。

要访问过去的构建历史记录、查看正在进行的多阶段构建或开始新的构建，请导航到项目中的“构建”选项卡。

开始新构建时，构建表会显示所有项目元器件及其所需数量和可用数量。对于支持元器件损耗计算的计划，所需数量包括损耗开销，这是根据每个元器件的损耗设置单独计算的。应用损耗时，“所需”列以“15 (12+3)”的格式显示细分，显示总所需数量，后跟括号内的基本数量和损耗开销。

对于生产计划及更高版本，您可以使用构建设置中的“禁用损耗？”复选框来禁用构建的损耗计算。禁用后，将使用 BOM 中的确切数量，而不会添加额外的损耗元件。您还可以通过展开条目行并调整该特定条目的损耗设置来覆盖单个 BOM 条目的此设置。

“库存请求”列指示元件将从何处采购。对于存储在多个位置的元件、具有批次控制的元件和元元件，此列可能会显示多个来源。

您可以通过输入数字或使用 +/- 按钮来设置计划构建数量。调整数量会立即更新所有内容。如果某个组件库存不足，该行将以红色高亮显示并带有警告。

PartsBox 在满足需求时使用各种策略：

• FIFO（先进先出）：首先使用最旧的批次（按获取日期排序）
• LIFO（后进先出）：首先使用最新的批次（按获取日期排序）
• 最后访问：首先使用最近访问的批次
• 最大批次优先：首先使用包含最多电子元器件的批次
• 最小批次优先：首先使用最小的批次

您还可以限制 PartsBox 为每个 BOM 条目仅使用单一元件来源。某些计划仅限于单一来源，而在其他计划中，确保完全可追溯性可能很有用。

默认的元器件来源选择策略决定了初始分配，但可以在表格中更改这些分配。每一行都可以展开以显示来源，允许您单独选择并重新排序（受计划限制）。您还可以逐条覆盖使用的数量。

每行都包含一个“排除？”复选框。选中它将从构建中排除该元件（本质上是 DNP - 不贴装）。不会为排除的元件移除库存。

如果某些 BOM 条目的库存不足，PartsBox 将显示警告，但仍允许您继续构建。如果您手头有尚未输入 PartsBox 的额外库存，或者您想生产部分组装的电路板，这将非常有用。最大可用数量将从您的库存中扣除。

单阶段构建

在单阶段构建中，按下“构建并扣除库存”按钮（并确认）将扣除属于该项目的所有非排除元件的库存。构建随后将被标记为已完成。

多阶段构建

对于多阶段构建，请选中“多阶段构建”复选框。PartsBox 将在构建中的每个元件旁边显示选择复选框。您可以使用单独的框来选择行，选择/取消选择所有行，并使用搜索/过滤界面来标记要在当前阶段构建/放置的元件。过滤界面支持标签，因此输入“#smd”是选择所有 SMD 元件的快速方法，这些元件通常首先放置。

按“构建并移除库存”将仅处理选定的条目（与单阶段构建相同）。

执行不选择任何元器件的构建阶段对于记录构建历史中的处理步骤非常有用。

未完成的多阶段构建将出现在构建界面的“进行中”选项卡中。选择它允许您构建下一阶段或完成构建，将其标记为已完成。

一次构建可以有任意数量的阶段。即使并非所有元器件都已放置，也可以将其标记为已完成。在这种情况下，未使用的条目将在构建中标记为已排除。

多阶段构建在所有阶段都由同一个 ID Anything™ 代码表示，允许将 ID Anything™ 标签甚至贴在未完成的设备上，以便快速识别和访问构建信息。

构建配置历史

在管理生产时，维护构建历史记录非常重要。该记录通常包括诸如项目或 BOM 的构建单元数量、构建日期和时间以及任何相关评论等信息。虽然这种详细程度对于简单的生产运行来说已经足够，但更复杂的构建通常需要跟踪额外的数据。

在现实场景中，每个构建都有其独特的配置。此配置包括补充信息，包括：

• 在特定构建中被排除或标记为“不贴片”的电子元器件
• 从构建生成的库存请求，详细说明了从特定位置使用了哪些元器件，或者在批次跟踪的情况下，用于生产运行的确切批次（由序列号标识）

PartsBox 将所有这些信息作为构建历史记录的一部分进行存储，使您能够在将来轻松查看和验证特定构建的配置方式。

要访问构建配置历史记录，请导航至 PartsBox “项目”部分的“构建”选项卡。在这里，您将找到所有构建的列表。您可以选择查看完整列表，或对其进行筛选以仅显示已完成的构建或当前正在进行的多阶段构建。

每次生产都会分配一个唯一的 ID Anything™ 代码，该代码可以打印在标签上并粘贴到该次生产的物理设备上。此代码提供了对生产信息的快速便捷访问，确保您随时可以检索相关详细信息，即使在生产完成很久之后也是如此。

查看使用的库存

查看已完成或正在进行的构建时，左侧导航中的已用库存选项卡显示在该构建期间消耗的库存。“已用库存”表格有两个用途：首先，它显示在构建中使用了或消耗了什么以及它的成本是多少；其次，它允许您管理表格中显示的批次——例如，将它们移动到不同的存储位置、调整它们的库存数量或标记它们。

可用的详细程度取决于是否启用了批次控制。如果没有批次控制，给定存储位置中元器件的库存是可替代的——没有可以单独跟踪或管理的批次概念。因此，无法查看构建中消耗的元器件的确切成本，也无法直接从此视图管理消耗的库存。

对于没有批次控制的计划，“已用库存”表格显示电子元器件名称、已用数量、位号和存储位置。这提供了已消耗内容的摘要。

对于具有批次控制的计划，“已用库存”表格提供了完整的详细信息。默认列包括电子元器件名称、批次名称、已用数量、成本、位号、存储位置以及每个批次中当前剩余的数量。成本跟踪显示已消耗库存的总成本，根据每个批次的单位成本计算得出。您可以展开每一行以查看完整的批次详细信息。

批次控制变体还支持对消耗批次的批量操作：

• 添加/删除标签：使用标签组织消耗的批次
• 设置/重命名/删除自定义字段：管理选定批次中的自定义字段值
• 移动：将批次重新定位到不同的存储位置
• 调整库存数量：重新盘点后修改批次数量

要使用批量操作，请使用复选框选择批次，然后从菜单中选择一个操作。

使用子组件元件

PartsBox 中的子组件元器件代表构建项目产生的库存。构建项目时，相应子组件元器件的库存将按构建数量增加。这允许有效管理由多个子组件和元器件组成的复杂产品，每个子组件均可单独生产或采购。

要为项目创建子装配零件：

• 导航到项目的信息屏幕。
• 单击“创建子装配元器件”按钮。每个项目只需执行一次此操作。

创建后，子组件元器件将出现在元器件列表中，并且可以像任何其他元器件一样进行管理，但有一个例外：子组件元器件的名称始终与相应的项目相同，且无法更改。

构建项目时，构建确认屏幕包含一个选项，用于将库存添加到关联的子装配元器件中。如果启用，您可以：

• 选择将存储构建的存储位置。
• 输入生产的子组件的定价。PartsBox 根据构建期间消耗的元器件计算建议成本：使用批次控制时，成本是准确的（基于特定批次价格），如果不使用批次控制，则根据平均元器件成本估算。建议成本显示在价格字段中，可以在确认前进行调整。对于多阶段构建，在完成构建时输入定价，因为此时实际成本已知。
• 添加与构建相关的评论。

确认后，子装配元件的库存将增加构建数量。由于子装配元件的行为类似于常规元件，因此它们可用于其他项目和构建，并且可以配置低库存警告和损耗参数等功能。

启用批次控制后，项目的每次构建都会产生相应子装配元件的一个独特批次，由唯一的 ID Anything™ 代码标识。通过将 ID Anything™ 标签贴在制造的设备上，您可以使用移动设备快速扫描代码以访问相关的构建信息。

查看构建结果

在查看具有子装配元器件的项目的构建时，左侧导航中的构建结果选项卡显示从该构建创建的最终库存。这与上面描述的“使用的库存”视图类似：使用批次控制，您可以获得完整的每批次详细信息（批次名称、数量、存储位置、注释）和批量操作（标记、移动、调整库存计数）；如果没有批次控制，则显示存储位置、数量和注释的摘要。

使用序列号跟踪单个设备

PartsBox 提供了一个强大的功能，用于跟踪从项目/BOM 构建的单个设备。开始构建时，您可以启用“分别跟踪每个生成的子组件”选项。这将改变构建过程，为构建的每个子组件生成单独的批次，从而有效地为每个设备分配唯一的序列号。

启用此选项为跟踪单个设备的生命周期提供了无限可能。PartsBox 中的批次已经携带了大量数据，并分配了唯一的 ID Anything™ 代码。您可以将额外的数据以文件的形式附加到这些批次中，例如测试结果、维修协议、监管文件、服务历史记录或任何其他相关信息。

每个批次都分配有一个唯一的 ID Anything™ 代码，可以将其打印为二维码并物理粘贴到相应的设备上。这允许轻松识别和跟踪单个设备。或者，可以通过构建 ID Anything™ 代码（指向特定构建）和在该构建内自动分配的整数序列号的组合来识别设备。

当启用多阶段构建的添加子组件元件库存选项时，PartsBox 会跟踪当前正在生产中的库存。这允许您在构建设备时，将有关生产中潜在异常或单个测试结果的信息附加到每个设备批次。完成构建后，库存状态将从“生产中”变为“可用”。

采购

采购

订单

PartsBox 支持三种类型的订单，每种代表采购过程中的不同阶段：

• 未结订单：这些订单处于初始阶段，可以自由修改。您可以添加或删除电子元器件、调整数量，并在最终确定订单之前进行任何必要的更改。未结订单在规划和预算阶段提供了灵活性。
• 已订购：一旦向分销商下达了未结订单，它就会过渡到“已订购”状态。这表明订单已提交并正在等待履行。预期交货日期与订购的物品相关联，允许您跟踪电子元器件计划到达的时间。
• 已接收：当订单中的所有物品都已成功交付和处理后，订单将被标记为“已接收”。这标志着该特定订单的采购过程已完成，并且收到的电子元器件现在在您的库存中可用。

要创建订单或向现有的未结订单添加项目，您可以先查看单个元件的定价和报价，或者使用采购清单。PartsBox 允许您向订单添加单个报价或一组报价，并将它们与提供定价的相应供应商关联起来。

修改未结订单中的数量时，PartsBox 会自动检索当前定价信息，并根据数量和任何适用的价格分段调整总价。这确保您的订单始终拥有最新且准确的定价。

未结订单可以通过复制和粘贴转移到分销商的网站，或者如果需要更正式的打印采购订单，可以以合适的格式导出。

向供应商下订单的最有效方式是利用“上传购物车”功能。这允许您复制并粘贴或上传包含订单详细信息的 CSV 文件。

当您将未结订单标记为“已订购”时，PartsBox 会提示您提供预计交货日期。此信息有助于您跟踪元件预计何时到达，并使系统能够在应用程序的各个相关部分显示已订购的库存。

如果需要，您可以取消订单，这会将其状态恢复为“未结”并从显示中移除预期库存。

PartsBox提供了几种方便的方法来接收订单中的元器件：

• 订单接收界面：此界面允许您只需单击几下即可有效地将订单中的所有或部分元器件接收到单个存储位置。
• 添加库存对话框：查看单个元器件时，您可以使用“添加库存”对话框接收针对特定订单的物品。该对话框根据订单详细信息预先填写数量和价格。
• 条形码扫描：根据经销商的功能，扫描条形码可以显示预先填写数量的“添加库存”对话框，或者在包含 PartsBox 代码的条形码的情况下，直接接收针对特定订单的元器件，自动填充数量、定价和订单信息。

采购清单

在计划生产多个电子设备时，通常需要批量购买元器件。然而，确定所需的确切数量可能具有挑战性，尤其是在考虑现有本地库存和不同BOM（物料清单）之间的共享元器件时。

元元器件（元器件替代品）、元器件备选和 BOM 替代品的存在为采购过程增加了另一层复杂性。在订购之前，保持选择特定 MPN（制造商零件编号）的灵活性是有益的。

要开始采购流程，请导航至“项目”部分，并使用每个项目卡片底部的“添加到购物车”按钮开始将项目/BOM 添加到您的项目购物车。添加项目时，您将有机会指定打算构建的数量。

将所需的项目添加到购物车后，为您的列表指定一个描述性名称，然后单击“创建采购清单”。此操作会将您重定向到“采购”部分，您可以在其中查看所有采购清单。

点击特定的采购清单将打开熟悉的定价界面，类似于用于 项目/BOM 定价 的界面。此界面允许您选择报价、添加您自己的报价、选择特定的元件替代品（对于元元件），并将您的选择限制为首选分销商。

完成采购清单后，切换到“按分销商/供应商分组”视图，即可看到您的元件按每个供应商分成了单独的订单。此视图提供与“所有元件”视图相同的功能，使您能够在需要时修改报价选择。此外，您可以快速将所有元件添加到特定供应商的新订单或现有订单中，并直接向他们下订单。

虽然自动订购支持一直是长期计划的一部分，但由于与各种分销商系统集成的复杂性，其实施仍然具有挑战性。

库存和报告

库存估值

PartsBox 使用添加库存时输入的购买价格计算您的电子元器件库存价值。了解此估值的工作原理有助于财务报告和库存管理。电子元器件来源选择策略（FIFO、LIFO 等——请参阅“构建项目”部分）也会影响估值：在有批次控制的情况下，它决定了将哪些特定批次成本归因于每个构建，而在没有批次控制的情况下，则使用平均成本。

关键指标

对于每个元器件，PartsBox 追踪：

• 采购价值：添加的所有库存支付的总金额。这代表了购买元器件实际花费的资金。
• 平均采购价格：根据输入了价格的所有入库操作计算得出。这是每单位的加权平均成本。
• 总价值：现有库存的估计当前价值，计算公式为：平均采购价格 × 当前库存数量。

使用批次控制进行估值

启用批次控制后，PartsBox 会跟踪每个批次的准确购买价格。这提供了精确的每批次成本信息：

• 每个批次保留其原始购买价格，允许精确的成本跟踪
• 当元件用于生产构建时，成本将根据消耗的具体批次进行归属
• 拆分的批次继承父批次的成本
• 报告显示基于实际批次成本的精确值

这种精确的估值特别适用于：

• 准确的销货成本 (COGS) 计算
• 遵守要求精确库存估值的会计准则
• 跟踪不同采购批次之间的成本差异

无批次控制的估值

如果不使用批次控制，PartsBox 使用平均成本法进行库存估值：

• 一个元器件的所有库存都被视为可替代的（可互换的）
• 平均购买价格是根据所有购买计算得出的
• 当库存被移除时，它按当前的平均价格估值
• 当不需要精确的批次跟踪时，此方法提供了一个合理的近似值

报告

报告允许您获取有关数据的概览信息。

像 PartsBox 中的其他所有内容一样，报告也是实时更新的。例如，如果您保持“低库存”报告打开，并且有人移除了库存（这将导致特定元件的库存低于阈值），您的报告将立即更新。

组织和访问

组织（公司）

PartsBox 通过组织（公司）的概念支持协作。PartsBox 中的公司或组织代表多个用户可以同时访问的共享数据库。这允许团队协同工作，管理其电子元器件库存、采购和生产。

当您在 PartsBox 中创建公司或组织时，您可以邀请其他用户加入并进行协作。可以访问公司数据库的用户数量取决于您的订阅计划。如果您需要容纳更多用户，可以相应地升级您的计划。

要授予某人访问公司数据库的权限，他们必须首先创建一个 PartsBox 帐户。一旦他们有了帐户，公司管理员就可以邀请他们并授予适当的访问权限。这允许您控制谁可以访问您公司的数据以及他们可以执行哪些操作。

除了公司数据库外，每个 PartsBox 用户还有一个供个人使用的免费私人数据库。此私人数据库与您可能有权访问的任何公司数据库是分开的。您可以使用位于 PartsBox 应用程序屏幕顶部的数据库切换器轻松在私人数据库和任何公司数据库之间切换。切换器显示当前所选数据库的名称。

组织可以在“设置”>“常规”中上传公司徽标。该徽标显示在 PDF 导出中，包括表格导出和 BOM 定价 PDF，替换文档标题中的默认 PartsBox 徽标。

访问权限

PartsBox 提供灵活的访问控制选项，以确保用户根据其在公司内的角色和职责拥有适当的权限。一家公司始终至少有一名“管理员”用户，该用户拥有最高级别的控制权，可以管理账单信息并授予或撤销其他用户的访问权限。

对于没有基于角色的访问控制 (RBAC) 的计划，PartsBox 提供三个基本访问级别：

• 管理员：具有管理员访问权限的用户可以完全控制系统。他们可以读取和写入数据库数据、管理用户访问权限、修改计费信息、删除所有数据以及取消订阅。管理员拥有最高级别的责任，应谨慎分配。
• 读/写：具有读/写访问权限的用户可以查看和修改数据库数据，例如创建和更新元器件、存储位置、项目和构建。但是，他们无法管理用户帐户、计费信息或订阅。此级别适用于积极处理库存并需要进行更改的用户。
• 只读：具有只读访问权限的用户可以查看数据库数据，但不能进行任何修改。此级别适用于需要访问信息以供参考但不需要进行更改的用户。

对于具有基于角色的访问控制 (RBAC) 的计划，PartsBox 提供了一种更精细和可定制的访问管理方法。通过 RBAC，公司可以定义任意数量的角色，并根据用户的具体职责将其分配给用户。每个角色定义了单个操作的权限，例如创建元件、添加库存或执行构建。

RBAC 允许对权限进行细粒度控制，使公司能够创建具有受限访问权限的有限角色。例如，可以定义“收货”角色，允许用户添加和移动库存，但不能修改项目或执行构建。此角色适用于负责接收和组织入库库存的员工。

同样，可以创建一个“生产”角色，允许用户根据预定义的项目执行构建，但不能修改项目本身。此角色对于参与制造过程、需要根据既定设计组装产品的员工非常有用。

审计跟踪

在大型组织中，维护所有数据库修改的不可变审计跟踪通常是监管合规性和可追溯性所必需的。这对于受美国 FDA Title 21 CFR Part 11 等法规约束的公司尤为重要，该法规强制要求严格的记录保存和数据完整性。

即使没有法律义务，许多公司也选择实施审计跟踪作为最佳实践，以确保问责制并在出现问题或差异时促进根本原因分析。

具有审计跟踪功能的 PartsBox 计划会自动记录对数据库所做更改的详细历史记录。每条审计跟踪记录包括：

• 修改发生时的精确时间戳
• 负责更改的用户帐户
• 描述修改具体性质的详细数据

此信息提供了数据库随时间演变的全面且细粒度的视图，允许管理员重建事件序列并了解每次更改背后的背景。

审计跟踪数据可以很容易地从 PartsBox 导出为适合数字签名和长期归档的格式。此导出的数据可作为系统历史记录的可验证记录，用于在审计或检查期间证明符合相关法规。

扫描、打印和识别

ID Anything™

PartsBox 中的每个对象——电子元器件、批次、存储位置、构建、订单和项目——都会自动分配一个独特的、紧凑的标识符，称为 ID Anything™ 代码。这些代码足够短，人类可读（26 个字符），并且可以编码为 QR 码以供扫描。

ID Anything™ 代码有几个用途：

• 物理标签：为存储位置、批次、构建或任何其他对象打印 QR 标签。使用移动设备扫描标签可直接将您带到 PartsBox 中的该对象。
• 设备跟踪：使用批次控制构建项目时，每个构建和每个产生的批次都有自己的 ID Anything™ 代码。启用每台设备序列号跟踪后，可以单独识别每个制造的设备，从而实现完整的生命周期可追溯性——从进入其中的元器件到后来附加的现场服务记录。
• 快速访问：每个对象的信息屏幕在右上角显示其 ID Anything™ 代码。单击它以查看 QR 码、打印标签或复制代码。
• CAD 集成：将 ID Anything™ 代码存储在您的 CAD 元器件库中，以便在将 BOM 导入 PartsBox 时获得即时、准确的 BOM 到元器件匹配。

ID Anything™ 系统在整个 PartsBox 中使用。以下部分详细描述了这些功能。

扫描条形码

扫描条形码是处理进货、添加或移除库存以及在 PartsBox 中创建新元件的快速有效的方法。此功能改善了您的库存管理工作流程，节省了时间并减少了手动数据输入。

条形码扫描方法

PartsBox支持两种扫描条形码的方法：

• 外部条码扫描器：对于常规的大批量操作，建议使用专用的条码扫描器。外部扫描器提供更快、更可靠的扫描性能。有关支持的扫描器和设置说明的详细信息，请参阅本手册中的“条码扫描器”部分。
• 内置摄像头：如果您没有外部扫描器，可以使用计算机的内置摄像头扫描条码。虽然不如外部扫描器快，但这种方法对于偶尔的扫描需求很方便。

扫描过程

要开始扫描条形码，请点击 PartsBox 中的“扫描”菜单按钮。根据您的扫描方式：

• 如果使用外部扫描仪，PartsBox 将等待扫描仪输入。
• 如果使用内置摄像头，PartsBox 将显示实时摄像头画面，供您将条形码置于摄像头前。

成功解码条形码后，PartsBox 会分析数据并采取以下操作之一：

• 现有元器件：如果扫描的元器件已存在于您的 PartsBox 数据库中，您将看到为该元器件添加库存、移除库存或移动库存的选项。
• 新元器件：如果扫描的元器件不存在于您的数据库中，PartsBox 将提示您创建一个新的链接元器件。它将提供匹配的在线元器件列表供您选择。选择匹配项并创建元器件后，将出现“添加库存”对话框，允许您为新创建的元器件添加新收到的库存。

支持的条形码

PartsBox 支持电子元件分销商常用的多种条形码格式：

• 2D 条形码：
  • 包含使用 ISO/IEC 15434:2006 编码的 ANSI MH10.8.2 数据的 DataMatrix 和 PDF417 条形码（由 DigiKey、Würth 和其他转向 2D 条形码的经销商使用）。
  • 来自某些经销商（LCSC 和 TME）的 QR 码。
  • ID Anything™ 代码
• 1D 条形码：
  • 来自 DigiKey、Mouser、Farnell、RS Components 和大多数其他在条形码中编码制造商元器件编号 (MPN) 的条形码。

如果扫描的条形码包含数量信息，它将自动预填充在“添加库存”对话框中。

DigiKey 订单

如果您在 PartsBox 中创建了 DigiKey 订单并将生成的 ID 代码复制到您的 DigiKey 购物车中，那么您收到的元器件上的条形码将包含 PartsBox ID。扫描这些条形码时，PartsBox 将自动识别关联的订单和行项目，使您可以轻松地根据订单接收元器件。

标签打印

您可以直接从 PartsBox 打印元件、批次、存储位置、订单、项目和构建的标签。有一个模板系统允许您根据需要自定义标签。

直接标签打印需要什么：

• Zebra标签打印机，或任何其他可以解释ZPL（Zebra打印机语言）的打印机。任何支持ZPL的Zebra打印机都可以使用，因此请根据您的需求选择一台。请注意：某些Zebra打印机仅支持EPL，不支持ZPL，这些打印机将无法与PartsBox配合使用。 - 在连接打印机的计算机上本地安装JSPrintManager。JSPrintManager适用于Mac、Windows、Linux和Android。您可以免费下载JSPrintManager。

需要 JSPrintManager 的原因是因为浏览器无法直接访问打印机。为了向打印机发送原始代码，PartsBox 需要连接到本地的 JSPrintManager 并要求它将数据发送到打印机。

打印机配置

如果您满足前提条件，转到“设置 | 标签 | 打印机”应该会显示系统中可用的打印机列表。在那里选择您的 ZPL 兼容标签打印机。

标签模板

有多个标签类别：元件、批次、存储位置、订单、项目和构建。在每个类别中，PartsBox 允许您定义多个标签模板。这使您可以快速在各种标签类型或尺寸之间切换。在商业计划中，标签模板在整个公司内共享。

要创建新的标签模板，请导航至“设置 | 标签”并选择其中一个类别。如果您点击所选类别中的“创建”，您将看到一个预先填充了示例标签的模板。这些示例经过精心准备，作为 2.25x1.25 英寸标签的默认设置非常合适（是的，Zebra 仅以英寸为单位指定标签尺寸，即 57.15mm x 31.75mm）。

在标签模板表单的左侧，您将看到：

• 标签名称：选择一个能让您快速记住标签用途的名称 - 标签模板ZPL代码：这是用于生成标签的ZPL代码所在的位置。我们建议使用Labelary Viewer来编写和测试您的标签代码，因为它具有出色的在线文档，只要将光标放在ZPL命令上就会显示。您希望用PartsBox数据填充的数据字段应使用大括号中的数字进行标记。字段编号从0（而不是1）开始，因此第一个字段使用{0}，第二个字段使用{1}，依此类推。PartsBox在生成标签时会将这些标记替换为实际数据。 - 标签宽度和标签高度：这些是标签尺寸，以英寸为单位。这些必须与您的实际标签纸尺寸相匹配。 - 每毫米点数：您将打印的分辨率，这取决于您的打印机。 - 示例预览：如果您的模板已准备就绪，您可以点击“生成”以使用数据库中的随机对象显示标签的预览图像。如果您的打印机已配置并准备好打印，您也可以尝试测试打印标签。

在标签模板表单的右侧有一个“字段”部分。这列出了模板中的数据字段（用花括号中的数字标记）。PartsBox 会根据模板中使用的最大数字自动检测字段。例如，如果您在模板中使用 {0}、{1} 和 {5}，您将有 6 个字段需要配置（字段 0 到 5）。对于每个字段，您可以选择任何可用的 PartsBox 数据字段。我们建议通过键盘输入进行搜索，因为有许多 PartsBox 数据字段可供选择。

点击“保存”后，您的模板即可使用。

打印标签

一旦您选择了打印机并创建了至少一个标签模板，您就可以为 PartsBox 中的任何对象打印标签。

要打印标签，请打开要标记的对象的详细信息屏幕。对于元件，这是元件信息屏幕；对于存储位置，则是存储位置信息屏幕；其他对象以此类推。在信息屏幕的右上角，找到 ID Anything™ 按钮，它显示一个小二维码图标和 ID Anything™ 代码的简短版本。点击此按钮将打开一个对话框，其中显示模板选择器、标签预览和“打印标签”按钮。

条形码扫描枪

PartsBox 支持生成按键的条形码扫描仪，其中包括大多数 USB 扫描仪。Zebra LS2208 是一款可靠且价格实惠的 1D 扫描仪，与 PartsBox 配合良好。然而，随着元器件分销商越来越多地采用具有卓越数据存储容量的 2D 条形码，建议使用 2D 扫描仪以适应未来的需求。

要将 2D 扫描仪与 PartsBox 一起使用，您必须将其配置为将特殊的不可打印字符（ASCII 代码 RS、GS 和 EOT）分别替换为字符串 '{RS}'、'{GS}' 和 '{EOT}'。这是扫描仪与基于 Web 的应用程序正常工作所必需的。如果您有 Zebra DS2208 扫描仪，只需扫描提供的条形码即可自动将其配置为与 PartsBox 一起使用：

支持的扫描仪

任何支持 USB HID 接口（即充当键盘）的 1D 扫描仪都应该适用于 PartsBox。如果扫描仪的输出在文本编辑器中可见，则它与 PartsBox 兼容。

已知能与 PartsBox 良好配合使用的 2D 扫描仪包括：

• Zebra DS2208
• Zebra DS2278（DS2208 的无绳版本）

已知 Zebra DS6608（2007 年停产）无法与 PartsBox 配合使用。

要在 PartsBox 中使用 2D 扫描仪，扫描仪必须支持扫描代码中的字符串替换（在 Zebra 扫描仪中称为“高级数据格式化”或“ADF”）。这是 Web 浏览器的限制，而不是 PartsBox 的限制。

为了获得最佳的条形码扫描体验，PartsBox 建议使用专用的 2D 扫描枪，特别是 Zebra DS2208。2D 扫描枪可以解码 1D 和 2D 条形码，确保与分销商使用 2D 条形码的增长趋势兼容。

一个更实惠的替代方案是 Barcode to PC 应用程序，它由安装在 PC 上的软件和用于扫描的移动应用程序组成。虽然此解决方案目前无法可靠地处理 DataMatrix 代码，但预计将来会有所改进。

已知问题和限制

• 如果您使用非美国键盘布局，则需要进行额外的扫描仪设置。扫描PartsBox设置条形码后，从扫描仪随附的手册中扫描您的键盘布局的区域代码。 - 在Windows上的Firefox中，扫描可能无法可靠工作。强烈建议使用其他浏览器，例如Chrome或Edge。

故障排除

由于 PartsBox 无法控制的因素，使用 USB 扫描仪进行条形码扫描时无法保证 100% 的可靠性。

如果 2D 扫描仪无法与 PartsBox 一起使用：

• 在记事本等文本编辑器中检查其输出
• 扫描 2D 条形码并验证结果是否包含 '{RS}'、'{GS}' 和 '{EOT}' 序列
• 如果缺少这些序列，请确保扫描仪配置为特殊代码替换
• 如果使用非美国键盘布局，请从扫描仪手册中扫描相应的区域设置代码

请参阅上面的“已知问题和限制”部分，看看您的问题是否列在其中。如果扫描仪在记事本中的输出看起来正确，但 PartsBox 仍然无法识别条形码，请使用反馈表报告问题。

发布您的元器件数据库

PartsBox 允许您将您的元器件数据库设为公开，与他人分享您的部分或全部元器件。此功能对于希望分享其元器件库存的业余爱好者，以及希望展示可用组件的创客空间非常有用。

设置您的公共页面

要发布您的元器件，请导航至 设置 | 发布 部分。在这里，您可以输入关于您自己或您的组织的信息，例如简介、URL 和详细描述。此信息将显示在您的公共页面上。

请注意，只有当您选择了要发布的元件时，您的公共页面才会存在。公共页面的更新不是即时的，可能需要几分钟到一小时不等。

选择要发布的电子元器件

PartsBox 提供了三个选项来选择要公开显示的元件：

• 无：如果您不想发布任何电子元器件，请选择此选项。您的公共网页将不存在。
• 符合过滤条件的电子元器件：使用“编辑过滤器”按钮根据电子元器件数据创建过滤器。只有通过过滤条件的电子元器件才会被发布。一种常见的方法是使用基于标签的过滤。例如，您可以设置一个过滤器，仅发布带有“public”标签的电子元器件。
• 您的所有电子元器件：选择此选项以公开您的整个电子元器件数据库。

通过仔细选择要发布的元件，您可以控制与他人共享的信息，同时保持其他数据的私密性。

与 CAD 工具集成

KiCad 集成

PartsBox 与 KiCad 7.0 或更高版本集成，允许您直接在 KiCad 的符号选择器中访问 PartsBox 元件数据。此集成使用 KiCad 的 HTTP 库功能。

KiCad HTTP 库充当 PartsBox 等外部数据源的只读接口。它们本身不存储符号或封装数据，而是引用标准 KiCad 库（.kicad_sym）中定义的符号和封装。当您在 KiCad 中从 PartsBox HTTP 库中选择一个组件时，它会使用来自 PartsBox 的数据填充原理图符号，例如制造商零件编号 (MPN)、值、封装和其他指定字段。

PartsBox 中的配置

要在 PartsBox 中配置 KiCad 集成：

• 导航到“设置”。
• 选择“CAD 集成”选项卡。
• 从左侧菜单中选择“KiCad”。

配置分为以下几个部分：

常规选项

• 应用于所有电子元器件的初始过滤器：此过滤器限制了您的数据库中哪些电子元器件可能对 KiCad 可用。只有匹配此过滤器的电子元器件才会被考虑包含在类别中。您可以编辑过滤条件或将其重置为默认值（无过滤器）。显示通过此过滤器的电子元器件计数。

类别

类别定义了您的元件数据库的子集，这些子集将在 KiCad 符号选择器中显示为单独的可浏览部分。

• 默认的“所有电子元器件”类别包括通过初始过滤器的所有电子元器件。
• 您可以使用过滤器创建自定义类别。例如，您可以为“电阻器”、“电容器”或“连接器”创建类别。
• 对于每个类别，您定义一个名称、一个可选描述和过滤条件。
• 显示每个类别中的电子元器件数量。

字段

此部分控制 PartsBox 元件数据如何映射到 KiCad 符号字段。

• PartsBox 为常见字段（如 MPN、制造商、数据手册 URL 以及每个元器件配置的特定 KiCad 字段）提供默认映射。
• 您可以自定义这些映射：
• 添加从 PartsBox 字段（包括标准字段、自定义字段、规格和特定 KiCad 字段）到 KiCad 字段的新映射。
• 指定 KiCad 字段名称。标准 KiCad 字段包括 Value、Footprint、Datasheet、Keywords、Reference、MPN、Manufacturer。您还可以定义自定义字段名称。
• 选择该字段默认情况下是否应在原理图中可见。
• 某些映射是内置的，无法更改。symbolIdStr 映射至关重要：它告诉 KiCad 从您的标准 KiCad 库中使用哪个符号。这始终映射到 PartsBox 中的“[元器件] KiCad 符号”字段。
• ID Anything™ 用于将导入的 BOM 与元器件匹配，并始终映射到 KiCad“PartsBox ID”字段。
• ID Anything™ URL 用于快速跳转到 PartsBox 中的元器件信息页面（可以在其中访问数据手册），因此它始终映射到 KiCad“datasheet”字段。这使您可以在 KiCad 中按“d”以在 PartsBox 中打开元器件信息页面。
• 建议将 Footprint 映射到“[元器件] KiCad 封装”，将 Reference 映射到“[元器件] KiCad 参考”。

KiCad 配置

本节提供 KiCad 所需的配置文件。

• PartsBox 生成 .kicad_httplib 文件的内容。
• 此文件包含 KiCad 连接到 PartsBox API 所需的信息，包括 API 端点 URL 和您的唯一访问令牌（API 密钥）。
• 您可以将配置文本复制到剪贴板或将其下载为文件。

KiCad 中的配置

要在 KiCad 中启用 PartsBox 库：

• 将上一步中生成的配置保存到名为 partsbox.kicad_httplib 的文件中（或任何带有 .kicad_httplib 扩展名的名称）。
• 将此文件放在 KiCad 可访问的位置，例如 KiCad 库目录或自定义位置。
• 在 KiCad 中，转到“首选项”->“管理符号库...”。
• 在“符号库”对话框中，点击“+”按钮或“添加库”。
• 导航到并选择您保存的 partsbox.kicad_httplib 文件。
• （可选，推荐）命名该库，使其在符号选择器中出现在其他库之前，例如“*PartsBox Library”。
• 确保该库已启用（选中复选框），然后点击“确定”。

PartsBox 库现在将出现在 KiCad 符号选择器中。您可以浏览定义的类别并选择元件。

设置每个元件的 KiCad 字段

为了使集成正常工作，PartsBox 需要知道将哪个 KiCad 符号、封装和位号前缀与每个元件相关联。这是在元件详细信息视图中配置的：

• 在 PartsBox 中打开特定电子元器件的详细信息页面。
• 转到左侧的“电子元器件设置”选项卡。
• 找到“CAD/PLM 数据”部分。
• 填写以下字段：
• KiCad 符号： 完整的 KiCad 符号名称，包括库别名（例如，Device:R，MyLibrary:MySymbol）。此值将映射到 KiCad 中的 symbolIdStr 字段。
• KiCad 封装： KiCad 封装名称，包括库别名（例如，Resistor_SMD:R_0603_1608Metric）。
• KiCad 参考： 默认参考位号前缀（例如，R，C，U）。

保存这些设置使其可通过 API 供 KiCad 在选择元件时使用。

将来，将有一种方法可以一次为多个选定的元件设置这些字段（例如，选择所有带有“电阻器”标签的元件并将其 KiCad 引用设置为“R”）。

数据交换和缓存

• 当您在 KiCad 中打开符号选择器时，它会从 PartsBox 获取类别列表以及当前所选类别中的元器件。
• 出于性能原因，KiCad 会缓存类别列表。在 PartsBox 中对类别定义的更改可能需要重新启动 KiCad 才能可见。
• 当您在符号选择器中选择特定元器件时，KiCad 会使用“字段”配置中定义的映射从 PartsBox 请求该元器件的详细信息。
• 此详细信息填充放置在原理图上的符号的字段。

与 Altium Designer® 集成

您可以让您的 PartsBox 库在 Altium Designer 中可访问。您的符号和封装仍将保留在 Altium 中，而有关元器件的所有其他数据将从 PartsBox 访问。由于 Altium Designer 传统的 ODBC 数据库连接要求，与 Altium Designer 的集成配置稍微复杂一些。

您需要在您的机器上运行 PartsBox Outpost™。它是一个应用程序，提供与您的在线 PartsBox 数据库的实时同步，并提供 Altium Designer 可以连接的 SQL 接口。Outpost™ 以 Docker 容器的形式发布。目前，同步仅是单向的，因此无法从 Altium 内部更改您的 PartsBox 数据库，但这在未来可能会改变。

先决条件：

• PostgreSQL ODBC 驱动程序
• Docker Desktop

首先安装 PostgreSQL ODBC 驱动程序。然后，安装 Docker Desktop，并从 Docker Hub 下载 jrychter/outpost:latest 镜像。

在 Docker Desktop 中，点击“Images”部分中镜像名称旁边的运行图标。然后打开“Optional settings”部分。

在“端口”部分，输入 5432 作为对应于 :5432/tcp 的主机端口。

在“环境变量”部分，创建两个环境变量：

• PARTSBOX_API_KEY：这应包含您的 PartsBox API 密钥
• POSTGRES_PASSWORD：您将在 Altium Designer 中用于连接到数据库的数据库密码

点击“运行”按钮，您应该会在“容器”部分看到一个正在运行的容器。如果您点击该容器，您可以检查日志以查看是否有任何异常消息。

之后，您可以在 Altium 中创建一个 DbLib 或 DbLink（有关这两者之间差异的详细信息，请参阅 Altium Designer 文档）。从主菜单中选择“File | New | Library”，然后选择“Database Library”。

在“连接源”部分，选择“使用连接字符串”。然后配置以下连接字符串： Driver={PostgreSQL Unicode};Server=localhost;Port=5432;Database=postgres;UID=postgres;PWD=YOUR_PASSWORD_HERE

请确保使用与启动 Docker 容器时相同的数据库密码。另外，请确保连接字符串末尾没有空格。

点击“Advanced”（高级）按钮。在 SQL 选项中，将左引号和右引号字符更改为双引号 (")，并保持“Quote Tables”（引用表）选项为选中状态。

点击“连接”。您应该会看到数据库字段出现在字段设置正下方的表格中。

在“字段设置”部分，选择“单键查找”，对于“数据库”字段，选择“PartsBox ID”。

此时，您应该拥有一个工作正常的数据库连接，并自动映射了基本字段。您可能希望保存此数据库。

如果连接失败并显示错误消息，需要检查的一件事是连接字符串中引用的 ODBC 驱动程序的名称。要列出计算机上的所有 ODBC 驱动程序，您可以使用 Windows PowerShell 和以下命令：Get-OdbcDriver。然后，您将在连接字符串中使用列出的驱动程序之一的相应驱动程序名称。

API

PartsBox 提供了一个 API，用于以编程方式访问您的元器件数据库。API 是面向操作的：它不直接公开数据库对象，而是提供用于管理元器件、库存、存储位置、项目、BOM、订单、构建、批次等的特定操作。这使得能够与 ERP、MES 或自定义工具等其他系统集成。

API 使用 JSON 进行请求和响应（以 EDN 作为替代），并使用 API 密钥进行身份验证。要生成 API 密钥，请转到您组织中的设置。

有关完整文档，包括可用操作、请求/响应格式和示例，请参阅 API 文档。