Отправка и обновление ресурса с помощью HTTP POST

Для отправки и обновления ресурсов используется запрос HTTP POST.

Об этой задаче

При отправке ресурса возвращается номер версии ревизии ресурса. Если в то же время ресурс обновляет другой пользователь, возвращается сообщение о конфликте. Необходимо загрузить и обновить ресурс.

Для отправки новых ресурсов или обновления существующих с помощью запросов 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>Обычное сохранение</option>
				<option value="saveAsDraft">Сохранить как черновой</option>
				<option value="saveAsIS">Сохранить как есть</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="Отправить">
</form>
Таблица описания элементов:
Табл. 1. Дескрипторы элементов
Элемент Тип Описание
serializedAsset Файл манифеста RAS Файл манифеста .RAS (спецификация многоразового ресурса).
serializedDetails Текст Сериализованная форма информации об артефактах ресурса.
assetOwnerIDs Текст Список владельцев нового ресурса через запятую.
assetGroup Целое число Целое число, представляющее группу, куда передается ресурс.
assetFile Файл .RAS Файл .RAS, отправляемый на сервер.
Важное замечание: Файл .RAS должен содержать файл манифеста и артефакты.
stateOption Определение состояния Во время отправки ресурса в Rational Asset Manager этот элемент задает состояние отправляемого ресурса. Допустимые состояния:
  • Сохранить как нормальный. Отправляет ресурс для проверки.
  • Сохранить как черновой. Отправляет ресурс в состоянии изменяемого чернового варианта.
  • Как есть. Отправляет ресурс, которому не требуется формальная проверка.
isUpdate Переключатель При обновлении ресурса этот переключатель разрешает ввод GUID и номера версии ресурса. Уникальный ИД и версия ресурса указываются в элементах UpdateOriginalGUID и UpdateOriginalVersion.
keepOldAssetVersion Переключатель При обновлении ресурса этот переключатель включает режим сохранения прежней версии ресурса и создания новой версии для обновленного ресурса. Когда этот переключатель выключен, обновленный ресурс заменяет старый и получает тот же номер версии.
userAssetTags Строка Теги ресурса. Теги ресурса можно добавлять и удалять в зависимости от того, что указывается.
Отправить Кнопка Отправляет форму.

Процедура

Для отправки или обновления ресурса с помощью своего имени и пароля:

  1. Передайте форму запроса POST HTTP по адресу https://хост:порт/com.ibm.ram.repository.web.ws.was/RAMSecure/RAMAssetAccess.jsp, где хост обозначает имя хоста сервера, порт обозначает номер порта, а 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: Передаваемый ресурс уже существует на сервере
Напоминание: Для подключения по защищенному соединению SSL HTTPS убедитесь, что в наборе ключей клиента есть открытый ключ сервера.

После отправки ресурса в теле ответа и поле com.ibm.ram.asset.revision заголовка возвращается целочисленный номер новой ревизии ресурса. Сообщения об ошибках сервера возвращаются в поле com.ibm.ram.error заголовка.


Комментарии