Formal criteria for reporting forms
With the integration of a form builder, you can collect information from employees via a form before or after each assignment.
To use this functionality, you need the "Reporting" add-on and additionally an account with a form builder that has an existing integration with Staffcloud. You can find out which form builders are supported by the "Reporting" add-on from our support team.In this article, you will learn:
- which formal criteria a reporting form must meet to fully utilize the functions of the "Reporting" add-on
Add a webhook URL
The webhook URL can be found under Configuration > Add-Ons > Reporting https://[tenant].staff.cloud/api/v1/reporting-webhooks/submissions?authorization_bearer=Bearer%20[StaffCloud API Key] and should be supplemented accordingly with:
tenant: your instance name (found in the browser → http://[tenant].staff.cloud
Staffcloud API Key: you received this from support at the very beginning (see point 1.)
(please omit the brackets [ and ])
Field 'AssignmentId' and other pre-filled information
To ensure the submitted form is assigned to the correct assignment, each form must include the 'AssignmentId' in the main section.
Depending on the form builder, the AssignmentId can also be included as a hidden field. More information can be found in the specific instructions for your form builder.
In addition to the mandatory 'AssignmentId' field, other fields can be added which will then be filled automatically:
| ProjectName | The project name from Staffcloud will be inserted here. |
| ProjectId | The (internal) ID of the project will be inserted. |
| EventName | The event name will be inserted. This also works for automatically generated names, e.g., from the assignment location. |
| EventId | The (internal) ID of the event will be inserted. |
| FunctionName | The designation of the function will be inserted. |
| FunctionId | The (internal) ID of the function will be inserted. |
| AssignmentStatus | The status (assigned, confirmed, etc.) will be inserted. Especially relevant for forms to be completed before the event. |
| EmployeeId | The (internal) ID of the employee will be inserted. |
Please note that the capitalization must be exactly as indicated here! Otherwise, the data will not be processed correctly.
