Anfrage- und Zuweisungsverlauf von Ressourcen lesen
Verwenden Sie resourceActivity in der authentifizierten KORONA Event-GraphQL-API, um die Aktivität der Ressourcen für ein Event zu rekonstruieren. Für diese Abfrage ist ein authentifizierter Benutzer mit der Berechtigung zum Lesen von Events sowie der Tenant-Kontext des Events erforderlich. Sie ist unabhängig von der öffentlichen Booking API.
Die Aktivität eines Events abrufen
Übergeben Sie die Event-ID und führen Sie die Paginierung mit first und after durch. Sie können die Ergebnisse mit requirementId oder resourceId eingrenzen. Die Ergebnisse werden nach Aktivitäts-ID sortiert.
query ResourceHistory($event: ID!, $after: String) {
resourceActivity(eventId: $event, first: 100, after: $after) {
nodes {
id
createdAt
kind
attemptId
requirementId
slotId
resourceId
actorType
actorId
actorEntityType
source
reason
response
lifecycle
allocation
suitability
communication
communicationId
feeId
feeStatus
eventRevision
eventAuditId
legacy
}
pageInfo {
hasNextPage
endCursor
}
}
}Verwenden Sie endCursor für die nächste Seite, solange hasNextPage wahr ist. Behalten Sie die Aktivitäts-IDs beim Zusammenführen von Seiten bei, damit bei einem wiederholten Abruf keine Einträge in Ihrer Anwendung doppelt erstellt werden.
Die Aufzeichnungen auswerten
Gruppieren Sie Anfragedatensätze nach attemptId. Eine erneute Anfrage nach einer Ablehnung oder einem Abschluss beginnt einen eigenen Anfrageversuch. Die bisherige Anfrage-ID bleibt für bestehende Integrationen die Referenz auf den aktuellen Status.
| Feld | Bedeutung |
|---|---|
actorType, actorEntityType, actorId | Die Rolle des Akteurs, der Entitätstyp und die ID. actorType ist entweder staff, resource, system oder unknown. Ein angemeldeter Benutzer einer Ressource hat den Entitätstyp User; eine Antwort auf eine Anfrage per E-Mail-Token hat den Entitätstyp Resource. Eine ID darf nur in Verbindung mit ihrem Entitätstyp aufgelöst werden. |
response | Die Antwort der Ressource: unanswered, accepted, rejected, withdrawn oder unknown. |
lifecycle | Gibt an, ob die Anfrage open, closed oder removed ist. Ein Abschluss bedeutet nicht automatisch eine Ablehnung. |
reason | Der angegebene Grund, sofern bekannt. not_selected schließt die Ressourcensuche ab, ohne eine frühere Zusage zu ändern. |
allocation | Nachweise für eine Zuweisung, beispielsweise preselected, allocated, unallocated oder released. Eine Zusage allein belegt keine Zuweisung. |
suitability | Unabhängiger Nachweis der Eignung. unknown bedeutet, dass keine Eignungsprüfung dokumentiert wurde. |
communication | Nachweis der Kommunikation. recorded bedeutet, dass die Kommunikation vorbereitet wurde, ohne dass ein Nachweis für eine erfolgreiche Zustellung vorliegt. delivered dokumentiert die erfolgreiche Übergabe der E-Mail durch die Anwendung; es belegt jedoch nicht, dass der Empfänger die Nachricht gelesen hat. |
feeId, communicationId | Verweise auf vorhandene Honorar- und Kommunikationsaufzeichnungen. Deren Inhalt wird nicht in diese Antwort übernommen. |
eventRevision, eventAuditId | Die im Zusammenhang mit der Aktivität festgestellte Eventrevision, sofern verfügbar. |
legacy | Eine Momentaufnahme eines Datensatzes, der aus der Zeit vor dem Anfrageverlauf stammt. Es handelt sich nicht um eine Rekonstruktion fehlender früherer Antworten. |
Beispielsweise bedeuten response: "accepted", lifecycle: "closed" und reason: "not_selected", dass die Ressource zugesagt hat, die Ressourcensuche jedoch beendet wurde, da eine andere Ressource ausgewählt wurde. Bitte halten Sie diese Felder in Ihren eigenen Anzeigen getrennt.
Bei älteren Datensätzen kann actorEntityType den Wert null annehmen; leiten Sie den Entitätstyp nicht aus der Akteurrolle oder der numerischen ID ab.
Ein Feld mit dem Wert null bedeutet, dass diese Dimension für die Aktivität nicht zutrifft oder dass keine Belege vorliegen. Wandeln Sie dies nicht in eine Ablehnung, einen Fehlversuch oder eine erfolgreiche Zuordnung um. createdAt ist der Zeitpunkt der Aktivitätserfassung; bei einem älteren Momentaufnahme-Datensatz handelt es sich um den Beobachtungszeitpunkt, nicht um den Zeitpunkt einer früheren Antwort.
Zugriff und Aufbewahrung
Mitarbeiter mit der Berechtigung zum Einsehen von Events können die aufgezeichneten Ressourcenaktivitäten der Event abrufen. Benutzer, deren Zugriff auf ihre eigene Ressource beschränkt ist, sehen lediglich ihre eigenen Aktivitäten in Bezug auf Anfragen, Zuweisungen und Kommunikation. Über diese Abfrage erhalten sie keine Antworten von Kollegen, keine internen Begründungen, keine Akteurskennungen, keine Akteur-Entitätstypen und keine Honoraraktivitäten. E-Mail-Token für Anfragen gewähren keinen Zugriff auf die Verlaufsabfrage.
Die Aktivität bleibt nach der regulären Archivierung von Ressourcen oder der Löschung einer Anforderung oder Zuordnung anhand der Event-ID weiterhin einsehbar. Die referenzierten Betriebsdatensätze sind möglicherweise nicht mehr vorhanden. Die Löschung des Mandanten und die bestehende Aufbewahrungsrichtlinie gelten weiterhin.
