Understanding Submission Activities

What Are Submission Activities?

Submission activities are records created via the Kinetic Core API. These records are linked to submission records and store additional information about the submission, including generic properties such as type, label, description, and data. They're commonly used to determine submission status as a submission moves through a workflow, making them useful for granting users visibility into the status of their requests.

Creating Submission Activity Records

You can add submission activity triggers in workflows where submissions are created, submitted, updated, or deleted. Routines for creating submission activity records when submitting, updating, or deleting a submission are prebuilt into the Kinetic Platform. By adding one of these routines as a node in your workflow, you can record that a particular activity occurred.

The examples below show a workflow configured to run when submitting a submission. The workflow uses two submission activity routines: one to create a record when the submission has been received and another to create a record when the request has been completed.

Activity record used to confirm receipt of the submission

Activity record used to confirm receipt of the submission

Activity record used to indicate request completion.

Activity record used to indicate request completion.

Viewing Submission Activity Information

Once submission activity records are created, you can retrieve them when you fetch a submission using the Kinetic Core API by including activities. For example, ticketing systems in the default Kinetic front-end portal show status changes in a Timeline tab that reflects the submission activity behavior. The image below shows how the submission activity nodes displayed in the Creating Submission Activity Records section above would appear in that front-end portal.

Example of submission activity displayed in a front-end portal

Example of submission activity displayed in a front-end portal


What’s Next

See the following pages in the Kinetic Core API Reference for more information: