Programmatic checks and task validation

what are programmatic checks? using programmatic checks in your project, you can catch specified errors and ensure they are fixed before task submission all currently available checks are so called task validation checks they locate potential mistakes in the annotation task and run whenever a team member clicks "validate" in a task these checks either warn the team members or block them from submitting the task while the check conditions are met there are two kinds of task validation checks custom and template the main difference between them is their level of flexibility kognic creates the template checks, and you can browse them and activate those you think could be helpful in your project custom checks are fully defined by you using the available parameters 👉🏻 the chapter validate task docid\ uoiuuxrkbc4vhovldnxuo provides more information about the experience of validating a task while working on it configuring programmatic checks the possibility of configuring programmatic checks is only available to a limited number of organizations if you want us to enable this for your organization, contact kognic programmatic checks are configured on a project level when activated, they are part of the task validation in all of the project's tasks current limitations you can only configure programmatic checks in projects that contain one or multiple requests and where all requests use the same annotation instruction/taxonomy if you want to add checks in projects that don't fulfill this requirement, you must add them inside the annotation instruction/taxonomy if programmatic checks are configured on the project level, these will take precedence, and any checks written into the annotation instruction/taxonomy will be ignored custom checks custom checks are a type of task validation check they locate potential mistakes in the annotation task and run whenever a team member clicks "validate" in one of this project's tasks custom checks differ from template checks in their flexibility kognic broadly defines template checks, while you fully define custom checks you find all currently created custom checks and add new ones inside project settings and the tab programmatic checks how do i add and activate a new custom check? to add and activate a new check you go through the following steps click the "add custom check" button in either the top right corner of the custom checks list or, if no custom checks exist, in the center of the empty custom checks list select from the available parameters and operators to define the check's conditions you can select parameters of the type property or geometry (optional) add additional and or or conditions if needed give your check a name and a description this will help you and others recognize and understand its function select what should happen if the check conditions are met during task validation the check can either trigger a warning or an error a warning doesn't block task submission, while errors do write a validation message that should be displayed to the team member performing the task make sure it is informative and instructive click "add check" and the check is added to the project but in an inactive state locate your new check in the "custom check" list and click activate save your updated project settings you have created and activated a new check! 🎉 how do i ensure my custom checks work as intended? you can preview custom checks while creating or editing them locate and click the button called "test check in task view" (see gif below) this opens a view link in which the check is activated create a situation that meets the check's conditions validate the task by clicking "test custom check " if the check was correctly configured and you successfully created a situation that meets its conditions, a warning or error message should be displayed gif showing how to preview a custom check how do i turn off an already existing custom check? there are two ways to ensure a custom check isn't used in the project's tasks deactivating or deleting it if you deactivate the check, it remains available but is currently not used for task validation if you delete the check, it is removed from the project permanently template checks template checks are a type of task validation check they locate potential mistakes in the annotation task and run whenever a team member clicks "validate" in one of this project's tasks kognic creates and maintains the template checks, but you decide which to use in your project and how to configure them you find all available template checks inside project settings and the tab programmatic checks how do i activate and configure a template check? if you find a template check which seems suitable for the error you want to prevent you can customize and activate it by completing the following steps when you have located a template check you want to use, click "activate and configure" a dialog opens in which you can configure the check to your needs you do this by editing the check configuration json when you feel happy with your configuration, click "activate check " save your updated project settings you have created and activated a new check! 🎉 how do i turn off an already existing template check? you can turn off the template check by deactivating it this means it is no longer used for task validation in the project