Protocol Launcher

简体中文

English

简体中文

English

Appearance

TrueContext ​

TrueContext 是一个移动表单和现场工作流平台。Protocol Launcher 可以生成它的官方 App-to-App URL。

使用 ​

有两种方式可以使用此库：

  • 按需从子路径导入，支持 Tree Shaking 并保持包体积较小。
  • 从根包完整导入更适合快速脚本或示例，但会包含全部应用模块。

生产构建建议使用按需导入；快速演示可以使用完整导入。

选择安装方式

按需加载
推荐使用。生产环境优化。
全量导入
使用便捷。适合快速脚本。

说明 ​

TrueContext 官方文档记录了 truecontext://x-callback-url/action 格式、可替代的 tcxt:// scheme、继续支持的 prontoforms://，以及 HTTPS 替代格式 https://prontofor.ms/x-callback-url/action。此模块只暴露官方记录的 App-to-App 动作：launch、refresh、list、open、send 和 search。

使用 answers 对象传入派发值。对象 key 是 TrueContext 问题唯一 ID，Protocol Launcher 会同时 URL 编码 key 和 value。按照 TrueContext URL Encoding 页面，空格和特殊字符会被 percent-encoded，括号保持不编码。官方记录的 x-callback 参数对应 xSuccess、xCancel 和 xError。

URL 方法 ​

Launch ​

生成官方记录的 launch 动作。

On-Demand
ts
import { launch } from 'protocol-launcher/truecontext'

const url = launch()
启动 TrueContext

Refresh ​

生成官方记录的 refresh 动作，用于启动应用并下载新的表单版本、数据源和派发记录。

On-Demand
ts
import { refresh } from 'protocol-launcher/truecontext'

const url = refresh()
刷新 TrueContext

List ​

显示指定应用区域，或按标签列出表单和资源。

On-Demand
ts
import { list } from 'protocol-launcher/truecontext'

const url = list({
  type: 'inbox',
})
打开 TrueContext Inbox

Open ​

打开表单、记录或资源。answers 对象会按照问题唯一 ID 将值派发到表单问题中。

On-Demand
ts
import { open } from 'protocol-launcher/truecontext'

const url = open({
  name: 'Universal Work Order',
  answers: {
    'Job - Type': 'Warranty',
    'Job - Work Order #': 1234567,
  },
  xSuccess: 'pftest://success',
  xCancel: 'pftest://cancel',
  xError: 'pftest://error',
})
打开 TrueContext 表单

Send ​

打开、填充并发送表单。TrueContext 官方文档说明此动作需要 type 和至少一个表单标识符。

On-Demand
ts
import { send } from 'protocol-launcher/truecontext'

const url = send({
  type: 'forms',
  formID: 99999999,
  answers: {
    ServiceType: 'Warranty',
  },
})

使用官方记录的文本、状态或日期筛选条件打开 TrueContext Mobile App Search 列表。

On-Demand
ts
import { search } from 'protocol-launcher/truecontext'

const url = search({
  stateFilter: 'AllIncomplete',
  dateSearchType: 'DatePeriod',
  datePeriod: 'ThisWeek',
})
搜索 TrueContext 表单

生成的 URL ​

ts
launch()
// => 'truecontext://x-callback-url/launch'

refresh()
// => 'truecontext://x-callback-url/refresh'

list({ type: 'inbox' })
// => 'truecontext://x-callback-url/list?type=inbox'

open({
  name: 'Universal Work Order',
  answers: { 'Job - Type': 'Warranty', 'Job - Work Order #': 1234567 },
})
// => 'truecontext://x-callback-url/open?name=Universal%20Work%20Order&Job%20-%20Type=Warranty&Job%20-%20Work%20Order%20%23=1234567'

send({ type: 'forms', formID: 99999999, answers: { ServiceType: 'Warranty' } })
// => 'truecontext://x-callback-url/send?type=forms&formID=99999999&ServiceType=Warranty'

search({ stateFilter: 'AllIncomplete', dateSearchType: 'DatePeriod', datePeriod: 'ThisWeek' })
// => 'truecontext://x-callback-url/search?stateFilter=AllIncomplete&dateSearchType=DatePeriod&datePeriod=ThisWeek'

launch({ scheme: 'tcxt' })
// => 'tcxt://x-callback-url/launch'

open({ format: 'web', name: 'asset list' })
// => 'https://prontofor.ms/x-callback-url/open?name=asset%20list'

官方文档 ​