Someter y actualizar un activo utilizando HTTP POST

Para someter y actualizar activos, utilice HTTP POST

Acerca de esta tarea

Cuando someta un activo, se devuelve un número que indica el número de versión de la revisión. Si usted u otro usuario actualizan el activo al mismo tiempo, se retornará un mensaje de colisión. Debe descargar el activo y actualizarlo.

Para someter activos nuevos o actualizar activos existentes utilizando llamadas HTTP POST, utilice la forma HTTP siguiente:

<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>
Consulte los elementos siguientes de esta tabla:
Tabla 1. Descriptores de elemento
Elemento Tipo Descripción
serializedAsset Archivo de manifiesto de RAS Proporciona un archivo de manifiesto .RAS (Especificación de activo reutilizable).
serializedDetails Texto Proporciona un forma serializada de detalles de artefacto del activo.
assetOwnerIDs Texto Proporciona una lista separada por comas de los propietarios del activo nuevo.
assetGroup Entero Proporciona un entero que representa el grupo dónde el activo debe someterse.
assetFile Archivo .RAS Proporciona el archivo .RAS que tiene que someter al servidor.
Importante: El archivo .RAS debe contener el archivo de manifiesto y los artefactos.
stateOption Definición de estado Cuando someta un activo a Rational Asset Manager, este elemento define el estado en el que se debería someter el activo. Hay los estados siguientes:
  • Guardar como normal. Somete el activo para revisión.
  • Guardar como borrador. Somete el activo en un estado de borrador editable.
  • Tal cual. Somete el activo sin que sea necesaria una revisión formal del mismo.
isUpdate Recuadro de selección Cuando actualiza un activo, marque este recuadro de selección para solicitar el GUID y número de versión del activo. Puede proporcionar el ID exclusivo y versión del activo en las líneas de elemento UpdateOrigionalGUID y UpdateOrigionalVersion.
keepOldAssetVersion Recuadro de selección Cuando actualiza un activo, marque este recuadro de selección si quiere mantener la versión antigua del activo y crear una nueva versión para el activo actualizado. Si no marca este recuadro de selección, el número de versión se sustituirá con la misma versión.
userAssetTags Serie de texto Proporciona etiquetas al activo. Puede eliminar etiquetas o añadir nuevas etiquetas basadas en lo que está especificado.
Someter Botón Someter el formulario.

Procedimiento

Para someter o actualizar un activo utilizando su nombre de usuario y contraseña:

  1. Someta HTTP POST FORM a https://host:puerto/com.ibm.ram.repository.web.ws.was/RAMSecure/RAMAssetAccess.jsp, donde host es el nombre de host del servidor, puerto es el número de puerto y com.ibm.ram.repository.web.ws.was es la aplicación web de los servicios web.
  2. Proporcione el nombre de usuario y contraseña utilizando autenticación básica.

Ejemplo

Para someter o actualizar un activo de forma anónima, elimine RAMSecure y utilice el URL siguiente: http://host:port/com.ibm.ram.repository.web.ws.was/RAMAssetAccess.jsp

Cuando hay problemas para someter o actualizar activos, se emiten los siguiente códigos de error HTTP:
  • 403 FORBIDDEN (PROHIBIDO): el interlocutor no tiene permiso para someter un activo
  • 500 INTERNAL_SERVER_ERROR (ERROR INTERNO DEL SERVIDOR): problema o excepción al intentar someter o actualizar el activo
  • 400 BAD_REQUEST (PETICIÓN ERRÓNEA): La petición HTTP realizada por el llamador no es correcta semánticamente, o se han enviado datos incorrectos.
  • 409 CONFLICT (CONFLICTO): los activos que se están sometiendo ya existen el en servidor (
Recuerde: Para conectar utilizando una conexión segura SSL HTTPS, confirme que la clave pública del servidor se encuentra en el conjunto de claves del cliente.

Después de someter un activo, el nuevo recuento de revisión del activo se devuelve como un entero en el cuerpo de respuesta y como valor de la cabecera com.ibm.ram.asset.revision. Los mensajes de respuesta de error del servidor se devuelven en la cabecera com.ibm.ram.error.


Comentarios