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)。如果 entityType 是 TestStepParent,则必须遵循顺序。 |
示例: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>
以下代码使用 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) ...