# 在CodeArts TestPlan中调用对参数自定义URL编码函数
#### 函数名
$urlEncoder(String A)
#### 参数说明
String A：需要被自定义编码的参数，编码字符使用的是UTF-8，最大字符长度为2000。
#### 功能说明
在接口自动化用例中支持对参数进行自定义的URL编码。
#### 使用场景
接口自动化用例中支持在以下场景（该函数不支持在环境参数中使用，若在环境参数中使用，参数输入即输出）使用对参数自定义URL编码函数：
- 请求url路径
- 请求头
- 请求体
- 检查点属性
- 响应提取
- if判断
- for循环中断条件
 
#### 示例
- 请求url路径 如下图所示，请求url路径中参数"test"的值为对参数进行自定义的URL编码函数，函数中的参数A为字符串"abc123测试"。
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000002213671401.png "点击放大")
  
  
  输出示例：
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000002224987333.png "点击放大")
  
- 请求头 如下图所示，请求头中参数"Accept-Encoding"的值为对参数进行自定义的URL编码函数，函数中的参数A为字符串"abc123测试"。
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000002178356266.png "点击放大")
  
  
- 请求体 如下图所示，请求体中应用了对参数进行自定义的URL编码函数，函数中的参数A为生成指定长度的随机字符串函数$random_string(10)。
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000002178374376.png)
  
- 检查点属性 如下图所示，检查点属性"result"的目标值为对参数进行自定义的URL编码函数，函数中的参数A为局部参数"test"。局部参数的设置方式请参考[局部参数](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0016.html#cloudtest_01_0016__section1911995744510)。
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000002213816201.png "点击放大")
  
  
- if判断 如下图所示，if判断的目标值为对参数进行自定义的URL编码函数，函数中的参数A为环境变量"status"。环境参数的设置方式请参考[设置CodeArts TestPlan接口脚本的环境参数](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0052.html)。
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000002178376836.png "点击放大")
  
  
- for循环中断条件 如下图所示，for循环中断条件的目标值为对参数进行自定义的URL编码函数，函数中的参数A为字符串"abc123测试"。
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000002213818785.png "点击放大")