Views: 2399 (Data available since 06.02.2017)

This action permits you to create a task for selected users consisting in reading the document with an option to leave a comment to it. During task performance, the percentage of those who have read the document is calculated.


Action Parameters

Reviewers – the users who must read the document are indicated.

Assignment name – the name of the document reading task is set here. It will be displayed on the user interface.

Assignment description – a description or comments to the task are indicated. The contents of this field will be displayed on the user interface. It is recommended to indicate complete information in this field about the action to be performed by the user. It will help you to avoid confusion in case of several similar actions.

Require reading by

  • All Employees – the task will not be completed until all the users indicated above have read the document;
  • Any Employee – any user from those indicated above must read the document.

Set Status Text – permits changing the document status text to an arbitrary. It may, for example, permit you to monitor the progress of a business process.

Status Text – a status text is set up.
The following modifiers can be used in the status text: #PERCENT# - percent, #REVIEWED# - persons informed, #TOTAL# - total number of persons to be informed, #REVIEWERS# - who has read the document.

Assignment button label – permits setting own text for the relevant button.

Show comment input field – this option makes it possible to permit users leaving their own comments to the assigned task. For example, any comments regarding the task. The contents of the field can be obtained after executing the action using the relevant option in the form Insert value – Additional results (see below).

Comment input field label – a caption for the field with a comment.

Time limit – a time period can be set up so that if the users have not read the document before the time period expires, the reading task will be automatically completed. An empty value or 0 means the absence of such a time period.


Action Results

The results of this action can be obtained using the form Insert value – Additional results where they will be available immediately after adding the action to the template.

The following is available:

  • Comment;
  • Persons Read;
  • Persons To Read;
  • Auto Examination – the field will contain 1 if the reading task was completed automatically (see Time limit).


Courses developed by «Bitrix», Inc.