com.trackstudio.soap.service.task
Class Task

java.lang.Object
  extended by com.trackstudio.soap.service.task.Task

public class Task
extends java.lang.Object

Класс описывает web-сервис для работы с задачами


Constructor Summary
Task()
           
 
Method Summary
 boolean allowedByACL(java.lang.String sessionId, java.lang.String taskId)
          Проверяет есть ли доступ залогиненного пользователя к указанной задаче посредством прав доступа
 java.lang.String createTask(java.lang.String sessionId, java.lang.String categoryId, java.lang.String shortname, java.lang.String name, java.lang.String description, long budget, long deadline, java.lang.String priorityId, java.lang.String parentId, java.lang.String handlerUserId, java.lang.String handlerGroupId, java.lang.String[] udfNames, java.lang.String[] udfValues)
          Триггер при создании задачи
 java.lang.String createTaskStatus(java.lang.String sessionId, java.lang.String categoryId, java.lang.String shortname, java.lang.String name, java.lang.String description, long budget, long deadline, java.lang.String priorityId, java.lang.String parentId, java.lang.String handlerUserId, java.lang.String handlerGroupId, java.lang.String[] udfNames, java.lang.String[] udfValues, java.lang.String statusId)
           
 void deleteTask(java.lang.String sessionId, java.lang.String taskId)
          Удаляет задачу
 SimilarTaskBean findSimilar(java.lang.String sessionId, java.lang.String taskId)
          Возвращает задачи, подобные указазнной
 TaskBean findTaskByName(java.lang.String sessionId, java.lang.String name)
           
 TaskBean findTaskByNumber(java.lang.String sessionId, java.lang.String number)
          Возвращает задачу по ее номеру
 java.lang.String findTaskIdByQuickGo(java.lang.String sessionId, java.lang.String quickGo)
          Возвращает ID задачи.
 TaskBean[] getChildrenTasks(java.lang.String sessionId, java.lang.String taskId)
          Возвращает список дочерних задач
 TaskBean[] getProjectChildren(java.lang.String sessionId, java.lang.String taskId)
          Возвращает список дочерних задач для проекта
 TaskBean[] getTaskChain(java.lang.String sessionId, java.lang.String startTaskId, java.lang.String stopTaskId)
          Возвращает цепочку задач от начальной до конечной
 java.util.ArrayList<java.lang.Integer> getTaskErrors()
           
 TaskSliderBean getTaskList(java.lang.String sessionId, java.lang.String taskId, TaskFvalueBean fvalue, boolean withUdf, int pageNumber, java.util.ArrayList<java.lang.String> order)
          Возвращает список отфильтрованных задач
 TaskExtendedBean[] getTaskListByQuery(java.lang.String sessionId, java.lang.String query)
          Возвращает список задач по SQL-запросу
 TaskSliderBean getTaskListForFilter(java.lang.String sessionId, java.lang.String taskId, java.lang.String filterId, boolean withUdf, int pageNumber, java.util.ArrayList<java.lang.String> order)
          Возвращает список отфильтрованных задач
 java.lang.String importTask(java.lang.String sessionId, java.lang.String taskNumber, java.lang.String taskName, java.lang.String taskShortName, java.lang.String taskDescription, long taskBudget, long taskDeadline, java.lang.String taskPriority, java.lang.String taskParent, java.lang.String taskHandlerUser, java.lang.String taskHandlerGroup, java.lang.String taskCategory, java.lang.String taskSubmitter, long taskSubmitDate, long taskUpdateDate, long taskCloseDate, java.lang.String taskResolution, java.lang.String taskStatus, java.lang.String[] taskUDFNames, java.lang.String[] taskUDFValues)
          Импортирует задачу
 void pasteTasks(java.lang.String sessionId, java.lang.String parentId, java.lang.String taskIds, java.lang.String operation)
          Вставляет указанные задачи, операция PASTE
 void setTaskErrors(java.util.ArrayList<java.lang.Integer> errors)
           
 void updateTask(java.lang.String sessionId, java.lang.String taskId, java.lang.String shortName, java.lang.String name, java.lang.String description, long budget, long deadline, java.lang.String priorityId, java.lang.String parentTaskId, java.lang.String handlerUserId, java.lang.String handlerGroupId, boolean sendMail, java.lang.String[] udfNames, java.lang.String[] udfValues)
          Триггер при редактировании задачи
 void updateTaskWithoutUdf(java.lang.String sessionId, java.lang.String taskId, java.lang.String shortName, java.lang.String name, java.lang.String description, long budget, long deadline, java.lang.String priorityId, java.lang.String parentTaskId, java.lang.String handlerUserId, java.lang.String handlerGroupId, boolean sendMail)
          Триггер для редактировании задачи, пользовательские поля не меняються
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Task

public Task()
Method Detail

getTaskErrors

public java.util.ArrayList<java.lang.Integer> getTaskErrors()

setTaskErrors

public void setTaskErrors(java.util.ArrayList<java.lang.Integer> errors)

updateTask

public void updateTask(java.lang.String sessionId,
                       java.lang.String taskId,
                       java.lang.String shortName,
                       java.lang.String name,
                       java.lang.String description,
                       long budget,
                       long deadline,
                       java.lang.String priorityId,
                       java.lang.String parentTaskId,
                       java.lang.String handlerUserId,
                       java.lang.String handlerGroupId,
                       boolean sendMail,
                       java.lang.String[] udfNames,
                       java.lang.String[] udfValues)
                throws java.lang.Exception
Триггер при редактировании задачи

Parameters:
sessionId - сессия
taskId - ID
shortName - алиас
name - название
description - описание
budget - бюджет
deadline - дедлайн
priorityId - ID приоритета
parentTaskId - ID родительской задачи
handlerUserId - ID ответственного пользователя
handlerGroupId - ID ответственного статуса
sendMail - надо ли отправить мообщение
udfNames - список названий полей
udfValues - список значений полей
Throws:
GranException - при необходимости
java.lang.Exception

importTask

public java.lang.String importTask(java.lang.String sessionId,
                                   java.lang.String taskNumber,
                                   java.lang.String taskName,
                                   java.lang.String taskShortName,
                                   java.lang.String taskDescription,
                                   long taskBudget,
                                   long taskDeadline,
                                   java.lang.String taskPriority,
                                   java.lang.String taskParent,
                                   java.lang.String taskHandlerUser,
                                   java.lang.String taskHandlerGroup,
                                   java.lang.String taskCategory,
                                   java.lang.String taskSubmitter,
                                   long taskSubmitDate,
                                   long taskUpdateDate,
                                   long taskCloseDate,
                                   java.lang.String taskResolution,
                                   java.lang.String taskStatus,
                                   java.lang.String[] taskUDFNames,
                                   java.lang.String[] taskUDFValues)
                            throws java.lang.Exception
Импортирует задачу

Parameters:
sessionId - сессия пользователя
taskNumber - номер задачи
taskName - название задачи
taskShortName - алиас задачи
taskDescription - описание задачи
taskBudget - бюджет задачи
taskDeadline - дедлайн
taskPriority - приоритет
taskParent - родительская задача
taskHandlerUser - ответственный пользователь
taskHandlerGroup - ответственный статус
taskCategory - категория
taskSubmitter - автор
taskSubmitDate - дата создания
taskUpdateDate - дата обновления
taskCloseDate - дата закрытия
taskResolution - резолюция
taskStatus - статус
taskUDFNames - названия пользовательских полей
taskUDFValues - значения пользовательских полей
Returns:
ID созданной задачи
Throws:
java.lang.Exception - при необходимости

deleteTask

public void deleteTask(java.lang.String sessionId,
                       java.lang.String taskId)
                throws java.lang.Exception
Удаляет задачу

Parameters:
sessionId - сессия пользователя
taskId - ID удаляемой задачи
Throws:
GranException - при необходимости
java.lang.Exception

getTaskChain

public TaskBean[] getTaskChain(java.lang.String sessionId,
                               java.lang.String startTaskId,
                               java.lang.String stopTaskId)
                        throws java.lang.Exception
Возвращает цепочку задач от начальной до конечной

Parameters:
sessionId - сессия пользователя
startTaskId - ID начальной задачи
stopTaskId - ID конечной задачи
Returns:
список задач
Throws:
GranException - при необходимости
java.lang.Exception
See Also:
TaskRelatedInfo

findTaskIdByQuickGo

public java.lang.String findTaskIdByQuickGo(java.lang.String sessionId,
                                            java.lang.String quickGo)
                                     throws java.lang.Exception
Возвращает ID задачи. Поиск идет вначале по номеру, потом по алиасу, потом по названию, если задача не найдена, то возвращается null

Parameters:
sessionId - сессия пользователя
quickGo - номер, алиас или название задачи
Returns:
ID задачи
Throws:
GranException - при необходимости
java.lang.Exception

getTaskListForFilter

public TaskSliderBean getTaskListForFilter(java.lang.String sessionId,
                                           java.lang.String taskId,
                                           java.lang.String filterId,
                                           boolean withUdf,
                                           int pageNumber,
                                           java.util.ArrayList<java.lang.String> order)
                                    throws java.lang.Exception
Возвращает список отфильтрованных задач

Parameters:
sessionId - сессия пользователя
filterId - ID фильтра
withUdf - Нудна ли фильтрация пользовательских полей
taskId - ID задачи
pageNumber - номер страницы
order - порядок сортировки
Returns:
Список задач
Throws:
GranException - при необходимости
java.lang.Exception
See Also:
SecuredTaskBean

getTaskList

public TaskSliderBean getTaskList(java.lang.String sessionId,
                                  java.lang.String taskId,
                                  TaskFvalueBean fvalue,
                                  boolean withUdf,
                                  int pageNumber,
                                  java.util.ArrayList<java.lang.String> order)
                           throws java.lang.Exception
Возвращает список отфильтрованных задач

Parameters:
sessionId - сессия пользователя
fvalue - Параметры фильтрации
withUdf - Нудна ли фильтрация пользовательских полей
taskId - ID задачи
pageNumber - номер страницы
order - порядок сортировки
Returns:
Список задач
Throws:
GranException - при необходимости
java.lang.Exception
See Also:
SecuredTaskBean

findSimilar

public SimilarTaskBean findSimilar(java.lang.String sessionId,
                                   java.lang.String taskId)
                            throws java.lang.Exception
Возвращает задачи, подобные указазнной

Parameters:
sessionId - сессия пользователя
taskId - ID задачи, для которой изем подобные
Returns:
карта (Map), содержащая ID найденных задач и числовые значения, означающие степень "подобности"
Throws:
GranException - при необходимости
java.lang.Exception

allowedByACL

public boolean allowedByACL(java.lang.String sessionId,
                            java.lang.String taskId)
                     throws java.lang.Exception
Проверяет есть ли доступ залогиненного пользователя к указанной задаче посредством прав доступа

Parameters:
sessionId - сессия пользователя
taskId - ID задачи
Returns:
TRUE - если доступ есть, FALSE - если нет
Throws:
GranException - при необходимости
java.lang.Exception

findTaskByNumber

public TaskBean findTaskByNumber(java.lang.String sessionId,
                                 java.lang.String number)
                          throws java.lang.Exception
Возвращает задачу по ее номеру

Parameters:
sessionId - сессия пользователя
number - Номер задачи
Returns:
ID задачи
Throws:
GranException - при необзодимости
java.lang.Exception
See Also:
SecuredTaskBean

findTaskByName

public TaskBean findTaskByName(java.lang.String sessionId,
                               java.lang.String name)
                        throws java.lang.Exception
Throws:
java.lang.Exception

getProjectChildren

public TaskBean[] getProjectChildren(java.lang.String sessionId,
                                     java.lang.String taskId)
                              throws java.lang.Exception
Возвращает список дочерних задач для проекта

Parameters:
sessionId - сессия пользователя
taskId - ID задачи
Returns:
список задач
Throws:
GranException - при необходимости
java.lang.Exception

getChildrenTasks

public TaskBean[] getChildrenTasks(java.lang.String sessionId,
                                   java.lang.String taskId)
                            throws java.lang.Exception
Возвращает список дочерних задач

Parameters:
sessionId - сессия пользователя
taskId - ID задачи, для которой ищутся дочерние
Returns:
список задач
Throws:
GranException - при необходимости
java.lang.Exception

pasteTasks

public void pasteTasks(java.lang.String sessionId,
                       java.lang.String parentId,
                       java.lang.String taskIds,
                       java.lang.String operation)
                throws java.lang.Exception
Вставляет указанные задачи, операция PASTE

Parameters:
sessionId - сессия пользователя
parentId - ID задачи, куда вставляем
taskIds - ID вставляемых задач
operation - тип операцуии, COPY или CUT
Throws:
GranException - при необходимости
java.lang.Exception

createTask

public java.lang.String createTask(java.lang.String sessionId,
                                   java.lang.String categoryId,
                                   java.lang.String shortname,
                                   java.lang.String name,
                                   java.lang.String description,
                                   long budget,
                                   long deadline,
                                   java.lang.String priorityId,
                                   java.lang.String parentId,
                                   java.lang.String handlerUserId,
                                   java.lang.String handlerGroupId,
                                   java.lang.String[] udfNames,
                                   java.lang.String[] udfValues)
                            throws java.lang.Exception
Триггер при создании задачи

Parameters:
sessionId - сессия
categoryId - ID категории
shortname - алиас
name - название
description - описание
budget - бюджет
deadline - дедлайн
priorityId - ID приоритета
parentId - ID родительской задачи
handlerUserId - ID ответственного пользователя
handlerGroupId - ID ответственного статуса
udfNames - список названий полей
udfValues - список значений полей
Returns:
ID задачи
Throws:
GranException - при необходимости
java.lang.Exception

createTaskStatus

public java.lang.String createTaskStatus(java.lang.String sessionId,
                                         java.lang.String categoryId,
                                         java.lang.String shortname,
                                         java.lang.String name,
                                         java.lang.String description,
                                         long budget,
                                         long deadline,
                                         java.lang.String priorityId,
                                         java.lang.String parentId,
                                         java.lang.String handlerUserId,
                                         java.lang.String handlerGroupId,
                                         java.lang.String[] udfNames,
                                         java.lang.String[] udfValues,
                                         java.lang.String statusId)
                                  throws java.lang.Exception
Throws:
java.lang.Exception

getTaskListByQuery

public TaskExtendedBean[] getTaskListByQuery(java.lang.String sessionId,
                                             java.lang.String query)
                                      throws java.lang.Exception
Возвращает список задач по SQL-запросу

Parameters:
sessionId - сессия пользователя
query - запрос вида SELECT t.id FROM com.trackstudio.model.Task AS t WHERE ...
Returns:
список ID Задач
Throws:
GranException - при необзодимости
java.lang.Exception

updateTaskWithoutUdf

public void updateTaskWithoutUdf(java.lang.String sessionId,
                                 java.lang.String taskId,
                                 java.lang.String shortName,
                                 java.lang.String name,
                                 java.lang.String description,
                                 long budget,
                                 long deadline,
                                 java.lang.String priorityId,
                                 java.lang.String parentTaskId,
                                 java.lang.String handlerUserId,
                                 java.lang.String handlerGroupId,
                                 boolean sendMail)
                          throws java.lang.Exception
Триггер для редактировании задачи, пользовательские поля не меняються

Parameters:
sessionId - сессия
taskId - ID
shortName - алиас
name - название
description - описание
budget - бюджет
deadline - дедлайн
priorityId - ID приоритета
parentTaskId - ID родительской задачи
handlerUserId - ID ответственного пользователя
handlerGroupId - ID ответственного статуса
sendMail - надо ли отправить мообщение
Throws:
GranException - при необходимости
java.lang.Exception


Copyright © 2002-2009 TrackStudio, Ltd. All Rights Reserved.