使用 Vuforia API 访问数据 > Vuforia API > 访问过程执行数据 > 进行 API 调用 > 针对给定序列号,返回所有已完成和已提交的会话(包括步骤数据)
  
针对给定序列号,返回所有已完成和已提交的会话(包括步骤数据)
要返回包含步骤数据的特定序列号的所有已完成和已提交的会话,请运行以下命令:
curl -X 'POST' 'https://vuforia.ptc.com/customer-events/<orgid>/report' \
-H 'accept: application/json' \
-H 'x-requested-with: fetch' \
-H 'x-api-key: <x-api-key secret>' \
-H 'Content-Type: application/json' \
-d '{ "serialNumber": <serial#>, "granularity": "step" }'
默认情况下,当检索包含诸如步骤等更为细化信息的执行数据时,还将返回为需要反馈的步骤生成的所有事件。例如,如果用户在 Vuforia Vantage 中执行过程并选择“失败”状态,然后将其更改为“通过”状态,则将为同一步骤生成多个事件(与以下示例类似)。事件按(步骤)numberendTime 排序。可通过(步骤)number 列表中的最后一个事件来查找该步骤的最新事件。
* 
不建议使用 endTime 来确定步骤的最新事件。此后,endTime 将按照“在‘查看者 - Insights’页面中移除用户信息和日期”设置进行缩短。
返回的结果应类似于以下示例:
{
"items": [
{
"sessionId": "ec4dfff9-d280-42c2-bff4-03d154924de9",
"procedure": {
"id": "2f0560f0-d5e9-11eb-9796-856502905bf2",
"title": "****",
"versionId": "a63e70d0150f3b2ba1cf9e81",
"versionName": "8.0",
"startTime": "2024-01-12T03:35:19.425Z",
"latestEventTimestamp": "2024-01-12T03:39:19.894Z",
"endTime": "2024-01-12T03:39:19.894Z",
"status": "incomplete",
"progress": "completed",
"feedback": "incomplete",
"serialNumber": "1234",
"requiresSerialNumber": true,
"steps": [
{
"lastVisitTime": "2024-01-12T03:35:19.463Z",
"status": "omitted",
"description": "****",
"number": 1,
"title": "****",
"ackType": "Confirmation"
},
{
"lastVisitTime": "2024-01-12T03:35:25.739Z",
"status": "confirmed",
"description": "****",
"number": 2,
"title": "****",
"ackType": "Confirmation",
"endTime": "2024-01-12T03:35:27.482Z"
},
{
"lastVisitTime": "2024-01-12T03:35:42.861Z",
"status": "pass",
"description": "****",
"number": 3,
"title": "****",
"ackType": "PassFail",
"endTime": "2024-01-12T03:36:13.211Z"
}
]
},
"user": {
"id": "7d496296-6a29-4f88-b9ca-d1f07e1c7e93",
"first_name": "****",
"last_name": "****",
"email": "****",
"role": "****"
}
}
],
"granularity": "step",
"fullCount": "1"
}
* 
steps 下的 status 属性会显示一线用户针对需要反馈的步骤所提供的值。可能的值包括:
omitted - 一线用户未提供步骤所需的反馈。
confirmed - 一线用户在需要确认反馈的步骤中确认步骤已完成。
pass - 一线用户在需要“通过/失败”反馈的步骤中选择了“通过”
fail - 一线用户在需要“通过/失败”反馈的步骤中选择了“失败”