 |
Метод RevokeInstruction (Отозвать отправленное поручение)
|
|
|
|
Метод отзыва отправленного поручения.
Формат вызова:
void RevokeInstruction (int instructionId)
Параметры:
§ instructionId – идентификатор отправленного поручения.
Права на выполнение операции:
Пользователь должен быть одним из лиц, указанных в поручении –
§ создателем,
§ инициатором,
§ получателем отчета,
§ контролером.
Дополнительные условия:
Ø Текущее состояние поручения должно позволять его отзыв, т.е поручение должно находиться в состоянии Проект, Активно или В работе.
Ø Если для отправки поручения использовалась рассылка (веер или цепочка) с ответственным исполнителем, то операция не может быть выполнена для поручения, направленного отв. исполнителю – в этом случае надо отзывать всю цепочку.
Метод RevokeChain (Отозвать полностью цепочку или веер)
Метод отзыва поручения, отправленного веером или по цепочке, у всех получателей.
Формат вызова:
void RevokeChain (int instructionId)
Параметры:
§ instructionId – идентификатор первого поручения в цепочке/веере.
Права на выполнение операции:
Пользователь должен быть одним из лиц, указанных в поручении –
§ создателем,
§ инициатором,
§ получателем отчета,
§ контролером.
Дополнительные условия:
§ Текущее состояние всех поручений в рассылке (цепочке или веере) должно позволять его отзыв, т.е. поручение должно находиться в состоянии Проект, Активно или В работе.
§ Метод может быть использован и в том случае, если в пакете содержится только одно поручение.
Метод DeleteObject (Удалить поручение, отчет или уведомление)
Метод физического удаления отправленного поручения, уведомления или отчета о выполнении поручения.
Формат вызова:
void DeleteObject (int objectID, bool removeChildren)
Параметры:
§ objectID – идентификатор удаляемого объекта;
|
|
|
§ removeChildren – если установлено значение true, то связанные отчеты будут удалены, если false, то при наличии отчетов возникнет ошибка.
Права на выполнение операции:
§ Пользователь должен быть создателем или инициатором сообщения
§ Или обладать правами на удаление поручений и сообщений (OperTypeID=41).
Дополнительное условие:
Текущее состояние поручения должно позволять его удаление, т.е. поручение должно находиться в состоянии Проект, Активно или В работе.
Метод MoveMessageToArchive (Переместить уведомление в архив)
Метод переноса в архив полученного уведомления.
Формат вызова:
void MoveMessageToArchive (int messageId)
Параметры:
§ messageId – идентификатор уведомления;
Права на выполнение операции:
Пользователь должен быть одним из лиц, указанных в поручении –
§ создателем,
§ инициатором,
§ получателем.
Метод SendInstruction (Отправить поручение)
Метод сохранения подписи и отправки поручения.
Формат вызова:
int[] SendInstruction (int projectId, SendInstructionSign[] signs)
Параметры:
§ projectId – идентификатор проекта поручения;
§ signs – коллекция подписей для отдельных поручений. Размер массива должен быть равен числу получателей поручения.
Результат выполнения операции:
§ массив новых идентификаторов поручений, созданных данной командой (могут не совпадать с исходными идентификаторами).
Права на выполнение операции:
§ Пользователь должен быть одним из лиц, указанных в поручении –
§ создателем,
§ инициатором
§ или иметь права на отправку поручений данного типа.
Метод AppendCoExecutors (Добавить исполнителей поручения)
Метод добавления исполнителей в поручение (проект или отправленное).
Формат вызова:
void AppendCoExecutors (string instructionId, UpdateSingleInstructionData[] instructionData)
Параметры:
§ instructionId – идентификатор поручения;
§ instructionData – данные о новых исполнителях.
Права:
§ Пользователь должен быть одним из лиц, указанных в поручении –
§ создателем,
|
|
|
§ инициатором
§ или для отправленных поручений пользователь должен быть одним из лиц, указанных в поручении–
§ получателем отчета,
§ контролером исполнения
§ или на момент отправки у пользователя должны быть права на создание и отправку поручений данного типа.
Метод ChangeExecutorOrder (Изменить порядковый номер соисполнителя)
Метод изменения порядкового номера соисполнителя в цепочке.
Формат вызова:
OrderInfo[] ChangeExecutorOrder (OrderInfo instructionOrder)
Параметры:
§ instructionOrder – идентификатор персонального поручения и новый порядковый номер. Номер должен быть больше 0, и поручение не должно быть назначено ответственному исполнителю.
Результат выполнения
§ итоговая цепочка с идентификаторами и номерами поручений.
Права:
Пользователь должен быть одним из лиц, указанных в поручении –
§ создателем,
§ инициатором поручения,
§ получателем отчета,
§ контролером.
Дополнительные условия:
§ Все поручения должны иметь одинаковый статус; возможные статусы – Проект или Активно.
§ Нельзя изменить порядковый номер ответственного исполнителя.
Метод RepeatChain (Повторить цепочку поручений)
Метод повторения всей цепочки поручений; при этом предыдущая цепочка помечается как удаленная.
Формат вызова:
int RepeatChain (int sourceInstructionId, UpdateInstructionData instructionData)
Параметры:
§ sourceInstructionId – идентификатор первого сообщения в цепочке;
§ instructionData – данные о новом поручении.
Результат выполнения:
§ NewId – идентификатор нового проекта поручения.
Права:
§ Пользователь должен быть одним из лиц, указанных в поручении –
§ создателем,
§ инициатором поручения,
§ получателем отчета,
§ контролером
§ или на момент отправки у пользователя должны быть права на создание поручений данного типа.
|
|
|
