如何将客户端上下文与适用于主机应用程序的 BizTalk 适配器配合使用

对于 Host Integration Server,客户端上下文是一组值,允许替代远程主机的配置值。 通过修改与 BizTalk 项目关联的 XML 文件中的 ClientContext 关键字 (keyword) ,或者通过业务流程或自定义管道,可以将这些关键字与 BizTalk 主机应用程序适配器 y 配合使用。 支持以下替代 (USERID、PASSWORD、RecvTimeOut、SendTimeOut、PortOverride、IPAddress、TPNameOverride、ProgNameOverride、IMS_LTERM、LIbNameOverride、OverrideSourceTP 和 REOverride) 。 尽管出于安全原因,但仅允许将以下内容与 XML 文档一起传入, (USERID、PASSWORD、RecvTimeOut、SendTimeOut、PortOverride 和 REOverride) 。

将客户端上下文关键字作为 XML 文档的一部分传递

  1. 从 HIS Designer生成的 XSD 生成描述程序集的 XML 文档的实例。

    有关详细信息,请参阅 如何创建事务集成器项目和接口定义

  2. 在 XML 文档中,编辑 TIClientContext 关键字 (keyword) 。

    TIClientContext 关键字 (keyword) 将采用以下格式显示在 XML 文档中:

    <ns0:TIClientContext TIContextKeyword="TIContextKeyword_0" TIContextValue="TIContextValue_1" />

    其中“TIContextKeyword_0”和“TIContextValue_1”分别表示关键字 (keyword) 和值对。

    对于适用于主机应用程序的 BizTalkAdapter,TIClientContext 接受 USERID、PASSWORD、RecvTimeOut 和 SendTimeOut 作为有效关键字。

    请注意,如果未使用 ClientContext,则需要从文档中删除或注释掉自动生成的 TIClientContext 元素,否则调用将无法发送无效的客户端关键字 (keyword) 。

  3. 完成后,保存 XML 文件并退出。

示例

以下示例描述使用 HIS Designer生成的 XSD 作为 BizTalk 项目的一部分生成的 XML 文档。

<ns0:DPC_WGB__GetBalance__WGBANK__Request xmlns:ns0="http://microsoft.com/HostApplications/TI/WIP">  
  <ns0:WGBANKInDocument>  
   <ns0:ACCNUM>1234</ns0:ACCNUM>  
   <ns0:name>Kim Akers</ns0:name>  
  </ns0:WGBANKInDocument>  
  <ns0:TIClientContext TIContextKeyword=" RecvTimeOut " TIContextValue="15" />  
<ns0:TIClientContext TIContextKeyword="TIContextKeyword_0"TIContextValue="TIContextValue_1" />  
</ns0:DPC_WGB__GetBalance__WGBANK__Request>  
  

另请参阅

COMTIContext 关键字
为主机应用程序的 BizTalk 适配器创建应用程序