5.3实例化和初始化
## 实例化
引入JS文件后会在`window`下挂载`WSPCSignContext`对象,下面是个实例化的例子,会返回一个签字视图对象。
```js
var ctx = new WSPCSignContext()
```
## 初始化
`Init()`
* 参数 :
`{Object} option` 数据参数配置,参数详情参考下面的说明。必传。
* 返回值:无
* 作用:配置初始化的的基本数据参数。
*****
`option` 参数说明
| 键(key) | 类型(type)| 说明(desc) |
| --- | --- |---|---|
| `el` | `String` | **必传**,签字视图渲染的节点`id`。|
| `token` | `String` | **必传**,授权token,后台接口生成的。[3.获取授权token](doc:gSvIuaom) |
| `sequenceId` | `String` | **必传**,签字文件id,会通过接口返回给接入者。[4.1上传文件](doc:ZHrWO4oq) |
| `callerId` | `String` | 非必传,业务系统中签名人的身份ID。 |
| `callerName` | `String` | 非必传,客户业务系统当前签名人的名称。 |
| `buildNo` | `Number` | 非必传,渲染的版本,从saveSucceed回调方法中获取。 |
| `sessionTimeout` | `String` | 非必传,签字有效时间,单位s。默认 60 \* 60 \* 24 (一天)。 |
| `authorityUrl` | `String` | 非必传,pc扫码签字的验权url,详细描述见下方详情 |
* buildNo:buildNo表示签批的版本号,随着签批次数增加而增加,buildNo在未进行签批时为0。可以从saveSucceed回调方法中获取,如果不指定,默认值为最新,也就是最后一次签批的结果。
例如:文档已经进行了三次签批,如果需要删除第三次签批的数据,可以指定buildNo为2。
* authorityUrl: pc端扫码签字的验权url,用来设置用户扫码签字的时候是否开启权限校验。 如果不设置,则扫码的是好签自带签字版页面;如若设置,则扫码签字的时候会跳转到验权的url,好签的签字版url以及用户信息callerId会附带在参数后面。
示例url:**https://www.baidu.com**
二维码的url:
**https://www.baidu.com**?**wellSignUrl**=aHR0cDovL2xvY2FsaG9zdDo4MDgzL3dlbGxzaWduX3Rlc3Qvc2NhbnNpZ24vd3Muc2NhbnNpZ24uaHRtbD93c0FwcFVybD13c3M6Ly93c3Mud2VsbHNpZ24uY24veGN4cGxhdGZvcm0vcGNUZXN0L3BjU2RrU2lnbi9hcHBfMTU3MDg2NDI2MzY4N1NrOG9tZmdVQUUvcGNfMTU3MDg2NDI2MzY4N1NrOG9tZmdVQUU=&**callerId**=d3dn
wellSignUrl的参数是好签签字版url地址的base64加密
callerId的参数是签名人身份ID的base64加密
扫描二维码后跳转到客户验权url后,调用者解密callerId,用来和自己业务系统身份ID做对比,不一致,则提示相关的错误信息,如身份不一致;一致的话则解密wellSignUrl,然后做跳转,供用户正常签名提交。
## 版本号(2.0.1+)
`Version`为了方便接入者明确js Api的版本号,可以通过该属性获取到js Api的版本号。such as:
```js
var version = ctx.Version
```