Formale Kriterien für Reporting-Formulare
Mit einer Integration eines Form-Builders können Sie vor oder nach jedem Einsatz über ein Formular Informationen von Mitarbeitenden abfragen.
Um diese Funktionalität zu nutzen, benötigen Sie das Add-On "Reporting" und zusätzlich ist einen Account einen Form-Builder mit bestehender Integration zu Staffcloud. Welche Form-Builder vom Add-On "Reporting" unterstützt werden, erfahren Sie von unserem Support-Team.
In diesem Artikel erfahre ich:
- welche Formal-Kriterien ein Reporting-Formular erfüllen muss, um die Funktionen des Add-Ons "Reporting" auszuschöpfenSpringe zu Anleitung für
Webhook URL hinterlegen
Jedes Formular in Ihrem Form-Builder muss mit einem Webhook ausgestattet werden, damit in Staffcloud angezeigt werden kann, ob ein Formular für einen bestimmten Einsatz bereits ausgefüllt wurde.
Die Webhook URL finden Sie unter Konfiguration > Add-Ons > Reporting https://[tenant].staff.cloud/api/v1/reporting-webhooks/submissions?authorization_bearer=Bearer%20[StaffCloud API Key] und ergänzen diese entsprechend mit:
- tenant: Ihr Instanzname (finden Sie im Browser → http://[tenant]staff.cloud
- Staffcloud API Key: diesen haben Sie ganz zu Beginn vom Support erhalten (siehe Punkt 1.)
(lassen Sie die Klammerzeichen [ und ] weg)
Feld 'AssignmentId' und weitere vorausgefüllte Informationen
Um die Zuordnung des eingereichten Formulars zum richtigen Einsatz zu gewährleisten, muss jedes Formular im Hauptteil die 'AssignmentId' enthalten.
Je nach Form-Builder kann die AssignmentId auch als verstecktes Feld geführt werden. Mehr dazu in der spefizischen Anleitung für Ihren Form-Builder.
Zusätzlich zum obligatorischen Feld 'AssignmentId' können weitere Felder eingefügt werden, welche dann automatisch ausgefüllt werden:
| ProjectName | Der Projektname aus Staffcloud wird hier eingefügt. |
| ProjectId | Die (interne) ID des Projekts wird eingefügt. |
| EventName | Der Eventname wird eingefügt. Dies funktioniert auch für automatisch generierte Namen, z.B. aus dem Einsatzort. |
| EventId | Die (interne) ID des Events wird eingefügt. |
| FunctionName | Die Bezeichnung der Funktion wird eingefügt. |
| FunctionId | Die (interne) ID der Funktion wird eingefügt. |
| AssignmentStatus | Der Status (Eingeteilt, Betätigt, etc.) wird eingefügt. Vor allem interessant für Formulare, die vor dem Event auszufüllen sind. |
| EmployeeId | Die (interne) ID des Mitarbeiters wird eingefügt. |
Bitte beachten Sie, dass die Groß- und Kleinschreibung exakt wie hier angegeben, übernommen werden muss! Andernfalls werden die Daten nicht korrekt übernommen.
