使用 HTTP POST 提交和更新资产

要提交和更新资产,请使用 HTTP POST。

关于此任务

提交资产时,会返回指示修订版本号的数字。如果您和另一位用户同时更新资产,那么将返回冲突消息。必须下载并更新该资产。

要使用 HTTP POST 调用来提交新资产或更新现有资产,请使用以下 HTTP 表单:

<form method="post" enctype="mulitpart/form-data" action="">
			<textarea name="serializedAsset"></textarea>
		<textarea name="serializedDetails">>/textarea>
			<input type="text" name="assetGroup" size="20">
	<input type="file" name="assetFile" size="100">
		<input type="text" name="assetOwnerID" size="100">
			<select name="stateOption">
					<option value="saveAsNormal" selected>Save Normal</option>
					<option value="saveAsDraft">Save As Draft</option>
				<option value="saveAsIS">Save As Is</option>
		</select>
		<input type="checkbox" name="isUpdate">	
				<input type="text" name ="updateOriginalGUID" size="50">
					<input type="text" name="updateOriginalVersion" size="50">
					<input type="checkbox" name="isKeepOldAssetVersion">
		<input type="text" name="useAssetTags" size="100">
		<input type="submit" name="Submit" value="Submit">
</form>
请参阅此表中的以下元素:
表 1. 元素描述符
元素 类型 描述
serializedAsset RAS 清单文件 提供 .RAS(可复用的资产规范)清单文件。
serializedDetails 文本 提供资产的工件详细信息的序列化格式。
assetOwnerIDs 文本 提供新资产所有者的逗号分隔列表。
assetGroup 整数 提供整数,该整数表示要向其提交资产的组。
assetFile .RAS 文件 提供要提交给服务器的 .RAS 文件。
要点: 该 .RAS 文件必须包含清单文件和工件。
stateOption 状态定义 您将资产提交至 Rational® Asset Manager 时,此元素定义应将资产提交至的状态。它们是以下状态:
  • 另存为一般文件。提交资产进行复审。
  • 另存为草稿。在可编辑草稿状态下提交资产。
  • 按现状。提交资产而不要求正式复审资产。
isUpdate 复选框 更新资产时,选择此复选框来表示需要资产的 GUID 和版本号。您可以在 UpdateOrigionalGUID 和 UpdateOrigionalVersion 元素行中提供资产的唯一标识和版本。
keepOldAssetVersion 复选框 更新资产时,选择此复选框来保留旧的资产版本,并为更新的资产创建新版本。如果您未选择此复选框,那么将在相同版本时替换版本号。
userAssetTags 文本字符串 为资产提供标记。您可以根据指定的内容来除去标记或添加新标记。
提交 按钮 提交表单。

过程

要使用用户名和密码来提交或更新资产:

  1. 将 HTTP POST 表单提交到 https://host:port/com.ibm.ram.repository.web.ws.was/RAMSecure/RAMAssetAccess.jsp,其中 host 是服务器的主机名,port 是端口号,com.ibm.ram.repository.web.ws.was 是 Web Service Web 应用程序。
  2. 使用基本认证来提供您的用户名和密码。

示例

要以匿名方式提交或更新资产,请除去 RAMSecure,并使用以下 URL:http://host:port/com.ibm.ram.repository.web.ws.was/RAMAssetAccess.jsp

当提交或更新资产出现问题时,会抛出以下 HTTP 错误代码:
  • 403 FORBIDDEN:调用者没有提交或更新资产所必需的许可权
  • 500 INTERNAL_SERVER_ERROR:尝试提交或更新资产时出现问题或异常
  • 400® BAD_REQUEST:调用者发出的 HTTP 请求在语义上不正确或发送的数据不正确
  • 409 CONFLICT:正在提交的资产在服务器中已存在
切记: 要使用 HTTPS SSL 安全连接来进行连接,请确认服务器的公用密钥位于客户机的密钥环中。

提交资产后,会将资产的新修订版计数作为响应主体中的整数以及头 com.ibm.ram.asset.revision 的值返回。服务器中的错误响应消息会在头 com.ibm.ram.error 中返回。


反馈