针对给定序列号，返回所有已完成和已提交的会话（包括步骤数据）
要返回包含步骤数据的特定序列号的所有已完成和已提交的会话，请运行以下命令：
用于服务主体方法 (推荐)
curl -X 'POST' 'https://vuforia.portal.ptc.com/customer-events/<orgid>/report' \
-H 'accept: application/json' \
-H 'x-requested-with: fetch' \
-H 'Authorization: Bearer [access_token]' \
-H 'Content-Type: application/json' \
-d '{ "serialNumber": <serial#>, "granularity": "step" }'
用于 x-api-key 方法
 |
此方法将在以后的版本中弃用。我们建议改为创建和使用服务主体进行身份验证。有关详情，请参阅创建用于外部 API 访问的服务主体。
|
curl -X 'POST' 'https://vuforia.portal.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 中执行过程并选择“失败”状态，然后将其更改为“通过”状态，则将为同一步骤生成多个事件（与以下示例类似）。事件按（步骤）number 和 endTime 排序。可通过（步骤）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 - 一线用户在需要“通过/失败”反馈的步骤中选择了“失败”。
|