Service Description : TeamMemberService
Service EPR : https://login.swiftkanban.com/axis2/services/TeamMemberService
Service Status : Active
Available Operations:
- getTeamsForProjects
- getTeamMembersForProject
- getAllActiveUsersInOrg
- adduser
- deleteUser
- addTeamMember
- getUserData
- getUserDataFromEmailId
- getAllUsersLastLogin
Note: Any mention of Iteration or Project in any Web Service operations are equivalent to Sprint or Board in the SwiftKanban User Interface (UI).
getTeamsForProjects
Input Elements
| Description | Fetches team member details for each team in the system |
| userLoginId | Email address of user to log on to SwiftKanban Example: [email protected] |
| Output | If successful, the response returns team member details for each team in the system |
Input Response Example
getTeamsForProjects -<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:team="http://team.webservices.kanban.app.digite.com/"><soapenv:Header><wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" soapenv:mustUnderstand="1"><wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="UsernameToken-31571602"><wsse:Username> [email protected]</wsse:Username><wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">welcome123</wsse:Password></wsse:UsernameToken></wsse:Security></soapenv:Header><soapenv:Body><team:TeamsForProjects_Input><team:userLoginId> [email protected]</team:userLoginId></team:TeamsForProjects_Input></soapenv:Body></soapenv:Envelope>
Output Response Example
<ns:getTeamsResponse xmlns:ns="http://team.webservices.kanban.app.digite.com/"> <ns:Teams> <ns:Team ns:projectId="87"> <ns:TeamMember ns:firstName="Jai" ns:id="1031883" ns:lastName="Bharti" ns:primaryRole="2" ns:userLoginId="[email protected]"/> <ns:TeamMember ns:firstName="chirag" ns:id="1030404" ns:lastName="digite" ns:primaryRole="4" ns:userLoginId="[email protected]"/> </ns:Team> </ns:Teams> </ns:getTeamsResponse>
getTeamMembersForProject
Input Elements
| Description | Id of the project that you get from getProject of ProjectService |
| projectId | Id of the project that you get from getProject of ProjectService Example: 8 |
| userLoginId | Email address of user to log on to SwiftKanban |
| Output | If successful, the response returns a list of team members in a project |
Input Response Example
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:team="http://team.webservices.kanban.app.digite.com/"> <soapenv:Header> <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" soapenv:mustUnderstand="1"> <wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="UsernameToken-31571602"> <wsse:Username> [email protected]</wsse:Username> <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">welcome123</wsse:Password> </wsse:UsernameToken> </wsse:Security> </soapenv:Header> <soapenv:Body> <team:TeamMembersForProject_Input> <team:projectId>2</team:projectId> <team:userLoginId> [email protected]</team:userLoginId> </team:TeamMembersForProject_Input> </soapenv:Body> </soapenv:Envelope>
Output Response Example
<ns:getTeamMembersForProjectResponse xmlns:ns="http://team.webservices.kanban.app.digite.com/"> <ns:TeamMembers> <ns:TeamMember ns:firstName="chirag" ns:id="1030404" ns:lastName="digite" ns:primaryRole="4" ns:userLoginId="[email protected]"/> </ns:TeamMembers> </ns:getTeamMembersForProjectResponse>
getAllActiveUsersInOrg
Input Elements
| Description | Fetches a list of all active users in the organization. |
| userLoginId | Email address of user to log on to SwiftKanban Example: [email protected] |
| Output | If successful, the response returns a list of all active users in the organization |
Input Response Example
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:team="http://team.webservices.kanban.app.digite.com/"> <soapenv:Header> <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" soapenv:mustUnderstand="1"> <wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="UsernameToken-31571602"> <wsse:Username>[email protected]</wsse:Username> <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">welcome123</wsse:Password> </wsse:UsernameToken> </wsse:Security> </soapenv:Header> <soapenv:Body> <team:AllActiveUsersInOrg_Input> <team:userLoginId>[email protected]</team:userLoginId> </team:AllActiveUsersInOrg_Input> </soapenv:Body> </soapenv:Envelope>
Output Response Example
:getPersonListResponse xmlns:ns="http://team.webservices.kanban.app.digite.com/"> <ns:PersonList> <ns:TeamMember ns:firstName="chirag" ns:id="1030404" ns:lastName="digite" ns:primaryRole="4" ns:userLoginId="[email protected]"/> <ns:TeamMember ns:firstName="ashim1" ns:id="1030406" ns:lastName="kanban" ns:primaryRole="2" ns:userLoginId="[email protected]"/> </ns:PersonList> </ns:getPersonListResponse>
addUser
Input Elements
| Description | Adds a new user in the Organization |
| userLoginId | Email address of a user to log on to SwiftKanban Example: [email protected] |
| userDetails | Details of the user to be added. It might have zero or more repetitions. |
| firstName | First name of the user to be added Example: Ravi |
| lastName | Last name of the user to be added Example: Tiwari |
| loginId | Login Id of the person who is to be added. It should be unique and valid e-mail address. Example: [email protected] |
| emailid | Email Address of the person who is to be added. It should be unique. Example: [email protected] |
| role | Role to be assigned to the user Example: Member |
| timeZone | Time zone in which the user wants the display time Example: Christmas Island Time |
| Output | The response returns the results of an add User action |
Input Response Example
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:team="http://team.webservices.kanban.app.digite.com/"> <soapenv:Header> <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" soapenv:mustUnderstand="1"> <wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="UsernameToken-31571602"> <wsse:Username> [email protected]</wsse:Username> <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">welcome123</wsse:Password> </wsse:UsernameToken> </wsse:Security> </soapenv:Header> <soapenv:Body> <team:AddUser_Input> <team:userLoginId> [email protected]</team:userLoginId> <team:userDetails> <team:firstName>Sam</team:firstName> <team:lastName>Tiwari</team:lastName> <team:loginId>sam</team:loginId> <team:emailId> [email protected]</team:emailId> <team:primaryRole>Member</team:primaryRole> <team:timeZone>Davis Time</team:timeZone> </team:userDetails> </team:AddUser_Input> </soapenv:Body> </soapenv:Envelope>
Output Response Example
<ns:addUser_Response xmlns:ns="http://team.webservices.kanban.app.digite.com/"> <ns:addUserDetails> <ns:loginId>sam.tiwari</ns:loginId> <ns:responseStatus>Successful</ns:responseStatus> <ns:responseMsg>User Added Successfully</ns:responseMsg> </ns:addUserDetails> <ns:addUserDetails> <ns:loginId>ron.parab</ns:loginId> <ns:responseStatus>Successful</ns:responseStatus> <ns:responseMsg>User Added Successfully</ns:responseMsg> </ns:addUserDetails> </ns:addUser_Response>
deleteUser
Input Elements
| Description | Deletes a new user in the Organization. Note: The Contact Person of App Account (Admin menu from Board > Admin > Account >Account Details) cannot be deleted via web service as some other user should be selected as Contact Person while deletion. Moreover, the Integration user also cannot be deleted via this webservice. |
| userLoginId | Email address of user to log on to SwiftKanban Example: [email protected] |
| userDetails | Details of the user to be added. It might have zero or more repetitions. |
| loginId | Login Id of the person who is to be added. It should be unique and valid e-mail address. Example: [email protected] |
| emailId | Email Address of the person who is to be added. It should be unique. Example: [email protected] |
| Output | The response returns the results of add User action |
Input Response Example
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:team="http://team.webservices.kanban.app.digite.com/"> <soapenv:Header> <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" soapenv:mustUnderstand="1"> <wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="UsernameToken-31571602"> <wsse:Username>[email protected]</wsse:Username> <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">welcome123</wsse:Password> </wsse:UsernameToken> </wsse:Security> </soapenv:Header> <soapenv:Body> <team:deleteUser_Input> <team:userLoginId></team:userLoginId> <!--1 or more repetitions:--> <team:userDetails> <team:loginId>OrgSystem_1024080</team:loginId> </team:userDetails> <team:userDetails> <team:loginId>IntegrationUser_1024080</team:loginId> </team:userDetails> <team:userDetails> <team:loginId>[email protected]</team:loginId> </team:userDetails> <team:userDetails> <team:loginId>[email protected]</team:loginId> </team:userDetails> <team:userDetails> <team:loginId>[email protected]</team:loginId> </team:userDetails> </team:deleteUser_Input> </soapenv:Body> </soapenv:Envelope>
Output Response Example
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Body> <ns:deleteUser_Response xmlns:ns="http://team.webservices.kanban.app.digite.com/"> <ns:userDetails> <ns:loginId>[email protected]</ns:loginId> <ns:responseStatus>Failed</ns:responseStatus> <ns:responseMsg>1.Account Contact person can not be deleted.</ns:responseMsg> </ns:userDetails> <ns:userDetails> <ns:loginId>[email protected]</ns:loginId> <ns:responseStatus>Failed</ns:responseStatus> <ns:responseMsg>1.Invalid userId: [email protected]</ns:responseMsg> </ns:userDetails> <ns:userDetails> <ns:loginId>[email protected]</ns:loginId> <ns:responseStatus>Successful</ns:responseStatus> <ns:responseMsg>User Deleteded Successfully</ns:responseMsg> </ns:userDetails> <ns:userDetails> <ns:loginId>IntegrationUser_1024080</ns:loginId> <ns:responseStatus>Failed</ns:responseStatus> <ns:responseMsg>1.Integration user can not be deleted.</ns:responseMsg> </ns:userDetails> <ns:userDetails> <ns:loginId>OrgSystem_1024080</ns:loginId> <ns:responseStatus>Failed</ns:responseStatus> <ns:responseMsg>1.OrgSystem user can not be deleted.</ns:responseMsg> </ns:userDetails> </ns:deleteUser_Response> </soapenv:Body> </soapenv:Envelope>
addTeamMember
Input Elements
| Description | Adds a new team member in a project |
| userLoginId | Email address of user to log on to SwiftKanban Example: [email protected] |
| teamMemberDetails | Details of the user to be added in the team. It might have zero or more |
| projectId | Id of the project that you get from getProject of ProjectService Example: 8 |
| Output | The response returns the results of add Team Member action |
Input Response Example
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:team="http://team.webservices.kanban.app.digite.com/"> <soapenv:Header> <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" soapenv:mustUnderstand="1"> <wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="UsernameToken-31571602"> <wsse:Username>amishra#digite.com</wsse:Username> <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">welcome123</wsse:Password> </wsse:UsernameToken> </wsse:Security> </soapenv:Header> <soapenv:Body> <team:addTeamMember_Input> <team:userLoginId></team:userLoginId> <team:teamMemberDetails> <team:userLoginId> [email protected]</team:userLoginId> <team:role>Member</team:role> <team:projectId>40189</team:projectId> </team:teamMemberDetails> <team:teamMemberDetails> <team:userLoginId> [email protected]</team:userLoginId> <team:role>Member</team:role> <team:projectId>40193</team:projectId> </team:teamMemberDetails> </team:addTeamMember_Input> </soapenv:Body> </soapenv:Envelope>
Output Response Example
<ns:addTeamMember_Response xmlns:ns="http://team.webservices.kanban.app.digite.com/"> <ns:teamMemberDetails> <ns:userLoginId>[email protected]</ns:userLoginId> <ns:projectId>40189</ns:projectId> <ns:responseStatus>Successful</ns:responseStatus> <ns:responseMsg>Team Member Added Successfully</ns:responseMsg> </ns:teamMemberDetails> <ns:teamMemberDetails> <ns:userLoginId>[email protected]</ns:userLoginId> <ns:projectId>40193</ns:projectId> <ns:responseStatus>Successful</ns:responseStatus> <ns:responseMsg>Team Member Added Successfully</ns:responseMsg> </ns:teamMemberDetails> </ns:addTeamMember_Response>
getUserData
Input Elements
| Description | Fetches details of the user |
| userLoginId | Login id of user to log on to SwiftKanban Example: [email protected] |
| loginId | Login id of the user to fetch the details. It could be one or many. Example: [email protected] |
| Output | If successful, the response returns user details |
Input Request Example
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:team="http://team.webservices.kanban.app.digite.com/"> <soapenv:Header> <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" soapenv:mustUnderstand="1"> <wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="UsernameToken-31571602"> <wsse:Username> [email protected]</wsse:Username> <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">welcome123 </wsse:Password> </wsse:UsernameToken> </wsse:Security> </soapenv:Header> <soapenv:Body> <team:UserData_Input> <team:userLoginId></team:userLoginId> <team:loginIds> [email protected]</team:loginIds> <team:loginIds> [email protected]</team:loginIds> </team:UserData_Input> </soapenv:Body> </soapenv:Envelope>
Output Response Example
<ns:getUserDataResponse xmlns:ns="http://team.webservices.kanban.app.digite.com/"> <ns:UserData ns:emailAddress="[email protected]" ns:firstName="Ravi" ns:lastName="Tiwari" ns:loginId="sam#digite.com" ns:primaryRole="Admin"/> <ns:UserData ns:emailAddress="[email protected]" ns:firstName="Kiran" ns:lastName="Gund" ns:loginId="[email protected]" ns:primaryRole="Member"/> </ns:getUserDataResponse>
getUserDataFromEmailId
Input Elements
| Description | Fetches details of the user |
| userLoginId | Login id of userto log on to SwiftKanban Example: [email protected] |
| emailIds | Email Id of user to fetch the details. It could be one or many. Example: [email protected] |
| Output | If successful, the response returns user details |
Input Request Example
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:team="http://team.webservices.kanban.app.digite.com/"> <soapenv:Header> <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" soapenv:mustUnderstand="1"> <wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="UsernameToken-31571602"> <wsse:Username>[email protected]</wsse:Username> <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">welcome123</wsse:Password> </wsse:UsernameToken> </wsse:Security> </soapenv:Header> <soapenv:Body> <team:UserDataFromEmailId_Input> <team:userLoginId>[email protected]</team:userLoginId> <team:emailIds>[email protected],[email protected]</team:emailIds> </team:UserDataFromEmailId_Input> </soapenv:Body> </soapenv:Envelope>
Output Response Example
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Body> <ns:getUserDataFromEmailIdResponse xmlns:ns="http://team.webservices.kanban.app.digite.com/"> <ns:UserData ns:emailAddress="[email protected]" ns:firstName="Sam" ns:lastName="Save" ns:loginId="sam" ns:primaryRole="Reader"/> <ns:UserData ns:emailAddress="[email protected]" ns:firstName="John" ns:lastName="Sable" ns:loginId="john" ns:primaryRole="Reader"/> </ns:getUserDataFromEmailIdResponse> </soapenv:Body>
getAllUsersLastLogin
Input Elements
| Description | Fetches last login date of all active users in Organization. |
| userLoginId | Email address of the user to log on to SwiftKanban. Example: [email protected] |
| Output | If successful, the response return users details with last login date. |
Note: In case if the user has never logged into SwiftKanban Application then lastLoginDate will be 1970-01-01.
Input Request Example
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:team="http://team.webservices.kanban.app.digite.com/"> <soapenv:Header> <wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd" soapenv:mustUnderstand="1"> <wsse:UsernameToken xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" wsu:Id="UsernameToken-31571602"> <wsse:Username> [email protected]</wsse:Username> <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">welcome123</wsse:Password> </wsse:UsernameToken> </wsse:Security> </soapenv:Header> <soapenv:Body> <team:AllUsersLastLogin_Input> <team:userLoginId> [email protected]</team:userLoginId> </team:AllUsersLastLogin_Input> </soapenv:Body> </soapenv:Envelope>
Output Response Example
<?xml version="1.0" encoding="UTF-8"?> <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Body> <ns:getAllUsersLastLoginResponse xmlns:ns="http://team.webservices.kanban.app.digite.com/"> <ns:lastLoginUsersList> <ns:userData ns:CreatedDate="2015-04-22T05:59:45Z" ns:emailAddress=" [email protected]" ns:lastLoginDate="2016-06-14T11:02:14Z" ns:userId=" [email protected]" ns:userName="dolton d" /> <ns:userData ns:CreatedDate="2015-05-04T06:41:24Z" ns:emailAddress=" [email protected]" ns:lastLoginDate="2016-06-03T10:23:05Z" ns:userId=" [email protected]" ns:userName="Kiran Gund" /> <ns:userData ns:CreatedDate="2015-04-22T05:51:33Z" ns:emailAddress=" [email protected]" ns:lastLoginDate="1970-01-01T05:40:03Z" ns:userId=" [email protected]" ns:userName="Dinanath Parab" /> </ns:lastLoginUsersList> </ns:getAllUsersLastLoginResponse> </soapenv:Body> </soapenv:Envelope>