Для отправки и обновления ресурсов используется запрос 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>
| Элемент | Тип | Описание |
|---|---|---|
| serializedAsset | Файл манифеста RAS | Файл манифеста .RAS (спецификация многоразового ресурса). |
| serializedDetails | Текст | Сериализованная форма информации об артефактах ресурса. |
| assetOwnerIDs | Текст | Список владельцев нового ресурса через запятую. |
| assetGroup | Целое число | Целое число, представляющее группу, куда передается ресурс. |
| assetFile | Файл .RAS | Файл .RAS, отправляемый на сервер. Важное замечание: Файл .RAS должен содержать файл манифеста и артефакты.
|
| stateOption | Определение состояния | Во время отправки ресурса в Rational Asset Manager этот элемент задает состояние отправляемого ресурса. Допустимые состояния:
|
| isUpdate | Переключатель | При обновлении ресурса этот переключатель разрешает ввод GUID и номера версии ресурса. Уникальный ИД и версия ресурса указываются в элементах UpdateOriginalGUID и UpdateOriginalVersion. |
| keepOldAssetVersion | Переключатель | При обновлении ресурса этот переключатель включает режим сохранения прежней версии ресурса и создания новой версии для обновленного ресурса. Когда этот переключатель выключен, обновленный ресурс заменяет старый и получает тот же номер версии. |
| userAssetTags | Строка | Теги ресурса. Теги ресурса можно добавлять и удалять в зависимости от того, что указывается. |
| Отправить | Кнопка | Отправляет форму. |
Для отправки или обновления ресурса с помощью своего имени и пароля:
Для анонимной отправки или обновления ресурса удалите RAMSecure и используйте следующий URL: http://host:port/com.ibm.ram.repository.web.ws.was/RAMAssetAccess.jsp
После отправки ресурса в теле ответа и поле com.ibm.ram.asset.revision заголовка возвращается целочисленный номер новой ревизии ресурса. Сообщения об ошибках сервера возвращаются в поле com.ibm.ram.error заголовка.