 |
Метод OpenInstruction (Получить информацию по поручению)
|
|
|
|
Метод получения структурированного описания типов поручений.
Формат вызова:
InstructionInfo OpenInstruction (OpenMode[] openMode, int InstructionId)
Параметры:
§ openMode – режим открытия поручения (управляет детальностью возвращаемой информации);
§ instructionID – идентификатор поручения. Если это идентификатор персонального поручения неответственного исполнителя, то возвращается 1 запись; если это идентификатор поручения ответственного исполнителя, то возвращается вся цепочка;
Результат выполнения операции:
Возвращает всю информацию по поручению в структурированном виде.
Права на выполнение операции:
Пользователь должен быть одним из лиц, указанных в поручении –
§ создателем,
§ инициатором,
§ получателем,
§ получателем отчета,
§ контролером исполнения,
§ исполнителем.
Список соисполнителей доступен для просмотра, если:
§ пользователь имеет право на просмотр поручения и является одним из лиц, указанных в поручении –
§ создателем,
§ инициатором,
§ получателем отчета,
§ контролером;
§ у пользователя есть право на просмотр соисполнителей (OperTypeID =2114).
Может использоваться для чтения отчета, будут заполнены только поля, имеющие смысл. Разрешены только OpenMode.All и OpenMode.Basic.
Метод CreateProject (Создать проект поручения)
Метод создания проекта поручения.
Формат вызова:
int CreateProject (UpdateInstructionData ProjectData)
Параметры:
§ ProjectData – данные проекта поручения (все идентификаторы объектов игнорируются).
Результат выполнения операции:
§ идентификатор нового проекта.
Права на выполнение операции:
§ Пользователь должен быть одним из лиц, указанных в поручении –
§ создателем поручения,
§ инициатором поручения
§ или иметь права на создание поручений заданного типа.
|
|
|
Метод ReplaceInstruction (Замена отправленного поручения)
Метод замены отправленного поручения.
Формат вызова:
int ReplaceInstruction (int sourceInstructionId, UpdateSingleInstructionData instructionData)
Параметры:
§ sourceInstructionId – идентификатор заменяемого поручения;
§ instructionData – данные о новом поручении.
Результат выполнения:
§ идентификатор нового, отправленного поручения.
Текущее состояние поручения (Активно и В работе) должно позволять замену.
Права на выполнение операции:
§ Пользователь должен быть одним из лиц, указанных в поручении –
§ создателем поручения,
§ инициатором поручения
§ или иметь права на создание поручений заданного типа.
Метод UpdateProject (Обновление проекта поручения)
Метод обновления проекта поручения.
Формат вызова:
int UpdateProject (int projectId, UpdateInstructionData projectData, int NewId)
Параметры:
§ projectId – идентификатор поручения;
§ projectData – данные о проекте поручения.
Результат выполенения операции:
§ идентификатор обновленного проекта (может не совпадать с идентификатором переданного поручения).
Права на выполнение операции:
§ Пользователь должен быть одним из лиц, указанных в поручении –
§ создателем поручения,
§ инициатором поручения;
§ или иметь права на создание поручений заданного типа.
Метод MoveObjectToFolder (Переместить поручение или отчет в папку)
Метод перемещения в папку поручения или отчета о его выполнении.
Устарел, вместо него стоит использовать метод MoveInstructionToFolder.
Формат вызова:
void MoveObjectToFolder (int objectId, int folderId)
Параметры:
§ objectId – идентификатор поручения или отчета;
§ folderId – папка, в которую нужно переместить поручение.
Права на выполнение операции:
§ Пользователь должен быть владельцем папки
§ или папка должна быть системной
§ или пользователь должен быть одним из лиц, указанных в поручении.
Метод MoveInstructionToFolder (Переместить поручение или отчет в папку)
Метод перемещения в папку поручения или отчета о его выполнении.
|
|
|
Формат вызова:
void MoveInstructionToFolder (int instructionId, int sourceFolderId, int destinationFolderId)
Параметры:
§ instructionId – идентификатор поручения или отчета;
§ sourceFolderId – папка, из которой происходит перемещение поручения;
§ destinationFolderId – папка, в которую происходит перемещение поручения.
Права на выполнение операции:
§ Пользователь должен быть владельцем папки
§ или папка должна быть системной.
Метод TakeInWork (Взять поручение в работу)
Метод взятия поручения в работу.
Формат вызова:
void TakeInWork(int instructionID, SignInfo sign, InstructionSign instructionSign);
Параметры:
§ instructionId – идентификатор поручения;
§ sign – Подпись поручения. Оставлена для совместимости, следует использовать instructionSign (опционально);
§ instructionSign - подпись операции над поручением вместе с подписью поручения. (опционально).
Права на выполнение операции:
Пользователь должен быть одним из лиц, указанных в поручении –
§ инициатором,
§ создателем,
§ получателем.
Метод RedirectInstruction (Перенаправить поручение)
Метод перенаправления поручения.
Формат вызова:
int RedirectInstruction (int sourceInstructionId, UpdateInstructionData instructionData)
Параметры:
§ sourceInstructionId – идентификатор исходного поручения;
§ instructionData – данные для нового поручения;
Результат выполнения операции:
Фактически создается новый проект поручения, устанавливается его связь со старым и возвращает идентификатор нового проекта поручения.
Права на выполнение операции:
§ Пользователь должен быть одним из лиц, указанных в поручении –
§ инициатором,
§ создателем,
§ получателем
и обладать правами на создание сообщений заданного типа.
|
|
|
