kz.arta.synergy.server.api.rest.filecabinet
Class UsersService

java.lang.Object
  kz.arta.synergy.server.api.rest.filecabinet.UsersService

public class UsersService
extends java.lang.Object

 User: topa
 Date: 03.05.13
 Time: 17:52
 

Since:

2.31

Constructor Summary

UsersService()

Method Summary

java.lang.String	createUser(java.lang.String lastname, java.lang.String firstname, java.lang.String patronymic, java.lang.String pointersCode, boolean isChancellery, boolean isConfigurator, boolean isAdmin, java.lang.String email, java.lang.String jid, java.lang.String privateFolder, boolean hasAccess, boolean hasPointersBookAccess, boolean hasStrategyAccess, java.util.List<java.lang.String> hrDepartmentID, java.lang.String userID, java.lang.String locale) Метод создает/изменяет пользователя URL rest/api/filecabinet/user/save Method POST
java.lang.String	deleteUser(java.lang.String userID, java.lang.String locale) Метод удаляет пользователя из системы URL rest/api/filecabinet/user/delete Method GET
java.lang.String	getUser(java.lang.String userID, java.lang.String locale, boolean getGroups) Load and return basic iformation on user as json object URL rest/api/filecabinet/user/{userID} Method GET
java.lang.String	getUserContacts(java.lang.String userID, java.lang.String locale) Load and return user contacts as list of json objects
java.lang.String	getUsersByFieldValue(java.lang.String formUUID, java.lang.String fieldName, java.lang.String value, java.lang.String locale) Находит пользователей по значению поля дополнительной карточки и возвращает список их идентификаторов URL rest/api/filecabinet/get_by_field_value Method GET Предполагается, что данный метод будет использоваться для реализации интеграционных решений (синхронизации пользователей ARTA Synergy с пользователями сторонней системы).

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

UsersService

public UsersService()

Method Detail

getUser

public java.lang.String getUser(java.lang.String userID,
                                java.lang.String locale,
                                boolean getGroups)

Load and return basic iformation on user as json object

URL rest/api/filecabinet/user/{userID}
Method GET

Parameters:

userID - user's UUID, path param

locale - actor's locale, query param, default - ru

Returns:

info on person as json object

See Also:

PersonWrapper.getJsonObject(arta.synergy.web.common.client.data.filecabinet.Person)

getUserContacts

public java.lang.String getUserContacts(java.lang.String userID,
                                        java.lang.String locale)

Load and return user contacts as list of json objects

Parameters:

userID -

locale -

Returns:

See Also:

Contact.getJsonObject()

createUser

public java.lang.String createUser(java.lang.String lastname,
                                   java.lang.String firstname,
                                   java.lang.String patronymic,
                                   java.lang.String pointersCode,
                                   boolean isChancellery,
                                   boolean isConfigurator,
                                   boolean isAdmin,
                                   java.lang.String email,
                                   java.lang.String jid,
                                   java.lang.String privateFolder,
                                   boolean hasAccess,
                                   boolean hasPointersBookAccess,
                                   boolean hasStrategyAccess,
                                   java.util.List<java.lang.String> hrDepartmentID,
                                   java.lang.String userID,
                                   java.lang.String locale)

Метод создает/изменяет пользователя

URL rest/api/filecabinet/user/save
Method POST

Parameters:

lastname - фамилия, FormParam

firstname - имя, FormParam

patronymic - отчество, FormParam

pointersCode - код показателя, FormParam

isChancellery - является ли сотрудником канцелярии, FormParam

isConfigurator - является ли методологом, FormParam

isAdmin - является ли администратором системы, FormParam

email - почтовый адрес для уведомлений, FormParam

jid - адрес jabber аккаунта, FormParam

privateFolder - личная папка, FormParam

hasAccess - имеет ли доступ в систему, FormParam

hasPointersBookAccess - имеет ли доступ к справочнику показателей, FormParam

hasStrategyAccess - имеет ли доступ к стратегии, FormParam

hrDepartmentID - UUID подразделений, в которых является сотрудником ОКК, FormParam

userID - идентификатор пользователя. Необходимо передавать если должно выполниться изменение существующего пользователя

locale - локаль пользователя, по-умолчанию ru, QueryParam

Returns:

json объект с полями - errorCode - код выполнения операции (0 успешно, иначе - ошибка), errorMessage - сообщение об ошибке. В случае успешного выполнения так же возвращается userID идентификатор созданного/измененного пользователя

deleteUser

public java.lang.String deleteUser(java.lang.String userID,
                                   java.lang.String locale)

Метод удаляет пользователя из системы

URL rest/api/filecabinet/user/delete
Method GET

Parameters:

userID - UUID пользователя, которого надо удалить (QueryParam)

locale - локаль пользователя, выполняющего действие (QueryParam)

Returns:

json объект с полями - errorCode - код выполнения операции (0 успешно, иначе - ошибка), errorMessage - сообщение об ошибке.

getUsersByFieldValue

public java.lang.String getUsersByFieldValue(java.lang.String formUUID,
                                             java.lang.String fieldName,
                                             java.lang.String value,
                                             java.lang.String locale)

Находит пользователей по значению поля дополнительной карточки и возвращает список их идентификаторов

URL rest/api/filecabinet/get_by_field_value
Method GET

Предполагается, что данный метод будет использоваться для реализации интеграционных решений (синхронизации пользователей ARTA Synergy с пользователями сторонней системы). В дополнительной карточке пользователя может храниться идентификатор соответствующего пользователя в сторонней системе (или иное поле, присутствующее в обоих системах и позволяющее установить соответствие между пользователями, например, ИИН) этот метод позволит найти идентификатор пользователя в нашей системе по его идентификатору из сторонней системы

Parameters:

formUUID - uuid формы, по полю которой необходимо произвести поиск

fieldName - название поля, по которому необходимо произвести поиск

value - значение поля

locale - локаль пользователя (по-умолчанию ru)

Returns:

список, состоящий из идентификаторов пользователей