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

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

public class PositionsService
extends java.lang.Object

Created by IntelliJ IDEA. User: topa Date: 23.08.13 Time: 18:08

Содержит методы для управления должностями, назначением на должности

Constructor Summary

PositionsService()

Method Summary

java.lang.String	appointAssistant(java.lang.String nameRu, java.lang.String nameKz, java.lang.String nameEn, int number, java.lang.String departmentID, java.util.List<java.lang.String> childDepartmentID, java.lang.String userID, java.lang.String locale) Метод создает должность заместителя подразделения и назначает на него пользователя URL rest/api/positions/assistant/appoint Method POST
java.lang.String	appointToPosition(java.lang.String positionID, java.lang.String userID, java.lang.String locale) Метод назначает на должность специалиста/руководителя подразделения URL rest/api/positions/appoint Method GET
java.lang.String	deleteAssistant(java.lang.String assistantID, java.lang.String locale) Метод удаляет должность заместителя и увольняет с нее назначенного пользователя URL rest/api/positions/assistant/delete Method POST
java.lang.String	deletePosition(java.lang.String positionID, java.lang.String locale) Метод удаляет должность специалиста URL rest/api/positions/delete Method GET
java.lang.String	dischargeFromPosition(java.lang.String positionID, java.lang.String userID, java.lang.String locale) Метод снимает с должности специалиста/руководителя подразделения URL rest/api/positions/discharge Method GET
java.lang.String	getAssistants(java.lang.String departmentID, java.lang.String locale) Возвращает информацию о заместителях руководителя подразделения URL rest/api/positions/assistant/get Method GET
java.lang.String	getPosition(java.lang.String positionID, java.lang.String locale) Метод возвращает информацию о должности URL rest/api/positions/get Method GET
java.lang.String	getPositionCards(java.lang.String positionID, java.lang.String locale) Возвращает список дополнительных карточек для данной должности URL rest/api/positions/get_cards Method POST Для заполнения полей карточки надо использовать метод APIFormsService#save
java.lang.String	getPositionsByFieldValue(java.lang.String formUUID, java.lang.String fieldName, java.lang.String value, java.lang.String locale) Находит должности по значению поля дополнительной карточки и возвращает список их идентификаторов URL rest/api/positions/get_by_field_value Method POST Предполагается, что данный метод будет использоваться для реализации интеграционных решений (синхронизации орг структуры ARTA Synergy с орг структурой сторонней системы).
java.lang.String	saveAssistant(java.lang.String nameRu, java.lang.String nameKz, java.lang.String nameEn, int number, java.lang.String departmentID, java.util.List<java.lang.String> childDepartmentID, java.lang.String userID, java.lang.String assistantID, java.lang.String locale) Метод изменяет данные заместителя руководителя URL rest/api/positions/assistant/save Method POST
java.lang.String	savePosition(java.lang.String nameRu, java.lang.String nameKz, java.lang.String nameEn, java.lang.String pointersCode, java.lang.String departmentID, java.lang.String positionID, int positionType, int number, java.lang.String locale) Метод создает/изменяет должность (специалиста/руководителя) орг структуры URL rest/api/positions/save Method POST

Methods inherited from class java.lang.Object

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

Constructor Detail

PositionsService

public PositionsService()

Method Detail

savePosition

public java.lang.String savePosition(java.lang.String nameRu,
                                     java.lang.String nameKz,
                                     java.lang.String nameEn,
                                     java.lang.String pointersCode,
                                     java.lang.String departmentID,
                                     java.lang.String positionID,
                                     int positionType,
                                     int number,
                                     java.lang.String locale)

Метод создает/изменяет должность (специалиста/руководителя) орг структуры

URL rest/api/positions/save
Method POST

Parameters:

nameRu - Название должности на русском языке, FormParam

nameKz - Название должности на казахском языке, FormParam

nameEn - Название должности на английском языке, FormParam

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

positionID - UUID должности, FormParam

departmentID - UUID родительского подразделения, FormParam

positionType - тип должности, FormParam

number - порядковый номер дожности, может отсутствовать, FormParam

locale - локаль пользователя, QueryParam

Returns:

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

deletePosition

public java.lang.String deletePosition(java.lang.String positionID,
                                       java.lang.String locale)

Метод удаляет должность специалиста

URL rest/api/positions/delete
Method GET

Parameters:

positionID - UUID должности, которую необходимо удалить (QueryParam)

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

Returns:

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

getPosition

public java.lang.String getPosition(java.lang.String positionID,
                                    java.lang.String locale)

Метод возвращает информацию о должности

URL rest/api/positions/get
Method GET

Parameters:

positionID - UUID должности, которую необходимо удалить (QueryParam)

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

Returns:

appointToPosition

public java.lang.String appointToPosition(java.lang.String positionID,
                                          java.lang.String userID,
                                          java.lang.String locale)

Метод назначает на должность специалиста/руководителя подразделения

URL rest/api/positions/appoint
Method GET

Parameters:

positionID - UUID должности на которую надо назначить специалиста (QueryParam)

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

locale - локаль пользователя, вызвавшего метод (QueryParam)

Returns:

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

dischargeFromPosition

public java.lang.String dischargeFromPosition(java.lang.String positionID,
                                              java.lang.String userID,
                                              java.lang.String locale)

Метод снимает с должности специалиста/руководителя подразделения

URL rest/api/positions/discharge
Method GET

Parameters:

positionID - UUID должности (QueryParam)

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

locale - локаль пользователя, вызвавшего метод (по умолчанию ru) (QueryParam)

Returns:

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

appointAssistant

public java.lang.String appointAssistant(java.lang.String nameRu,
                                         java.lang.String nameKz,
                                         java.lang.String nameEn,
                                         int number,
                                         java.lang.String departmentID,
                                         java.util.List<java.lang.String> childDepartmentID,
                                         java.lang.String userID,
                                         java.lang.String locale)

Метод создает должность заместителя подразделения и назначает на него пользователя

URL rest/api/positions/assistant/appoint
Method POST

Parameters:

nameRu - название должности на русском языке (FormParam)

nameKz - название должности на казахском языке (FormParam)

nameEn - название должности на русском языке (FormParam)

departmentID - UUID родительского департамента (FormParam)

childDepartmentID - UUID-ы дочерних подразделений (FormParam)

userID - UUID пользователя которого надо назначить на должность (FormParam)

number - порядковый номер для сортировки (по умолчанию 0) (FormParam)

locale - локаль пользователя, вызвавшего метод (по умолчанию ru) (QueryParam)

Returns:

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

saveAssistant

public java.lang.String saveAssistant(java.lang.String nameRu,
                                      java.lang.String nameKz,
                                      java.lang.String nameEn,
                                      int number,
                                      java.lang.String departmentID,
                                      java.util.List<java.lang.String> childDepartmentID,
                                      java.lang.String userID,
                                      java.lang.String assistantID,
                                      java.lang.String locale)

Метод изменяет данные заместителя руководителя

URL rest/api/positions/assistant/save
Method POST

Parameters:

nameRu - название должности на русском языке (FormParam)

nameKz - название должности на казахском языке (FormParam)

nameEn - название должности на русском языке (FormParam)

departmentID - UUID родительского департамента (FormParam)

childDepartmentID - UUID-ы дочерних подразделений (FormParam)

userID - UUID пользователя которого надо назначить на должность (FormParam)

number - порядковый номер для сортировки (по умолчанию 0) (FormParam)

assistantID - идентификатор заместителя (FormParam)

locale - локаль пользователя, вызвавшего метод (по умолчанию ru) (QueryParam)

Returns:

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

getAssistants

public java.lang.String getAssistants(java.lang.String departmentID,
                                      java.lang.String locale)

Возвращает информацию о заместителях руководителя подразделения

URL rest/api/positions/assistant/get
Method GET

Parameters:

departmentID - идентификатор подразделения, для которого необходимо получить заместителей

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

Returns:

список заместителей, см FileCabinetWrapper#getAssistantJson

See Also:

FileCabinetWrapper.getAssistantJson(arta.synergy.web.common.client.data.filecabinet.Assistant)

deleteAssistant

public java.lang.String deleteAssistant(java.lang.String assistantID,
                                        java.lang.String locale)

Метод удаляет должность заместителя и увольняет с нее назначенного пользователя

URL rest/api/positions/assistant/delete
Method POST

Parameters:

assistantID - UUID должности заместителя

locale - локаль пользователя, вызвавшего метод

Returns:

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

getPositionCards

public java.lang.String getPositionCards(java.lang.String positionID,
                                         java.lang.String locale)

Возвращает список дополнительных карточек для данной должности

URL rest/api/positions/get_cards
Method POST
Для заполнения полей карточки надо использовать метод APIFormsService#save

Parameters:

positionID - uuid должности

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

Returns:

список json объектов с информацией о карточке должности, для каждой карточки присутствуют поля:
form-uuid uuid формы
name название карточки
editable true - есть право наредактирование, иначе - false
data-uuid uuid данных по данной карточке
mandatory true - карточкая обязательна для заполнения, иначе - false

See Also:

kz.arta.synergy.server.api.rest.asforms.APIFormsService#save(String, String, String)

getPositionsByFieldValue

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

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

URL rest/api/positions/get_by_field_value
Method POST

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

Parameters:

formUUID - идентификатор формы

fieldName - название поля

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

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

Returns:

список идентификаторов должностей