SuperAPI AI 工具集

b24jssdk-helpers

数据与分析

查看项目

更新于 10-15 20:06

技能介绍

用途:b24jssdk helpers 提供 useB24Helper() 组合式函数,封装 B24HelperManager 与 Pull 客户端生命周期,是在应用启动时一次性加载门户级上下文(货币、应用安装信息、当前用户等)的推荐方式。

主要能力:通过 initB24Helper 批量加载数据,可传入 LoadDataType.Profile、App、Currency、AppOptions、UserOptions 等标志,内部走单次批处理 REST 调用;用 getB24Helper 获取 helper 后可读取 profileInfo、appInfo、licenseInfo、paymentInfo、currency 等数据。货币相关支持 getCurrencyLiteral、getCurrencyFullName 与 format,遵循门户配置的小数位与分隔符规则。helper 级 OptionsManager 可批量保存选项并广播 Pull 事件,encode 将对象转为兼容字符串,getJsonObject 反向解析。

使用方式:从 @bitrix24/b24jssdk 导入 initializeB24Frame、useB24Helper、LoadDataType 等;初始化后调用 initB24Helper($b24, [...], requestId)。isInitB24Helper() 在 initB24Helper 完成后返回 true,可作为守卫。Pull 用法为 usePullClient()、useSubscribePullClient(handler, moduleId)、startPullClient(),顺序不可颠倒,且订阅需在启动前完成。后端发布消息应通过 REST 调用 pull.application.event.add,并在参数中提供 COMMAND、PARAMS、MODULE_ID。结束时可调用 destroyB24Helper 一并清理 Pull 客户端。B24HelperManager 也可直接 new 出来配合 B24Hook / B24OAuth 使用。

适用场景:框架内应用启动时加载门户上下文、货币格式化、选项批量保存与通知,以及基于 Pull 的推送事件处理。

限制:initB24Helper 重复调用不会刷新数据,需先 destroyB24Helper;未先调用 usePullClient 就调用订阅或启动会抛错;不要在 CLI 脚本中 startPullClient;不要加载全部 LoadDataType“以防万一”;在 initB24Helper 完成前读取 profileInfo 会抛 not initialized;PullClient 的 sendMessage 通常不可用(会因 JSSDK_PULL_PUBLIC_IDS_UNAVAILABLE 被拒绝),发布应走后端 REST 路径。文档未提及收费、价格或具体平台限制等信息。