How to Use Comments in AiRForms and Jobs

Commenting on AiRForms

Comment support has been added to AiRForms allowing authors and reviewers with comment permission to provide feedback against areas within an AiRForm.

In Atheer Studio, authors and reviewers can use the Comment button button to activate the comment drawer and leave comments. In the app drawer, they can also indicate that comments are resolved, edit comments, and delete comments.

In order to activate the Comments feature for AiRForms, the workspace Settings > Features > AiRForms > Allow Commenting on AiRForms flag must be activated. This feature flag is not activated by default.

In order for users to be able to use the comment feature, they need to have the “Comment” permission associated with their account. The “Comment” permission is already part of the AiRForm Admin role and the Super User role. Any users who need to be able to use the comment feature will need to have the AiRForm “Comment” permission added to their account.

The Comments feature can be used with the AiRForm configuration page, with AiRForm sections, and with AiRForm steps.

While on the AiRForms configuration page, if you click on the Comment button, the Comments drawer will open, and you will be able to leave, see, and manage comments associated with the configuration.

While editing a section, if you click on the Comment button, the Comments drawer will open, and you will be able to leave, see, and manage comments associated with that specific section.

While editing a step, if you click on the Comment button, the Comments drawer will open, and you will be able to leave, see, and manage comments associated with that specific step.

After comments are created, authors and reviewers with comment permission can glance at the AiRForm title and the section and step list to quickly see where unresolved comments are. Then, they can access and manage them by clicking on the Comments button. When they click, the comment drawer will open, and they can mark the comment as resolved, edit the comment, or delete the comment.

The ability to make and manage comments in AiRForms allows AiRForm authors and reviewers to provide feedback and/or call out issues and get prompt resolution.

Commenting while executing Jobs

Comments can also be added when users are executing Jobs. In order to activate this feature, the workspace’s Settings > Features > Job > Allow Commenting on AiRForms flag must be activated.

When this feature flag is activated, once the Job is created,  your front line workers can enter comments about the Job into the comments field on the Job details page before they tap the Execute button.

Once a Job has an associated comment, the comment indicator is displayed on the Job’s line item in the Job board in Lens and Studio.

Tapping or clicking on the comment indicator will open up the comment. Once opened, you can review the comment(s) and click on tool buttons that allow you to resolve, edit, or delete the comment.

Giving your front line workers the ability to comment in Jobs increases visibility of issues and work progress, and enables quick responses to outstanding issues recognized by the front line.