傳回包含步驟資料之指定序號所有已完成及已提交的工作階段
如要傳回包含步驟資料之指定序號所有已完成及已提交的工作階段，請執行下列指令：
與服務主體搭配使用的方法 (建議)
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 來判斷步驟的最新事件。系統日後會根據「將使用者資訊及日期從檢視者 Insights 中移除」設定縮短 endTime。
|
結果範例
傳回的結果應與以下範例相似：
{
"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 - 前線使用者已在需要提供通過 / 失敗意見反應的步驟上選取「失敗」。
|