bitrix24-crm

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

CRM Битрикс24: серверный PHP

Bitrix24 CRM:服务端 PHP

Scope: Bitrix24 on-premise · Verified: crm 26.1900.0, main 26.1000.0
Перед PHP-кодом один раз прочитай
bitrix-framework
. Здесь код внутри портала: модули
/local/
, обработчики, агенты. Вызовы CRM через REST:
bitrix24-rest-api
.
ЗадачаОткрыть
Container, Factory, чтение Item, поля, телефоны и почта
rules/factory-items.md
Добавление/изменение/удаление, Context, проверки, свои действия
rules/operations.md
Смарт-процессы, воронки, стадии и смарт-счета
rules/smart-processes.md
Права и списки с их учётом
rules/permissions.md
Реакция на изменения, подмена фабрики, роботы и триггеры
rules/events-automation.md
Комментарии таймлайна, запланированные и прочие дела
rules/timeline-activities.md
Коллекция полей и пользовательские поля
rules/fields-uf.md
Замены
CCrmDeal
/
CCrmLead
/…, соответствие D7 и REST
rules/legacy-rest.md
适用范围:Bitrix24 本地部署 · 已验证:crm 26.1900.0、main 26.1000.0
在编写 PHP 代码前,先阅读一次
bitrix-framework
。这里涉及门户内部的代码:
/local/
模块、事件处理器和 Agent。通过 REST 调用 CRM:
bitrix24-rest-api
。
任务打开
Container、Factory、读取 Item、字段、电话和邮箱
rules/factory-items.md
添加/修改/删除、Context、检查、自定义操作
rules/operations.md
智能流程、漏斗、阶段和智能商机
rules/smart-processes.md
权限及考虑权限的列表
rules/permissions.md
响应变更、替换 Factory、机器人和触发器
rules/events-automation.md
时间线评论、计划活动及其他活动
rules/timeline-activities.md
字段集合和自定义字段
rules/fields-uf.md
替换
CCrmDeal
/
CCrmLead
/…、兼容 D7 和 REST
rules/legacy-rest.md

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

通用规则

  • Подключи
    Loader::includeModule('crm')
    ; сервисы получай из
    Container::getInstance()
    .
  • Записывай через операции Factory:
    getAddOperation()
    /
    getUpdateOperation()
    /
    getDeleteOperation()
    и
    launch()
    . Прямые
    DealTable::add()
    ,
    $factory->getDataClass()::update()
    ,
    Item::save()
    /
    Item::delete()
    обходят права, обязательные поля, события, таймлайн, индекс и роботов.
  • Используй
    Item::FIELD_NAME_*
    : фабрика сопоставляет их столбцам сущности (у лида
    STAGE_ID
    соответствует
    STATUS_ID
    ).
  • entityTypeId
    , ID воронок и стадий различаются между порталами. Ищи по коду или семантике при выполнении.
  • У агента, CLI и очереди нет пользователя. Передай
    Context
    с ID инициатора; системный обход прав должен быть явным решением.
  • Проверяй
    isSuccess()
    каждого
    launch()
    и передавай ошибки вызывающему коду.
  • 引入
    Loader::includeModule('crm')
    ;通过
    Container::getInstance()
    获取服务。
  • 通过 Factory 操作写入数据:使用
    getAddOperation()
    /
    getUpdateOperation()
    /
    getDeleteOperation()
    并调用
    launch()
    。直接调用
    DealTable::add()
    、
    $factory->getDataClass()::update()
    、
    Item::save()
    /
    Item::delete()
    会绕过权限、必填字段校验、事件、时间线、索引和机器人。
  • 使用
    Item::FIELD_NAME_*
    :Factory 会将其映射到实体列(例如,Lead 的
    STAGE_ID
    对应
    STATUS_ID
    )。
  • entityTypeId
    、漏斗 ID 和阶段 ID 在不同门户之间可能不同。执行时应根据代码或语义进行查找。
  • Agent、CLI 和队列中没有当前用户。需要传递包含发起人 ID 的
    Context
    ;是否在系统中绕过权限必须是明确决策。
  • 检查每次
    launch()
    返回的
    isSuccess()
    ,并将错误传递给调用方代码。