Alle abgeschlossenen und eingereichten Sitzungen für eine bestimmte Seriennummer einschließlich Schrittdaten zurückgeben
Führen Sie den folgenden Befehl aus, um alle abgeschlossenen und eingereichten Sitzungen für eine bestimmte Seriennummer, die Schrittdaten enthält, zurückzugeben:
Für die Verwendung mit der Dienstprinzipal-Methode (empfohlen)
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" }'
Für die Verwendung mit der x-api-key-Methode
 |
Diese Methode ist in einer zukünftigen Version veraltet. Wir empfehlen stattdessen das Erstellen und die Verwendung von Dienstprinzipalen für die Authentifizierung. Weitere Informationen finden Sie unter Dienstprinzipale für den Zugriff auf externe APIs erstellen.
|
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" }'
Beim Abrufen von Ausführungsdaten, die granularere Informationen wie Schritte enthalten, werden standardmäßig auch alle Ereignisse, die für Feedback erfordernde Schritte generiert werden, zurückgegeben. Wenn ein Benutzer z.B. ein Verfahren in Vuforia Vantage ausführt und den Status Fehler auswählt und diesen dann in Erfolg ändert, so werden mehrere Ereignisse für denselben Schritt generiert (ähnlich wie im nachfolgenden Beispiel). Die Ereignisse sind nach number und endTime (Schritt) sortiert. Das neueste Ereignis für den Schritt kann gefunden werden, indem das letzte Ereignis in der Liste für die number des Schritts verwendet wird.
 |
Es wird nicht empfohlen endTime zu verwenden, um das neueste Ereignis für einen Schritt zu bestimmen. In der Zukunft wird endTime basierend auf der Einstellung Benutzerinformationen und Datum aus "Benutzer - Insights" entfernen gekürzt.
|
Beispiele für Ergebnisse
Die zurückgegebenen Ergebnisse sollten ähnlich aussehen wie im folgenden Beispiel:
{
"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"
}
|
|
Die Eigenschaft status unter steps zeigt den Wert an, den der Frontline-Benutzer für einen Schritt, für den Feedback erforderlich ist, zurückgegeben hat. Mögliche Werte sind:
• omitted – Der Frontline-Benutzer hat das erforderliche Feedback für den Schritt nicht bereitgestellt.
• confirmed – Der Frontline-Benutzer hat bestätigt, dass ein Schritt für einen Schritt, für den Bestätigungs-Feedback erforderlich ist, abgeschlossen wurde.
• pass – Der Frontline-Benutzer hat Erfolg für einen Schritt, für den Erfolg/Fehler-Feedback erforderlich ist, ausgewählt.
• fail – Der Frontline-Benutzer hat Fehler für einen Schritt, für den Erfolg/Fehler-Feedback erforderlich ist, ausgewählt.
|