Lorsque vous soumettez un actif, un numéro est renvoyé, qui correspond au numéro de révision. Si vous ou un autre utilisateur mettez à jour cet actif au même moment, un message collision est renvoyé. Vous devez télécharger l'actif et le mettre à jour.
Pour soumettre de nouveaux actifs ou mettre à jour des actifs existants à l'aide d'appels HTTP POST, utilisez le formulaire HTTP suivant :
<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>Enregistrer normalement</option> <option value="saveAsDraft">Enregistrer comme brouillon</option> <option value="saveAsIS">Enregistrer en l'état</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="Soumettre"> </form>
| Elément | Type | Description |
|---|---|---|
| serializedAsset | Fichier manifeste RAS | Fournit un fichier manifeste .RAS (Reusable Asset Specification). |
| serializedDetails | Texte | Forme sérialisée des détails de l'actif en termes d'artefacts qui le composent. |
| assetOwnerIDs | Texte | Liste séparée par des virgules répertoriant les propriétaires de l'actif. |
| assetGroup | Entier | Entier représentant le groupe auquel soumettre l'actif. |
| assetFile | Fichier .RAS | Fichier .RAS qui doit être
soumis au serveur. Important : Le fichier .RAS doit contenir le fichier manifeste
et les artefacts.
|
| stateOption | Définition de l'état | Lorsque vous soumettez un actif
à Rational Asset Manager, cet élément
définit l'état dans lequel il doit être soumis. Il peut s'agir de l'un des états suivants :
|
| isUpdate | Case à cocher | Lorsque vous mettez à jour un actif, cochez cette case pour demander que soient fournis son identificateur global unique (GUID) et son numéro de version. L'identificateur unique et le numéro de version de l'actif peuvent être fournis dans les éléments UpdateOrigionalGUID et UpdateOrigionalVersion respectivement. |
| keepOldAssetVersion | Case à cocher | Lorsque vous mettez à jour un actif, cochez cette case si vous voulez que l'ancienne version soit conservée et qu'une nouvelle version soit créée pour l'actif mis à jour. Si vous ne cochez pas cette case, l'ancienne version sera remplacée et conservera le même numéro de version. |
| userAssetTags | Chaîne de texte | Etiquettes de l'actif. Vous pouvez supprimer des étiquettes ou en ajouter de nouvelles en fonction des spécifications. |
| Soumettre | Bouton | Soumet le formulaire. |
Pour soumettre ou mettre à jour un actif avec vos nom d'utilisateur et mot de passe :
Pour soumettre ou mettre à jour anonymement un actif, supprimez la partie RAMSecure et utilisez une URL de la forme suivante : http://host:port/com.ibm.ram.repository.web.ws.was/RAMAssetAccess.jsp
Une fois l'actif soumis, le nouveau nombre de révisions de l'actif est renvoyé comme entier dans le corps de la réponse ainsi que comme valeur de l'en-tête com.ibm.ram.asset.revision. Les messages d'erreur provenant du serveur sont retournés dans l'en-tête com.ibm.ram.error.