“数据库”Functoid
数据库 functoid 从数据库中提取数据以用于输出实例消息。
概述
下面是 数据库 functoid 及其使用方式的列表：
数据库查找。 使用 数据库查找 functoid 从数据库中提取信息，并将其存储为 Microsoft ActiveX 数据对象 .NET (ADO.NET) 记录集。 此 functoid 需要按以下顺序排列的四个输入参数：
查找值
数据库连接字符串
表名称
查找值的列名。
错误返回。 使用 “错误返回” functoid 捕获运行时发生的错误信息，例如数据库连接失败。 此 functoid 需要一个输入参数： 来自数据库查找 functoid 的链接。
格式化消息。 使用参数替换并且可能使用 ID 和值的交叉引用返回格式化的本地化字符串。
获取应用程序 ID。 检索应用程序对象的标识符。
获取应用程序值。 检索应用程序值。
获取公用 ID。 检索公用对象标识符。
获取公用值。 检索公用值。
删除应用程序 ID。 删除应用程序值。
设置通用 ID。 设置和返回公用对象的标识符。
值提取程序。 使用 值提取程序 functoid 从 数据库查找 functoid 返回的记录集中的指定列中提取数据。 此 functoid 需要两个输入参数：一个指向 数据库查找 functoid 的链接和一个列名。
其中七个 数据库 functoid（ 格式化消息、获取应用程序 ID、 获取应用程序值、 获取公共 ID、 获取公共值、 删除应用程序 ID 和 设置通用 ID）是 CrossReferencing functoid。 这些 functoid 可以将输入消息中的 ID 和值翻译为输出消息中所需的 ID 和值。 有关详细信息，请参阅 UI 指南中的数据库 Functoid 参考和开发人员 API 命名空间参考。
示例
以下示例使用一些 数据库 functoid。 假设有一个大型零售制造商，在很多地方都设有商店。 为了跟踪商店，总部为每个商店分配一个名为 StoreID 的唯一代码。 此外，总部将以下信息与每个 StoreID 相关联：
StoreName
StoreAddress
城市
邮政编码
StorePhoneNumber
StoreManager
这些信息都存储在一个数据库中，并且会定期分发给贸易合作伙伴。 对于该制造商来说，所有采购活动都是总部完成的，而不是各个商店。 当总部向贸易合作伙伴发送采购订单后，一般会有多个商店可以收到通过该采购订单订购的商品。 总部不发送要接收商品的每个商店的名称和地址信息，而只是发送 StoreID。 若要在高级发货通知中插入名称和地址信息，贸易合作伙伴使用 数据库 functoid 自动将此信息插入到输出实例消息中。 下图显示了贸易合作伙伴如何在映射中实施 StoreID 替换：
在该图中，源架构代表传入采购订单；目标架构则代表提前发运通知。 数据库查找 functoid 从相应的数据库表中查找相应的记录。 值提取程序 functoid 从查找记录中提取相应的列。 如果运行时) 出现错误 (（例如连接失败），则 错误返回 functoid 会输出一个包含错误信息的字符串。
在前面的示例中，第一个输入参数取自传入采购订单的 StoreID 字段，其余三个输入参数是在数据库查找functoid 的“配置 <Functoid>”对话框中配置的常量。 也可以创建源自源架构的链接，以便为全部四个输入参数提供值。
注意
不能使用某些 Microsoft SQL Server数据类型（如文本、ntext 和图像）作为数据库查找 functoid 的查找值。 该 functoid 需要可用文本字符串形式表示的数据类型。
如果有多个记录与 数据库查找 functoid 的输入参数匹配， 则值提取器 functoid 仅从第一条记录中提取数据。
在连接字符串中使用 NT 验证可利用加密来保护密码。
可用的 functoid
数据库 functoid 包括：
- 数据库查找
- 错误返回
- 格式化消息
- 获取应用程序 ID
- 获取应用程序值
- 获取公用 ID
- 获取公用值
- 删除应用程序 ID
- 设置公用 ID
- 值提取程序
有关这些 functiod 的更多详细信息，请参阅 UI 指南中的 Functoid 参考和开发人员 API 命名空间参考。
另请参阅
- 如何将基本 Functoid 添加到映射
- UI 指南中的数据库 Functoid 参考和开发人员 API 命名空间参考