new api method - setUserRoleOnProject #141

Author: Luiko Czub

example/TestLinkExampleGenericApi.py

@@ -185,6 +185,20 @@ def checkUser(name1, name2):
 print("createTestProject", newProject)
 newProjectID = newProject[0]['id'] 
 print("New Project '%s' - id: %s" % (NEWPROJECT,newProjectID))
+
+# assign project roles to user
+response = myTestLink.setUserRoleOnProject(myTestUser1_ID, "tester", newProjectID)
+print("setUserRoleOnProject user1", response)
+response = myTestLink.setUserRoleOnProject(myTestUser2_ID, "senior tester", newProjectID)
+print("setUserRoleOnProject user2 role a", response)
+response = myTestLink.setUserRoleOnProject(myTestUser2_ID, "test designer", newProjectID)
+print("setUserRoleOnProject user2 role b", response)
+# get user information
+response = myTestLink.getUserByID(myTestUser1_ID)
+print("getUserByID user1", response)
+response = myTestLink.getUserByID(myTestUser2_ID)
+print("getUserByID user2", response)
+
 
 # Create test plan A  - uses platforms
 newTestPlan = myTestLink.createTestPlan(NEWTESTPLAN_A, testprojectname=NEWPROJECT,

src/testlink/testlinkapigeneric.py

@@ -2093,6 +2093,27 @@ def getAllExecutionsResults(self):
     def createUser(self):
         """ Create a new user """
 
+    # /**
+    #  * Set a role to a user at project level
+    #  *
+    #  * Restricted to users with System Wide Role Admin
+    #  *
+    #  * @param struct $args
+    #  * @param struct $args["userid"]
+    #  * @param struct $args["rolename"]
+    #  * @param struct $args["testprojectid"]
+    #  *
+    #  * @return true if OK, otherwise error structure
+    #  *
+    #  * @access public
+    #  */
+    # public function setUserRoleOnProject($args)
+    @decoApiCallAddDevKey
+    @decoMakerApiCallWithArgs(['userid', 'rolename', 'testprojectid'])
+    def setUserRoleOnProject(self):
+        """ Set a role to a user at project level 
+            Restricted to users with System Wide Role Admin
+        """
 
     #
     #  internal methods for general server calls

test/utest-offline/test_apiClients_whatArgs.py

@@ -114,7 +114,8 @@ def test_whatArgs_unknownMethods(api_client):
                        'platformonexecution=<platformonexecution>']),
     ('closeBuild', ['<buildid>']),
     ('createUser', ['<login>', '<firstname>', '<lastname>', '<email>', 
-                    'password=<password>'])
+                    'password=<password>']),
+    ('setUserRoleOnProject', ['<userid>', '<rolename>', '<testprojectid>'])
     ]
 
 @pytest.mark.parametrize("apiCall, descriptions",