Changes between Version 3 and Version 4 of TestManagerForTracPluginApi

Timestamp:

Sep 21, 2010, 6:30:35 PM (14 years ago)

Author:

anonymous

Comment:

--

TestManagerForTracPluginApi

@@ -70 +70 @@
 === Create a Test Plan from a specific catalog ===
 
-Get the wollowing URL, where "path" is the name of the (sub-)catalog to create the test plan against.
+Get the following URL, where "path" is the name of the (sub-)catalog to create the test plan against.
 {{{
 <yourserver/yourproject>/testcreate?type=testplan&path=TC_TT0&title=Test%20Plan%20for%2020100818
@@ -102 +102 @@
  - FAILED
 
+[[BR]][[BR]]
+=== Change a [custom] property of any test object ===
+
+Any property, either standard or custom, of any test object can be set programmatically through the RESTful API.
+
+A test object is identified by its realm (i.e. type) and its key (i.e. in most cases the ID, for test cases in the context of a plan, also the plan ID is required).
+
+The realms that identify the test objects are the following:
+ * Test Catalog: testcatalog
+ * Test Case: testcase
+ * Test Case in the context of a plan (i.e. with a status): testcaseinplan
+ * Test Plan: testplan
+
+The realm must be provided to the property update service through the "realm" parameter.
+
+The corresponding key properties, needed to identify any particular object, are:
+ * Test Catalog: id
+ * Test Case: id
+ * Test Case in the context of a plan (i.e. with a status): id, planid
+ * Test Plan: id
+
+The key properties are provided to the property update service through the "key" parameter, in the form of a dictionary.
+
+The next things to pass to the service are the name of the property to modify and the new value. Guess what... you use the "name" and "value" parameters, respectively.
+
+For example, to change a Test Case - with ID 5 - custom property "platform" (which has been previously added to the test case type in the trac.ini file) to the new value "Windows", this is the URL to GET:
+
+{{{
+<yourserver/yourproject>/testpropertyupdate?realm=testcase&key={'id':'5'}&name=platform&value=Windows
+}}}
+
 
 [[BR]][[BR]]