Yigo Operation Script

1. OperationCollection（操作定义集合）

结构

<OperationCollection>
    <!-- 直接的操作 -->
    <Operation Key="optKey" Caption="操作名称">
        <Action><![CDATA[操作执行的公式内容]]></Action>
        <ExceptionHandler><![CDATA[异常处理公式]]></ExceptionHandler>
        <!-- 子操作（可嵌套） -->
        <Operation Key="subOpt" Caption="子操作">
            <Action><![CDATA[子操作公式]]></Action>
        </Operation>
    </Operation>
    
    <!-- 分组的操作集合 -->
    <OperationCollection Key="groupKey" Caption="操作分组">
        <Operation Key="opt1" Caption="操作1">
            <Action><![CDATA[公式]]></Action>
        </Operation>
        <Operation Key="opt2" Caption="操作2">
            <Action><![CDATA[公式]]></Action>
        </Operation>
    </OperationCollection>
</OperationCollection>

层级说明

• 顶层 OperationCollection：Form 直接的子元素，无属性
• 嵌套 OperationCollection：有 yigo-Operation-Attr 属性，用于分组
• Operation：具体的操作项，可嵌套子 Operation

Operation 属性（yigo-Operation-Attr）

Operation 子元素

2. ScriptCollection（脚本集合）

<ScriptCollection>
    <!-- 脚本内容，Type 可选 Formula/Java 等（默认 Formula，可省略） -->
</ScriptCollection>

BaseScript 类型

在 Form 中的使用位置

Form 中有多个使用脚本类型的地方：

• ScriptCollection — 脚本集合
• OnLoad — 表单加载事件
• OnClose — 表单关闭事件
• OnPostShow — 表单显示后事件
• Grid 中的 RowClick/RowDblClick/RowInsert/RowDelete 等
• Button 的 OnClick
• 控件的 KeyEnter

这些元素都使用 yigo-BaseScript2 类型（mixed content，脚本内容直接写在元素体内）：

<OnLoad><![CDATA[初始化公式内容]]></OnLoad>
<OnClick><![CDATA[按钮点击公式]]></OnClick>
<RowDblClick><![CDATA[SetFormState("Edit")]]></RowDblClick>

3. MacroCollection（宏公式集合）

<MacroCollection>
    <Macro Key="宏标识" Args="参数列表">
        <![CDATA[宏公式内容]]>
    </Macro>
</MacroCollection>

Macro 属性

内容：宏的公式体，直接作为元素的文本内容。

使用示例

示例 1：标准实体表单操作集合（增删改查审核）

<OperationCollection>
    <Operation Key="New" Caption="新增" ShortCuts="Ctrl+N">
        <Action><![CDATA[New()]]></Action>
    </Operation>
    <Operation Key="Edit" Caption="编辑">
        <Action><![CDATA[Edit()]]></Action>
    </Operation>
    <Operation Key="Save" Caption="保存" ShortCuts="Ctrl+S" SelfDisable="true">
        <Action><![CDATA[Save()]]></Action>
        <ExceptionHandler><![CDATA[ShowMessage(GetLastError())]]></ExceptionHandler>
    </Operation>
    <Operation Key="Delete" Caption="删除">
        <Action><![CDATA[if(Confirm("确定要删除吗？")) { Delete() }]]></Action>
    </Operation>
    <Operation Key="Cancel" Caption="取消">
        <Action><![CDATA[Cancel()]]></Action>
    </Operation>
    <!-- 审核分组 -->
    <OperationCollection Key="ApproveGroup" Caption="审核">
        <Operation Key="Submit" Caption="提交" Enable="GetFieldValue(&quot;Status&quot;)==0">
            <Action><![CDATA[Submit()]]></Action>
        </Operation>
        <Operation Key="Approve" Caption="审批" Enable="GetFieldValue(&quot;Status&quot;)==1">
            <Action><![CDATA[Approve()]]></Action>
        </Operation>
    </OperationCollection>
    <Operation Key="Close" Caption="关闭">
        <Action><![CDATA[CloseForm()]]></Action>
    </Operation>
</OperationCollection>

示例 2：View 表单操作集合（叙时簿）

<OperationCollection>
    <Operation Key="Query" Caption="查询" Icon="query.png">
        <Action>Query()</Action>
    </Operation>
    <Operation Key="New" Caption="新增" Icon="new.png">
        <Action>OpenForm("PurchaseOrder", "New")</Action>
    </Operation>
    <Operation Key="Edit" Caption="编辑" Icon="edit.png">
        <Action>OpenForm("PurchaseOrder", "Edit")</Action>
    </Operation>
    <Operation Key="Delete" Caption="删除" Icon="delete.png">
        <Action>DeleteSelected()</Action>
    </Operation>
    <Operation Key="Export" Caption="导出" Icon="export.png">
        <Action>Export("Excel")</Action>
    </Operation>
    <Operation Key="Close" Caption="关闭" Icon="close.png">
        <Action>CloseForm()</Action>
    </Operation>
</OperationCollection>

示例 3：宏公式集合

<MacroCollection>
    <Macro Key="CalcAmount" Args="qty,price">
        <![CDATA[SetFieldValue("Amount", qty * price)]]>
    </Macro>
    <Macro Key="ValidateBeforeSave">
        <![CDATA[IIF(IsEmpty(GetFieldValue("PONo")), ShowMessage("订单编号不能为空"), true)]]>
    </Macro>
</MacroCollection>

示例 4：表单事件

<Form Key="PurchaseOrder" Caption="采购订单" FormType="Entity">
    <!-- ... -->
    <OnLoad><![CDATA[IIF(GetFormState()=="New", SetFieldValue("PODate", Today()), '')]]></OnLoad>
    <OnClose><![CDATA[IIF(IsModified(), IIF(Confirm("数据已修改，是否保存？"), Save(), ''), '')]]></OnClose>
</Form>

CommonDef 中的操作集合

CommonDef 定义的是公共操作，可被多个表单引用（通过 RefKey）：

<CommonDef>
    <OperationCollection>
        <Operation Key="CommonSave" Caption="保存">
            <Action>Save()</Action>
        </Operation>
    </OperationCollection>
    <StatusCollection>...</StatusCollection>
    <ScriptCollection>...</ScriptCollection>
    <MacroCollection>...</MacroCollection>
</CommonDef>

在 Form 中引用公共操作：

<Operation Key="Save" RefKey="CommonSave" />

与其他 Skill 的配合

• OperationCollection 是 yigo-form-scaffold 中 Form 的子元素
• Operation 的 Action 公式可能引用 yigo-dataobject-generator 定义的字段
• Button 控件的 OnClick 事件内容格式与此相同 → 参考 yigo-control-generator
• 公式语法细节 → 参考 yigo-expression-helper