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, создание, изменение, завершение, удаление и ошибки
rules/writing.md
Одна задача/список: фильтры, порядок, страницы и даты
rules/reading.md
Участники, сроки/часовые пояса, чек-листы, теги, проекты, шаблоны, комментарии
rules/details.md
Контракты БП/REST: статус, длительность, инициатор шаблона
rules/integrations.md
Проверки доступа, события/аргументы, соответствие REST
rules/access-events.md
范围:Bitrix24 私有部署版 · 已验证版本:tasks 26.800.0、main 26.1000.0
在编写 PHP 代码前,先阅读一次
bitrix-framework
。
内容文档
API 选择、创建、修改、完成、删除及错误处理
rules/writing.md
单个任务/任务列表:筛选、排序、分页和日期
rules/reading.md
参与者、截止日期/时区、checklist、标签、项目、模板和评论
rules/details.md
业务流程/REST 契约:状态、持续时间、模板发起人
rules/integrations.md
访问权限检查、事件/参数、REST 一致性
rules/access-events.md

Общие правила

通用规则

  • Записывай через V2-команды (
    AddTaskCommand
    ,
    UpdateTaskCommand
    …); legacy
    CTaskItem
    /
    CTasks
    используют те же V2-сервисы. Прямая запись
    TaskTable
    , участников и чек-листов пропускает счётчики, чат, индекс, события и корзину.
  • Сами команды обычно не проверяют права. Перед
    run()
    проверяй
    TaskAccessService
    /
    TaskAccessController
    инициатора; отдельные команды могут иметь собственную проверку.
  • Передавай инициатора явно:
    userId
    конфигурации. У агента/CLI нет авторизованного
    $USER
    ;
    CTasks::Add
    без
    USER_ID
    подставляет пользователя 1.
  • Даты V2 — Unix timestamp (
    deadlineTs
    ). В фоне не передавай строки формата сайта.
  • Изолируй V2 в одном классе доступа
    /local
    : команды используют
    V2\Internal\…
    , сущности/конфигурации меняются. Проверено на tasks 26.800.0; если
    class_exists(AddTaskCommand::class)
    ложно, используй
    CTaskItem
    .
  • Комментарий новой карточки — сообщение чата задачи (
    rules/details.md
    ,
    bitrix24-im
    ).
  • 通过 V2 命令写入(
    AddTaskCommand
    、
    UpdateTaskCommand
    ……);旧版
    CTaskItem
    /
    CTasks
    也使用相同的 V2 服务。直接写入
    TaskTable
    、参与者和 checklist 会绕过计数器、聊天、索引、事件和回收站。
  • 这些命令通常不会检查权限。在调用
    run()
    前,使用
    TaskAccessService
    /
    TaskAccessController
    检查发起人;某些命令可能带有自己的权限检查。
  • 显式传入发起人:使用配置中的
    userId
    。在 Agent/CLI 中没有已授权的
    $USER
    ;调用
    CTasks::Add
    时如果不传入
    USER_ID
    ,则会使用用户 1。
  • V2 中的日期使用 Unix 时间戳(
    deadlineTs
    )。在后台执行时,不要传入站点格式的日期字符串。
  • 将 V2 封装在
    /local
    下的一个访问类中:命令使用
    V2\Internal\…
    ,实体/配置会发生变化。已在 tasks 26.800.0 上验证;如果
    class_exists(AddTaskCommand::class)
    返回 false,则使用
    CTaskItem
    。
  • 新卡片的评论是任务聊天中的消息(
    rules/details.md
    、
    bitrix24-im
    )。