Asset mit HTTP POST übergeben und aktualisieren

Um Assets zu übergeben und zu aktualisieren, verwenden Sie HTTP POST.

Informationen zu diesem Vorgang

Wenn Sie ein Asset übergeben, wird eine Zahl zurückgegeben, die die Überarbeitungsversionsnummer angibt. Wenn Sie und ein anderer Benutzer das Asset gleichzeitig aktualisieren, wird eine Kollisionsnachricht zurückgegeben. Sie müssen das Asset herunterladen und aktualisieren.

Um neue Assets zu übergeben oder vorhandene Assets mithilfe der Aufrufe HTTP POST zu aktualisieren, verwenden Sie das folgende HTTP-Formular:

<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>
Beachten Sie die folgenden Elemente in dieser Tabelle:
Tabelle 1. Elementdeskriptoren:
Element Typ Beschreibung
serializedAsset RAS-Manifestdatei Gibt eine .RAS-Manifestdatei (RAS = Reusable Asset Specification) an.
serializedDetails Text Gibt ein serialisiertes Formular der Artefaktdetails des Assets an.
assetOwnerIDs Text Gibt eine durch Kommas getrennte Liste der neuen Asseteigner an.
assetGroup Ganze Zahl Gibt eine ganze Zahl an, die die Gruppe darstellt, an die das Asset übergeben werden soll.
assetFile .RAS-Datei Gibt die .RAS-Datei an, die an den Server übergeben werden soll.
Wichtig: Die .RAS-Datei muss die Manifestdatei und Artefakte enthalten.
stateOption Statusdefinition Wenn Sie ein Asset an Rational Asset Manager übergeben, definiert dieses Element den Status, in den das Asset übergeben werden soll. Dabei handelt es sich um einen der folgenden Status:
  • Normal speichern. Übergibt das Asset für die Überprüfung.
  • Als Entwurf speichern. Übergibt das Asset in einem bearbeitbaren Entwurfsstatus.
  • Unverändert (As Is). Übergibt das Asset, ohne eine formale Überprüfung des Assets zu erfordern.
isUpdate Kontrollkästchen Wenn Sie ein Asset aktualisieren, wählen Sie dieses Kontrollkästchen aus, um die GUID und die Versionsnummer des Assets als erforderlich zu definieren. Sie können die eindeutigen ID und die Version des Assets in den Zeilen für die Elemente UpdateOrigionalGUID und UpdateOrigionalVersion angeben.
keepOldAssetVersion Kontrollkästchen Wenn Sie ein Asset aktualisieren, wählen Sie dieses Kontrollkästchen aus, um die alte Assetversion beizubehalten und eine neue Version für das aktualisierte Asset zu erstellen. Wenn Sie das Kontrollkästchen nicht auswählen, wird die Version unter Beibehaltung der Versionsnummer durch die neue Version ersetzt.
userAssetTags Textzeichenfolge Gibt Tags für das Asset an. Abhängig von der Angabe können Sie Tags entfernen oder neue Tags hinzufügen.
Submit Schaltfläche Übergibt das Formular.

Vorgehensweise

Gehen Sie wie folgt vor, um ein Asset unter Verwendung Ihres Benutzernamens und Ihres Kennworts zu übergeben oder zu aktualisieren:

  1. Übergeben Sie das Formular für HTTP POST an https://Host:Port/com.ibm.ram.repository.web.ws.was/RAMSecure/RAMAssetAccess.jsp; dabei ist Host der Hostname des Servers, Port die Portnummer und com.ibm.ram.repository.web.ws.was die Web-Services-Webanwendung.
  2. Geben Sie Ihren Benutzernamen und Ihr Kennwort unter Verwendung der Basisauthentifizierung an.

Beispiel

Um ein Asset anonym zu übergeben oder zu aktualisieren, entfernen Sie RAMSecure und verwenden Sie die folgende URL: http://Host:Port/com.ibm.ram.repository.web.ws.was/RAMAssetAccess.jsp

Wenn beim Übergeben oder Aktualisieren von Assets Probleme auftreten, werden die folgenden HTTP-Fehlercodes ausgelöst:
  • 403 FORBIDDEN: Der Aufrufende hat die nicht erforderlichen Berechtigungen zum Übergeben oder Aktualisieren eines Assets.
  • 500 INTERNAL_SERVER_ERROR: Probleme oder Ausnahmebedingungen bei dem Versuch, das Asset zu übergeben oder zu aktualisieren
  • 400 BAD_REQUEST: Die vom Aufrufenden übergebene HTTP-Anforderung ist semantisch nicht korrekt oder es wurden fehlerhafte Daten gesendet.
  • 409 CONFLICT: Das übergebene Asset ist bereits auf dem Server vorhanden.
Hinweis: Um die Verbindung mithilfe einer sicheren HTTPS-SSL-Verbindung herzustellen, müssen Sie bestätigen, dass sich der öffentliche Schlüssel des Servers im Schlüsselring des Clients befindet.

Nachdem ein Asset übergeben wurde, wird die neue Überarbeitungszahl des Assets als ganze Zahl im Antworthauptteil als der Wert des Headers com.ibm.ram.asset.revision zurückgegeben. Fehlerantwortnachrichten vom Server werden im Header com.ibm.ram.error zurückgegeben.


Feedback