- UDDI 教程
- UDDI - 首页
- UDDI - 概述
- UDDI - 元素
- UDDI - 技术架构
- UDDI - 数据模型
- UDDI - 接口
- UDDI - 使用示例
- UDDI 与 WSDL
- UDDI - 实现
- UDDI - 规范
- UDDI - 总结
- UDDI API 参考
- UDDI - API 快速参考
- UDDI 有用资源
- UDDI - 快速指南
- UDDI - 有用资源
- UDDI - 讨论
UDDI API - find_business
描述
find_business 函数搜索与指定条件匹配的企业。
响应包含一个根 businessList 元素,以及每个匹配公司的 businessInfo 元素。如果 UDDI 运营商只返回部分匹配结果,则 businessList 元素的 truncated 属性将设置为 true。如果没有找到匹配项,则返回一个包含零个子元素的 businessList 元素。
2.0 版语法
<find_business generic = "2.0" [maxRows = "nn"] xmlns = "urn:uddi-org:api_v2"> [<findQualifiers/>] [<name/> [<name/>]...] [<discoveryURLs/>] [<identifierBag/>] [<categoryBag/>] [<tModelBag/>] </find_business>
参数
maxRows − 可选属性,用于指定要返回的最大行数;如果超过 maxRows,则 bindingDetail 元素的 truncated 属性将设置为 true。
findQualifiers − 可选元素,用于覆盖默认搜索功能。例如,find qualifier exactNameMatch 将匹配完全相同的企业名称。
name − 企业的全名或部分名称。UDDI 2.0 允许您指定最多五个企业名称。
discoveryURLs − 可选元素,用于按发现 URL 搜索。如果指定了多个 discoveryURL,则搜索将通过逻辑 OR 执行。
identifierBag − 可选元素,用于按标识符搜索。如果指定了多个标识符,则搜索将通过逻辑 OR 执行。
categoryBag − 可选元素,用于按类别搜索。例如,您可以按 NAICS 代码搜索。如果指定了多个类别,则搜索将通过逻辑 AND 执行。
tModelBag − 可选元素,用于按 tModel 记录搜索。如果指定了多个 tModel,则搜索将通过逻辑 AND 执行。
返回错误
如果在此 API 调用处理过程中发生任何错误,则将在 SOAP 错误中向调用方返回 dispositionReport 元素。以下错误编号信息将相关
E_invalidKeyPassed − 表示传递的 uuid_key 值与任何已知的 serviceKey 或 tModelKey 值都不匹配。错误结构将首先指明发生了哪种情况,并且无效的密钥将在文本中清晰地指示。
E_unsupported − 表示传递的 findQualifier 值之一无效。无效的限定符将在文本中清晰地指示。
E_tooManyOptions − 表示超过了对 name 参数数量的实现定义限制。