本篇聚焦销售易CRM PaaS平台开发能力,涵盖492个技术问题,包括自定义对象开发、API调用规范、沙盒环境管理、数据源配置、开发平台使用等,是实施顾问和开发人员的技术参考宝典。
本篇共收录 492 个高频实战问题
PaaS平台(356题)
Q:为什么有些自定义对象没有转移按钮?
在主子关系中,子对象的权限跟随主对象,子对象不支持转移,所以没有转移按钮。
Q:创建主子明细自动时提示“创建的明细关系已超过许可的数量”,是什么原因?
如果一个对象有两个父对象,则该对象就不能再有孙对象。
Q:一个自定义对象最多可以存储多少条数据?
目前对于一个自定义对象可以存储的最大数据量并未设定上限。
Q:创建计算类型-文本字段时,“文本类型+自动编号类型+计算公式(文本)类型”可创建字段显示还有 75 个,但提示字段超出允许限制,是什么原因?
“文本类型+自动编号类型+计算公式(文本)类型”虽然显示还有 75 个,但“计算公式(含汇总累计)已经为 0 到达上限,所以无法创建任何计算类型字段。
Q:时间类型和日期+时间类型字段的区别是什么?
时间类型显示的信息为 24 小时制的时间(精确到分),日期 + 时间显示的信息为日期(年月日)加上 24 小时制的时间(精确到分)。
Q:计算字段写公式,公式本身太长了超限,是否可以扩展?
最多 4000 字符,目前不支持扩展。
Q:目前哪些对象上可以使用富文本类型字段?
目前所有自定义对象和大部分标准对象上都可以使用富文本类型字段,以下为不支持的标准对象:任务、日程、部门、用户、活动记录、应收单、应收单明细、收款单、收款单明细、应收变更单、应收变更明细、退款、退款明细、收款计划、发票、发票明细、团队成员、应收发票、应收收款、应收收款退款、敏感词监控。
Q:相同的校验规则,在新建、编辑两个场景下对于同一字段的数据校验结果不一样,是什么原因?
校验规则中使用数据 ID 作为判断条件时,需要注意新建时数据 ID 永远是 NULL,从而导致新建和编辑时校验规则触发结果不一致。
Q:主子新建时,子对象校验规则中能否取到主对象业务类型的 apiKey?
可以获取到。
Q:在列表页中,勾选表头下拉框中的全选后,为什么在列表顶部没有显示出筛选条件?
全选表示包含全部选项值(包括空),等同于不进行任何筛选,所以不显示筛选条件。如果在勾选全选后,取消勾选一些选项值,会正常显示筛选条件。
Q:生产环境中开通的 License 和 Limits 是否会自动同步到沙盒环境?
创建沙盒环境时,生产环境中的 License 和 Limits 会自动同步到沙盒环境;创建沙盒环境后,生产环境中新增的License 会自动同步到沙盒环境,而 Limits 不会自动同步到沙盒环境。
Q:沙盒环境中,配置包迁移是否支持业务数据迁移?
沙盒迁移不支持业务数据迁移,业务数据迁移可以使用数据批量导入、导出功能。
Q:配置包是否支持从生产环境向沙盒环境迁移?
支持。配置包迁移支持:生产环境 > 沙盒环境、沙盒环境 > 生产环境、沙盒环境 > 沙盒环境。
Q:修改用户的部门有几种方式?用户的业务数据是否会跟随转移?
目前有以下三种方式可以修改用户的部门:
1.在系统后台的用户和权限管理 > 部门/用户管理中,编辑修改单个用户的部门,然后根据需要自行决定是否同时转移业务数据(可自定义配置)。
2.在系统后台,通过用户和权限管理 > 部门/用户管理中的部门数据移交功能修改,即将某个部门下的用户和业务数据一起转移到另一个部门。
3.通过批量导入用户功能,以更新用户信息的方式修改用户的部门,此方式用户的业务数据默认不跟随转移。
Q:创建外部部门时需要关联客户,已创建的客户无法被选择到,是什么原因?
需要设置客户对象的业务类型,在业务类型配置中勾选上设置该类型为合作伙伴,设置之后该业务类型下的客户才能被外部部门所关联。
Q:管理员为用户分配相应职能和角色后,用户登录系统时提示“未授权不可登录”,是什么原因?
管理员不仅需要为用户分配职能和角色,还需要为其分配相应的授权许可证(基础功能及其他所需功能的许可证),授权许可时会自动激活该用户,之后用户才能正常登录系统。
Q:在基于条件的共享规则中,将对象上的某个字段值作为条件进行共享时,如果该字段值在系统前台被用户手动修改或者在业务逻辑代码中被修改时,共享规则会重新计算吗?会立即生效吗?
条件中使用的字段值被手动或者代码修改时,系统会自动对共享规则进行重新计算,但会有一定的延迟。如果希望快速生效,可以在系统后台的用户和权限管理 > 共享规则中,单击重新计算按钮手动执行重新计算操作。
Q:在共享规则中,什么情况下需要手动重新计算?
正常情况下,当有新数据或者现有数据有变更时,系统会自动重新计算共享规则,无需手动处理,但此计算可能会有一些延迟,当需要立即计算或生效时,可以手动进行重新计算操作。
Q:资源权限组的作用是什么?
资源权限组用于控制系统管理员在系统后台能够管理哪些功能的配置数据。目前支持对角色、职能和审批流的数据管理权限控制,可以定义哪些角色、职能和审批流允许由哪些管理员来配置。
Q:内部用户已经打开了全部社交权限,但在添加团队成员时,仍找不到伙伴的名字,是什么原因?
必须启用通讯录权限。在系统后台,用户和权限管理>数据权限多维度 > 数据权限设置中勾选启用通讯录权限。只有成功启用通讯录权限,角色上的社交权限才会生效。
Q:数据权限设置>启用通讯录权限和角色上的社交权限之间是什么关系?
启用通讯录权限:表示当前系统(租户)启用了社交权限。
角色上的社交权限:表示当前所选角色能够看到哪些部门、用户。
只有启用通讯录权限,角色上的社交权限配置才会生效。
Q:用户对象支持哪些 Trigger?
新建(含导入):前事件(before)、后事件(after)
编辑(含导入):前事件(before)、后事件(after)
激活用户:前事件(before)、后事件(after)
删除用户:前事件(before)、后事件(after)
分配职能/分配角色:前事件(before)
离职/复职:前事件(before)、后事件(after)
启用/禁用:前事件(before)、后事件(after)
用户授权:后事件(after)
Q:在系统后台修改部门后,系统前台多久可以更新?
如果是在部门列表中修改部门名称,则系统前台页面刷新后,所属部门名称自动更新。
如果是在用户列表中修改用户的部门,需要符合下面两个条件,系统前台数据会自动更新(更新操作为异步方式)。
1.修改用户部门时需要勾选转移对象。
2.用户由 A 部门改为 B 部门,如果数据所属部门是 A 部门,则会自动变更为 B 部门,如果数据所属部门不是 A 部门,则不会自动更新。
3.更新时间基于需要更新的数据量动态变化。
Q:对于布局上的必填属性,前置 Trigger 在执行时,是在必填属性校验之前还是之后执行?
遵循先执行布局(UI)级校验,再执行对象级校验的逻辑。因此,布局上字段必填属性的校验会优先执行。
Q:如何快速查看当前系统中计划作业、自定义计划作业已启用数量?
在系统后台的系统设置 > 系统资源用量中查看。
Q:为什么含有 slf4j-api、jetty-server、commons-collections、commons-codec、commons-beanutils、json-lib、httpclient 这些包的业务逻辑代码上传会报错?
目前第三方包仅支持 fastJson 和 commons-lang。
Q:在同一对象上配置多个相同操作的Trigger时,如何控制这些Tirgger的执行顺序?
可以通过配置文件scriptTrigger.xml中的order值控制Trigger的执行顺序,order值较小的Trigger会优先执行。
Q:在系统后台,启用或者禁用了计划作业,有日志可以查到启用或禁用计划作业的时间吗?
在系统后台的日志审计 > 系统设置日志中查看。
Q:触发规则中的延时任务到期未执行,且在触发规则延时列表中“执行状态”为“未处理”,是什么原因?
延时生效功能目前仅付费租户可正常使用,非付费租户可正常配置,在触发规则延时列表中也可以查看延时事件(执行状态会一直为“未处理”状态),但事件不会被执行。
Q:定时调度自定义执行频率时,如何理解“每N天执行一次”?
以月为单位,每次固定以每月1日为起点重新计算每N天。例如:每6天执行一次,则每个月的1日、7日、13日、19日、25日、29日、31日各执行一次,如果当月没有31日,则当月少执行一次,然后从次月1日重新开始新一轮的执行,即次月1日开始当月的第一次执行。
Q:批量转移业务数据时,是否会触发转移的触发规则或Trigger?
会触发转移的触发规则,也会触发对象上的转移前、后Trigger。
Q:设置文本字段时,将默认值设置为关联对象的某个字段,当关联字段值变更时,默认值是否会随之变更?
不会随之变更。默认值只应用于新建数据时。在新建对象数据时,如果不对字段值进行修改,则数据保存后,该字段值使用默认值。在保存后编辑数据时,不会再应用默认值。如果默认值引用了其他字段,则数据保存后,也不会随引用字段值的变化而变化。
Q:在系统后台的自定义对象中,设置业务类型可见的选项范围时,在编辑字段选项范围窗口的已选值中调整了选项的顺序,但保存后再打开,仍显示调整前的顺序,是什么原因?
此处仅用于配置业务类型显示的选项值范围,其中的选项顺序调整不会在任何地方生效,可以忽略。
Q:电话类型字段录入时的格式校验规则是什么?
电话字段录入数据时,默认的格式校验规则如下:
1.至少6位。
2.支持数字。
3.支持特殊符号:+、-、()、空格。其中,“-”不能放在第一位和最后一位,“+”只能放在第一位。
4.自动去除首尾空格。
Q:配置包部署成功后,是否支持回滚?
不支持回滚。
Q:配置包部署或校验失败后,在哪里查看失败原因?
配置包校验或部署失败后,可在系统后台的沙盒环境 > 部署管理 > 操作历史页面,单击具体配置包后操作列的“查看错误信息”按钮查看失败原因。
Q:系统标准对象和字段是否支持通过配置包迁移?
如果目标环境中无该标准对象和字段,则必须先开通 License 或启用相关产品能力,然后再通过配置包迁移该标准对象和字段;如果目标环境中已经存在该标准对象和字段,则可直接通过配置包迁移更新该标准对象和字段。
Q:流程启用失败是什么原因?
以下情况会导致流程启用失败:
1.流程中必须要包含一个开始节点(含提交人节点)、至少一个结束节点。如果不满足此条件,则启用流程失败。
2.必须进行的配置项没有设置,例如没有设置审批人、分支连线没有设置分支条件。
Q:五个流程用户组一起会签,每个流程用户组包含多人,流程用户组中的人任签即可,如何实现?
通过包容网关实现,将五个流程用户组分成五个分支,每个每支使用一个流程用户组,且节点审批方式配置成任签。
Q:审批时限是否可以按照工作日处理?
目前审批时限按照自然日处理,不支持区分工作日和节假日的配置方式。
Q:审批节点里的人离职了,管理员应该如何操作?
以下两种审批人更换方式任选其一即可:
1.单独替换:在系统后台的流程中心 > 审批流程 > 审批节点属性 > 审批人配置中重新配置审批人。
2.批量替换:在系统后台的流程中心 > 流程报告中批量替换审批人(目前支持对审批策略为固定审批人的节点进行批量替换)。
Q:审批流为何会出现多版本?
在企业日常运营中,审批流程的执行时间通常按天计算,所以每天会有大量的在途审批实例,且这些在途实例的推进节点、办理人员各不相同。因此,当对系统中某一特定审批流程进行调整时:
1.会产生新版本,以确保新的审批实例按照新版本执行。
2.禁用并保留历史版本,以确保之前基于旧版本产生的审批实例、审批任务能够正常推进,审批历程能够正常查看,必要时能够被追溯。
Q:为什么不允许直接修改审批流的历史版本(禁用版本)?
禁用状态的流程版本,可能会存在在途或已完成的流程实例数据:
1.对于在途流程实例数据,其审批进度、办理人员各不相同。这些在途流程实例的推进,严格依赖于实例对应流程版本(最新或历史禁用版本)中的流程定义。如果对禁用状态的流程版本进行修改,可能会导致此版本对应的在途流程实例执行异常,甚至无法继续执行,将影响正常的业务流转。
2.对于已完成的流程实例数据,同样需要确保对应的流程版本稳定且不会被随意修改,以此保障各项审批业务的可追溯性。
Q:如何关闭流程工作台里的批量办理功能?
在系统后台的流程中心 > 审批流程中,单击流程工作台设置,将允许批量办理设置为不允许。
Q:后台配置审批流节点时,审批类型设置为“单人审批”,审批策略设置为“按角色查找”。如果该角色下包含多人,当前节点是否角色下所有人员都会收到待办任务?
不会,由上一节点审批人从该角色下选择一个人办理当前节点任务。
Q:提交前校验、提交前、提交后事件的发生时机在系统页面上怎么定义?
提交前校验事件:发生在出现提交弹窗之前(校验失败会阻断提交)。
提交前事件:发生在出现提交弹窗 + 单击提交弹窗确定按钮之后(执行失败会阻断提交)。
提交后事件:发生在单击提交弹窗确定按钮 + 成功完成当前提交之后(执行失败不会阻断当前提交)。
Q:配置了审批流程,并在企微应用中接收审批相关卡片,什么情况下企微卡片上不展示审批按钮?
在审批流程中,当前节点存在以下任一情况时,企业微信(企微)卡片将不会展示审批按钮:
1.审批控制配置为“会签”。
2.拒绝后动作配置为“2:当前节点之前的任意节点”。
3.通过、拒绝按钮设置审批意见留言必填。
4.审批编辑必填字段为空。
在审批流程中,下一节点存在以下任一情况时,企业微信(企微)卡片将不会展示审批按钮:
1.下一节点审批策略配置包含自选审批人。
2.下一节点审批控制配置为单人,但按照审批策略返回结果是多人。
Q:流程关联对象数据的详情页中,为什么没有审批提交按钮?
以下两种情况,不会显示审批按钮:
1.流程配置完后,没有启用流程。
2.数据的业务类型与流程关联的业务类型不同。
Q:审批节点里的人休假了,审批流又很着急该怎么办?
1.休假前,休假人应进行任务委托。休假人在系统前台的流程工作台 > 待办中完成休假期间的任务委托。
2.休假中,审批人可进行任务转办。管理员也可以在系统前台流程工作台 > 审批移交中完成待办事项的转办移交。
Q:如果审批流中某个节点的审批人没有这条数据的查看权限,他能进行审批吗?
审批人接收到待办任务时,会自动将审批人添加到数据的团队成员中,一般情况下不会出现审批人无法查看数据的问题。
Q:审批流中审批人的审批意见是否能导出?
可以导出。在系统前台的流程工作台 > 全部审批中,单击右上角的导出,在弹出的页面中勾“选流转记录”即可导出每个审批人的审批意见。
Q:审批人员无法查看当前数据,且动态记录中数据未添加审批人员为团队成员,是什么原因?
审批流配置、审批人、所有人的用户权限都以数据提交审批时刻的配置和拥有的权限为准,所以当存在以下情况时,可能会出现审批人员无法查看待审批数据:数据提交审批时,审批人员拥有待审批数据的查看(编辑)权限,此时数据所有人不会主动添加审批人员为团队成员,然后修改了审批人员角色或职能权限,修改后该审批人员无权限查看待审批数据,此时数据所有人也不会主动添加审批人为团队成员。
Q:通过业务逻辑代码转办时,提示“不支持的操作(转办)”,是什么原因?
该节点不允许转办。管理员在系统后台的流程中心 >审批流程中配置人工节点属性,在基本属性部分勾选上“允许转办”。
Q:被加签的审批人是否还可以转办给别人?
不可以。
Q:删除对象上某一字段时,提示被审批流或自动流引用,该如何处理?
在系统后台的流程中心 > 流程监控 > 流程实例管理 > 元数据引用中,选择相应的对象和字段,并查看引用关系,删除该引用关系后再删除该字段。
Q:字段的帮助文本最大长度是多少?汉字、字母、符号等不同类型分别占用多少字符?
字段的帮助文本最大长度为500字符,1个汉字、换行符、符号、空格、字母或数字都计为1个字符。
Q:计算公式中使用 NUMBERSTRING 函数转换多货币字段时,转换出的大写金额单位是否受所转换字段的币种单位影响?
不受所转换字段的币种单位影响。NUMBERSTRING 函数在转换时只取其中的数值,且转换后的值前面自动带“人民币”字样, 如无需显示“人民币”,可以使用 SUBSTITUTE 函数将其去掉。
Q:如何修改审批流禁用版本中的流程属性?
1.在业务闲暇时,将待修改审批流的禁用版本调整为启用状态,然后对流程属性进行修改。修改完成后,再次将该版本禁用。2.联系销售易技术支持申请处理。
Q:BI中的流程绩效报表是否支持统计在途数据?
目前仅支持统计已结束的流程数据,不支持统计在途数据。鉴于在途数据可能受到用户收回、撤销、拒绝等操作的影响,即使其同步至 BI,也可能导致每次统计结果不一致。所以,在途数据统计结果的不确定性导致其参考价值也相对有限。
Q:主子明细表单中,子明细列表中子记录的展示顺序遵循什么规则?
1.直接新建的子明细记录,会追加在子明细记录列表的最后一行。2.通过复制功能新建的子明细记录,会追加在被复制记录的下一行。3.编辑表单时,子明细记录的顺序按照子明细记录的创建日期升序排列。
Q:对象列表页中的“最近访问”视图能否配置为不显示?
对象列表页“最近访问”视图不支持配置。
Q:对象详情页相关列表中,用户对子对象有新建权限但看不到新建图标(+),是什么原因?
用户只有同时拥有新建子对象数据的功能权限和编辑当前主对象数据的数据权限时,才能在主对象详情页的相关列表页中对子对象数据进行新建操作。
Q:如何将多条记录中同一字段的值批量修改为相同的值?
NeoUI:在对象列表页中,筛选同一业务类型的数据后,单击列表页顶部右侧的编辑列表按钮(笔形图标)进入批量编辑模式。在勾选多条待修改数据后,单击待修改字段表头的编辑按钮(笔形图标),然后设置修改值及修改范围,之后依次单击确定、保存完成批量修改。
经典版(旧版)页面:通过前台导入/导出功能实现批量修改。
Q:沙盒初始化功能,可以自动同步哪些后台设置?
在系统创建沙盒页面中,单击查看范围了解。
Q:沙盒环境无法登录,提示用户名和密码不匹配,如何处理?
如果是首次登录沙盒,则用户名与生产环境相同,密码同用户名;如果之前登录过沙盒,则为之前使用的用户名和密码。此外,也可以在沙盒环境登录页单击忘记密码进行密码重置。
Q:沙盒配置包批量添加组件时,无法勾选BI报告和BI视图,是什么原因?
BI报告和BI视图不支持批量添加,需要在配置包组件设置页面,单击添加组件,然后找到智能分析下的BI报告和BI视图分别添加。
Q:配置包检验失败,提示用户唯一Key不存在,如何处理?
需要在沙盒环境中导入或录入用户,且用户的唯一Key需要和生产环境中相同。
Q:用户创建并登录沙盒环境后,看不到后台的功能菜单,是什么原因?
用户在创建并登录沙盒环境后,需要在系统后台的用户和权限管理 > 部门/用户管理中,对用户进行功能授权并分配相应的角色与职能。授权与角色职能分配完成后,用户重新登录沙盒环境时,即可查看到相应的功能菜单。
Q:删除刚创建的沙盒时,提示未达到删除时间不能删除,是什么原因?
沙盒创建完成24小时之后可以删除。
Q:系统首页流程任务组件的待提交中,不显示标准对象和自定义对象的审批数据,是什么原因?
首页流程任务组件中,待提交部分仅显示审批单(系统后台流程中心审批单设置中)对象的待提交数据。对于标准对象和自定义对象的待提交数据,可以在各自对象列表页中查看(审批状态字段为“待提交”的数据)。
Q:通过系统后台的密钥管理功能,自动生成或自定义上传密钥后,能否定期修改密钥?
系统不支持修改密钥。
若因特殊情况必须更改密钥,请联系销售易技术支持并提服务工单,由销售易协助处理。处理过程大致为:系统管理员需要先自行借助系统导入导出或 API 等能力,将数据以明文形式读取后转存到其他备份字段上,然后由销售易进行特殊处理,之后系统管理员可以重新在系统中设置密钥,密钥设置完成后,需要自行将备份字段的值迁回已有加密字段上,此后会使用新密钥进行加密。
Q:计算公式中使用NUMBERSTRING函数转换多货币字段时,转换出的大写金额单位是否受所转换字段的币种单位影响?
不受所转换字段的币种单位影响。NUMBERSTRING函数在转换时只取其中的数值,且转换后的值前面自动带“人民币”字样, 如无需显示“人民币”,可以使用SUBSTITUTE函数将其去掉。
Q:字段的帮助文本最大长度是多少?汉字、字母、符号等不同类型分别占用多少字符?
字段的帮助文本最大长度为500字符,1个汉字、换行符、符号、空格、字母或数字都计为1个字符。
Q:删除对象上某一字段时,提示被审批流或自动流引用,该如何处理?
在系统后台的流程中心 > 流程监控 > 流程实例管理 > 元数据引用中,选择相应的对象和字段,并查看引用关系,删除该引用关系后再删除该字段。
Q:如何实现将数据批量初始化到系统中?
可以通过系统前后台的数据导入功能实现,前后台单次导入的数据量最多都是5万条。前台导入主要面向业务人员,导入时会执行所有的校验规则和业务逻辑规则,适合日常业务数据的导入。后台导入主要面向系统管理员,管理员在导入时可以根据需要跳过一些校验(如校验规则、查重规则、触发规则等),适合数据初始化场景。此外,也可以通过API实现数据的批量导入。
Q:新建子对象数据时,Picker 页面中显示的主对象数据,未遵循主对象查询权限中设置的权限规则,而是显示了所有数据,是什么原因?
主子关系中,Picker页面显示的主对象数据范围,取决于角色数据权限高级设置中主对象修改权限的设定范围,
若出现此问题,可能是因为该用户所属角色在主对象上的修改权限被设置为全部。
Q:NEX扩展代码编写完成并单击发布时,提示“您当前访问的页面暂不支持NEX扩展”,是什么原因?
出现此提示有两种原因:
1.当前打开的表单不是Neo表单。
2.系统(租户)未开通NEX扩展开发相关功能。
若出现此问题,可联系销售易申请开通。
Q:NEX扩展是否支持向主子表单的子表中批量添加新数据行?
支持。
Q:CRM导航菜单中,如何设置显示哪些对象?
CRM菜单是系统预置的导航菜单,其菜单项不可修改或删除。对于管理员,默认将包含所有对象和自定义菜单;对于普通用户,如果不希望其访问某个对象,可以通过在系统后台的用户和权限管理 > 职能管理 > 功能权限中,设置对象的功能权限,来控制对象是否在导航菜单中显示。
Q:Nex目前有几个版本?
Nex目前有四个版本:
1.RPA版本
仅适用于经典版(旧版)页面开发,不支持NeoUI(新版)页面。
2.Nex1.0未拆分版本
1)所有对象集中在一个文件中,代码冗长,难以维护。
2)无版本管理机制,难以追溯旧版本。
3.Nex1.0版本
1)基于Nex1.0未拆分版本演进,每个对象独立成文件,结构更清晰。
2)引入版本概念,提升了可维护性。
4.Nex2.0版本
1)当前主推版本,支持NeoUI页面的首页、列表页、详情页和表单页扩展。
2)API设计清晰,文档丰富,示例完善,开发效率高。
Q:为什么发布的Nex代码不生效?
当系统中存在未拆分代码时,运行Nex1.0的代码将无法生效。
Q:如何判断当前系统是否运行的是未拆分的Nex?
下载最新的开发工具(在销售易系统后台单击页面顶部右侧的帮助文档,在文档中心>开发资源>开发工具中下载:NEX工具(NEX DevTools)),如果系统中存在未拆分情况,该工具会有相应提示。
Q:在后台配置关联关系字段时,设置了筛选条件,但在该关联字段的Picker页上搜索数据时,发现不满足筛选条件的数据仍然能搜索出来,这是什么原因?
此问题是由于在配置关联关系字段时,未勾选【只允许从筛选结果中关联数据】选项。勾选该配置项后,Picker页上仅会显示满足筛选条件的数据。
Q:在后台新建或编辑触发规则时,【执行方式】配置项中【只对数据进行特定修改时才执行】怎么定义?
1. 特定修改仅在编辑、锁定、解锁、转移的执行方式下生效。
2. 特定修改的要求是:下一步条件设置中的数据修改前不满足条件,修改后满足条件时才会执行触发规则。例如,若规则条件设置为`int=1`,则只有当修改前`int≠1`,修改后`int=1`时,特定修改才符合条件,其余情况不会触发规则。
Q:用户对子对象有全部职能权限,而对主对象没有修改的职能权限时,子对象数据能否删除?
用户对主对象没有修改职能权限时,子对象数据无法删除。
Q:主对象职能权限正常,子对象数据及职能权限正常时,仍无法删除子对象数据,是什么原因?
管理员删除子对象数据时,系统不会检验主对象数据的权限(包括锁定状态)。但对于普通用户,如果主对象数据是只读权限或被锁定,则无法删除子对象数据。
Q:租户已开通合作伙伴能力,但前台选人/选部门组件下为何没有显示【合作伙伴】页签?
【合作伙伴】页签的显示受职能和许可授权的控制。当前登录用户需要满足以下条件:
1. 用户授权:在后台【部门/用户管理】功能中,为该用户授权【PRM企业端】许可证。
2. 分配职能:在后台【部门/用户管理】功能中,为该用户分配包含【合作伙伴通讯录】权限的职能。
Q:前台为实体数据选择团队成员时,选人组件下【合作伙伴】页签内为何没有显示相关人员数据?
【合作伙伴】页签的数据展示受当前登录用户角色的社交权限控制。具体要求如下:
内部用户角色:在后台【角色管理】功能的【社交权限】页签中,需勾选【外部下级部门】或【全部外部部门】任意一个选项。
外部用户角色:在后台【角色管理】功能的【社交权限】页签中,需勾选【本部门】、【外部下级部门】、【直属上级部门】、【全部外部部门】或【本人下属人员】任意一个选项。
Q:在业务逻辑代码(脚本)中实现触发事件:客户所有人发生变更时,自动将审批流转办给客户所有人。操作时系统报错,是什么原因?
需排查以下问题:
1. 客户所有人是否满足审批权限:检查变更后的客户所有人是否有足够的审批权限。如果不满足,将无法转办。
2. 当前办理人是否有转办权限:确认当前办理人是否具备转办权限。如果没有转办权限,将无法转办。
3. 当前节点是否允许转办:确保审批流的当前节点允许进行转办。如果节点设置不允许转办,则无法完成该操作。(如需修改此类权限,可在后台【流程中心】功能下找到对应的流程进行调整。)
4. 业务逻辑代码中是否更新了最新所有人用户ID:确保业务逻辑代码中获取的是最新的客户所有人ID。如果没有更新为最新所有人的ID,系统将报错。
Q:对象的计算字段没有值时,显示为空白,但汇总计算该计算字段时,若没有值,汇总字段显示为0,是为什么?
计算字段为空白时,汇总计算时会默认将空值视为0。
Q:配置关联字段时,筛选器的数量上限是否与高级公式的长度有关系?
是的,筛选器的数量上限与高级公式的长度有关。高级公式的长度上限为2000字符,若筛选器配置数量较多,可能会达到此限制。通常情况下,筛选器数量不会如此庞大,且即便达到了该上限,过多的筛选条件在业务上也往往意义不大。
Q:对象数据归档后,是否可以进入数据详情页面,查看相关Tab中的记录以及其他子Tab页面记录?
数据归档后,无法进入详情页,只能查看归档列表中的字段信息。如需查看子对象数据记录,建议将子对象数据也归档,并通过归档列表中的关联关系或主子明细字段进行筛选查看。
Q:用户发现,自定义对象的某一自定义字段,权限被突然设置为所有职能只读,是否可以查看修改日志?
可以通过后台【日志审计】>【系统设置日志】功能查看自定义字段的修改记录。如果是在后台编辑自定义字段时修改权限,会生成修改日志;但如果是通过【职能管理】>【字段使用】功能进行修改,则不会生成字段的修改日志。
Q:离职用户复职时,系统是否会发送邮件或短信通知?
对离职用户进行复职操作后,系统不会自动发送任何邮件或短信通知,但在后续为该用户进行激活授权(分配许可证)时,可勾选“发送激活邮件或短信邀请”选项,届时系统将向用户发送激活通知。
Q:激活邮件是否支持发送英文版本?
支持。系统会根据用户个人设置中的语言偏好发送对应语言的激活邮件,若用户设置为英文,系统将自动发送英文版本的激活邮件。
Q:自动流程中配置了“绑定操作 > 创建记录”,执行该操作创建数据时,是否会触发对应业务对象上的触发规则?
不会触发。
Q:如何在复制主对象数据时,同时复制其关联的子对象数据?
可在子对象的字段配置中,勾选主子关联字段的“随父复制”选项。启用后,当复制主对象数据时,系统会自动将关联的子对象数据一并复制。
Q:业务逻辑代码日志出现乱序是什么原因?
这是由于业务逻辑代码中相邻日志的打印时间间隔极短,可能在同一毫秒内。系统在按时间戳从数据库中读取并排序日志时,无法精确区分同一时间戳下的先后顺序,导致局部日志顺序出现乱序现象。
Q:关注对象数据时提示“已达上限”,这是为什么?
这是由于关注数据数量已达到系统上限(上限为 10,000 条)。如果后台启用了“自动关注”功能,用户在创建对象数据时会自动关注这些数据,长期累积后可能触达上限,导致后续无法继续关注。
如需关闭自动关注功能,可在后台进入【功能设置】 > 【办公设置】 > 【关注】页面,取消勾选“自动关注”。
Q:某普通用户未配置“删除客户”权限,为什么后台日志显示该用户删除了客户数据?
该用户虽然没有“删除客户”权限,但拥有“转换销售线索”权限。在进行线索转换时,系统会自动创建客户数据。若转换过程中发生异常导致失败,系统会自动回滚操作并删除新建的客户数据,因此后台日志中会记录该用户“删除客户”的操作日志,属系统自动处理的结果,并非用户主动删除。
Q:某普通用户未配置“新建客户”权限,但客户列表中却显示该用户新建的客户数据,原因是什么?
该用户拥有“转换销售线索”权限。线索转换过程中系统会自动创建新的客户数据,因此客户列表中显示的该用户新建客户,实际上是由线索转换操作自动生成的,不属于用户直接执行的新建操作。
Q:如何判断当前租户是否已开通 NEX 新工具?
可通过以下操作在浏览器中判断租户是否已开通 NEX 新工具:
1. 登录系统后,按 F12 打开浏览器开发者工具。
2. 切换到 Network(网络)页签。
3.搜索接口:rest/metadata/v2.0/nex/hasSplitted。
4. 单击Response(响应) 页签查看返回内容。
5. 若返回值为 `true`,表示当前租户已开通 NEX 新工具;若为 `false`,则尚未开通。
Q:如何判断当前表单是 Breeze 表单、Neo 表单还是 Neo2.0 表单?
可通过浏览器开发者工具识别表单类型,操作步骤如下:
1. 在表单页面按F12打开浏览器开发者工具,进入Network(网络)页签。
2. 在请求中搜索以下关键词判断表单类型:
若出现接口 initData1,说明该表单为 Neo 表单;
若出现接口 formInit,说明该表单为 Neo2.0 表单;
若都未出现,说明该表单为 Breeze(或 Dayone)表单,此类表单不支持使用 NEX 工具。
Q:一个租户是否可以部分实体开通 Neo 表单和 NEX 扩展?
系统支持单个实体开通 Neo 表单,但需要注意,NEX 和 Neo 表单是一一对应的。即开通了Neo 表单后,会自动开通 NEX 功能。因此,只有在Neo 表单开通后,才能使用 NEX 扩展功能,反之则不支持。也就是说,无法只为部分实体单独开通 NEX,而不启用 Neo 表单,二者必须一同启用。
Q:为什么在浏览器中打开系统 H5 地址进行 NEX 开发时,拉取的是网页端的扩展代码?
这是因为在浏览器打开的 H5 地址缺少 NEX 专属后缀,需要在 H5 地址中添加相应的后缀。
正确的地址格式应该为:
https://crm-***.xiaoshouyi.com/bff/spa/crmh5/index.html#/home?platform=h5&deviceType=0
重新打开浏览器工具,即可拉取并开发移动端的 NEX 扩展代码。
Q:NEX 工具有多个版本时,是否支持同时安装到浏览器?
可以。多个版本的 NEX 开发工具可以同时安装到浏览器中,旧版本不需要删除。
Q:外部系统调用销售易接口时,提示每秒超出 15 次限制,如何处理?
销售易接口限制同一个用户每秒最多发起 15 次请求,超出该限制时可以采取以下解决方法:
1. 改为定时批量请求:将高并发的实时请求改为定时批量请求。
2. 使用多个用户身份调用:可以通过多个用户身份发起请求,租户级的并发请求上限为 50 次/租户。
Q:如何获取用户查看业务数据的日志?
系统目前不支持查看用户访问业务数据的日志。
Q:对象列表页上未显示转移等批量按钮,是什么原因?
这是因为用户的职能权限未开通。管理员需要在后台【职能管理】中,选择对应的职能,并为用户开通相关对象的操作权限,才能显示转移等批量按钮。
Q:后台创建用户时提示“系统根据登录账号自动生成唯一Key时存在重复,请手动设置”,这是什么原因?
系统在创建用户时,会根据登录账号自动生成唯一Key。如果该唯一Key在当前系统中已存在,就会出现该提示。
解决方法:手动输入一个不重复的唯一Key字段值。
注意事项:若该用户被其他组件引用,且涉及沙盒迁移,为确保迁移后组件能正常关联用户,需确保该用户的唯一Key在各个环境中保持一致。
Q:租户的业务逻辑代码日志列表中只显示 ERROR 级别日志,如何设置显示全部日志?
日志的显示范围由日志规则控制。如需显示全部日志,请按以下步骤操作:
1. 进入后台【日志审计】>【业务逻辑代码日志】>【日志规则】页签。
2. 编辑默认日志规则,将日志级别设置为 DEBUG。
注意:业务逻辑代码日志每日有输出上限,建议合理控制日志数量。
Q:Picker 页上的新建按钮能否通过配置隐藏?
不能通过后台配置隐藏该按钮,但可以通过权限设置或 NEX 开发扩展方式进行隐藏。
Q:FutureTask(异步操作)是否会按照调用时间顺序执行?
不会。FutureTask 的执行顺序不保证与其调用时间一致。
Q:后台自动流程日志中,无流程名称且状态显示为“执行调度”的日志是什么类型?
这类日志是系统新增的日志类型,表示用户进行了新建或编辑操作,但该操作未触发任何自动流程或规则。系统会将此类操作记录为“执行调度”状态,表示系统已捕获该操作行为。
Q:系统 APP 端对象列表页放大镜图标的搜索逻辑是什么?
APP 端对象列表页中的放大镜搜索图标,会检索该对象中所有文本、电话、邮箱和网址类型字段的数据,搜索逻辑与网页端对象列表页顶部的搜索框保持一致。
Q:对象列表页中,引用单选字段数据未能筛选出来,是什么原因?
引用字段的数据查询存在 50000 条记录的限制,当数据量超过该阈值时,超出部分会被系统丢弃,导致无法查询到全部数据。如有特殊需求,请联系销售易。
Q:后台导入数据时,更新【文件】字段且匹配依据选择【自动编码】,导入导出日志一直显示【执行中】,是什么原因?
更新【文件】字段时,匹配依据不支持使用自动编号字段,只支持使用记录的唯一 ID 进行导入更新。
Q:流程工作台中新建委托时,提示信息如何理解?
根据不同用户和委托关系,系统会对委托时间冲突进行校验,提示如下:
1. A委托给B后,A创建委托任务(委托C,时间冲突):提示“当前用户已存在与指定时间段存在交集的委托配置”,表示A在该时间段已有委托,不能再创建重叠委托。
2. A委托给B后,B创建委托任务(委托A或C,时间冲突):提示“当前用户已有代理任务,不能委托给其他人”,说明B作为代理已有委托任务,不能再委托给他人。
3. A委托给B后,C创建委托任务(委托A,时间冲突):提示“代理人已存在与指定时间段存在交集的委托配置”,表示C作为代理人,不能重复委托给A。
4. A委托给B后,C创建委托任务(委托B,时间冲突):允许委托。
Q:NeoWeb环境下,可视化流程中关键信息的展示为何与后台配置不完全一致?展示逻辑是什么?
可视化流程中关键信息默认展示后台配置顺序中的前6个字段,以及剩余已勾选且为必填的字段,其它字段默认隐藏。用户可通过单击【查看全部】,展开查看全部字段内容。
Q:NeoUI环境下,在对象列表页筛选某一多态关联类型字段,为什么筛选下拉框为空?
NeoUI环境中,多态关联字段暂不支持筛选功能。
Q:选人组件中进行模糊搜索时,部分数据未被搜索出来,是什么原因?
系统默认最多返回十条搜索结果,超过数量限制的数据不会显示。
Q:邮件发送日志中,发送类型为【销售易代发】时,【发送状态】表示什么含义?
【销售易代发】表示系统通过汉启或 SendCloud 平台代为发送邮件。
1. 选择汉启发送时,无回调机制,系统无法确认邮件是否成功发送,日志中仅显示【发送】状态。
2. 选择 SendCloud 发送时,支持发送结果回调,日志会显示邮件发送的具体状态,如【成功】或【失败】。
Q:用户为何收不到【销售易代发】的邮件?
用户可能对该发件人已取消订阅,导致无法接收【销售易代发】的邮件。
Q:接口描述(description)中返回的"type"字段对应哪些字段类型?
主要对应以下字段类型:
文本域( textarea)
富文本( richtext)
单选( picklist)
多选(multipicklist)
整数( int)
实数(float)
货币(currency)
日期( date)
时间(time)
日期时间(datetime)
自动编号 (autonumber)
电话(phone)
邮箱( email)
网址(url)
百分比(percent)
布尔( boolean)
地理定位(localization)
文件(doc)
图片 (image)
关联关系(reference)
主子明细(detail)
引用字段(join)
计算文本(formula_text)
计算数字(formula_real)
计算百分比(formula_percent)
计算时间(formula)
计算日期(formula_date)
计算日期时间(formula_date)
计算汇总(formula_aggregate)
计算布尔(formula_boolean)
计算单选(formula)
Q:XOQL 接口中用 in 查询多选字段时,括号内的多个 code 值之间是什么关系?
括号内的多个值是“或”的关系。只要多选字段包含括号内任意一个值,该记录就会被查询出来。
Q:后台计算文本(超链接)计算公式中配置了两个超链接,但各界面只显示一个,为什么?
计算文本的结果最大长度限制为300字符,存储到数据库时超出部分会被截断。计算超链接字段在数据库中以转换后的a标签形式存储,超出长度的第二个链接内容被截断,因此界面只显示一个超链接。可通过XOQL接口查询数据库存储内容,核实实际存储长度(去除转义符)。
Q:后台新建移动端应用并分配职能用户后,用户登录移动端系统未显示该应用,是什么原因?
新建移动端应用后,需进入后台【APP构建】页面,单击【发布】,完成发布操作后,移动端系统才会显示该应用。
Q:如何使用 Query 或 XOQL 接口查询某文件类型字段中有值的数据?
1. 在后台对应对象设置页面,新建一个计算数字类型字段,计算公式使用函数 FILECOUNT(),参数为目标文件字段。
2. 通过 XOQL 接口查询该计算字段,筛选条件设为该字段值大于 0,即表示该文件字段有数据。
Q:设置关联关系字段筛选器时,计算型文本字段能否设置等于文本字段?能否查询到子数据对应的主数据字段?
关联关系字段的筛选器中:
1.计算型文本字段可以设置为等于普通文本字段。
2. 对于主子明细字段,表单上的主数据字段值会同步到后端,查询时直接取表单上的主数据字段值,而非通过主子明细字段穿透计算。因此,即使主子明细字段为空,也能查询到主数据字段值。
Q:审批中的数据配置了可编辑字段,详情页网页端有编辑按钮,移动端为何没有编辑按钮?
若审批中可编辑字段未添加至表单布局,移动端将不显示“编辑”按钮;网页端会显示“编辑”按钮,但编辑页中不包含未添加到布局的字段。若使用网页端扣框编辑,可直接修改这些字段。
Q:移动端系统中,对象详情页相关列表下,字段值显示不全,如何处理?
在相关列表的卡片右上角点击感叹号图标,即可展开并完整显示被截断的字段值。
Q:对象详情页相关下的列表组件显示字段,后台详情页布局一旦编辑保存后,立即回归后台配置,可否保留前台个人设置的显示字段?
不可以。后台详情页布局一旦保存,系统会立即覆盖用户级的个性化显示字段配置,无法保留前台个人设置。
Q:用户分配的角色的数据权限设置为【本人及下属】,但市场活动对象未受此限制,用户能看到全部市场活动数据,这是什么原因?
在角色的简易设置模式下,系统默认对市场活动、个案、合作伙伴、竞争对手等公开业务对象不做权限限制,以便用户更好地开展相关业务。因此,即使角色设置为【本人及下属】,用户仍可查看全部市场活动数据。
如需限制用户对这些对象的数据访问权限,可切换为高级设置模式,并为每个业务对象单独配置数据权限。
Q:试用租户在新建用户时提示:“免费租户用户数量超过『基础功能』license用户数”,但“基础功能”license的分配数量并未达到限制数量(1/4),这是什么原因?
该提示是由于租户当前存在的用户数量已超过“基础功能”license数量的两倍,系统会禁止继续创建新用户。
需要注意的是,该限制与“基础功能”license的实际分配数量(如 1/4)无关,而是依据 license 数量的倍数进行控制。
Q:为什么对象列表页上的“新建”按钮点击后无反应?
出现该情况的原因是用户所属职能未分配该对象的可用业务类型。
解决方法:进入后台对象设置页面,在业务类型页签下,编辑对应的业务类型,并在相关用户职能后勾选“可用”。
Q:在后台设置校验规则时,如果校验条件中插入字段“当前用户 > 主职能”,返回结果是否为职能名称?
不是。校验规则中“当前用户”的主职能返回值为该职能对应的 API 名称,而非职能名称。
Q:数据记录的文件字段中,上传的文档被删除后,是否可以恢复?是否可以从日志中查看文档的 ID?
1. 文件字段中已删除的文档无法恢复。
2. 系统日志中也无法查看到被删除文档的 ID。
Q:为什么计算日期类型字段的结果为空?
当计算结果为不存在的日期时(例如“2020-02-30”,而2020年2月并没有30日),系统会将该字段的计算结果显示为空。
Q:Picker 页上的全局搜索是否可以指定特定字段进行搜索?
不可以。Picker 页上的全局搜索不支持配置为仅针对部分字段进行搜索,系统会默认检索所有文本类型的字段。
Q:在后台对象设置页面编辑字段的“帮助文本”后,是否可以通过接口查询到该帮助文本?
可以。可通过 GET 请求调用以下接口获取:
/rest/metadata/v2.0/xobjects/{xObjectApiKey}/items
Q:为什么在后台对象设置页面中计算类型字段无法禁用?
当对象中仍有计算类型字段处于计算状态时,该对象下的所有计算字段都无法被禁用。
Q:对象详情页的相关组件中,单击“更多”进入二级列表页时,字段显示是否受查找数据列表布局的设置控制?
不是。二级列表页的字段显示受对象详情页中相关列表字段显示设置的控制。
Q:为什么对象列表页中有权限编辑的字段仍无法编辑?
列表页不支持编辑后台资料组件中未配置的字段。
Q:为什么后台编辑通用选项集列表页面未显示全部选项?
新建或编辑字段页面中,系统仅显示前 1000 个选项。
Q:如何实现新建对象数据时触发校验规则,而编辑数据时不触发?
在配置校验规则时,可使用函数 ISNEW() 判断操作类型,仅在新建数据时触发规则。
Q:为什么调用查询接口获取时间字段时,返回值为负数?
时间字段在转换为时间戳前,会先与日期 1970-01-01 拼接。若时间值在该日期之前,转换后的时间戳可能为负数。
Q:触发规则的执行时间是否有限制?
系统对触发规则的执行时间没有上限。但如果某条规则的执行时间频繁超过 30 秒,系统会将其自动移至慢队列。慢队列的任务仍会正常执行,但完成时间会相较正常队列延长。
Q:管理员在进行集成运营时,如何查看系统开发的自定义接口?
进入系统后台,依次打开开发 > 业务逻辑代码 > 扩展点页签,选择自定义接口即可查看所有自定义接口。
Q:软件包与配置包有什么区别?
1.使用场景不同:软件包主要用于通用解决方案的打包;配置包主要用于项目迭代开发。
2.租户范围不同:软件包可在不同租户间进行迁移,包括生产环境到生产环境;配置包仅可在同一租户内迁移,包括生产环境与沙盒环境或沙盒环境之间。
3.安装方式不同:软件包上传后,系统会自动生成安装码,目标环境可通过安装码完成安装;配置包同步后,可在目标环境直接进行校验和部署。
Q:业务逻辑代码 SDK 是否支持通过外部 ID 对关联字段进行赋值?
不支持。
Q:BI组件是否支持沙盒迁移?
旧版 BI 支持沙盒迁移,新版 BI 不支持。可通过 BI 资源导入导出工具实现跨环境迁移。
Q:业务逻辑代码日志不再生成日志,可能的原因是什么?
1. 检查日志规则(后台日志审计>业务逻辑代码日志>日志规则),确认是否规则限制了日志生成。
2. 检查实时日志(后台日志审计>业务逻辑代码日志>文本输出页签),如果超出当日系统上限,会显示提示:业务逻辑代码日志数据量已超出当日最大上限,查看更多日志请到【超额日志下载】界面。
Q:使用 CommonHttpClient.downBlob 下载文件时,文件名为空,是什么原因?
服务端未在响应中正确设置 Header:Content-Disposition 或 filename。示例格式:Content-Disposition: attachment;filename="filename.jpg"。
Q:子对象业务类型如何映射主对象业务类型?
在后台主对象设置页面,业务类型 > 业务类型映射下,新建映射,选择主对象业务类型对应的子对象业务类型。
Q:沙盒环境删除后能恢复吗?
不支持恢复。
Q:A 生产环境的沙盒能否关联到 B 生产环境作为 B 租户的沙盒?
不支持。
Q:接口使用外键赋值功能是否需要开通?
不需要。
Q:经典版(旧版)页面,自定义对象列表页搜索后,左下角统计会按搜索结果汇总吗?
不会,左下角统计始终按全部数据汇总。可通过字段筛选或升级到 NeoWeb 实现按搜索结果统计。
Q:NeoUI 环境下,列表页左侧隐藏字段的默认排序规则是什么?
按数据库返回的字段名称升序排序,与名称排序逻辑一致。
Q:禁用字段时报“被检索条件引用”,如何快速定位?
字段删除时报错提示中会显示具体使用的检索条件位置。
Q:能基于已有沙盒复制新沙盒吗?
暂不支持。
Q:主对象处于审批中,详情页中相关列表下子对象列表的新建按钮是否显示?
处于审批中的主对象,详情页相关列表下子对象列表的新建按钮仍显示,且可以创建子对象数据。
Q:移动端子明细列表字段与表单布局不一致,是什么原因?
子明细列表显示前6个字段,但关联关系字段及单选、多选级联、币种、汇率字段会被强制带出显示。
Q:系统导航布局如何配置?用户能自定义吗?
1. 配置路径:后台应用 > 应用管理,修改对应应用的导航方式。
2. 不支持用户个人自定义,如需为单个用户配置,需要创建专用应用及职能。
Q:自动流程更新关联字段后值被清除,是什么原因?
关联字段配置了级联清除功能,删除关联数据后字段值被自动清除并生成操作日志。
Q:数据创建时间与图片水印时间不一致,是什么原因?
图片上传时打水印,水印时间为上传时间,数据稍后保存时可能与创建时间不一致。
Q:导出用户操作日志时文件类型字段不显示文件ID,如何获取?
无法导出历史文件ID(fileid),标准产品功能不支持。
Q:详情页相关列表字段显示会变化,是什么原因?
详情页相关列表字段显示与二级列表页设置联动,两边设置互相影响。
Q:系统后台自定义对象中,主子明细字段上的“随父复制”配置项显示受什么控制?
1. 是否开启 Neo 表单控制。2. 若租户开启 Neo 首页但未开启 Neo 表单,“随父复制'不会显示。
Q:通过复制方式创建对象数据,能否控制部分字段不赋值?
不能。复制后字段会被赋值(无论字段是否在表单界面中显示)。特殊依赖字段可能部分被清空。建议通过 NEX 代码进行控制。
Q:期一天的部分的 Job 作业还在进行中,是否正常?
正常现象。Job 作业创建后,可手动将状态从“进行中”修改为“已关闭”或“已终止”;若未手动修改,“进行中”状态将在 24 小时后自动更新为“已关闭”。
Q:自定义页面调用 API 是否存在并发限制?
当页面代码认证方式为 session 时,不存在并发限制;若认证方式为 token,则存在并发限制。
Q:批量创建作业接口支持删除操作吗?为什么传参会报错?
批量创建作业接口支持删除操作,但请求中不允许包含 "batchContentType" 参数,否则会导致报错。
Q:自定义图片字段上传的图片是否默认压缩?能否禁用压缩?
1. 移动端会在上传前自动压缩图片(选择相册或拍照后);网页端不会压缩。
2. 移动端无法禁用图片压缩。
Q:查询某业务类型的单选字段选项值,可使用哪个接口?
使用接口:/rest/metadata/v2.0/xobjects/customEntityxxx__c/busiTypes/pickOptions。返回为空表示该业务类型未配置可见/不可见选项或默认值,意味着支持所有选项;若配置了选项可见/不可见或默认值,则返回对应数据。
Q:租户登录系统后只看到英文,如何显示中文?
需在后台“租户多语言设置”功能中启用多语言,并启用中文语言。
Q:租户注册后,后台未显示自定义对象功能,原因是什么?
由于未开通自定义对象许可证,需联系销售易开通该许可证。
Q:选人/选部门组件中如何显示“合作伙伴”页签?
配置步骤:
1. 系统后台数据权限多维度 > 数据权限设置中启用通讯录权限。
2. 职能管理中,用户职能的功能权限页签勾选“合作伙伴通讯录”。
3. 角色管理中,用户角色的社交权限页签选择外部部门选项。
4. 部门/用户管理中为用户授权“PRM 企业端”许可证。
5. 若配置正确仍未显示,退出登录并重新登录。
Q:主对象数据锁定,子对象数据未锁定,子对象详情页可编辑吗?
1. Neo 表单和 Breeze 表单无法打开编辑表单,会报错“无数据权限”。
2. 经典版(旧版) 表单可正常打开编辑表单并进行编辑。
Q:查重规则是否支持为空判断?单选字段不等于某值能否筛选空数据?
查重规则支持为空判断。但使用单选字段的等于/不等于条件时,无法筛选为空的数据。其他类型字段(如文本字段)支持为空/不为空判断。
Q:API 接口的 Token 有效期多长?
Token 的默认有效期为 24 小时。
Q:在对象中创建了计算单选字段后,打开 Breeze 编辑表单未报错,但未显示该字段,这是什么原因?
系统已兼容对象存在计算单选字段时 Breeze 编辑表单的打开场景。表单可以正常打开,但不会显示计算单选等特殊字段。
Q:在对象表单布局设计器 2.0 中配置了只读字段,但新建表单未显示该字段,这是什么原因?
实体表单层级未开启只读字段显示。需在后台主对象的表单布局设计器中,将"是否显示只读字段"配置为“是”。
Q:子明细对象 Picker 页上的计算文本字段为何不支持 ES 搜索?
子明细对象 Picker 页暂不支持 ES 搜索功能。
Q:新建主对象后,表单页未显示子对象表单,这是什么原因?
在主对象启用表单布局后才新建的子明细对象,需要在后台手动开启子表单。在表单布局设计器中,将实体表单层级下的“是否包含子表单”配置为“是”。
Q:PaaS 平台中的 class 指的是什么?
class 指在 PaaS 平台业务逻辑代码中,可被各功能模块独立使用的功能单元,同时作为平台业务逻辑代码资源用量的计量单位。
Q:PaaS 平台开发能力中的 class 有何作用?
class 可用于开发定制对象的 Trigger、流程脚本、计划作业、自定义 API 等业务逻辑。一个 class 可实现一个或多个功能:
1.开发者可在单个 class 中实现多套逻辑,减少对数量限制的依赖。
2.可将不同逻辑拆分为多个 class,以适配不同业务场景。
Q:专有环境是否支持安装公有云软件包?
不支持。
Q:系统当前共提供多少个 API 接口?
系统提供一套标准化基础操作接口(创建、更新、删除、转移、锁定/解锁),并支持丰富的业务专用接口。接口数量会随产品迭代动态增长,以灵活适配业务需求。
Q:销售易系统是否原生支持 Kafka 集成?
系统原生不支持 Kafka 集成。如需使用,可通过定制集成方案或第三方集成平台实现对接。
Q:XObjectService(数据操作接口)的调用次数是否有限制?
目前未限制调用次数。但存在以下约束:
1.单次链路查询不超过 10,000 条记录。
2.单次 DML 操作不超过 10,000 条记录。
未来可能增加链路级调用限制,请关注产品更新信息。
Q:沙盒创建后,系统是否会同步已有用户?
会。沙盒创建后,系统会自动将生产环境的用户等数据初始化至沙盒,范围详见文档中心:产品手册 > PaaS平台 > 沙盒使用手册 > 沙盒相关支持说明 > 沙盒初始化范围。
Q:CRM 组织和人员的接口文档在哪里查看?
系统提供用户 和部门 的 API 接口:
1.用户接口:文档中心 > API 中心 > Open API > PaaS 平台 API 接口 > 用户接口。
2.部门接口:文档中心 > API 中心 > Open API > PaaS 平台 API 接口 > 自定义对象接口,其中部门对象 xObjectApiKey 为department。
Q:在校验规则中,若公式使用的计算字段值为空,结果是 true 还是 false?
字段值为空时,该计算步骤按 false 处理,公式继续计算,最终得出完整结果。
Q:是否存在数字补零函数?
暂不支持单独的数字补零函数。系统会根据字段的小数位设置自动补零。
Q:如何通过 XOQL 查询已删除的数据?
在 XOQL 请求中增加参数 “queryDeletedData”,并设置为“true”,即可查询已删除的数据。
Q:上传文档的大小限制为 200M,是否可申请扩容?
不支持扩容。大文件会对网关造成过大传输压力,因此系统统一限制为200M。
Q:自定义对象布尔类型字段数量超限,能否扩容?
布尔类型字段不支持扩容。建议:
1. 清理不再使用的历史字段。
2. 使用单选字段替代。
3. 多业务场景共享字段,避免冗余。
Q:'onChange': function (e, originData)中的originData指的是什么?
originData 是 NEX2.0 为兼容 NEX1.0 保留的参数对象,包含 NEX1.0 中相同或相似事件的参数全集。后续将逐步下线,建议使用 e.data。
Q:修改租户登录页面和系统 LOGO 是否有版本限制?
无版本限制。
修改登录页面:需具备 App 设计器 License 且启用个性化域名。
修改系统 LOGO:可在前台个人头像下“LOGO 设置”完成。
Q:能否仅为单个用户开通 NeoUI?
可以。联系销售易开通后台 NeoUI 设置功能后,可为单个或多个用户开启。
Q:H5 端表单字段显示顺序与布局不一致,这是什么原因?
在 H5 端,表单字段的显示顺序由以下规则决定:
1.若启用了表单布局,则按照表单布局中的字段配置顺序显示。
2.若未启用表单布局,则按照详情页面布局中“资料组件”的字段配置顺序显示。
若字段顺序与预期不一致,可能原因包括:
1.实际分配的布局与预期不一致。
2.布局中设置了隐藏只读字段。
3.对于子表单,在列表批量模式下,系统会自动将字段依赖关系、引用关联字段、币种及货币类字段优先追加显示到卡片上。
Q:JSSDK 如何获取当前用户的职能?
当前需通过自定义 API 获取用户职能信息。
Q:使用 NEX1.2.0 插件开发代码时预览生效但发布无效,原因是什么?
NEX1.2.0 插件用于在 NeoUI 环境下开发 NEX1.0 代码。若预览有效但发布无效,可能是代码仍在旧环境编写。需在 NeoUI 环境 中开通插件方可生效。
Q:角色分配给用户后,如删除角色,关联用户会如何?
已分配给用户的角色不可删除。若尝试删除,系统会提示并拦截操作。
Q:如何批量移除团队成员?
在业务对象列表页中,勾选目标业务数据左侧复选框后,选择团队成员变更 > 将团队成员从选中移除,即可批量移除所选数据中的一个或多个团队成员。
Q:后台部门/用户管理功能下,无法新增部门,这是什么原因?
部门新增受以下权限限制:
1. 职能权限:操作者所属职能需包含“部门/用户管理”功能权限(路径:职能管理 > 功能权限 > 后台权限 > 用户和权限 > 部门/用户管理)。
2. 角色权限:操作者所属角色需在“部门”维度下,对“用户”对象具有“修改”权限,且覆盖所需部门。
3. 许可授权:需包含“基础功能”许可证。
请检查操作者是否具备上述权限。
Q:如何查看超过 18 个月的操作记录?
不同日志类型的可查询范围如下:
1.用户操作日志:支持查询近 60 个月记录。
2.用户/权限管理日志:支持查询近 36 个月记录。
3.用户登录日志:支持查询近 36 个月记录。
其他日志类型,请提供具体需求以确认支持范围。
Q:团队成员姓名旁的“普通员工”字样来源于哪里?能否修改?
该字样取值自用户信息中的“职位”字段。可在后台“部门/用户管理”中找到对应用户并修改职位信息。
Q:沙盒迁移失败,提示“失败组件失败组件:团队成员继承中设置的依赖对象在目标租户下不支持团队成员,实体apiKey名称=applyCustomer,这是什么原因?
因目标租户中不存在该实体,导致迁移失败。
Q:如何添加团队成员?
团队成员可通过以下方式添加:
1. 数据详情页:在数据详情页直接添加,用于临时授权。
2. 数据列表页:在列表页勾选业务数据后,通过“团队成员变更”功能批量添加。
3. API 调用:调用接口/rest/data/v2.0/xobjects/teamMember 新建团队成员。
Q:如何限制团队成员的编辑权限?
1.编辑权限控制:
1) 团队成员需具备对象的“修改”功能权限(如客户对象需有“修改客户”权限)。
2)团队成员需具备对象数据的“修改”数据权限,来源包括职能、角色、默认共享、共享规则,或通过“分配修改权限”单独赋予。
2.管理权限控制:
1) 新建团队成员:控制添加成员权限。
2) 修改团队成员:控制分配/收回修改权限。
3) 删除团队成员:控制移除成员权限。
4) 成员标签管理:控制单个或批量编辑成员标签的权限。
Q:从数据回收站恢复数据后,审批历史是否会一并恢复?
不会。回收站仅保存被删除的业务数据,不包含过程性数据(如团队成员、审批历史等)。若需重新使用过程性数据,请重新发起流程或添加团队成员。
Q:触发规则或自动流程中,能否触发团队成员的添加或删除?
可以。在后台配置触发规则或自动流程时,选择“操作类型”为“业务事件”,在对应业务对象下的“事件名称”选择“添加团队成员”或“删除团队成员”,即可实现团队成员的自动增删。
Q:如何通过业务类型字段区分可视化流程?
在可视化流程设计器的“流程属性”页面,通过设置“初始条件”的条件/公式,将业务类型作为启动条件,从而为不同业务类型配置不同流程。
Q:审批流和工作流的提交事件中,提交前校验与提交前事件有何区别?
提交前校验与提交前事件的区别主要体现在触发时机与执行目的两个方面:
1.触发时机
提交前校验:
用户单击“提交”按钮后,系统会立即触发提交前校验,执行其中配置的代码脚本。只有当所有脚本均成功执行后,流程才会进入正式提交阶段。此时尚未弹出提交审批对话框,该环节主要用于前置数据验证。
提交前:
用户单击“提交”按钮后,系统会先弹出提交流程界面(可选择办理人、设置紧急程度、填写意见等)。在提交人单击“确定”按钮后,系统将执行已配置的提交前事件。此时流程已进入正式提交阶段,并流转至下一个节点。目前提交前事件仅支持代码脚本和业务事件。
2.执行目的
提交前校验事件:
用于验证业务数据的合法性(如必填字段检查、关联数据完整性、库存校验、金额阈值检查等)。
若校验失败,将直接阻断提交流程。
提交前事件:
用于执行提交流程前的预处理操作(如生成日志、初始化审批参数、数据状态变更、通知外部系统等)。
即使事件执行失败,也不会阻断流程提交。
Q:系统报错提示:{"code":"290023","msg":"The tenant has not activated the listener script","errorInfo":null},这是什么原因?
系统启用了业务逻辑代码告警校验,但当前租户未申请开通该功能,且上传了相关告警处理代码,导致报错。
Q:主对象与子对象在审批中的使用是否有区别?
无区别。主对象与子对象均可配置审批流并执行审批。
Q:后台的业务逻辑代码日志功能由哪个 License 控制?
由CRM 旗舰版 - 开发者平台 License 控制。
Q:用量提醒中的“用户级业务逻辑代码日志”资源类型有什么作用?
系统支持实时查看用户级业务逻辑代码日志,日志存储默认上限为「License 数量 × 5,000 条/日」。为确保关键日志信息的完整性与可追溯性,管理员可配置资源用量监控阈值,并在日志量超限时实时接收告警。当用户级业务逻辑代码日志频繁突破预设阈值时,管理员可通过优化业务逻辑代码日志规则,平衡业务可观测性与系统资源利用率。
Q:CacheService 的限制信息有哪些?
租户级缓存接口(CacheService)的使用限制如下:
1.累计缓存数据总大小不得超过 200 KB。
2.累计缓存 Key 的数量不得超过 64 个。
3.在单个同步脚本(链路级)中,调用缓存接口的次数不得超过 50 次。
4.在单个异步脚本(链路级)中,调用缓存接口的次数不得超过 100 次。
Q:接口接收文件大小上限是多少?是否支持扩展?
文件上传接口(/rest/file/v2.0/file/batch)的单个文件大小上限为 200M,不支持扩展。
Q:认证连接器在什么场景下使用?
在调用销售易 API 前,需通过 OAuth 2.0 完成安全认证。配置连接器是实现认证的前提。
Q:接口创建异步作业时,"execOption" 参数的含义及可选项是什么?
在创建异步作业接口(/rest/bulk/v2/job)中,"execOption" 参数用于指定在新建或更新操作时是否执行数据规则校验。可选项:
CHECK_RULE:执行校验规则。
CHECK_DUPLICATE:执行查重规则。
Q:APP 端是否支持创建审批流委托?
不支持。
Q:启用工作流后,新建/编辑表单页面是否会显示“保存并提交申请”按钮?
默认不开放。如需开通,请联系销售易。
Q:审批流中的某个节点设置了 A、B 两人任签,如果 B 将审批委托给 A,A 会收到几条待办任务?
A 将收到两条该节点的待办任务(自身待办 + 受托待办)。
Q:编辑用户的相关部门有什么作用?
系统支持在用户归属部门之外,额外关联其他相关部门,以满足跨部门处理业务数据的需求。管理员可通过角色数据权限控制用户对相关部门业务数据的可见范围。
Q:用户模块中的离职/在职状态与激活/未激活状态之间是什么关系?
两者为独立但存在约束关系的状态:
1.激活/未激活状态:表示账号是否处于活动状态。未激活账号可删除,且不可登录;激活状态不可逆。
2. 离职/在职状态:标记员工职业状态。只有已激活用户才可被设置为离职。
Q:取消用户授权后,系统是否会发送激活邮件或短信?
是否发送取决于在设置或取消授权时,是否勾选了“发送激活邮件或短信邀请”选项。如勾选,则会发送。
Q:职能是否有数量限制?
暂无限制。
Q:CRM 每天对接的导入数据量是否有限制?
导入数据量无限制,但 API 调用次数有限制。建议使用 BulkAPI 以提高处理效率。
Q:文件字段上传的文件类型是否有限制?
上传文件类型不限。预览功能依托金山预览,可支持多种文件类型。
Q:计算型自定义字段公式是否支持换行?
当前不支持主动换行,仅可根据 UI 组件宽度自动换行。后续版本计划提供换行函数。
Q:除 NeoWeb 外,其他版本是否支持富文本字段?
经典版(旧版)的列表页和详情页支持富文本字段,但表单页暂不支持。
Q:移动端支持新建对象数据存草稿,网页端是否支持该功能?
网页端暂不支持该功能,后续版本计划实现移动端与网页端统一的草稿功能。
Q:如何判断当前系统界面为 NeoUI 版还是经典版?
可通过以下方式判断系统界面版本:
Web 端:
NeoUI 版地址以 https://crm-gray.xiaoshouyi.com/bff/neoweb 开头。
经典版地址以 https://crm-p05.xiaoshouyi.com/index.action 开头。
App 端:
NeoUI 版在应用界面左上角显示“我”的头像。
经典版在底部导航栏显示“我”的头像。
Q:如何在查找布局中隐藏“新建”按钮?
管理员可在查找布局的配置界面取消勾选“新建按钮显示”选项,从而隐藏该按钮。
Q:如何根据用户的部门或职能控制列表按钮显示?
在后台列表按钮配置中,可设置按钮的可见性条件,选择“当前用户的部门”或“当前用户的职能”作为控制依据,实现动态显示或隐藏按钮。
Q:如何设置用户首次打开对象列表页时的默认视图?
管理员可在后台“修改列表布局”页面设置默认视图,用户首次访问该列表页时将自动显示所选视图的数据。
Q:如何在单个字段中关联多个对象数据(如会议参会人选择多个联系人)?
可使用“多值关联”字段功能,每个字段最多可关联 100 条对象数据,适用于会议参会人、任务分配等场景。
Q:新版全局搜索有哪些优化?
新版全局搜索优化如下:
1.提供全新的交互体验。
2.支持无限数量的搜索对象。
3.支持复杂搜索逻辑,如 A AND B、全字匹配关键词。
4.搜索结果按相关度排序,相关度排序逻辑优化。
5.搜索结果支持按数字或日期字段进行二次排序。
6.支持用户级常用对象设置。
Q:文件字段上传后如何快速预览?
系统支持文件上传后即时预览,并可在同一字段的多个文件间切换,无需保存后返回查看。
Q:文本字段长度能否扩展至 500 或 1000 字符?
暂不支持。建议使用文本域字段以存放更长内容,或联系销售易评估扩展可行性。
Q:如何将已有未办理的流程任务一并委托给他人?
创建流程委托单时,勾选“代理已有代办”选项,系统会自动将未完成的任务一并转交给代理人。
Q:如何查看计划作业的下次执行时间?
在计划作业列表页的“下次执行时间”列中,可直接查看各作业的预计运行时间。
Q:页面代码更新迭代时如何避免业务中断?
目前已支持无感知发布,可在启用状态下直接上传新代码包。请通过“复制”按钮获取标准引用地址,避免手动修改 URL 导致兼容性问题。
Q:如何在不影响执行的情况下排查计划作业的配置问题?
可直接单击作业名称进入详情页查看配置,无需禁用后进入编辑模式查看,从而避免执行中断。
Q:审批操作未收到邮件(通知)类系统信息,这是什么原因?
请按以下顺序排查:
1.租户级:系统后台功能设置 > 办公设置 > 通知,检查是否存在通知过滤配置,过滤规则可能导致信息无法接收。
2.用户级:系统前台个人设置 > 订阅设置,确认是否勾选“审批(提交/拒绝/通过)”,未勾选将影响邮件接收。
3.流程级:流程属性中是否勾选“允许发送消息通知”,未勾选将导致信息无法发送。
Q:流程属性中添加提交权限时,用户类型中“指定数据所有人主职能”选项的含义是什么?
该选项表示:核对当前审批数据所有人的主要职能需在流程属性配置的提交权限范围内。
Q:审批抄送是否会生成待办任务?
审批抄送不会生成待办任务。被抄送的审批会显示在用户流程工作台 > 抄送页签下。如启用了通知或邮件配置,用户将收到相应的抄送通知或邮件。
Q:如何查看审批抄送配置?
若在提交时抄送,抄送及抄送人员的配置位于提交节点上。
若在节点1同意到节点 2 时抄送,抄送及抄送人员的配置位于节点1上。
Q:系统首页的宣传图链接如何拼接?
系统首页宣传图在后台用户界面 > 移动端 > App设计器 > PRM登录页/CRM登录页设置。可为宣传图配置链接,链接需以 https 开头,可指向任意有效地址。
Q:表单设计器是否支持标准对象“市场活动”?
暂不支持。NeoUI 表单设计器目前支持在自定义对象及部分标准对象(销售机会、服务工单、派工单、服务云、派工物料明细、知识条目、出库单以及明细)上使用。
Q:NEX1.0 是否支持提交前弹框?
建议使用 NEX2.0,通过 beforeSave 事件触发自定义逻辑,并可使用 ctx.ui.openIframe 函数实现弹框。
Q:系统首页数据列表组件的普通模式与高级模式有何区别?
两种模式均可展示数据,但高级模式支持更多功能,例如操作按钮、分页及数据筛选。
Q:租户开发的 NEX 代码预览生效,但启用后不生效,原因是什么?
原因:租户过去使用的是经典版(非 NeoUI 版本),该版本默认运行 RPA 代码和 NEX1.0 未拆分代码。存在未拆分的代码会导致新工具创建的 NEX 代码无法运行。
解决方案:手动拆分 NEX 代码。
1.登录系统,进入后台开发 > NEX 扩展,切换至 NEX1.0 页签。
2.单击提示消息中的“此处查看”,查看未拆分的代码。
3.在查看界面中单击“拆分代码”按钮,即可完成代码拆分。
Q:NEX2.0 是否需要单独开通才能使用?
不需要。只要租户升级至 NeoUI 并安装最新版开发工具,即可开发 NEX2.0 代码,无需单独开通。
Q:使用经典版进行 RPA 扩展的租户,如何将扩展逻辑迁移到 NeoUI 版本?
经典版的 RPA 扩展代码无法在 NeoUI 版本中执行。建议优先通过 Neo 表单设计器重新配置实现,表单设计器无法实现的功能,可使用 NEX2.0 实现。建议先在沙盒环境中测试验证,再迁移到生产环境。
Q:沙盒初始化是否支持将流程相关组件同步到沙盒?
支持。创建沙盒后,系统会自动将流程相关组件初始化到沙盒环境。初始化范围可参考:文档中心 > 产品手册 > PaaS 平台 > 沙盒使用手册 > 沙盒相关支持说明 > 沙盒初始化范围。
Q:沙盒配置包同步安装后,能否取消操作?
目前系统不支持取消安装操作,请在安装前仔细核对配置内容。
Q:软件包迁移安装是否支持私有云到私有云?
目前不支持。若尝试安装,会提示:“The installation code is not available, please check and try again”。
Q:系统中哪些操作会清空用户的授权许可?
当用户被设置为禁用或离职状态时,其当前的授权许可将被清空。
Q:存在旧审批历史的数据,还能提交新审批流吗?
旧审批已结束的数据无法提交新审批;旧审批未结束的数据,可在撤回后重新提交新审批。
Q:审批人加签挂起后,加签人操作完成,原审批人继续处理时未收到钉钉待办提醒,原因是什么?
同一个待办任务在 1 小时内仅会发送一次钉钉提醒。加签前后,原审批人处理的仍为同一个待办任务,因此不会重复推送提醒。
Q:在标准对象销售机会配置审批流程时,审批编辑功能未将“客户名称”字段设为可编辑,但审批过程中仍能修改该字段,原因是什么?
销售机会创建后,“客户名称”字段的是否可修改由其最高优先级属性决定,可在后台销售机会设置页面的通用设置 > 商机表单页签下配置,若勾选了“允许修改”,则审批过程中仍可编辑该字段。
Q:审批流程触发事件公式中的“当前节点”、“下级节点”、“当前审批人”和“下级办理人”应如何理解?
对于提交后、通过后、拒绝后事件:
1.当前节点:执行操作的节点(如提交节点)。
2.当前审批人:执行审批动作的用户(如提交人、同意或拒绝的审批人)。
3.下级节点:操作完成后指向的节点(如节点 1、提交节点)。
4.下级办理人:下级节点的待办人(如节点 1 的待办人);若为提交节点,则待办人无明确指向。
对于到达后事件:
1.当前节点:到达的节点(如节点 1)。
2.当前审批人:到达节点的待办人(如节点 1 的待办人)。
3.下级节点:无。
4.下级办理人:无。
Q:在审批流程中设置触发事件时,“流程上下文”操作符中的“当前审批人”是什么意思?
提交后、通过后、拒绝后事件:当前审批人指当前节点中最后执行审批动作的用户。
到达后事件:当前审批人指前序节点中最后执行审批动作的用户。
Q:自动流网关条件中,“发生变更”操作符是否适用于 ID 字段?
不适用。ID 字段不支持使用“发生变更”操作符。
Q:自动流接口调用成功,但未执行自动流,原因是什么?
若在短时间内对同一条数据重复调用自动流接口,超过 5 次后系统将不再执行。
Q:编辑业务类型操作为什么不会触发规则?
编辑业务类型属于配置操作,不同于业务数据处理,因此不会触发规则执行。
Q:通知消息事件执行失败,提示 sendNewMessageNotice Query targetUser Exception!,原因是什么?
需核对通知消息接收人员的有效性。若接收人已离职,在通知服务端会被视为无效用户,因此不会发送消息。
Q:公共组是否有数量限制?
暂无限制。
Q:对象的 Trigger(业务逻辑代码)未执行,原因可能是什么?
可从以下方面排查:
1.对象是否启用业务逻辑代码:进入后台对象列表,单击该对象的编辑按钮,检查“启用业务逻辑代码”配置项是否已开启。
2.扩展点是否正常生成:在后台开发 > 业务逻辑代码 > 扩展点中,筛选对应对象,确认扩展点是否已正确生成。
3.是否通过 API 调用触发:API 调用默认不触发 Trigger。
Q:审批流程的初始化条件是否有个数限制?
目前没有数量限制。但后续预计会增加限制,最多不超过 20 个条件。条件数量过多会影响性能,建议控制在 10 个以内,最多不超过 20 个。
Q:计算类型的单选字段是否支持网关分支条件?
支持。
Q:移动端新建数据保存为草稿,可以保存多久?
草稿可保存 10 天。
Q:审批流中的“加签”是什么功能?
在审批流中,“加签”允许审批人在处理任务时,临时邀请其他人员参与当前节点审批。
主要应用场景及配置:
协作决策:当审批事项涉及跨部门或专业领域(如法务条款需财务协助审核),审批人可加签相关同事提供专业意见。
权限与结果配置:
是否影响审批结果:管理员可配置加签人的意见是否计入审批结论(勾选“加签人是否参与审批”则计入,否则仅作参考)。
操作权限:需在节点属性中启用“允许加签”选项,否则审批人无法使用该功能。
Q:在按钮中执行以下代码时,如果未切换到子对象的 Tab,无法获取数据,是什么原因? const subFormInstance = props.getComponent('entityFormDetailTab', { objectApiKey: currentObject }, true); const subFormData = subFormInstance.getFormData();
1.先切换到对应 Tab 再获取数据。
2.若不希望切换后再获取,可在 tabs 节点添加 loadAllData=true(会默认加载所有实体下所有业务类型子表,数据量大时可能出现卡顿)。
Q:NEX 2.0 的地理位置字段是否支持扩展赋值?
支持。地理位置字段与文本字段一致,支持 onchange、onblur、onfocus 事件,可在这些事件中进行赋值。
Q:NEX 2.0 是否提供获取当前位置的 API?
暂不提供。
Q:列表页扩展中,能否对某一行的单元格进行赋值(非整列)?
可以,在 onSearchDataLoad 事件中调用:
e.cmp.setCellValue(0, 'name', '2222222222222222');
注意事项:
1.建议增加等待时间,防止数据较多时导致执行慢而赋值失败。
2.0 行会在新增或删除数据时发生变化。
3.仅支持对当前页进行赋值。
Q:未开通 NeoWeb,是否可以编写 NEX 2.0 的代码扩展?
不可以。即使表单是 Neo 1.0,未开通 NeoWeb 也无法编写、预览或生效 2.0 的代码扩展。
Q:详情页相关列表中,是否可以通过扩展隐藏编辑显示字段或 Setting 按钮组?
不支持隐藏编辑显示字段和 Setting 按钮组,仅支持隐藏新建按钮和自定义按钮。
Q:NEX2.0代码,为什么移动端新增按钮放在指定位置不生效?
Web 端可直接写在指定位置。
移动端(H5)需要写在 tab 节点下才会生效。
Q:升级向导是否支持升级列表页和详情页的 NEX 代码?
不支持,目前仅支持表单的 NEX 代码升级。列表页和详情页的旧代码需手动转换。
Q:移动端和 Web 端在扩展中应使用什么变量?
Web 端使用 this。
移动端使用 $mainForm、$subForm 代替 this 或 data。
Q:如何使用 hideOperations 方法隐藏子明细操作按钮?
示例如下:
"onPageComplete": (data) => {
let subFormInstance = props.context.getComponentByName("subNode")
.context.getComponentByName('defaultBusiType customEntity52 c0');
subFormInstance.api.hideOperations(0, ['copy']);
}
Q:NEX 代码会自动升级到 2.0 吗?
不会。可通过升级向导将表单升级至 2.0,或在工具中直接在 1.0 表单中使用 2.0 代码。
Q:在 NEX 2.0 中如何为省市区字段赋值?
使用 setFormData 方法赋值,1.0 的 send 方法在此不适用。
Q:NEX 2.0 中如何获取子表所有数据?
调用以下方法即可:
getFormData()
Q:新建表单时,第二个 Tab 能否默认加载?
可以。在 tabs 下添加:
loadAllData = true
此方式会默认加载所有子表数据(数据量大时可能会影响性能)。
Q:loadAllData: ctx.formType == 'create' 为什么只在新建时执行?
该配置仅在新建表单时执行,编辑表单时不会执行。新建时默认只渲染一个子实体,设置为 true 后会渲染所有子实体。
Q:为什么代码保存时提示“您的请求已中断,很抱歉,您提交的请求可能对网站造成威胁,无法访问”?
包含“confirm(” 内容,被 WAF 误判为攻击流量而被拦截了。请联系销售易处理。
Q:APP 页面中的登录 Logo 如何恢复为默认显示?
目前系统不支持一键恢复默认 Logo,只能通过重新上传图片的方式替换。
Q:给用户授权激活后收不到短信,可能是什么原因?
常见原因包括:
1.未勾选激活短信:在授权激活时,若取消勾选“发送激活邮件或者短信邀请”,用户将不会收到短信。
2.短信服务商异常:若已勾选但仍未收到,可能与短信服务商的通道问题有关。
Q:脚本代码中使用 SimpleDateFormat 进行日期格式转换时,为什么会出现偶发性结果不符合预期的情况?
原因在于 SimpleDateFormat 非线程安全,如果在多线程环境下复用了同一个 SimpleDateFormat 实例,就可能导致转换结果异常。
解决方案:
1.将全局/共享的 SimpleDateFormat 实例改为方法局部变量,避免多线程并发问题。
2.使用线程安全的日期格式化类,如 DateTimeFormatter,替代 SimpleDateFormat。
Q:代码包中能否实现 Excel 读取操作?
不支持。
Q:业务逻辑代码执行超过 15 秒是否会自动停止?
是的。当业务逻辑代码运行超出系统 Limits(15 秒)时,会自动停止执行,后续代码不再运行,并在业务逻辑代码日志中显示超出 Limits 的异常信息。
Q:如何根据实体的 belongId 获取对应的 apiKey?
可通过查询对象列表接口获取当前租户的全部实体信息,再根据 belongId 匹配并获取对象的 apiKey。接口路径:文档中心 > API 中心 > Open API > PaaS 平台 API 接口 > 查询对象列表接口 > 查询对象列表。
Q:如何通过 belongTo 的 ID 查询其所属对象?
可调用查询对象列表接口获取当前租户的全部实体信息,再根据 belongId 匹配,确认其所属对象并获取对应的 apiKey。接口路径:文档中心 > API 中心 > Open API > PaaS 平台 API 接口 > 查询对象列表接口 > 查询对象列表。
Q:是否可以通过 OpenAPI 创建字段?
目前系统尚未对外开放创建字段的元数据 API。
Q:内部请求的并发量有限制吗?
内部请求执行业务逻辑代码目前没有设置并发上限。
Q:系统是否提供更新业务对象字段配置(如字段名称)的接口?
目前系统尚未对外开放更新字段的元数据 API。
Q:如何通过接口终止进行中的审批流?
可使用 审批操作接口 终止进行中的审批流。该接口提供撤回、拒绝和结束流程等操作(结束流程仅支持流程管理员)。根据需求选择对应操作即可。接口文档路径:文档中心 > API 中心 > Open API > PaaS 平台 API 接口 > 审批流接口 > 审批操作。
Q:使用 openCreateForm 对文件类型字段传参时,应如何传?
目前文件字段和图片字段不支持赋值,无法通过接口直接传参。
Q:相同对象下同时启用审批流和工作流时,提交流程会执行哪个流程?
对于同一业务对象下同一业务类型:
1.若先启用审批流,再启用工作流,系统可正常提交工作流。
2.若已启用工作流,则无法再启用审批流,但可以发布已启用的审批流。提交业务数据时,系统仅会执行工作流,审批流将被忽略。
3.若该业务类型下已有工作流实例,禁用工作流后,也无法提交审批流。
对于同一业务对象:
若存在未绑定任何业务类型的已启用工作流,则该对象下所有提交将执行工作流。
Q:未拆分代码的 NEX1.0 扩展在 1.0 表单(自定义实体)中预览生效,但发布后不生效,原因是什么?
原因是代码未拆分。解决方法:手动拆分代码,拆分完成后即可正常发布和生效。
Q:子表的条件只读是否可以根据主表字段设置?
2.0 表单支持根据主表字段设置条件只读;1.0 表单不支持此功能。
Q:详情页明细操作按钮(detailButton)是否支持根据数据动态显示或隐藏?例如根据 dataList 某个字段控制按钮显示。
支持。可在字段的 onchange 事件中获取详情页按钮实例,然后通过 .setAttributes({ label: '123456', visible: true }) 方法动态修改按钮属性,实现显示或隐藏。
Q:NEX 2.0扩展中,如何设置详情页中的只读属性动态配置?
静态设置:使用 disabled: false 或 disabled: true。
动态设置:获取字段实例后,使用 .setAttributes 或 .updateItemsAttributes 批量修改字段属性。
Q:NEX 2.0 扩展中,编辑明细数量后,未d单击空白区域时不会自动计算,但单击保存时总价会计算,保存后总价未计算,如何解决?
由于字段中写了 onchange 事件,在未失去焦点时,数据未完成计算,因此单击保存时,计算结果未保存。可通过增加 immediateUpdate 属性来解决。
Q:NEX 2.0 是否支持根据主表字段动态控制子表的显示或隐藏?
可以通过使用 `disabledOn: "$mainForm.customItem25__c == 0"` 来实现主表字段动态控制子表的显示或隐藏。
Q:如何通过自动流打开新的表单界面?
自动流中无法直接打开新的表单界面。
Q:自动流程中哪些字段不支持更新?
在字段更新界面中可选的字段均支持更新。如果选中后无法更新,请提交服务工单进行排查。
Q:在自动流中创建或更新数据时,是否会触发业务对象的 Trigger?
在自动流中创建或更新数据时,不会触发业务对象上的 Trigger。
Q:api-tencent 对应的环境节点是什么?
销售易API URL格式规范:https://api-{pod}.xiaoshouyi.com/{api_path}
{pod}为销售易环境标识,例如tencent环境对象描述接口地址为:
https://api-tencent.xiaoshouyi.com/rest/data/v2.0/xobjects/{apiKey}/description
Q:如何通过销售易CRM的标准接口查询客户数据库中的数据?
1.查询CRM系统数据:如果客户数据库指的是销售易CRM系统中的客户(Account)对象数据,可使用销售易提供的 Query 或 XOQL 接口进行查询。
2.查询企业内部数据库:如果客户数据库是企业内部数据库,需要确认该数据库是否对外开放接口(API)。在开放的情况下,可通过对应API进行数据查询。
Q:出现“服务异常(异常编码:1600000),请联系系统管理员!”怎么办?
当异常提示未明确说明原因时,表示发生了未知系统异常。异常编码 1600000 常见于流程审批过程中。如果遇到此异常,请按照标准流程提交产品问题反馈。
Q:如何通过 API 获取客户母公司的数据?
1.明确母公司数据的来源位置。
2.确认存储母公司数据的应用是否提供对外开放能力(如 API)。
3.根据该应用的开放接口规范,通过 API 进行数据读取。
Q:NEX2.0扩展中,详情资料页是否支持批量设置字段为只读?
支持。可通过 updateItemsAttributes 方法批量设置字段属性为只读。
Q:是否可以通过 NEX 扩展或布局配置隐藏评论按钮?
不支持。当前 NEX 扩展无法控制评论按钮的显示,布局配置中该按钮为固定项,不能进行隐藏或修改。
Q:NEX 2.0 扩展中,详情页是否支持隐藏 Tab?
支持。
Q:详情页相关列表的操作区域是否支持自定义按钮?
支持,可在后台系统后台进行配置。
Q:在 NEX 2.0 扩展中,Web 端如何使用 addRows 事件?
示例:
let entityFormDetail = props.getComponent('entityFormDetail', {
objectApiKey: 'customEntity222__c',
busiTypeApiKey: 'defaultBusiType'
});
entityFormDetail.addRows([mockChildData]);
Q:在 NEX 2.0 扩展中,详情页单击“新建”按钮后,能否在表单打开时获取资料页某个字段的值,并自动赋值到表单字段中?
不支持直接传值。详情页的数据无法在打开新建表单时自动带入。
如需实现类似效果,可通过以下方式自行处理:
1.在 entityForm 的 afterRender 生命周期中,通过 ctx.requestParams 或 props 获取详情页的 recordId 参数。
2.使用 OpenAPI 查询详情数据。
Q:是否提供根据地址查询经纬度的接口?
系统目前未提供根据地址查询经纬度的接口。如有需要,可使用第三方地图服务接口,例如高德或腾讯地图。
Q:审批流程组件中查看全流程图时,为什么会显示空白?
当审批流画布中的节点配置存在循环(从后序节点又重新指回前序节点)时,会影响全流程图的溯源计算,因此不支持该类型配置,全流程图不支持该场景。
Q:设置审批流时,网关条件中多选字段的“包含/不包含”运算符如何理解?
以共 A、B、C 三个选项的多选字段为例:
包含:指同时包含指定选项,例如字段值包含 A 和 B 时,满足条件的值为 [A,B]、[A,B,C];不满足条件的值为 [A]、[B]、[A,C]、[B,C]。
不包含:指不同时包含指定选项,例如字段值不包含 A 和 B 时,满足条件的值为 [A]、[B]、[A,C]、[B,C];不满足条件的值为 [A,B]、[A,B,C]。
Q:可视化流程是否可以设置操作退回到之前的阶段?
可以设置。在流程的基本属性中,将“允许推进任意阶段”设置为 True 后,就可以在每个节点的“阶段节点属性”中配置当前节点可以退回的阶段。
Q:在 NEX2.0 中,如何动态隐藏详情页新建按钮中的业务类型?
可以通过 setAttributes 方法动态设置按钮的可见性和禁用某些业务类型,示例如下:
let detailButton = e.cmp.getComponent('detailButton', { buttonApiKey: 'createCustomEntity16__c_customItem1__c' });
detailButton.setAttributes({
label: '123456', // 设置按钮标签
visible: true, // 设置按钮可见
disabledBusinessTypes: ["defaultBusiType"] // 禁用特定的业务类型
});
Q:在 NEX 2.0 中,如何使用 openPickerList 方法?
ctx.ui.openPickerList({
objectApiKey: "account", // Picker 对象的 API Key
selectionMode: "multiple", // 数据选择模式:"single"(单选) | "multiple"(多选)
conditions: [
{ apiKey: "industryId", type: 10, value: "2,3", item: -11100000100017 },
{ apiKey: "fState", type: 10, value: "2,5", item: -11100000100057 }
], // 数据筛选条件
orderBy: { field: "createdAt", order: "asc" }, // 排序方式:"asc"(升序) | "desc"(降序)
title: "hello" // Picker 页面标题名称
});
Q:在 NEX 1.0 版本中,如何控制详情页的订单明细字段,在某个条件达成时不展示?
目前 NEX 1.0 已经下架,建议使用 NEX 2.0 来实现该功能。NEX 2.0 提供了更多的灵活性。
Q:在 NEX 2.0 中,表单子表批量删除按钮是否提供隐藏能力?
不支持扩展。
Q:在 NEX 2.0 中,在 afterRender 函数执行时,Web 端现在无法获取到明细数据了吗?
可以通过以下方式获取:
let entityFormDetail = props.getComponent('entityFormDetail', {
objectApiKey: 'customEntity10__c',
busiTypeApiKey: 'defaultBusiType'
});
entityFormDetail.getAllData();
Q:租户已经按照升级向导操作过一次升级,但现在又提示需要升级,这是为什么?
这种情况是正常的。当某些对象在新版本中得到支持时,发版后需要对这些支持的对象进行重新升级。如果在之前的版本中这些对象不被支持,而新版本支持了,升级过程就会提示需要再次进行升级。
Q:触发事件的上限每天有多少个?
目前没有限制。
Q:approvalStatus 对应的值有哪些?
approvalStatus 的值包括:待提交、审批中、审批拒绝、审批通过、撤回。
Q:单个租户的定时调度上限是多少?
专业版:0 个
企业版:20 个
旗舰版:50 个
Q:在 Web 端 NEX 扩展中,通过 addRows 批量新增数据后,引用字段无法带出,该怎么办?
批量新建场景目前不支持引用字段带出。
Q:购物车是否支持 NEX 2.0?
不支持 NEX 2.0,可继续使用 NEX 1.0 扩展。
Q:在 NEX 2.0 中,在 beforeSave 中是否支持更新表单数据?
不支持,执行时机已晚,无法修改表单数据。
Q:如果租户未升级表单设计器,对某个实体部署 NEX 2.0 代码,会不会影响其他实体的 1.0 代码运行?
不会。该实体会使用 NEX 增强版,不会影响其他实体的 1.0 代码运行。
Q:为什么在 APP 设计器中不显示企业微信?
首先确认是否已开通 企业微信 License,然后进行相应授权。
Q:新建了NEX 2.0 代码但未发布,会影响 1.0 代码的发布吗?
不会影响。
Q:在 NEX 2.0 扩展中,是否支持在新增或编辑时,根据主表字段的值来控制子表列表的显示或隐藏?
不支持动态控制子表列表的显示或隐藏。
Q:多值字段是否支持扩展?
不支持。
Q:在 NEX 2.0 中,updateItemsAttributes 可以修改哪些属性?
updateItemsAttributes 可用于批量修改字段的以下属性:
visible:是否可见
required:是否必填
disabled:是否禁用
placeholder:占位文本
disabledAfterTime:禁用某时间之后的日期
disabledBeforeTime:禁用某时间之前的日期
options:选项列表(仅支持单选和多选字段)
示例:
let entityFormMaster = props.getComponent('entityFormMaster');
entityFormMaster.updateItemsAttributes([
{
scope: { itemApiKey: 'customItem10__c' },
visible: true,
required: false,
disabled: false,
placeholder: "我是测试数据",
disabledAfterTime: '2025-07-25',
disabledBeforeTime: '2025-06-03',
options: [
{ label: "二季度", value: 2 },
{ label: "四季度", value: 4 }
],
}
])
Q:在 NEX 2.0 中,表单是否支持 setAttributes?
只支持 entityFormDetail.setAttributes({ enableCreate: false })。
Q:在 NEX 2.0 中,在编辑明细详情页中,是否可以获取缓存中的所有明细数据(包含其他业务类型)?
可以。
可通过以下方式获取实例并读取缓存数据:
1.使用
let entityFormDetailTab = props.getComponent('entityFormDetailTab', { objectApiKey: 'customEntity222__c' });
获取明细组件实例。
2.调用 getFormData 方法,获取缓存中的明细数据(包含其他业务类型)。
Q:沙盒环境是否支持委托登录?
支持。
Q:自动流中的“智能体操作”是什么?
将流程设置为“智能体操作”后,可在智能体操作中引用该流程,并通过智能对话触发和执行该流程。
Q:在 NEX 2.0 中,Web端预览可以正常使用,但发布后实际操作无法正常跳转,可能与哪些因素有关?
该情况通常与浏览器缓存或服务器缓存无关。建议查看浏览器控制台,确认是否在发布后使用了被禁用的 API,从而导致运行时报错并影响跳转。
Q:在 NEX 2.0 中,Web端和移动端目前是否统一由移动端组件进行控制?
不是。Web端和移动端目前分别由各自的组件独立控制。
Q:在 NEX 2.0 中,在 H5 端主表单中,如何清空某个明细下指定业务类型的所有数据?
可通过调用 Tabs 上的 removeData 方法实现。
第一个参数:子明细的 objectApiKey。
第二个参数:需要清空的业务类型 apiKey。
Q:通过关键词搜索时,系统的搜索逻辑是怎样的?
系统基于相关度对搜索结果进行排序,相关度主要根据搜索关键词与各字段的匹配情况综合计算,整体遵循以下优先级规则:
1.主属性名称与搜索关键词完全一致的,排在最前。
2.主属性名称中完整包含关键词的(支持关键词拆分匹配),排在其次。
3.其他字段中包含关键词的(支持关键词拆分匹配),排在最后。
在上述优先级基础上,系统还会结合一些细粒度因素对结果进行排序优化,例如关键词在各字段中的出现次数、关键词在字段内容中的占比或匹配度。
因此,在同一优先级内,具体排序可能会因这些综合因素而有所不同。例如:
在“主属性名称完全一致”的结果中,如果某条记录的其他字段也命中了关键词,可能会获得更高的相关度,从而排在更前。
在“主属性名称包含关键词”的结果中,关键词在字段中占比更高的记录,通常会排在更前。
开发平台(18题)
Q:如何在页面代码中把图片字段显示出来?目前查询图片字段得到的是id,但是没有办法直接使用id 作为图片标签中的src 源,遇到这种场景如何实现?
查询图片字段返回是记录id,无法作为图片源使用,可以通过在前端发起http 请求id 对应的文件流资源,再通过js封装一个虚拟的url地址,然后把地址放入图片标签的src地址。
Q:在CRM 中嵌入网页,对网址证书有没有什么要求?什么样式的证书才能正常呈现?
由于我们的主站是https,浏览器的安全限制要求嵌入到我们站点内部的链接也必须是https 的站点,不能是http 的站点,而对于证书来说,需要是CA 证书,否则会出现页面打不开的情况 对于https 和证书相关可以看这篇文章了解:https://www.jianshu.com/p/29e0ba31fb8d
Q:业务逻辑代码并发场景下的全局锁问题。例如,编写的业务逻辑代码,要给商机模块上的商机编码字段自动生成编码,格式为SC+21(这个是年份)+00001递增开始,不能重复,要求是在商机审批通过后事件里执行这个代码脚本,代码逻辑是先从数据库取这个字段最新编码值,然后代码加1后再写入。系统可以批量做审批,同时触发脚本,多条数据取库的值一样,造成重复,如何解决?
可以考虑使用SDK中的LockService来实现:
//定义某个字符串的锁资源
LockService lock = LockService.newLock(BillNo);
//通过Lock方法进行资源的占用,可以定义加锁时长,最大时长为1min,如不设置,默认为30s
lock.lock();
//通过unlock方法进行资源的释放
lock.unlock();
Q:现在IngageSDK 中有ScriptTrigger 和Trigger,应该使用哪个?
建议使用Trigger,主要基于以下原因:
•Trigger 支持批量,在进行批量操作时性能更优。
•Trigger 中还可以使用TriggerContext 上下文来进行传递。
•Trigger 中在进行批量操作时可以实现部分成功部分失败。
Q:上传业务逻辑代码失败?
请先检查包名,package名称不能重复,必须三级且以other开始,例如:other.xsy.demo。
Q:业务逻辑代码中调用订单更新的接口,但是应该被更新的字段并没有被更新,是什么原因?
1.检查Trigger是否启用和触发,通过增加logger日志验证。
2.检查触发器是否设置的是before trigger,如果设置的before trigger,则代码执行完成后更新的字段会被原值给覆盖掉。
Q:销售易系统中是否可以集成自己开发的页面?
可以直接集成调用其他第三方已有的页面,也可以集成自己开发的页面。在集成自己开发的页面之前,需要先上传页面代码到销售易系统中。
Q:添加的自定义开发页面,如果只想给部分人看如何设置?
页面代码目前不支持权限控制,但是可以在菜单中对入口权限进行控制,操作方法如下:
在系统设置中选择职能,找到添加的自定义页面并进行勾选,然后在前台CRM菜单中也勾选此页面。设置完成后,相应的职能就能看见此自定义页面。
如果需要严格控制权限,建议在页面代码打开时判断当前用户身份,如果不允许访问则不显示内容。
Q:主子明细关系的模块,如果直接删除主表数据,是否会触发子模块的删除Trigger?
不会触发,虽然主子明细关系删除主数据会自动删除子数据,但是只是进行了删除而不会触发子的删除trigger。
Q:校验规则和trigger的触发顺序是什么?
执行顺序: Before Trigger > 校验规则 > 查重规则 > 数据入库 > After Trigger。
Q:如何定位script resource overrun报错?
在系统后台(新版Admin),日志审计>业务逻辑代码日志的输出日志标签下找到报错的信息(支持搜索),然后单击链路id即可查看对应的代码执行以及详细报错。
Q:新建订单添加产品报错script resource overrun是什么原因?
这是由于开发代码用量超限了,在系统后台(新版Admin),日志审计>业务逻辑代码日志的输出日志标签下找到报错的信息(支持搜索),然后单击链路id即可查看对应的代码执行以及详细报错。
Q:通过Trigger做了数据的校验,导入数据后报错文档的报错信息是Trigger的,但是报错和数据无法对应,是什么原因?
Trigger返回的信息必须和进入的数据顺序是一致的。
Q:无法在系统后台看到连接器,是什么原因?
在系统后台,查看职能管理>后台功能-开发者平台中是否勾选了连接器,如果没有勾选,请勾选上。
Q:Java使用批量更新提示Out of running memory (100)MB是什么原因?
线上业务逻辑代码执行内存是100M,超过了会报这个错误提示,启用新版业务逻辑代码限制后内存默认都提升到了500M。
Q:上传页面代码包时有哪些注意事项?
1.上传的代码包必须是 ZIP格式,并且不能超过80M。
2.当 更新即再次上传安装包时,会删除原有的代码安装包。
3.当修改URL时,服务器中的代码会被删除。
4.当删除代码时,服务器中的代码会被删除。
Q:jia数据删除,同步数据时存在缓存,不能实时同步吗?
缓存问题属于服务器配置,不能调整更改。
Q:中间件用SDK调用系统接口,数据为什么会返回错误?
在中间件里面调用API,都是通过http远程进行调用的,不能通过SDK直接调用。可以使用NeoApiClient调用,获取方式:在文档中心的开发资源中下载NeoApiClient.jar。
沙盒(28题)
Q:什么是沙盒?
沙盒环境是基于生产环境的配置数据复制出的一个独立的环境,相当于生产环境的副本。沙盒环境在物理上与生产环境隔离。可以在沙盒环境中进行开发、测试、培训等工作,沙盒环境中的任何操作都不会影响生产环境中的数据和配置。与直接在生产环境中进行开发、测试相比,使用沙盒环境,可以有效避免在开发过程中对用户使用系统造成影响。
Q:目前支持的沙盒类型有哪些?
目前仅支持开发者版本,可以在沙盒环境中进行开发、测试。例如,开发人员在沙盒环境中进行新功能的开发和单元测试。
Q:沙盒的存储空间有多大?
每个沙盒包含200MB 的数据存储空间,20GB 的文件存储空间,超出部分按照存储空间定价规则购买。
Q:沙盒环境支持哪些版本?
目前支持销售云、客户服务云、现场服务云的旗舰版和无限版,企业版需单独购买。
Q:沙盒的创建是否有数量限制?
旗舰版赠送2个,无限版赠送5个。对于企业版、旗舰版和无限版,如果需要创建更多沙盒,都可以单独购买,数量没有上限。
Q:是否可以在移动端登录沙盒环境?
可以,系统提供了安卓和IOS版本的独立沙盒APP。
Q:沙盒环境登录是否使用生产环境的账号密码?
如果是第一次创建沙盒,则沙盒环境登录的用户名与生产环境相同,密码与用户名相同;如果之前创建过沙盒或者账号被其他用户加入过沙盒,则用户名和密码为之前的用户名和密码。
Q:生产和沙盒之间支持哪些迁移方式?
生产>沙盒,沙盒>生产,沙盒>沙盒。
Q:生产和沙盒之间,三种迁移方式的区别是什么?
生产迁移到沙盒时使用的是软迁移,沙盒之间的迁移使用的是软迁移,沙盒迁移到生产时使用的是硬迁移。使用软迁移时,如果在部署过程中出现错误,则对于已经部署成功的组件不会恢复到之前的版本,对于部署失败的组件以及相关组件会恢复到之前的版本。使用硬迁移时,只要在部署过程中出现错误,则无论是否有组件安装成功,都会恢复到之前的版本。
Q:迁移的数据是否包含用户的业务数据?
目前仅支持迁移配置内容,后期推出完全复制版本和部分复制版后,会支持用户数据的迁移。
Q:自定义对象迁移时需要注意什么?
不可以在两个环境手动创建APIKey 相同的自定义对象,否则在迁移时系统会报实体ID不能修改的错误。 需要在一个环境创建,然后迁移到另外一个环境。
Q:迁移系统标准字段时提示字段在目标环境不存在,该如何处理?
标准对象的标准字段如果在目标环境不存在,通常是由于license未开通或功能未启用,此时需要根据具体的字段进行判断,然后开通license或启用对应的功能设置。
Q:配置包迁移的更新机制是什么?
更新机制是新增和覆盖,不能通过配置包进行配置数据的删除。
Q:沙盒初始化时是否会同步配置数据?
新创建的沙盒,系统不会自动将配置从生产环境同步到沙盒环境,需要在生产环境手动打配置包,然后同步到沙盒,在沙盒环境中进行安装。
Q:开通了多货币功能,迁移时需要注意什么?
如果生产环境开通了多货币功能,则在创建完沙盒环境后,需要先在沙盒中手动开启多货币功能,再进行生产到沙盒的同步操作,否则在操作过程中可能会出现错误。
Q:生产环境开通过特殊限制,迁移时需要注意什么?
生产环境可以申请开通特殊限制,例如额外申请增加1个多选类型字段。如果是在创建沙盒之前增加的特殊限制,则系统会自动将此限制同步到沙盒环境。 如果是在沙盒使用过程中增加的特殊限制,则需要先联系销售易进行处理,然后才可进行生产到沙盒的同步操作,否则在操作过程中可能会出现错误。
Q:系统使用过程中增加license,迁移时需要注意什么?
创建沙盒之前在生产环境增加的license, 在创建沙盒时,系统会自动同步到沙盒环境;沙盒使用过程中在生产环境增加的license,系统不会自动将新增的license同步到沙盒环境,而是需要联系销售易在沙盒环境中增加。
在进行配置包迁移时,系统会先对比两个环境的license是否一致, 如果license不一致,则系统不允许迁移配置包。
Q:组件迁移失败时,导致其相关组件也迁移失败,错误信息如何显示?
组件迁移失败时,该组件上会显示错误信息,其相关组件不会显示错误信息。例如,自定义对象迁移失败,导致对象上的自定义字段也迁移失败,此时自定义对象组件上会显示错误信息。
Q:业务类型迁移后,哪些职能可以看到?
迁移后,默认所有职能都可以看到。
Q:布局迁移完成后,哪些内容需要手动配置?
•首页布局、APP设计器中如果使用到数据列表组件,则迁移完成后,需要手动配置数据列表组件设置中的列表视图选项。
•布局中如果使用嵌入页面组件,由于迁移时系统会自动清空嵌入页面组件的URL地址,所以迁移完成后需重新进行配置。
•布局中如果配置了自定义按钮,则迁移完成后,需重新配置布局中的自定义按钮。
Q:迁移职能时需要注意什么?
在迁移职能时,无论配置包中是否包含对象、字段、业务类型,只要对象、字段、业务类型在原环境与目标环境同时存在,在迁移职能时就会将对应的权限同时迁移。
Q:自定义字段迁移后会有哪些影响?
迁移后,默认所有职能都可以看到。在布局不迁移的情况下,新字段不会被增加到布局之中,需要手动添加。
Q:部署过程中需要注意什么?
部署过程中系统仍处于可用状态,但仍需要避免用户或者调用API的方式对用户数据进行操作。
部署过程中会修改系统的配置,所以部分功能可能无法正常使用。
Q:配置包校验失败怎么办?
查看校验错误信息,根据错误信息排查问题后重新上传一个新的配置包,也可以复制原有的配置包。
Q:配置包同步之后是否还可以继续使用?
不可以,配置包只能同步一次,且同步配置包时使用的是同步时刻的配置数据。一旦同步,配置包内的组件将无法修改,也无法再次同步。
Q:部署后是否还可以恢复到以前的版本?
不可以,部署成功后,无法恢复。
Q:是否支持动态获取当前租户域名、clientid和clientSecret?沙盒迁移代码后这些参数如果为固定,需要手动修改,比较麻烦。
可以参考SDK中ScriptRuntimeContext.getEnvInfo.getName()方法,获取当前环境的环境变量,然后根据环境变量值来进行属性的映射。
Q:为什么在沙盒环境配置了定时触发,没有生效?
目前定时触发只有已付费的线上租户才可以正常使用,测试租户和沙盒租户不支持。
数据源(14题)
Q:数据源指什么?
数据源是指跨业务对象创建的数据模型,即企业各业务模块之间的内在关联关系。
Q:为什么在BI数据源里找不到新增的自定义实体?
1904版本新增了缓存刷新的功能,在销售易智能分析云>数据源页面,点击页面右上方的同步按钮。
Q:在数据源页面,为什么没有新建数据源按钮,只有验证数据源按钮?
(1)首先确认系统设置>许可管理>许可信息中是否有BI旗舰版功能—高级能力选项,若没有该选项且需要使用该功能,需要联系客户成功经理开通。
(2)若许可信息中有该功能,查看系统设置>用户和权限>部门/用户管理中搜索到该用户,勾选后点击上方弹出的功能选项中用户授权查看该用户的授权列表中是否勾选了该功能,若未勾选,勾选后保存即可。
Q:新建BI数据源,多个的筛选条件是and吗?
是的,此处没有高级公式,默认是and的关系。
Q:新建数据源时的左连接和内连接代表什么意思?
使用左联接来合并表时,生成的表将包含左侧表中的所有值以及右侧表中的对应匹配项;当左侧表中的值在右侧表中没有对应匹配项时,将在数据网格中看到null值。使用内联接来合并表时,生成的表将包含与两个表均匹配的值。
Q:BI是否支持跨系统取数据,比如从其他的OA系统取?
目前不支持,可以将其他系统的数据通过api传到CRM,然后通过BI抓取数据信息。
Q:如何设置客户与活动记录的数据源连接?
客户中选择最新跟进人字段,活动记录中选择发布人字段。
Q:系统里面是否能直接展示出与任务相关的销售机会数据?
可以通过BI来统计,将机会与任务建立数据源后,通过表格形式展示即可查看。
Q:BI数据源中,为什么维表之间不能连接?
维表为星型模型的建模方式,不支持连接。维表就是为了处理不同实体里共有的维度字段,将之统一,两个维表连接也没有实质意义。
Q:在销售易自定义数据源中,实体类型可以切换成维表,维表与实体类型有什么区别?
维表是一个逻辑概念,如商机实体里的创建日期,线索实体里的创建日期,这时候可以用一个时间维度来统一这两个实体里的时间,用维表里的时间字段,这样在查询时,机会和线索的时间都按照统一时间的维度查询。维表字段不能在度量中使用,且保存数据源之后维表不支持切换为实体,实体字段支持在度量中使用。
Q:BI数据源中,实体类型与维表之间的连接显示为默认连接,这个默认连接是默认的哪种连接?
默认连接指的是内连接。
Q:在验证数据源时提示:数据源连接错误,请及时修改,是什么原因导致?
该报错表明有数据关联异常,请根据数据源列表出的错误标记,进入数据源检查对象间的关联是否正确。
Q:已经被视图引用的数据源支持删除某个业务模块的操作吗?
支持,可以出现独立的没有与任何模块关联的业务模块。
Q:多维度目标模型怎么删除?
先禁用,再删除,且只能禁用或删除自己创建的模型,无法禁用或删除他人的。
API(76题)
Q:怎么获取安全令牌?
在系统前台左下角,设置>个人设置-安全令牌中获取安全令牌。
Q:使用:/rest/data/v2/query接口模糊查询未成功。链接如下:https://api-tencent.xiaoshouyi.com/rest/data/v2/query?q=select id from opportunity where customItem288__c like '范%',在postman中执行报400,请求异常,原因是什么?
HTTP GET请求,query参数使用特殊字符('%'.......)时,需要先进行转义(URLEncoded)操作,使用转义后的字符串作为参数再次传入。
Q:接口创建数据时会触发Trigger吗?
通过Open API 接口创建数据时不会触发Trigger。
Q:接口调用时Connected Time Out和Read Time Out(Socket Time Out)有什么区别?是否是Open API出了问题?
ConnectTimeout 是指建立连接所用的时间,适用于网络状况正常的情况下,两端连接所用的时间;ReadTimeout是指建立连接后从服务器读取到可用资源所用的时间。所以如果是connectTimeout,一般是网络通信等问题导致,先检查网络环境。
Q:做集成开发时,租户每日Open API调用次数超限了,如何申请增加?
每次Open API的调用都会占用系统资源,如果租户Open API每日调用量超限,有两种方案:
1.如果该租户是Open API重度用户,可以考虑进行增量的Open API每日调用次数的购买。
2.如果是因为临时原因,可以联系销售运营,进行临时的Open API每日调用次数增加。
以上两种方式都需要修改当前租户API功能的license 数量:
•旗舰版:每日API调用次数=1000*API的license数。
•企业版及专业版:每日API调用次数=500*API的license数。
Q:Open API 超出每秒并发次数15 次,该怎么解决?
目前超频时会有明确的提示,http reponse code的响应值固定为429,可以通过判断该code的方式,进行重试操作,这样可以规避偶发的接口超频问题,保证代码的稳定性。
具体优化建议:
1.如果使用自定义API,将多次调用的逻辑合并到一个逻辑上。
2.通过XObjectService 或者rkhdHttpClient 在业务逻辑代码中进行数据操作(不计算并发次数)。
3.重试机制优化,当出现超时后,随机延时1 到10 秒后重试。
除以上建议之外,还建议使用NeoApiClient来进行接口调用(含Token过期重试、并发控制、超时重试)。
Q:Open API 的query 接口限制sql 长度最大是1000,如果超出了该怎么办?
如果查询条件无优化空间,建议使用XOQL 来查询,该接口最大可接收4000 个字符的条件语句。
Q:通过API操作的数据会触发第三方脚本或Trigger吗?
不会触发。
Q:如果防止API使用次数超出?
在系统后台,系统设置>系统资源用量,设置用量提醒进行预警。
Q:调用API超限优化的方法?
将ScriptTrigger改为Trigger,优化SQL查询次数等。
Q:创建连接器的前提是什么?
需要有API授权。
Q:API接口提供了哪些数据操作功能?
提供增、删、改、查功能。
Q:如何查看租户中是否有API功能授权?
在系统后台,许可管理>许可信息中查看是否有API功能。
Q:查询接口单次查询限制?
单次查询,一次最多返回100条数据。
Q:查询接口支持图片字段查询吗?
不可以,where查询条件不支持多选字段、文本域、地理位、图片字段和引用类型字段。
Q:查询接口可以进行select * 查询吗?
不支持。
Q:查询接口支持关联查询吗?
查询接口只支持单对象数据查询,不支持关联查询。
Q:Bulk API每个异步任务提交数据量最大为多少?
每异步任务提交数据量最大为5000。
Q:Bulk API每个租户文件上传大小限制?
每租户文件上传最大为20M。
Q:Bulk API每天访问频次限制?
每天每个租户Bulk API请求次数最大为300。
Q:Bulk API每个租户每秒请求次数限制?
每秒每个租户Bulk API请求次数最大为15。
Q:每个用户在1秒内可调用多少次接口?
每个用户在1秒内可调用15次。
Q:Open API访问频次根据什么判断?
访问次数由调用url地址的次数决定。
Q:Open API访问频次限制是多少?
访问次数与购买的用户数有关,每个租户每日可用用户*1000次,每日的访问次数为用户数*1000。
Q:怎么查询自定义对象的API名称?
在系统后台,对象和字段>对象-自定义对象页面查看。
Q:对象详情页面的动态信息能否通过API接口获取?
不支持获取。
Q:API接口调用次数达到上限怎么办?
需要联系销售易进行后续购买。
Q:系统通过API对接时,数据在公网上以何种形式进行传输?
API对接时,数据传输是以HTTPS的方式进行。
Q:销售易系统能否和AD域集成?如果可以,如何实现账号和密码的统一与校验?
销售易无法与AD域直接集成,如果有开发能力,并且了解AD域对接方式,销售易API可以支持。
Q:系统后台中字段的API名称和描述接口中不统一,以哪个为准?
以描述接口返回的值为准。
Q:如何获取对象中的所有字段?
通过对象的描述接口获取。
Q:通过API创建数据时,如何确定哪些字段是必填?
对象的描述接口中,required属性为true的都是必填字段。
Q:系统中手动设置所有职能不可编辑的字段,可以通过API编辑么?
可以,API编辑权限不受限制。
Q:销售易的API接口使用的通讯协议?
支持通过 HTTP 或 HTTPS 通道进行请求通信。为了获得更高的安全性,建议使用 HTTPS 通道发送请求。
Q:销售易的API接口编码集?
支持UTF-8,请求及返回结果默认使用 UTF-8 字符集进行编码。
Q:销售易的API接口数据交互格式?
以JSON格式进行数据交换。
Q:查询接口只支持一次返回30条数数据,需要查询大量数据怎么处理?
查询接口最大支持返回300条数据,当需要查询大量数据时,可以多次查询或者使用Bulk API,Bulk API支持一次返回5000条数据。
Q:查询语句中时间字段如何做查询条件?
支持时间戳,可以将时间转换成时间戳进行对比。
Q:通过接口创建数据时,如果没有指定ownerId,当前数据的所有人是谁?
所有人为获取Token的账号。
Q:能否通过API创建对象的业务类型?
不可以,API接口只支持对数据进行操作,对属于系统设置的功能不支持。
Q:如何开通API功能?
请联系您的客户成功经理开通。
Q:API的查询接口是否能查询计算型字段?
可以查询。
Q:API如何处理多货币字段?
必须传币种和汇率字段的值,本位币会自动计算。
Q:API接口传递的参数有特殊符号如何处理?
使用form-data方式。
Q:用户列表接口为什么查不到手机号或邮箱?
用户列表接口只支持查询已验证通过的手机号或邮箱。
Q:API是否有试用账号?
不提供试用,如有需要请联系客户成功经理。
Q:查询接口都支持哪些语句?
支持的SQL子句有:select、from、where、order by、limit。
Q:查询语句是否支持排序?
支持desc 降序,asc升序,仅支持id字段。
Q:BULK API都支持什么操作?
BULK API支持insert,update,delete,query这四种操作。
Q:获取不到Token了,之前一直可以正常获取,是为什么?
第一步检查获取Token的密码是否被修改。第二步检查个人设置中安全令牌是否变化,点击获取安全令牌查看获取到的令牌是否与获取的安全令牌一致。第三步检查获取Token的用户的权限是否进行了调整,是否有API权限。
Q:通过API创建的数据会不会触发系统的查重规则或校验规则
通过API创建的数据会触发查重和校验规则。
Q:图片数据如何通过API上传或下载?
图片数据的上传与下载通过图片接口。
Q:什么是XOQL?
XOQL(销售易对象查询语言)相当于查询数据库的SQL语句,可以返回与使用语言的类型系统相匹配的对象。
Q:通过API如何获取指定订单下的所有变更单?
在销售易系统中,变更单基于订单,以订单的一个业务类型存在,所以要查询变更单,可以直接查询订单表,以entityType(业务类型-值参考订单描述接口)和originalOrderId(变更订单号)为条件筛选。
Q:访问接口时提示license not enough是什么原因?
所使用的license为专业版,只能访问用户、部门、线索、和市场活动,如果需要获取更多操作权限,请开通旗舰版API。
Q:API中,对时间类型字段做限制查询,为什么不起作用?
需要将时间格式(yyyy-mm-dd hh:mi:ss)转换成以ms为单位的时间戳进行查询。
Q:XOQL支持哪些聚合函数?
支持AVG、MIN、MAX、SUM、COUNT、COUNT_DISTINCT。
Q:postman里用param查询数据时,为什么有时查询不到数据?
param查询时存在urlencoding的问题,可以尝试以下两种方案: 1. 通过x-www-formurlencoded Content-Type进行参数传递 。2. 通过urlencode对参数编码后再调用API。
Q:调用API接口创建数据,完后在页面上查看详情信息发现头部信息不显示。
请检查创建数据时的业务类型等信息是否正确,可以查看列表页中业务类型是否显示的是业务类型名称、关联关系字段是否有值。
Q:腾讯云环境API接口访问的URL是多少?
https://api-tencent.xiaoshouyi.com
Q:普通用户XOQL查询数据时报系统错误,管理员能够正常查询,这是为什么?
原因可能是由于普通用户没有查询相关模块或者具体数据的权限。
Q:通过明细接口获取不到图片类型字段,是为什么?
明细接口中,图片类型字段,没有值不会显示。
Q:通过接口无法查询集成用户的详细信息?
集成用户属于虚拟用户类型,目前不支持通过接口查询。
Q:使用API查询数据时,为什么日期型字段直接等于字符串查询不到数据?
API使用SQL查询时,日期型字段只支持timestamp类型,不支持日期类型,所以必须进行转换。
Q:通过API创建的数据会不会触发系统的业务逻辑代码?
通过API创建的数据不会触发业务逻辑代码。
Q:API中XOQL查询,desc offset 0 limit 10 的正确顺序是什么?
正确顺序应该为:desc limit 10 offset 0 ,语法顺序会影响结果,limit 和 offset 颠倒后,会执行影响返回条数。
Q:API查询数据时,使用XOQL接口和Query接口有何种区别?
Query接口是实时查询,仅能查询单个实体(对象)内数据,XOQL可能存在几秒延时,可以多实体(对象)关联查询。如果不是创建完数据后立即查询,建议使用XOQL。
Q:为什么XOQL降序排序时排序字段为空的排在前面?和常规逻辑不同?
当排序字段的内容为空时,如果是升序排序,则排序字段为空的记录会显示在最后面,如果是降序排序,则排序字段为空的记录会显示在最前面。因为目前XOQL查询的存储引擎,没用null这个概念,只有空串,所以会排在前面。
Q:引用字段支持作为查询条件吗?Query接口在数据查询时,支持使用引用字段作为where条件吗?
不支持,因为引用字段在数据库中没有存储具体值,只是一个引用位置,而引用位置用在条件中会对系统性能有较大影响。因此,引用字段不支持作为where条件,而且不支持筛选、排序。
Q:API如何处理多货币字段?
必须传币种和汇率字段的值,本位币会自动计算。
Q:API中支持用户公海池分配功能吗?
由于Account 中 highSeaStatus 不允许被修改,因此API不能支持公 海池客户分配功能。
Q:通过api接口创建客户,创建成功后为什么在客户列表中找不到这个客户?
客户的创建接口中需要传一个控制参数:public,这个参数有两个值:true、false,这个参数的作用是控制创建的客户是进入公海池中还是直接创建到销售名下,true表示入公海,false表示到销售名下。若不设定这个参数,则默认传true。所以如果发生创建完客户后客户列表找不到的情况,那客户一定在公海池中,所以如果要查看客户信息,需要到公海池中查找。
Q:调用API接口创建产品时,在产品目录下添加下级产品报无数据权限。
检查创建的用户是否对产品这级目录有读写权限。需要有读写权限才能在此级目录下添加产品。
Q:是否可以通过API接口修改活动记录?
活动记录不支持通过API接口进行修改。
Q:如何读取文档,将销售易CRM上传的文档通过接口传到OA系统?
系统提供了接口来读取文档。具体的接口说明,请参考文档中心 > Open API文档中的“下载文件”和“查询对象下的文档”章节。
Q:集成第三方应用时,销售易系统是否支持配置白名单,跳过Token验证?
销售易系统不支持无身份认证的接口。若集成第三方应用时需要无身份认证的接口,可通过集成中间件或第三方集成平台实现。
关于我们
辽宁博观创意科技有限公司,扎根东北,深耕 CRM 领域,具备大型 CRM 系统全流程交付能力。
业务覆盖 CRM 调研规划、系统实施、二次开发、ERP 系统集成、AI 应用落地、售后运维等一站式全链路服务。无论小微企业还是大型企业,我们都同等重视每一位客户。
我们坚持长期主义,不做一锤子买卖,致力于与客户建立长期稳定的战略合作关系,陪伴企业数字化持续成长。
资深 CRM 技术顾问:林锋
联系方式:189-0405-4976
邮箱:linfeng@xsycrm.com.cn