TMAttach 接口

TMAttach 接口用于将附件上载到测试或需求。下表显示了 TMAttach 接口的参数。

接口 URL 参数 说明

http://<front-end URL>/servicesExchange?hid=TMAttach

sid 用于用户身份验证的 Web 服务令牌或会话标识符。您可以在 Silk Central UI 的设置页面中生成 Web 服务令牌。要访问此页面,请将鼠标光标悬停在 Silk Central 菜单中的用户名上,然后选择用户设置。您可以通过调用可用 Web 服务之一的 logonUser 方法来检索会话标识符。
  entityType 目标实体类型:

(测试、需求或 TestStepParent)

  entityID 目标实体 ID:

(测试 ID、需求 ID 或手动测试 ID)

  description 附件说明:

URL 编码文本,用于描述附件。

  isURL 如果为 true,则附件为 URL。如果为 false,则附件为文件。
  URL 可选 - 要附加的 URL。
  stepPosition 可选 - 测试步骤顺序。标识手动测试的步骤(例如,顺序第一步是 1)。如果 entityTypeTestStepParent,则必须遵循顺序。

示例:http://<front-end URL>/servicesExchange?hid=TMAttach&entityType=<test, requirement, or TestStepParent>&entityID=<id>&description=<text>&isURL=<true or false>&URL=<URL>&stepPosition=<number>&sid=<webServiceToken>

TMAttach Web 服务示例

以下代码使用 Apache HtmlClient 获取便捷的 HTTP-POST API,以便上载二进制附件。每个请求仅可上载一个附件。

每个请求仅可上载一个附件。要下载 Apache HttpComponents,请访问 http://hc.apache.org/downloads.cgi。请参阅组件文档,了解所需的库。

import org.apache.commons.httpclient.*; // Apache HttpClient

	String webServiceToken = "e39a0b5b-45db-42db-84b2-b85028d954d5"; // Token generated in the UI
	String testNodeID = null; // receiving test
	File fileToUpload = null; // attachment
	String AttachmentDescription = ""; // descriptive text

	HttpClient client = new HttpClient();
	String formURL = "http://localhost:19120/
		servicesExchange?hid=TMAttach" +
		"&sid=" + webServiceToken +
		"&entityID=" + testNodeID +
		"&entityType=Test" + 
		"&isURL=false";
	PostMethod filePost = new PostMethod(formURL);
	Part[] parts = {
		new StringPart("description", attachmentDescription),
		new FilePart(fileToUpload.getName(), fileToUpload)
	};
	filePost.setRequestEntity(new MultipartRequestEntity(parts,
		filePost.getParams()));
	client.getHttpConnectionManager().
		getParams().setConnectionTimeout(60000);	
	// Execute and check for success
	int status = client.executeMethod(filePost);
	// verify http return code...
	// if(status == httpStatus.SC_OK) ...