跳转到主要内容
您可以使用以下附加参数配置移动端上传功能:
  • md 参数 用于自定义文档的数量和名称,以及在单个处理事务中为每个文档需采集的页。
  • dt 参数 用于将移动端上传配置为仅采集单一文档类型。
  • redirect_uri 参数 用于自定义在移动端上传完成后打开的网站链接。
  • ma 参数 用于在本地部署环境中启用微应用。

md 参数

您可以使用 md 参数在一次处理事务中指定待处理文档的结构,包括文档的数量、类型和名称。Vantage Mobile Input 将引导用户准确采集指定文档,以便后续处理。 默认情况下,移动端上传链接中包含 md 参数,其取值为 0 或 1,具体取决于所选的 Skill。您可以指定以下值之一:
说明
0采集一个文档,页数不限。
1采集任意数量的文档,页数不限。
编码后的指向 JSON 文件的 URL采集指定数量且具有自定义名称的文档,并为每个文档定义页数和页名称。
编码后的 JSON 文件采集指定数量且具有自定义名称的文档,并为每个文档定义页数和页名称。
注意: 用于 md 参数的 JSON 文件 仅适用于来自微应用的移动端上传。
使用编码后的指向 JSON 文件的 URL 作为 md 参数的示例:
https://your-server/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&md=https%3A%2F%2Fdomain.tld%2Fstructure.json&token=<token>&v=<2.4>
用于 md Parameter 的已编码 JSON 文件示例:
https://your-server/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&md=<encoded_json_structure>&token=<token>&v=<2.4>
注意: 如果在移动端上传链接中使用了 dt Parametermd 参数的值将被忽略。

dt 参数

要使移动端上传仅采集单一文档类型,请使用 dt 参数:
  1. 在移动端上传链接中添加 dt 参数。
  2. 指定以下值之一:
ValueDescription
idcard采集身份证的正反两面。
passport采集护照的首页。
document采集其他任意文档。
使用 dt 参数的示例:
https://your-server/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&dt=idcard&token=<token>&v=<2.4>
注意: 如果在移动端上传链接中使用了 dt 参数,md 参数的值将被忽略。

redirect_uri 参数

您可以自定义一个在移动端上传完成且处理事务开始处理后将要打开的网站链接。这样可以在移动端上传完成后管理用户的后续流程。为此,请在移动端上传链接中添加 redirect_uri Parameter。 使用 redirect_uri Parameter 的示例:
https://your-server/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&redirect_uri=https%3A%2F%2Fwww.example.com&token=<token>&v=<2.4>
注意: 使用 redirect_uri 参数时,请确保将要打开的网站链接的基准 URL(例如 https://www.example.com)添加到租户设置的 Allowed redirect URLs 部分。更多信息请参见“Configuring Allowed Redirect URLs”。

ma 参数

默认情况下,移动上传链接中不包含 ma 参数。要在本地环境中使用微应用,请在移动上传链接中添加 ma 参数并将其设为 true 使用 ma 参数的示例:
https://your-server/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&ma=true&token=<token>&v=<2.4>
注意: 云环境不支持 ma Parameter。