# 功能使用场景

   当系统某个标准功能出现问题时，开发人员可以使用一键屏蔽功能来快速确认当前问题是否由e-code前端二开代码引起

   > **支持基线：10.0.2502.01**

# 功能使用说明

"调试权限配置"及"调试屏蔽日志"相关功能，仅支持在主管理组织中进行设置及查看。非主管理组织中不显示操作菜单

## 1、新建调试权限

点击"新建"按钮新建调试权限

![](${appMdRes}/1738916039-image.png)
![](${appMdRes}/1738916244-image.png)

- 登录状态：该设置项是用来配置所需调试的页面是登录前的还是登录后的。如果调试的页面为登录后的页面，则登录状态需要设置为登录后。
- 人员：调试页面如果为登录前页面，则不会显示该设置项。调试页面为登录后页面，则该设置项为必填。点击"选择人员"后，弹出人员设置弹框。
  点击选择租户后，默认不显示数据，需要输入租户key进行搜索后才会显示数据【需要再哪个租户进行调试，就输出哪个租户的租户key】。选中需要调试的租户后，联动显示人员选择弹框，人员选择弹框需要输入人员姓名或者联系方式进行搜索后选中。
  
- 支持调试页面：设置为指定页面后，则当前授权码只会在指定页面生效（指定页面地址要输入全路径地址）。设置为全部页面，则授权码在任一页面都会生效

- 授权码：开启后，会显示授权码数据。


![](${appMdRes}/1738916724-image.png)

## 2、使用授权码进行一键屏蔽e-code前端二开代码


每个授权码只支持一次调试，使用授权码后，只有第一次刷新会屏蔽所有e-code前端二开代码的加载。
使用过后会立即失效，调试权限配置页面授权码数据会显示已使用，
再次调试需要在“调试权限配置”页面点击“重新生成授权码”图标，进行授权码更新。


![](${appMdRes}/1738917171-image.png)


**调试方式一：地址栏拼接授权码参数【该调试方式在10.0.2507.01基线后不在支持】**




在需要调试的地址栏中拼接ecodeAuthCode=xxxxxx 参数后，回车刷新页面，此次刷新会屏蔽所有e-code前端二开代码。再次刷新后，当前调试授权码失效，需要使用新的授权码调试


**调试方式二：开启调试工具**

1. 通过地址栏拼接wea_link_show_ecode_debug=1参数的当时打开调试工具
1. 通过在e-code中发布二开代码的方式来开启调试工具
		
    开启调试工具代码：localStorage.setItem('wea_link_show_ecode_debug', '1')  
注意：调试完成后，需要将发布的代码修改为localStorage.removeItem('wea_link_show_ecode_debug')后刷新页面关闭调试工具。


调试工具开启后，点击调试工具图标，会弹出授权码输入弹框，输入正确的授权码后，点击确定，当前页面刷新，e-code二开前端代码屏蔽。


![](${appMdRes}/1738917374-image.png)

调试工具输入授权码，点击确定后，如果出现"授权码不存在或已失效或调试配置不符！"提示信息，则有以下几种可能：

- 授权码设置的人员与当前登录人员不一致（或者租户不一致）
- 授权码设置的调试页面与当前页面地址不一致（指定页面调试时，页面地址要完全匹配）
- 授权码已过期。刷新下"调试权限配置"页面，检查授权码状态。如果已过期，则需要点击"重新生成授权码"图标进行授权码重新生成。

![](${appMdRes}/1738917396-image.png)

## 3、调试屏蔽日志查看

点击日志监控下"查看屏蔽日志"菜单，或者直接在"调试权限配置页面"顶部点击"查看屏蔽日志"按钮，都可跳转到屏蔽日志查看页面

![](${appMdRes}/1738917742-image.png)

每次成功屏蔽调试，日志都会记录相应的调试人员、调试组织、调试页面地址及调试时间相关数据（登录前调试日志不会记录调试人员姓名及组织名称）


![](${appMdRes}/1738917880-image.png)


# 功能版本变更

## 10.0.2507.01 版本功能变更

- 去除"地址栏拼接授权码参数"调试方式

- 调试码支持设置有效时长

- 新增根据-code应用维度、资源路径维度进行调试屏蔽

- 新增e-code代码异常堆栈查看功能

### 功能说明

#### 调试码有效时长

调试码支持设置有效时长。在有效期内，授权码可以一直进行调试使用。更新授权设置后，授权码失效时间会跟随变更。

![](${appMdRes}/1752651168-image.png)


#### "资源文件路径"维度调试

支持根据指定资源文件路径进行屏蔽调试。指定资源路径禁用后，当前资源文件在授权码有效期内不会加载。如需恢复加载，点击"恢复"、"批量恢复"或者"清除禁用信息"后，刷新页面即可恢复加载。



![](${appMdRes}/1752651497-image.png)



#### "e-code"应用维度调试

支持根据指定e-code应用进行屏蔽调试。指定应用禁用后，当前应用前置js文件内容不生效。如需恢复加载，点击"恢复"、"批量恢复"或者"清除禁用信息"后，刷新页面即可恢复加载。


**注意事项： 应用屏蔽后，是不会屏蔽当前应用的前置css文件**


![](${appMdRes}/1752651617-image.png)


#### e-code异常堆栈

调试工具-异常堆栈，可以查看当前环境e-code代码报错的堆栈信息。点击报错，可查看详情。点击应用名称，可以跳转到指定报错应用页面（非当前应用报错不支持点击名称跳转）。


![](${appMdRes}/1752653122-image.png)

![](${appMdRes}/1752653132-image.png)