Interface TMAttach

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>

Exemple de service Web TMAttach

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) ...