Skip to main content

服务端方法痕迹信息

服务端方法痕迹信息，主要用于查看哪个用户在哪台机器执行了哪个 API。

1. 功能介绍​

服务端方法痕迹信息，主要用于查看哪个用户在哪台机器执行了哪个 API。

例如：某用户的正常权限被不小心删除或者被授予越级权限，超级管理员可通过权限痕迹查看到这种操作是哪个用户所为。

info

构造痕迹信息方法，指实现 vbase_integration 构件下的 EP_MarkGenDataMessage 方法，并需要在该实现中调用获取输入输出参数规则，选择需要监听的方法，将监听方法的数据构造输出。

2. 服务端方法痕迹监听​

首先，确定需要监听哪个活动集的操作痕迹。

下面以 vbase_organization.OrgSaveUser（保存用户数据） 活动集为例，通过痕迹监听查看该活动集相关参数的执行情况。

info
  • 由于活动集 vbase_organization.OrgSaveUser 属于 VBase 的内置构件方法，因此再无需定义服务端方法。
  • 在实际项目中，可按需定义服务端方法进行痕迹监听。

2.1 添加引用

  • 由于 EP_MarkGenDataMessage 方法在 vbase_integration 构件中，因此需要引入该构件；
  • 在本案例中，监听 vbase_organization.OrgSaveUser（保存用户数据） 活动集，因此需要引入该构件。
img
在引用构件中双击方法，可以查看该方法的相关参数：
（1）方法输入
img
（2）方法输出
img

2.2 新增 EP 扩展实现

img
img
（1）方法输入和方法输出：EP 扩展实现，一般有对应的方法输入和方法输出，并且不允许修改。
 EP_MarkGenDataMessage 方法的方法输入和方法输出，请查看引用中相关介绍。
（2）方法变量
在 EP 扩展实现中需要定义相关变量获取活动集输入输出参数，因此根据被监听方法 vbase_organization.OrgSaveUser（保存用户数据） 的参数，定义方法变量。
info
在引用中查看 vbase_organization.OrgSaveUser（保存用户数据） 方法的相关信息，直接拷贝变量参数新增即可。
img
img
img
（3）规则配置
img
① 获取活动集输入输出参数【OrgSaveUser】
选择需要监听的活动集 vbase_organization.OrgSaveUser（保存用户数据） 。
img
② IF：BR_VAR_PARENT.isSuccess==False ——如果监听的活动集执行不成功
a、给界面实体/控件/变量赋值【EP方法输出-false】
img
b、中断规则：中断当前规则链
③ 执行方法_OrgQueryUser(用户单表数据查询)
img
④ 给界面实体/控件/变量赋值【EP方法输出-true】
五个输出字段分别赋值
  • dataMessage（痕迹显示数据）：ConcatStr(BR_IN_PARENT.[bizInfo].[loginName]," 在 ",BR_IN_PARENT.[bizInfo].[ipAddress]," 保存人员",ListToStringFunc("BR_VAR_PARENT.userEntity_in","userName"," 、",false)) 
  • dataType（数据类型）："user"
  • operateOwnerName （被操作对象名称） ：ListToStringFunc("BR_VAR_PARENT.userEntity","userName","、",false) 
  • detailData （详细数据） ：VConvertEntityToXMLFunc("BR_VAR_PARENT.resultEntity","BR_VAR_PARENT.userEntity")
  • operateOwnerId （被操作对象ID） ：ListToStringFunc("BR_VAR_PARENT.resultEntity","id","、",false)
img
（4）构件服务映射
添加 EP 扩展实现，一般新增会默认勾选服务映射。若通过拷贝的方式新增，则需要手动勾选。
img

2.3 服务端方法痕迹监听注册

访问目录：配置中心 → 业务系统初始化配置 →  集成服务 → 服务端方法痕迹 → 服务端方法痕迹监听
img
选择监听构件方法后，需要选择对应的构件方法的 构造痕迹数据方法（EP扩展实现）。
img
配置构件方法的扩展实现 EP 后，会在选择页面显示对应信息。
img

2.4 监听的服务端方法痕迹

服务端方法注册监听之后，可以在监听的服务端方法痕迹中查看，并且取消监听。
img

3. 服务端方法痕迹日志​

在服务端方法痕迹日志中，可以查看监听方法的具体被操作痕迹。

访问目录：配置中心 → 业务系统初始化配置 → 集成服务 → 服务端方法痕迹 → 服务端方法痕迹日志

img

双击痕迹日志信息，可以查看活动集具体被操作的痕迹。

img