跳转至

O-ACTION标签

本文档内容来源于 http://doc.myapps.cn/docs/common-script/common-script-1f1agtaiid5mu

脚本说明

O-ACTION标签是MyApps平台中的特殊标签,用于在表单或视图中执行特定的操作。可以通过O-ACTION标签实现按钮点击、数据操作等功能。

常见实现方式

方式1:基本O-ACTION标签使用

<o-action action-type="操作名称" exparams="参数">
    按钮文本
</o-action>

方式2:带参数的O-ACTION标签

<o-action action-type="操作名称" exparams="参数1=值1&参数2=值2">
    执行操作
</o-action>

方式3:O-ACTION标签跳转表单

<o-action action-type="opendocument" open-type="open-present" appid="软件ID" formid="表单ID" docid="文档ID" exparams="参数">
    打开表单
</o-action>

方式4:O-ACTION标签跳转视图

<o-action action-type="openview" open-type="open-present" appid="软件ID" viewid="视图ID" exparams="参数">
    打开视图
</o-action>

扩展示例

示例1:O-ACTION标签跳转外部链接

<o-action action-type="jumpto" url="url地址" open-type="open-present" exparams="参数">
    打开外部链接
</o-action>

示例2:O-ACTION标签执行刷新操作

<o-action action-type="opendocument" isRefresh="true" exparams="参数">
    刷新
</o-action>

示例3:O-ACTION标签调用接口

<o-action action-type="interface" url="接口地址" type='get' exparams="参数">
    调用接口
</o-action>

关键属性说明

action-type属性

  • opendocument: 打开表单
  • openview: 打开视图
  • jumpto: 跳转链接
  • interface: 调用接口

open-type属性

  • open-present: 当前页打开(表单、视图、跳转通用)
  • open-eject: 弹出层打开(表单、视图、跳转通用)
  • open-tab: 标签页打开(表单、视图、跳转通用)
  • open-blank: 新窗口打开(表单、视图、跳转通用)
  • open-below: 从下往上打开表单
  • open-side: 从右往左打开表单

exparams属性

  • 参数格式:参数名=参数值&参数名2=参数值2
  • 多个参数用 & 分隔
  • 参数值需要进行URL编码(如果包含特殊字符)

isRefresh属性

  • 用于确认是否刷新
  • 等于true是刷新

isReadonly属性(注:目前仅对表单有效)

  • 用于确认是否只读
  • 等于true是只读

dialog-width(注:仅open-type属性为“open-eject”时可用)

  • 用于设置弹窗宽度,例如:dialog-width='1200px'

dialog-height(注:仅open-type属性为“open-eject”时可用)

  • 用于设置弹窗高度,例如:dialog-height='500px'

url属性

  • 链接格式:例如 https://www.baidu.com/
  • 接口格式:例如 /obpm/magic-api/orderapplet/setStoreStatus?status="status"

type属性

  • get: 接口请求类型为get
  • post: 接口请求类型为post
  • put: 接口请求类型为put
  • delete: 接口请求类型为delete

O-ACTION标签说明

基本语法

<o-action action-type="操作类型" open-type="打开类型" exparams="参数列表">
    打开内容
</o-action>

使用场景

  • 表单按钮操作
  • 视图操作按钮
  • 视图列操作
  • 自定义操作
  • widget计算脚本值

注意事项

  • ⚠️ action-type属性: 确保action-type值正确,区分大小写
  • ⚠️ open-type属性: 确保open-type值正确,区分大小写
  • ⚠️ exparams格式: 参数格式要正确,多个参数用&分隔
  • ⚠️ 参数编码: 参数值包含特殊字符时需要URL编码
  • ⚠️ 权限控制: 确保用户有执行操作的权限
  • O-ACTION标签是MyApps平台的特殊标签
  • 可以在表单和视图中使用
  • 支持多种内置操作和自定义脚本

使用场景

  • 表单操作按钮
  • 视图操作按钮
  • 视图列
  • widget计算脚本值
  • 自定义业务操作

如需查看完整脚本代码,请访问源文档链接。