Logic Hook

hook配置信息和触发器定义在以下目录中

./custom/Extension/modules/<module>/Ext/LogicHooks/<file>.php

./custom/modules/<module>/logic_hooks.php(避免使用)

./custom/Extension/application/Ext/LogicHooks/<file>.php

./custom/modules/logic_hooks.php(避免使用)

具体的hook代码在配置文件中制定, 但是建议放在与之相关的module目录中去

配置文件还定义了执行hook的类名和方法名

可以通过代码调用去移除hook: remove_logic_hook("<module>", "before_save", $my_hook);

为防止发生无限循环执行hook的情况, 可以在类里加一个属性, 来记录是否已经执行过hook, 从而避免不必要的hook执行

hook分类:

db保存前, 保存后

数据删除前, 后 ..

登录, 退出: 成功/失败

job执行失败

job执行失败后重试

数据展示到Listview或Editview前进行处理

Application Hooks
　　after_ui_frame
　　after_ui_footer
　　server_round_trip
　　after_delete
　　after_relationship_add
　　after_relationship_delete
　　after_restore
　　after_retrieve
　　after_save
　　before_delete
　　before_restore
　　before_save
　　process_record
Job Queue Hooks
　　job_failure
　　job_failure_retry
User Hooks
　　after_load_user
　　after_login
　　after_logout
　　before_logout
　　login_failed

Sugar Logic(逻辑运算/数学运算??)

方便自定义的业务逻辑代码的创建, 管理以及在服务器端和客户端重用

他由许多互相独立和可扩展的组件构成, 其中的一个重要组件就是 Sugar Formula 引擎, 它用来解析和求值那些人类读懂的数学公式

Formula 是一个代码表达式, 包含了嵌套的函数和变量, 符合 Sugar Formula 引擎语法, 用来实现比如 加法, 乘法, 逻辑运算: add(1, 2);  not(equal($billing_state, "CA")); multiply(number($employees), $seat_cost, 0.0833); ...

Function 可以被调用的函数, 他的输出结果无论在服务端还是前段都是一样的

Trigger 一个只返回true或false的Formula, 他在这种情况下被执行: 当一个公式中的字段被更新或者一条记录被获取/保存, 此时他会通知关联的action去执行一些动作

Action 以某种方法去更改当前记录或者布局的函数, 大多数有两个参数, 一个目标, 一个formula; 比如说 style action(样式动作), 需要传递一个字段, 和一个字符串样式, 就可以用传入的样式来更改字段的样式; 列表

Dependencies  是由触发器和action组成的用来表达业务逻辑的单元, 比如: 当一个下拉选项中的值没有被选中的时候, 对应的面板要隐藏起来

Sugar Logic Types (类型)

number 数值类型, string 字符串类型, enum 枚举类型(列表类型) link 连接类型(描述两个表之间的关联关系)

Sugar Logic 基本特性(Sugar Logic Based Features)

计算字段的值, 如显示的时候, 将值乘以0.1而不是原值显示

字段关联, 比如当一个字段值在某一个范围的时候才在页面中显示出来

下拉列表关联, 如多级联动效果

自定义

自定义Function,

他将会存放在/custom/include/Expressions/Expression/{Type}/{Function_Name}.php

文件名必须是: {functionName}Expression.php, 类名跟文件名要一样, 例如继承了数字类型的function: class AbcExpression extends NumericExpression{}

必须要同时定义php和JavaScript两个相同的计算逻辑,  当在admin面板中操作"Rebuild Sugar Logic Functions"重新构建时, 相关的js代码(代码文件??)就会被编译出来

自定义Action

自定义的action就不用像function那样保持前后端一致了, 比如, 填写表单时用户输入错误了, 前段会有一个alert提醒, 但是后端会记录一条日志

他会存放在: custom/include/Expressions/Actions/{ActionName}.php ,

文件名必须以Action.php结尾, 类名跟文件名要一样, 同时得继承AbstractAction类: class WarningAction extends AbstractAction{}

必须定义一些基本的方法: "fire", "getDefinition", "getActionName", "getJavascriptClass",  "getJavscriptFire"

Extensions 扩展

扩展的目的是为了提供一个修改Sugar metadata(vardefs and layouts)的渠道,

他的文件存放在: ./custom/Extension/application/Ext/ 和 ./custom/Extension/modules/<module_name>/Ext 目录下

这些文件会通过一个事先定义好的规则(例如: vardef.ext.php)被合并成一个单独的文件,

比如vardefs文件, ./custom/Extension/modules/Accounts/Ext/Vardefs/ 目录下的所有文件都会被合并, 里边的变量合并成一个数组放到./custom/modules/Accounts/Ext/Vardefs/vardefs.ext.php中, 其中:

如果你通过studio添加了一个test字段, 就会在./custom/Extension/modules/Accounts/Ext/Vardefs/ 目录下生成一个 sugarfield_test_c.php文件, 里边很简单就一行: $dictionary['Task']['fields']['test_c']['labelValue']='test';

./ModuleInstall/extensions.php 包含了所有的扩展映射关系

扩展的属性:

1. name: 扩展的内部名字, This is used in method names such as rebuild_layouts (???)

2. install definition: manifest文件的段的名字

3. ext directory : 扩展文件存放的目录

4. ext file: 合并后存放的文件名

5. useage: 扩展在哪里被用到了

扩展种类: