L'interface TMAttach sert à télécharger des pièces jointes à un test ou une exigence. Le tableau ci-dessous présente les paramètres de l'interface TMAttach.
| URL de l'interface | Paramètre | Descriptions |
|---|---|---|
|
http://<front-end URL>/servicesExchange?hid=TMAttach |
sid | Jeton de service Web ou identificateur de session pour l'authentification des utilisateurs. Vous pouvez générer le jeton de service Web dans la Page Paramètres de l'interface utilisateur de Silk Central. Pour accéder à cette page, passez le curseur de la souris sur le nom d'utilisateur dans le menu Silk Central et sélectionnez Paramètres utilisateur. Vous pouvez appeler la méthode logonUser de l'un des services Web disponibles pour récupérer l'identificateur de session. |
| entityType | Type d'entité cible :
test, exigence ou parent du pas de test |
|
| entityID | ID d'entité cible :
ID de test, d'exigence ou de test manuel |
|
| description | Description de la pièce jointe :
Texte codé dans une URL, utilisé pour décrire la pièce jointe |
|
| isURL | Si la valeur est true, la pièce jointe est une URL. Si la valeur est false, la pièce jointe est un fichier. | |
| URL | Optionnel : URL à joindre | |
| stepPosition | Optionnel : Ordre du pas dans le test. Identifie le pas d'un test manuel (par exemple, l'ordre du premier pas est 1). L'ordre est obligatoire si entityType est TestStepParent. |
Exemple : 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>
Le code ci-dessous utilise Apache HtmlClient pour obtenir une API HTTP-POST pratique afin de télécharger une pièce jointe binaire. Il n'est possible de télécharger qu'une seule pièce jointe par demande.
Il n'est possible de télécharger qu'une seule pièce jointe par demande. Pour télécharger Apache HttpComponents, visitez le site http://hc.apache.org/downloads.cgi. Reportez-vous à la documentation du composant pour connaître les bibliothèques requises.
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) ...