Soumettre et mettre à jour un actif en utilisant HTTP POST

Pour soumettre et mettre à jour des actifs, utilisez l'appel HTTP POST.

Pourquoi et quand exécuter cette tâche

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>
Pour la description des éléments, consultez le tableau suivant :
Tableau 1. Description des éléments
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 :
  • Enregistrer normalement. Soumet l'actif pour révision.
  • Enregistrer comme brouillon. Soumet l'actif à l'état de brouillon éditable.
  • Enregistrer en l'état. Soumet l'actif sans demander qu'il soit formellement révisé.
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.

Procédure

Pour soumettre ou mettre à jour un actif avec vos nom d'utilisateur et mot de passe :

  1. Soumettez le formulaire HTTP à https://hôte:port/com.ibm.ram.repository.web.ws.was/RAMSecure/RAMAssetAccess.jsp, où hôte est le nom d'hôte du serveur, port est le numéro de port et com.ibm.ram.repository.web.ws.was est l'application de services Web.
  2. Fournissez vos nom d'utilisateur et mot de passe en utilisant le mécanisme d'authentification standard.

Exemple

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

En cas de problème de soumission ou de mise à jour de l'actif, les codes d'erreur HTTP suivants sont renvoyés :
  • 403 FORBIDDEN : L'appelant n'a pas les droits nécessaires pour soumettre ou mettre à jour un actif
  • 500 INTERNAL_SERVER_ERROR : Problèmes ou exceptions lors de la tentative de soumission ou de mise à jour de l'actif
  • 400 BAD_REQUEST : La demande HTTP émise par l'appelant est sémantiquement incorrecte ou contient des données incorrectes
  • 409 CONFLICT : L'actif soumis existe déjà sur le serveur
A faire : Pour établir une connexion sécurisée SSL (protocole HTTPS), vérifiez que la clé publique du serveur se trouve dans le fichier de clés du client.

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.


Commentaires