Über die Schnittstelle TMAttach werden Anhänge zu einer Test oder Anforderung hochgeladen. Die folgende Tabelle enthält die Parameter der Schnittstelle TMAttach.
| Schnittstellen-URL | Parameter | Beschreibung |
|---|---|---|
|
http://<front-end URL>/servicesExchange?hid=TMAttach |
sid | Webdienst-Token oder Sitzungs-ID für die Benutzerauthentifizierung. Sie können das Webdienst-Token auf der Einstellungsseite der Silk Central-Benutzeroberfläche generieren. Um auf diese Seite zuzugreifen, zeigen Sie mit dem Mauszeiger auf den Benutzernamen im Menü Silk Central und wählen Sie Benutzereinstellungen. Sie können die Sitzungs-ID abrufen, indem Sie die Methode logonUser für einen der verfügbaren Webdienste aufrufen. |
| entityType | Typ der Zielentität:
(Test, Anforderung oder TestStepParent) |
|
| entityID | ID der Zielentität:
(Test-ID, Anforderungs-ID oder ID des manuellen Tests) |
|
| description | Beschreibung des Anhangs.
URL-codierter Text, der den Anhang beschreibt. |
|
| isURL | Bei true ist der Anhang ein URL. Bei false ist der Anhang eine Datei. | |
| URL | Optional - Anzuhängender URL. | |
| stepPosition | Optional – Der Name des Testschritts. Bezeichnet den Schritt eines manuellen Tests (z. B. 1 für den ersten Schritt). Die Reihenfolge ist obligatorisch, wenn entityType den Wert TestStepParent hat. |
Beispiel: http://<front-end URL>/servicesExchange?hid=TMAttach&entityType=<test, requirement, or TestStepParent>&entityID=<id>&description=<text>&isURL=<true or false>&URL=<URL>&stepPosition=<number>&sid=<webServiceToken>
Der folgende Quelltext ruft zum Hochladen eines binären Anhangs mit Apache HtmlClient eine geeignete HTTP-POST API ab. Pro Anfrage kann nur ein Anhang hochgeladen werden.
Pro Anfrage kann nur ein Anhang hochgeladen werden. Apache HttpComponents können Sie von http://hc.apache.org/downloads.cgi herunterladen. Die erforderlichen Bibliotheken entnehmen Sie der Dokumentation der Komponente.
import org.apache.commons.httpclient.*; // Apache HttpClient
String webServiceToken = "e39a0b5b-45db-42db-84b2-b85028d954d5"; // Token generated in the UI
String testNodeID = null; // receiving test
File fileToUpload = null; // attachment
String AttachmentDescription = ""; // descriptive text
HttpClient client = new HttpClient();
String formURL = "http://localhost:19120/
servicesExchange?hid=TMAttach" +
"&sid=" + webServiceToken +
"&entityID=" + testNodeID +
"&entityType=Test" +
"&isURL=false";
PostMethod filePost = new PostMethod(formURL);
Part[] parts = {
new StringPart("description", attachmentDescription),
new FilePart(fileToUpload.getName(), fileToUpload)
};
filePost.setRequestEntity(new MultipartRequestEntity(parts,
filePost.getParams()));
client.getHttpConnectionManager().
getParams().setConnectionTimeout(60000);
// Execute and check for success
int status = client.executeMethod(filePost);
// verify http return code...
// if(status == httpStatus.SC_OK) ...