Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

Pobieranie listy użytkowników

Ścieżka do servletu: api/users/query

Metoda: GET

Parametry:

  • query - fraza, na podstawie której zostaną przefiltrowane wyniki. Filtrowanie dotyczy loginu, imienia i nazwiska użytkowników.
  • start - przesunięcie w zbiorze wynikowym
  • limit - maksymalna ilość zwracanych wyników

Odpowiedź:

  • Odpowiedź zawiera obiekt przechowujący całkowitą ilość wyników w polu total, oraz listę użytkowników w polu data.

 

Code Block
languagejavascript
titlePrzykładowa odpowiedź
linenumberstrue
{
   "total":3,
   "data":[
      {
         "userName":"admin",
         "objectId":1000036,
         "firstName":"Default User",
         "lastName":"",
         "email":"",
         "active":true,
 		 "number":"122",
         "positions":null,
         "groups":null,
         "fullName":"Default User "
      },
      {
         "userName":"afd",
         "objectId":1001001,
         "firstName":"fdsfasd",
         "lastName":"sdfs",
         "email":"",
         "active":true,
         "positions":null,
		 "number":"124",
         "groups":null,
         "fullName":"fdsfasd sdfs"
      }
   ]
}

Pobieranie listy użytkowników po rolach

Ścieżka do servletu: api/users/by/roles

Metoda: POST

Request Content-Typeapplication/json

Treść zapytania:

 Lista obiektów JSON zawierający parametry wyszukiwania ról. Definicja obiektu powinna zawierać następujące pole:

    • packageId Id pakietu w którym będą wyszukiwane role
    • processDefId Id procesu w którym będą wyszukiwane role
    • roleIds List id ról(id tekstowe)

Wszystkie parametry są opcjonalne. Jeżeli podamy processDefId to zostaną wyszukane również role globalne użyte w tym procesie. Warunki w obrębie pojedynczego elementu są połączone operatorem AND(np. jeżeli podamy packegeId i processDefId). Natomiast warunki poszczególnych elementów listy warunków są połączone operatorem OR np:

Code Block
languagejavascript
titlePrzykładowe zapytanie
linenumberstrue
[  //Zapytanie znajdzie użytkowników o roli uczestnik_1 z pakietu suncode_api z procesu zapisformularza
   //oraz użytkowników o roli uczestnik_3 z pakietu suncode_api z procesu faktury
   {  
      "processDefId":"zapisformularza",
      "packageId":"suncode_api",
      "roleIds":[  
         "uczestnik_1"
      ]
   },
   {  
      "processDefId":"faktury",
      "packageId":"suncode_api",
      "roleIds":[  
         "uczestnik_3"
      ]
   }
]


Odpowiedź:

  • Odpowiedź zawiera listę użytkowników

 

Code Block
languagejavascript
titlePrzykładowa odpowiedź
linenumberstrue
[
      {
         "userName":"admin",
         "objectId":1000036,
         "firstName":"Default User",
         "lastName":"",
         "email":"",
         "active":true,
         "positions":null,
         "groups":null,
		 "number":"123",
         "fullName":"Default User "
      },
      {
         "userName":"afd",
         "objectId":1001001,
         "firstName":"fdsfasd",
         "lastName":"sdfs",
         "email":"",
         "active":true,
		 "number":"124",
         "positions":null,
         "groups":null,
         "fullName":"fdsfasd sdfs"
      }
]