分类： 字段类型

创建自定义链接字段

链接字段是链接到另一个文档类型的字段。例如，客户字段在销售订单中就是一个链接字段。该字段链接到客户主数据。

您可以按照以下步骤插入自定义链接字段。

步骤 1：前往自定义表单

首页 > 自定义 > 表单自定义 > 自定义表单

步骤 2：选择表单

在自定义表单中，选择文档类型（报价单、销售订单、采购发票项目等）。一旦下方附表中的字段更新后，打开您希望插入自定义字段上方的字段。然后点击“在上方插入”以插入新的自定义字段。

步骤 4：自定义字段值

要将字段设置为链接，请输入以下值。

  1. 标签：用户希望在表单中显示的标签。
  2. 类型：设置为“链接”
  3. 名称：字段的名称
  4. 选项：输入字段所链接的文档类型的名称

注意：此功能将从版本 15 及以上版本可用。

Frappe 提供了一种用户友好的方式，通过表单构建器对链接字段应用筛选器。

您会注意到，在文档类型中的所有链接字段上都有一个操作图标，它为您提供了选择要应用的筛选器的选项。

例如，在“公司”的情况下，点击该图标将打开一个对话框，您可以在其中选择所需的筛选器。

一旦您做出选择并点击应用，筛选后的结果将相应显示。

如果您正在自定义表单并决定更改筛选器，将出现一个“重置为默认值”按钮。点击此按钮会将筛选器恢复为原始状态。但需要注意的是，“自定义表单”中的任何筛选器都将覆盖默认筛选器。

评估支持

用户可以根据表单中的某些值添加动态筛选器。

用法：

eval: doc.fieldname

或

eval: doc.fieldname1 + doc.fieldname2

对于子表：
可以添加两种类型的筛选器。

  • 来自子表行：要添加这些筛选器，请使用 doc.child_table_field_name
  • 来自父文档：要添加这些筛选器，请使用 parent.parent_doc_fieldname

在“eval:”之后添加的表达式会被评估，并返回其值。

Note: Filters applied through frm.set_query, will take preference over filters applied via the User Interface (UI).

签名字段

在 ERPNext 中，可以使用签名（Signature）字段类型创建电子签名。该字段允许您在一个区块中书写签名，就像在纸上签名一样。

要创建电子签名，请按照以下步骤操作：

  1. 打开 DocType 并进入自定义表单。
  2. 在表单视图或字段表中，创建一个名为“签名”的新字段，并将字段类型选择为 签名。

  1. 点击更新。
  2. 刷新页面并输入您的签名。

动态链接字段

动态链接字段是一种可以搜索并保存任何文档类型值的字段。让我们通过一个例子来了解动态链接字段的工作原理。

在创建商机或报价时，我们必须明确指定它是针对潜在客户还是客户。根据我们的选择（潜在客户/客户），会显示另一个链接字段，我们可以在其中选择实际的潜在客户或客户。

如果您将前一个字段（即选择实际潜在客户或客户的字段）设置为动态链接，那么后一个字段将自动链接到第一个字段中选择的主数据，即潜在客户或客户。因此，我们无需为客户和潜在客户分别插入单独的链接字段。

以下是插入自定义动态字段的步骤。例如，我们将在日记账中插入动态链接字段。

首先，我们将创建一个链接字段，该字段将链接到文档类型。

选项字段中提到的文档类型，指的是父文档类型。就像报价是一种文档类型，其下包含多个报价记录一样。同样，文档类型本身也是一种文档类型，其下创建了销售订单、采购订单和其他文档类型作为文档类型记录。

文档类型

—- 销售订单

—- 采购发票

—- 报价

—- 销售发票

—- 员工

—- 工作订单

… 等等。

因此，将此字段与父文档类型链接将列出所有文档类型记录。

此自定义字段的类型将为“动态链接”。在选项字段中，将指定文档类型链接字段的名称。

此字段将允许根据在文档类型链接字段中选择的值来选择文档 ID。例如，如果我们在前一个字段中选择销售订单，则动态链接字段将列出所有销售订单的 ID。

自定义文档类型链接字段中的选项

默认情况下，文档类型链接字段将提供所有表单/文档类型供选择。如果您希望此字段在搜索结果中显示某些特定的文档类型，则需要为其编写自定义脚本。

表格多选字段

表格多选字段与链接字段非常相似。主要区别在于，表格多选字段允许您选择多个值。

让我们通过一个示例来理解这一点。假设您想将待办事项分配给多个用户，如下所示：

您可以通过以下步骤添加表格多选字段：

步骤 1：创建子文档类型。

创建一个新的文档类型，启用“是子表”和“可编辑网格”复选框，并添加一个类型为“链接”的字段，如下所示。

将链接字段设置为必填。确保子表中的字段已勾选“在列表视图中显示”。

步骤 2：添加类型为“表格多选”的字段。

创建一个类型为“表格多选”的字段，并在“选项”中添加第一步中创建的文档类型。

您可以通过点击选定值旁边的叉号，或将光标放在该值旁边并按退格键，来移除任何选定的值。

此字段允许每个值仅被选择一次。

注意：表格多选字段不能添加到子文档类型中。

地理位置字段

“地理位置”字段用于捕获和存储地理坐标，例如纬度和经度。

这可用于多种用途，例如跟踪资产、员工或事件的位置。地理位置数据有助于在ERP系统中映射和可视化各种实体的地理分布。

以下是关于ERPNext中地理位置字段的几个关键点：

  1. 存储坐标：地理位置字段通常存储纬度和经度值，这些值代表地球表面上的一个特定点。
  2. 在模块中的使用：此字段可用于与位置信息相关的不同模块。例如，它可以在资产模块中用于跟踪资产的物理位置，或在员工模块中用于记录员工的位置。
  3. 与地图集成：地理位置数据可以与地图服务（如谷歌地图）集成，以提供位置的视觉表示。这对于路线规划、现场访问和物流管理非常有用。
  4. 自动捕获：某些实现允许使用支持GPS的设备自动捕获地理位置数据，确保准确和实时的位置跟踪。
  5. 自定义：ERPNext支持自定义，因此可以根据组织的特定需求将地理位置字段添加到自定义表单和文档类型中。

字段类型

以下是您在创建新字段或修改标准字段时可以定义的字段类型。

链接字段连接到另一个主数据，并从中获取数据。例如，在报价单主数据中，客户是一个链接字段。要了解更多信息，请点击此处。

动态链接字段是一种可以搜索并保存任何文档/文档类型值的字段。点击此处了解动态链接字段如何工作。

复选框

这将使您能够在此处拥有一个复选框。

选择

选择将是一个下拉字段。您可以在选项字段中添加多个结果，每行一个。

表格

表格是一种链接字段，它在当前表单中呈现另一个文档类型。例如，销售订单中的项目表格是一个表格字段，它链接到销售订单项目文档类型。

附件

附件字段允许您从文件管理器中浏览一个文件并将其附加在此处。

附件图片

附件图片是一个字段，您可以在其中附加 jpeg、png 等格式的图片。这将成为代表该特定文档类型的图片。例如，如果您希望在项目文档类型中显示项目图片，您可以将字段选择为附件图片字段。

文本编辑器

文本编辑器是一个文本字段。它具有文本格式化选项。在 ERPNext 中，此字段通常用于定义条款与条件。

日期

此字段将使您能够在此字段中输入日期。

日期和时间

此字段将为您提供一个日期和时间选择器。默认设置为当前日期和时间（由您的计算机提供）。

条码

在此字段中，您可以将字段指定为条码，这将允许您输入条码编号。一旦您这样做，系统将自动根据该编号生成条码。

按钮

这种字段将是一个操作按钮，例如保存、提交等。

代码

如果字段类型选择为代码，您将能够向该字段输入代码。

颜色

您将可以选择为此表单指定颜色。

列分隔

由于 ERPNext 具有多列布局，使用列分隔，您可以将一组字段最多分为两列。

货币

货币字段保存数值，例如项目价格、金额等。货币字段的值最多可以保留六位小数。此外，您可以为货币字段显示货币符号。

数据

数据字段将是一个简单的文本字段。它允许您输入最多 140 个字符的值，使其成为最通用的字段类型。要为电子邮件、姓名或电话号码输入启用验证，请在设置 > 文档类型中将选项设置为”电子邮件”、”姓名”、”电话”。

浮点数

浮点数字段保存数值，最多保留九位小数。浮点数字段的精度通过设置精度来设定

设置 > 设置 > 系统设置

该设置将应用于所有浮点数字段。

地理位置

使用地理位置字段存储 GeoJSON feature_collection。存储多边形、线和点。它在内部使用以下自定义属性来标识圆形。

阅读地理位置字段以了解更多信息。

HTML

当您希望数据以 HTML 格式输入时，您可以选择该字段为 HTML 字段。

图片

图片字段将渲染在另一个附件字段中选择的图片文件。

对于图片字段，在选项（在文档类型中）下，应提供一个字段名称，其中附加了图片文件。通过引用该字段中的值，图片将成为图片字段中的引用。

整数

整数字段保存数值，没有小数位。

小文本

小文本字段保存文本内容，并且比数据字段具有更多的字符限制。

长文本

当您希望输入具有无限字符限制的数据时，您可以将字段定义为长文本字段。

文本

此字段类型允许您在字段中添加文本。小文本、长文本和文本字段中的字符限制将根据关系数据库管理系统确定。

Markdown 编辑器

此字段允许您以标记语言添加文本。

密码

密码字段将包含解码后的值。

百分比

您可以将字段定义为百分比字段，在后台它将计算为百分比。

评分

您可以将字段定义为评分字段，在后台它将计算为评分。

只读

只读字段将保存从另一个表单获取的数据，这些数据不可编辑。如果其值的来源是预先确定的，您应将字段类型设置为只读。

节分隔

分段用于将表单划分为多个部分。

签名

您可以将字段定义为签名字段，在此字段中添加数字签名。

表格多选

这是“链接”类型和“表格”类型字段的组合。与带有“添加行”按钮的子表不同，您可以在一个字段中选择多个值。

时间

这是一个时间字段，您可以在该字段中定义时间。

持续时间

如果您想定义一个时间段，可以使用持续时间字段。

如果您不想以天或秒为单位跟踪持续时间，可以在表单中分别启用“隐藏天数”和“隐藏秒数”选项。

这是进行上述更改后持续时间字段的外观。