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

md 参数

您可以使用 md 参数指定文档的结构,包括在一个处理事务中需要处理的文档数量、类型和名称。Vantage Mobile Input 将引导用户准确采集指定的文档,以便后续处理。 默认情况下,md 参数会出现在移动端上传链接中,其值根据所选 Skill 的不同为 0 或 1。您可以指定以下值之一:
ValueDescription
0采集一个文档,此文档可包含任意数量的页。
1采集任意数量的文档,每个文档可包含任意数量的页。
Encoded URL to JSON file采集指定数量的文档,并为其自定义名称,同时为每个文档定义其中各页的数量和名称。
Encoded JSON file采集指定数量的文档,并为其自定义名称,同时为每个文档定义其中各页的数量和名称。
注意: 用于 md 参数的 JSON 文件 仅适用于通过微型应用(micro applications)发起的移动端上传。
使用编码后的、指向 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>
使用编码后的 JSON 文件作为 md Parameter 的示例:
https://your-server/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&md=<encoded_json_structure>&token=<token>&v=<2.4>
注意: 如果在移动端上传链接中使用了 dt Parameter,则会忽略 md Parameter 的值。

dt 参数

要自定义移动端上传,使其仅采集一种文档类型,请使用 dt 参数:
  1. 在移动端上传链接中添加 dt 参数。
  2. 指定以下值之一:
说明
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 参数。 使用 redirect_uri 参数的示例:
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 Parameter

默认情况下,移动端上传链接中不包含 ma Parameter。要在本地部署环境中使用微应用,请在移动端上传链接中添加值为 truema Parameter。 使用 ma Parameter 的示例:
https://your-server/mobile?baseUrl=<基础URL>&transactionId=<事务ID>&ma=true&token=<令牌>&v=<2.4>
注意: 在云环境中不支持 ma Parameter。