Enviando e Atualizando um Recurso Usando o HTTP POST

Para enviar e atualizar recursos, use o HTTP POST.

Sobre Esta Tarefa

Ao enviar um recurso, um número que indica a versão de revisão é retornado. Se você e outro usuário atualizarem o recurso ao mesmo tempo, uma mensagem de conflito será retornada. Você deve fazer o download do recurso e atualizá-lo.

Para enviar novos recursos ou atualizar recursos existentes usando as chamadas HTTP POST, use o seguinte formato 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>
Consulte os seguintes elementos nesta tabela:
Tabela 1. Descritores de Elementos
Elemento Autenticação Descrição
serializedAsset Arquivo de manifesto RAS Fornece um arquivo de manifesto .RAS (Reusable Asset Specification).
serializedDetails Texto Fornece um formulário serializado de detalhes de artefato do recurso.
assetOwnerIDs Texto Fornece uma lista separada por vírgulas de novos proprietários de recurso.
assetGroup Inteiro Fornece um número inteiro que representa o grupo ao qual o recurso será enviado.
assetFile Arquivo .RAS Fornece o arquivo .RAS a ser enviado para o servidor.
Importante: O arquivo .RAS deve conter o arquivo de manifesto e os artefatos.
stateOption Definição de estado Quando você enviar um recurso para o Rational Asset Manager, esse elemento definirá que o recurso deve ser enviado. Estes são os seguintes estados:
  • Salvar como normal. Envia o recurso para revisão.
  • Salvar como rascunho. Envia o recurso em um estado de rascunho editável.
  • No estado em que se encontra. Envia o recurso sem exigir que ele seja formalmente revisado.
isUpdate Caixa de Opções Ao atualizar um recurso, selecione essa caixa de opção para requerer o GUID e o número de versão do recurso. É possível fornecer o ID e a versão do recurso exclusivos nas linhas de elemento UpdateOrigionalGUID e UpdateOrigionalVersion.
keepOldAssetVersion Caixa de Opções Ao atualizar um recurso, selecione essa caixa de opção para manter a versão antiga do recurso e criar uma nova versão para o recurso atualizado. Se você não selecionar a caixa de opções, o número de versão será substituído na mesma versão.
userAssetTags Cadeia de texto Fornece tags para o recurso. É possível remover as tags ou incluir novas tags com base no que é especificado.
Enviar Botão Envia o formulário.

Procedimento

Para enviar ou atualizar um recurso usando o nome de usuário e senha:

  1. Submeta o HTTP POST FORM para https://host:port/com.ibm.ram.repository.web.ws.was/RAMSecure/RAMAssetAccess.jsp, em que host é o nome do host do servidor, port é o número da porta, com.ibm.ram.repository.web.ws.was é o aplicativo da Web de serviços da Web.
  2. Forneça seu nome de usuário e senha utilizando autenticação básica.

Exemplo

Para enviar ou atualizar um recurso anonimamente, remova RAMSecure e use o seguinte URL: http://host:port/com.ibm.ram.repository.web.ws.was/RAMAssetAccess.jsp

Se ocorrerem problemas ao enviar ou atualizar recursos, os seguintes códigos de erro HTTP serão emitidos:
  • 403 FORBIDDEN: O responsável pela chamada não pode possuir as permissões necessárias para enviar ou atualizar um recurso
  • 500 INTERNAL_SERVER_ERROR: Problemas ou exceções ao tentar enviar ou atualizar o recurso
  • 400 BAD_REQUEST: O pedido de HTTP feito pelo responsável pela chamada está semanticamente incorreto ou contém dados incorretos enviados
  • 409 CONFLICT: O recurso que está sendo enviado já existe no servidor
Lembre-se: Para conectar-se utilizando uma conexão segura HTTPS SSL, confirme se a chave pública do servidor está localizada no conjunto de chaves do cliente.

Depois que um recurso for enviado, a nova contagem de revisão do recurso será retornada como um número inteiro no corpo da resposta e como o valor do cabeçalho com.ibm.ram.asset.revision. As mensagens de resposta de erro a partir do servidor serão retornadas no cabeçalhocom.ibm.ram.error.


Feedback