bitrix24-tasks
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseЗадачи Битрикс24: серверный PHP
Bitrix24 任务:服务端 PHP
Scope: Bitrix24 on-premise · Verified: tasks 26.800.0, main 26.1000.0
Перед PHP-кодом один раз прочитай .
bitrix-framework| Задача | Открыть |
|---|---|
| Выбор API, создание, изменение, завершение, удаление и ошибки | |
| Одна задача/список: фильтры, порядок, страницы и даты | |
| Участники, сроки/часовые пояса, чек-листы, теги, проекты, шаблоны, комментарии | |
| Контракты БП/REST: статус, длительность, инициатор шаблона | |
| Проверки доступа, события/аргументы, соответствие REST | |
范围:Bitrix24 私有部署版 · 已验证版本:tasks 26.800.0、main 26.1000.0
在编写 PHP 代码前,先阅读一次 。
bitrix-framework| 内容 | 文档 |
|---|---|
| API 选择、创建、修改、完成、删除及错误处理 | |
| 单个任务/任务列表:筛选、排序、分页和日期 | |
| 参与者、截止日期/时区、checklist、标签、项目、模板和评论 | |
| 业务流程/REST 契约:状态、持续时间、模板发起人 | |
| 访问权限检查、事件/参数、REST 一致性 | |
Общие правила
通用规则
- Записывай через V2-команды (,
AddTaskCommand…); legacyUpdateTaskCommand/CTaskItemиспользуют те же V2-сервисы. Прямая записьCTasks, участников и чек-листов пропускает счётчики, чат, индекс, события и корзину.TaskTable - Сами команды обычно не проверяют права. Перед проверяй
run()/TaskAccessServiceинициатора; отдельные команды могут иметь собственную проверку.TaskAccessController - Передавай инициатора явно: конфигурации. У агента/CLI нет авторизованного
userId;$USERбезCTasks::Addподставляет пользователя 1.USER_ID - Даты V2 — Unix timestamp (). В фоне не передавай строки формата сайта.
deadlineTs - Изолируй V2 в одном классе доступа : команды используют
/local, сущности/конфигурации меняются. Проверено на tasks 26.800.0; еслиV2\Internal\…ложно, используйclass_exists(AddTaskCommand::class).CTaskItem - Комментарий новой карточки — сообщение чата задачи (,
rules/details.md).bitrix24-im
- 通过 V2 命令写入(、
AddTaskCommand……);旧版UpdateTaskCommand/CTaskItem也使用相同的 V2 服务。直接写入CTasks、参与者和 checklist 会绕过计数器、聊天、索引、事件和回收站。TaskTable - 这些命令通常不会检查权限。在调用 前,使用
run()/TaskAccessService检查发起人;某些命令可能带有自己的权限检查。TaskAccessController - 显式传入发起人:使用配置中的 。在 Agent/CLI 中没有已授权的
userId;调用$USER时如果不传入CTasks::Add,则会使用用户 1。USER_ID - V2 中的日期使用 Unix 时间戳()。在后台执行时,不要传入站点格式的日期字符串。
deadlineTs - 将 V2 封装在 下的一个访问类中:命令使用
/local,实体/配置会发生变化。已在 tasks 26.800.0 上验证;如果V2\Internal\…返回 false,则使用class_exists(AddTaskCommand::class)。CTaskItem - 新卡片的评论是任务聊天中的消息(、
rules/details.md)。bitrix24-im