Функции модуля (__call)


НАЧАЛО >> Оглавление >> Сервер приложений ИРБИС 64/128 >> Описание модулей системы >> Tasks - Задачи >> Функции модуля (__call)📄 Скачать в DOCX


Функции могут быть вызваны как UseModule("Tasks")->function(parameter1,parameter2,...);

Имя функцииОписаниеПараметры
ApplyTaskAiSuggestionПрименить AI-предложение задачи
Подробнее... 
Проверяет ручное подтверждение, актуальность версии задачи и apply policy AI-предложения. По умолчанию возвращает только planned diff; применение меняет объект ObjectDataTask в памяти и не сохраняет запись в обход штатного Tasks save/apply path.
ТипПараметрПо умолчаниюОписание
ObjectDataTask$task''Объект задачи
array$suggestion'array()'AI suggestion envelope, полученный из CreateTaskAiSuggestion
array$options'array()'Параметры применения: confirmed, apply, ignoreVersionConflict
ApplyTaskBulkTransitionВыполнить переход для нескольких задач
Подробнее... 
Последовательно применяет один Workflow-переход к набору задач. Используется внутренним API рабочего места для массовых операций; фактическую проверку маршрута и прав выполняет Workflow.
ТипПараметрПо умолчаниюОписание
ObjectDataDatabase$db''База данных с записями задач
array$keys'array()'Список ключей задач
string$transitionId''Идентификатор перехода Workflow
string$projectKey'TASK'Ключ проекта Workflow
array$input'array()'Данные формы WorkflowScreen для перехода
string$comment''Комментарий к переходу
bool$continueOnError'false'Продолжать обработку после ошибки отдельной задачи
ApplyTaskTemplateПрименить шаблон задачи
Подробнее... 
Применяет к объекту TASK task-specific шаблон из системной доменной модели Tasks: начальные значения полей, SLA, очередь, чек-лист, участников, затронутые объекты, ресурсы и связи. Функция не сохраняет запись и не выполняет workflow-переходы.
ТипПараметрПо умолчаниюОписание
ObjectDataTask$task''Объект задачи, к которому применяется шаблон
string$templateKey''Ключ шаблона задачи из доменной модели Tasks
string$projectKey'TASK'Ключ проекта задач
bool$overwrite'false'Перезаписывать уже заполненные поля задачи значениями шаблона
ApplyTaskTransitionВыполнить переход задачи
Подробнее... 
Выполняет Workflow-переход для записи TASK по ключу задачи. Функция не содержит собственного workflow-engine: маршрут, условия, права перехода, post-functions, история 907 и сохранение выполняются модулем Workflow.
ТипПараметрПо умолчаниюОписание
ObjectDataDatabase$db''База данных с записями задач
string$key''Ключ задачи
string$transitionId''Идентификатор перехода Workflow
string$projectKey'TASK'Ключ проекта Workflow
array$input'array()'Данные формы WorkflowScreen для перехода
string$comment''Комментарий к переходу
bool$save'true'Сохранять запись после перехода
BuildTaskAiInputPackageСобрать входной пакет AI-операции задачи
Подробнее... 
Собирает безопасный input package для task-specific AI-операции по ObjectDataTask и input profile. Скрытые поля, приватные ресурсы и запрещенные source keys исключаются до передачи в общий AI runtime.
ТипПараметрПо умолчаниюОписание
ObjectDataTask$task''Объект задачи
string$operationKey''Ключ AI-операции Tasks
array$options'array()'Параметры сборки: hiddenFieldKeys, allowedSourceKeys, candidateSet, publicComments, includePrivateResources, securityDecision, traceId
BuildTaskFromObjectReferenceСоздание задачи из ссылки на запись
Подробнее... 
Создает объект задачи в памяти из произвольной записи ИРБИС 128, заполняет базовые поля TASK и добавляет типизированную связь 113 LINK с исходной записью. Функция не сохраняет задачу и не обходит Security или Workflow.
ТипПараметрПо умолчаниюОписание
$0Обязательный
$1Обязательный
$2Обязательный
$3Обязательный
$4Обязательный
$5Обязательный
$6Обязательный
$7Обязательный
$8Обязательный
BuildWorkflowViewBoardCardsПостроить карточки задач для доски Workflow
Подробнее... 
Преобразует записи TASK в карточки доски WorkflowView: доменные поля задачи, текущее состояние Workflow, человекочитаемый статус и ссылку на детальное представление задачи.
ТипПараметрПо умолчаниюОписание
array$records'array()'Записи TASK, уже отобранные WorkflowFilter
ObjectDataWorkflowProject$project''Проект Workflow, в котором отображаются задачи
array$board'array()'Нормализованное описание доски WorkflowView
array$options'array()'Параметры построения: dbn, detailViewKey, fromPageKey, projectObjectTypeKey
CalculateTaskRankingРассчитать ранг задачи
Подробнее... 
Выполняет детерминированный task-specific расчет ранга задачи по сохраненным полям: приоритет, влияние, возраст, SLA, ручное повышение и блокирующие связи. Функция не рассчитывает WIP, рабочие календари и права, но оставляет объяснимый результат для очередей и TestA.
ТипПараметрПо умолчаниюОписание
ObjectDataTask$task''Объект задачи TASK
array$profile'array()'Необязательные веса ranking profile
string$now''Текущий момент в формате ИРБИС
bool$apply'false'Записать рассчитанный ранг в поля задачи
CheckTaskAiHealthHealthCheck AI-операций задач
Подробнее... 
Проверяет task-specific AI operation pack: обязательные операции, input profile bindings, prompt bindings, field keys, manual confirmation, Help и TestA-ссылки. Проверка read-only и не запускает модель.
ТипПараметрПо умолчаниюОписание
array$options'array()'Зарезервированные параметры HealthCheck
CreateTaskAiSuggestionСоздать AI-предложение задачи
Подробнее... 
Формирует task-specific AI suggestion envelope для классификации, похожих задач, резюме истории, черновика ответа или внутреннего комментария. Функция не вызывает модель, не публикует сообщения, не выполняет workflow-переход и не сохраняет запись.
ТипПараметрПо умолчаниюОписание
ObjectDataTask$task''Объект задачи
string$operationKey''Ключ AI-операции Tasks
array$payload'array()'Опциональный payload: proposedFields, candidates или заранее собранный inputPackage
array$options'array()'Параметры suggestion: hiddenFieldKeys, candidateSet, publicComments, ttlSec, traceId
EnsureWorkflowScreenFilesПроверить файлы экранов Workflow для Tasks
Подробнее... 
Создает в базе данных отсутствующие стандартные WS, WSS и MNU-файлы, необходимые для экранов Workflow модуля Tasks. Существующие файлы не перезаписываются без явного признака force.
ТипПараметрПо умолчаниюОписание
ObjectDataDatabase|null$db'null'База данных, в которую надо записать файлы экранов
bool$force'false'Перезаписать существующие файлы
ExecuteVirtualRefMigrationВыполнить миграцию VirtualRef
Подробнее... 
Выполняет миграцию VirtualRef в TASK-записи по профилю Tasks. По умолчанию работает как dry-run; production cutover требует dryRun=false, confirm=cutover и sourceFrozen=true, повторно проверяет план и не создает дубли по legacy-маркерам.
ТипПараметрПо умолчаниюОписание
ObjectDataDatabase$sourceDb''База данных с исходными записями VirtualRef
ObjectDataDatabase|null$targetDb'null'База данных назначения с TASK-записями; если не указана, используется sourceDb
string$profileKey'vref_to_task'Ключ профиля миграции
array$options'array()'Опции выполнения: dryRun, confirm, sourceFrozen, migrationRunKey, limit, src, records, profile
ExplainTaskSlaОбъяснить состояние SLA задачи
Подробнее... 
Возвращает детерминированное объяснение сохраненного SLA-состояния задачи: правило, календарь, сроки первого ответа и решения, признаки просрочки, паузу и диагностические сообщения. Функция не рассчитывает рабочее время сама и не обращается к WorkCalendar.
ТипПараметрПо умолчаниюОписание
ObjectDataTask$task''Объект задачи TASK
string$now''Текущий момент в формате ИРБИС; пустое значение означает текущую дату сервера
GetDeveloperPackageПакет разработчика Tasks
Подробнее... 
Возвращает машинно-читаемое описание стабильных контрактов модуля Tasks: API, object references, правила интеграции, границы ответственности, Help-страницы и TestA-сценарии.
Отсутствуют
GetGoldenDatasetDefinitionGolden dataset Tasks
Подробнее... 
Возвращает воспроизводимое описание тестового набора Tasks для TestA, Help и приемки первого промышленного контура без записи в базу данных.
Отсутствуют
GetGoldenDatasetLifecyclePlanПлан жизненного цикла golden dataset Tasks
Подробнее... 
Возвращает безопасный план установки, повторной проверки и очистки golden dataset Tasks. План не удаляет записи сам по себе и предназначен для TestA writes-сценариев, setup и runbook.
Отсутствуют
GetSystemWorkflowDefinitionFilesПолучить системные JSON Workflow модуля Tasks
Подробнее... 
Возвращает список JSON-файлов с системным проектом задач, workflow, статусами, переходами, экранами, фильтрами и представлениями, поставляемыми модулем Tasks.
Отсутствуют
GetTaskAiOperationПолучить AI-операцию задачи
Подробнее... 
Возвращает одну task-specific AI operation definition по стабильному ключу. Описание содержит bindings на AI policy, input profile, prompt, model policy, tool policy, права, Help и TestA.
ТипПараметрПо умолчаниюОписание
string$operationKey''Стабильный ключ AI-операции Tasks
string$projectKey'TASK'Ключ проекта задач
GetTaskAiOperationPackПолучить пакет AI-операций задач
Подробнее... 
Возвращает task-specific AI operation pack модуля Tasks: опубликованные операции, input profiles, prompt definitions и source-файлы поставки. Функция не запускает AI runtime и не изменяет записи.
ТипПараметрПо умолчаниюОписание
string$projectKey'TASK'Ключ проекта задач
bool$activeOnly'true'Возвращать только опубликованные/активные definitions
GetTaskDetailsПолучить карточку задачи
Подробнее... 
Возвращает внутреннее API-представление карточки задачи по ключу и проекту Workflow: доменные поля TASK, текущее Workflow-состояние, человекочитаемый статус и канонический URL карточки.
ТипПараметрПо умолчаниюОписание
ObjectDataDatabase$db''База данных с записями задач
string$key''Ключ задачи
string$projectKey'TASK'Ключ проекта Workflow
GetTaskDomainModelПолучить доменную модель задач
Подробнее... 
Возвращает task-specific справочники и шаблоны системного проекта Tasks: типы задач и обращений, сервисы, компоненты, уровни влияния, роли участников, шаблоны, компетенции, SLA, OLA, очереди, WIP, таймеры, ранжирование, квоты, профили импорта и экспорта. Функция читает поставляемый JSON Tasks и не реализует внешние справочники, типы связей WorkflowProject, права, Queue runtime или workflow-engine.
ТипПараметрПо умолчаниюОписание
string$section''Необязательный ключ секции доменной модели; пустое значение возвращает все секции
string$projectKey'TASK'Ключ проекта задач для отбора project-specific записей
bool$activeOnly'true'Возвращать только активные элементы справочников и шаблонов
GetTaskListПолучить список задач
Подробнее... 
Возвращает внутреннее API-представление списка задач по странице рабочего места Tasks. Отбор строится через WorkflowFilter, а карточные данные берутся из канонической записи TASK.
ТипПараметрПо умолчаниюОписание
ObjectDataDatabase$db''База данных с записями задач
string$projectKey'TASK'Ключ проекта Workflow
string$pageKey'list'Ключ страницы списка задач
int$page'1'Номер страницы результата
int$pageSize'0'Размер страницы; 0 означает взять значение из WorkflowView
array$criteria'array()'Параметры фильтра: project, status, assignee, author, priority, type, requestType, service, component, impact, slaState, slaBreached, slaPaused, queue, queueGroup, rankBucket, takenBy, src
GetVirtualRefMigrationProfileПолучить профиль миграции VirtualRef
Подробнее... 
Возвращает нормализованный профиль миграции VirtualRef в канонические записи TASK: источник, целевой проект, карту статусов, политику ключей, legacy-маркеры и режим cutover.
ТипПараметрПо умолчаниюОписание
string$profileKey'vref_to_task'Ключ профиля миграции в системном JSON Tasks
array$overrides'array()'Необязательные переопределения профиля для dry-run или тестового сценария
GetWorkflowFilterOptionsПолучить варианты фильтра списка задач
Подробнее... 
Возвращает пары ключ-значение для выпадающих списков WorkflowFilter, построенных поверх доменной модели Tasks. Функция не строит интерфейс и не исполняет фильтр, а только предоставляет task-specific справочники общему модулю WorkflowView.
ТипПараметрПо умолчаниюОписание
string$section''Ключ секции справочника Tasks или task-specific перечисления
string$projectKey'TASK'Ключ проекта задач для отбора project-specific элементов
array$filterMeta'array()'Метаданные параметра WorkflowFilter; в этой функции используются только как контекст вызова
GetWorkflowScreenFileDefinitionsПолучить поставляемые файлы экранов Tasks
Подробнее... 
Возвращает содержимое стандартных WS, WSS и MNU-файлов, необходимых для базовых экранов создания, редактирования, назначения, планирования и доменной классификации задач через WorkflowScreen.
Отсутствуют
PlanVirtualRefMigrationПостроить план миграции VirtualRef
Подробнее... 
Выполняет dry-run миграции VirtualRef в Tasks: читает исходные вопросы, применяет профиль сопоставления, проверяет статусную карту, ищет уже перенесенные TASK-записи по legacy-маркерам и формирует понятный отчет без записи данных.
ТипПараметрПо умолчаниюОписание
ObjectDataDatabase$sourceDb''База данных с исходными записями VirtualRef
ObjectDataDatabase|null$targetDb'null'База данных назначения с TASK-записями; если не указана, используется sourceDb
string$profileKey'vref_to_task'Ключ профиля миграции
array$options'array()'Опции dry-run: limit, src, records, includeRecords, sampleLimit, profile
RequestTaskRecalculationЗапросить пересчет задачи
Подробнее... 
Готовит task-specific payload для фонового пересчета SLA, очереди, ранга и таймеров задачи. В dry-run режиме возвращает действие Queue и идемпотентный ключ без постановки задания; при реальной постановке использует существующий Queue/Append.
ТипПараметрПо умолчаниюОписание
ObjectDataTask$task''Объект задачи TASK
string$reason'manual'Причина пересчета: изменение SLA, календаря, статуса, ответственного, приоритета, блокера или контрольной даты
bool$dryRun'true'Только подготовить payload без постановки в Queue
SetupModuleConfigureВыполнить первичную настройку Tasks
Подробнее... 
Проверяет наличие обязательных Workflow-модулей, синхронизирует системный проект задач из JSON и устанавливает стандартные файлы экранов Workflow для базы I128F.
ТипПараметрПо умолчаниюОписание
int$count'0'Служебный счетчик шага настройки
UpdateTaskFieldsОбновить поля задачи
Подробнее... 
Обновляет разрешенный набор доменных полей TASK через внутренний API рабочего места задач. Ключ, проект, состояние Workflow и история не меняются этой функцией напрямую.
ТипПараметрПо умолчаниюОписание
ObjectDataDatabase$db''База данных с записями задач
string$key''Ключ задачи
array$fields'array()'Изменяемые поля: title, description, type, category, priority, requestType, serviceKey, componentKey, impactLevel, dueAt, assigneeSid, watchers, visibility, serviceFlags, stageKey, versionKey, deliveryKey, SLA-поля, queue-поля, resources, checklist, participants, impactRefs, slaPauses, olaLines, timers, controlDates, links
string$projectKey'TASK'Ключ проекта Workflow
bool$save'true'Сохранять запись после изменения
ValidateGoldenDatasetDefinitionПроверка golden dataset Tasks
Подробнее... 
Проверяет машинно-читаемое описание golden dataset Tasks: обязательные ключи, статусы, отсутствие секретов и соответствие expected manifest.
Отсутствуют
Workflow_ApplyManualBoostПрименить ручное повышение ранга
Подробнее... 
Записывает task-specific ручное повышение ранга в поле 13 и перестраивает индексы. Проверка права на такое действие должна выполняться политикой Security/Workflow до вызова команды.
ТипПараметрПо умолчаниюОписание
WorkflowContext$ctx''Контекст выполнения workflow-команды
Workflow_MarkFirstResponseОтметить первый ответ по задаче
Подробнее... 
Заполняет дату первого ответа в SLA-блоке TASK при workflow-переходе. Команда не рассчитывает рабочее время и не отправляет уведомления.
ТипПараметрПо умолчаниюОписание
WorkflowContext$ctx''Контекст выполнения workflow-команды
Workflow_MarkResolvedОтметить решение задачи
Подробнее... 
Заполняет факт решения в SLA-блоке TASK. Если первый ответ еще не был отмечен, заполняет и его, потому что решение является пользовательски значимой реакцией.
ТипПараметрПо умолчаниюОписание
WorkflowContext$ctx''Контекст выполнения workflow-команды
Workflow_NormalizeRecordНормализовать запись задачи
Подробнее... 
Приводит запись TASK к канонической структуре после создания или изменения через Workflow: заполняет проект, автора, ключ, даты, значения по умолчанию и перестраивает индексы TASK и Workflow.
ТипПараметрПо умолчаниюОписание
WorkflowContext$ctx''Контекст выполнения workflow-команды
Workflow_SetClosedFlagИзменить признак завершения задачи
Подробнее... 
Обновляет доменные поля завершения TASK после перехода Workflow: устанавливает или снимает признак завершения, заполняет дату завершения и перестраивает индексы задачи.
ТипПараметрПо умолчаниюОписание
WorkflowContext$ctx''Контекст выполнения workflow-команды
Workflow_StartSlaPauseВключить паузу SLA задачи
Подробнее... 
Добавляет открытый период паузы SLA в поле 12, устанавливает признак паузы и состояние SLA `paused`. Команда предназначена для workflow-переходов ожидания.
ТипПараметрПо умолчаниюОписание
WorkflowContext$ctx''Контекст выполнения workflow-команды
Workflow_StopSlaPauseСнять паузу SLA задачи
Подробнее... 
Закрывает последний открытый период паузы SLA в поле 12, снимает признак паузы и возвращает SLA в активное состояние.
ТипПараметрПо умолчаниюОписание
WorkflowContext$ctx''Контекст выполнения workflow-команды
Workflow_TakeTaskВзять задачу из очереди
Подробнее... 
Фиксирует дату взятия задачи, исполнителя и очередь в поле 13. WIP, права и выбор следующей задачи проверяются внешними механизмами Security/WorkflowFilter/Queue.
ТипПараметрПо умолчаниюОписание
WorkflowContext$ctx''Контекст выполнения workflow-команды