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 Manifest 파일 .RAS(재사용가능한 자산 스펙) Manifest 파일을 제공합니다.
serializedDetails 텍스트 자산의 아티팩트 세부사항에 대한 연속된 양식을 제공합니다.
assetOwnerIDs 텍스트 쉼표로 구분된 새 자산 소유자 목록을 제공합니다.
assetGroup 정수 자산을 제출할 그룹을 표시하는 정수를 제공합니다.
assetFile .RAS 파일 서버에 제출할 .RAS 파일을 제공합니다.
중요사항: .RAS 파일에는 Manifest 파일과 아티팩트가 있어야 합니다.
stateOption 상태 정의 Rational® Asset Manager에 자산 제출 시, 자산에 요구되는 상태를 정의합니다. 자산 상태는 다음과 같습니다.
  • 정상으로 저장. 검토할 자산을 제출합니다.
  • 초안으로 저장. 편집 가능한 초안 상태의 자산을 제출합니다.
  • 현재 상태. 형식적인 검토가 필요 없는 자산을 제출합니다.
isUpdate 선택란 자산을 업데이트하는 경우 자산의 GUID와 버전 번호를 요청하려면 이 선택란을 선택하십시오. UpdateOrigionalGUID와 UpdateOrigionalVersion 요소 행에 자산의 고유 ID와 버전을 제공할 수 있습니다.
keepOldAssetVersion 선택란 자산을 업데이트하는 경우 이전 자산 버전을 유지하고 업데이트된 자산의 새 버전을 작성하려면 이 선택란을 선택하십시오. 선택란에 체크하지 않으면 버전 번호가 동일한 버전으로 교체됩니다.
userAssetTags 텍스트 문자열 자산에 태그를 제공합니다. 지정된 것에 기반하여 태그를 제거하거나 새 태그를 추가할 수 있습니다.
Submit 단추 양식을 제출합니다.

프로시저

사용자 이름과 비밀번호를 사용하여 자산을 제출하거나 업데이트하려면 다음을 수행하십시오.

  1. https://host:port/com.ibm.ram.repository.web.ws.was/RAMSecure/RAMAssetAccess.jsp에 HTTP POST FORM을 제출하십시오. 여기서 host는 서버의 호스트 이름, port는 포트 번호, com.ibm.ram.repository.web.ws.was는 웹 서비스 웹 애플리케이션입니다.
  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에 리턴됩니다.


피드백