ResponseControl 数据对象

ResponseControl 在 API 调用的 return 数据对象中返回。

如果 API 调用由同步适配器来处理,那么返回的数据对象中可能不存在控件。如果调用由异步适配器来处理,那么将返回此控件。

ResponseControl 数据对象的结构由以下内容组成:
complete
是一个布尔属性,如果调用未完成,那么设置为 false。 在调用完成后,complete 标志设置为 true,并且返回的数据对象包含调用的结果。
ticket
是不要求调用者进行解释的字符串。对于未完成调用,ticket 属性包含一个可在 RequestControl 中用于检查 API 调用状态的凭单字符串。

XML 模式定义

以下是 ResponseControl 数据对象的 XML 模式定义。
<xsd:complexType  name="ResponseControl">
	<xsd:complexContent>
		<xsd:extension base ="Control">
			<xsd:attribute name="complete" type="xsd:boolean" default="true"/>
<xsd:attribute name="ticket" type="xsd:string"/>
</xsd:extension>
 </xsd:complexContent>
</xsd:complexType>

样本数据对象

以下是一个样本 ResponseControl 数据对象。它是由异步适配器所处理的对某个 API 的调用返回的。数据对象中的 complete 属性指示操作尚未完成,并且凭单可用于跟踪调用的状态。
<wim:controls xsi:type="wim:ResponseControl" complete="false" 
ticket="AsyncLDAP1:1113940307424:-1278154994"/>
以下是一个在异步调用完成之后返回的样本 ResponseControl 数据对象。
<wim:controls xsi:type="wim:ResponseControl" complete="true"/> 
注: 如果调用是由同步适配器处理的,那么 ResponseControl 可能不存在。


使用条款 | 反馈