API task EN: различия между версиями

Материал из WiKi - UserSide
(Новая страница: «en | ru Section '''API''' ERP "UserSide"»)
 
Нет описания правки
 
(не показаны 4 промежуточные версии этого же участника)
Строка 2: Строка 2:


Section '''[[API_EN|API]]''' ERP "UserSide"
Section '''[[API_EN|API]]''' ERP "UserSide"
Purpose: Working with tasks
Additional parameters:
action - request subcategory ''(possible value: see below)''
== Subcategories ==
==== add ====
''Modified in: 3.18.29 (added deadline_hour parameter)''
''Modified in: 3.17dev1 (removed usercode, uzelcode parameters and added customer_id, node_id parameters)''
''Modified in: 3.16dev2 (removed unit_id, author_operator_id parameters and added employee_id, author_employee_id parameters)''
''Modified in: 3.12.84 (added parent_task_id parameter)''
''Modified in: 3.12.38 (added unit_id, division_id parameters)''
''Modified in: 3.12.26 (added work_amount parameter)''
''Modified in: 3.12beta31 (added author_operator_id parameter)''
Description: Task creation
Obligatory parameters:
  work_datedo - date on which the task is scheduled to run
  work_typer - task TYPE ID
Optional parameters:
  apart - flat number
  address_id - ''(for version 3.13 and later)'' address unit id
  author_employee_id - ID of the employee author of the task
  author_operator_id - task author operator ID ''(before version 3.16dev2)''
  citycode - ''(for version 3.12 and earlier)'' the id of the location. If not specified, it is taken from the housecode data.
  customer_id - ''(for version 3.17 and later)'' user ID
  deadline_hour - time to complete the task ''(from the date of acceptance. In hours)''
  division_id - division ID ''(multiple values separated by commas are allowed)''
  dopf_N - value of additional field for field ID N
  employee_id - employee ID ''(several values separated by commas are allowed)''
  fio - client's full name ''(meaning that 'client' is not yet a user)''
  housecode - ''(for version 3.12 and earlier)'' the building id. If not specified, it is taken from the user data - customer_id, or from the communication facility data - node_id
  node_id - ''(for version 3.17 and later)'' communication facility ID
  opis - task notes
  parent_task_id - ID of parent task
  unit_id - ID of executor ''(multiple values separated by commas are allowed) (up to version 3.16dev2)''
  usercode - ''(for version 3.16 and earlier)'' user ID
  uzelcode - ''(for version 3.16 and earlier)'' ID of communication facility
  work_amount - scope of work
==== add_customer_to_task ====
''Added in: 3.13.70''
Description: Add a user to a task
Required parameters:
  task_id - task id
  customer_id - id of customer
==== add_device_to_task ====
''Added in: 3.19beta1''
Description: Add equipment to a task
Obligatory parameters:
  task_id - task id
  device_id - equipment id
==== change_date_work ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''
''Added in: 3.12.83''
Description: Change the date and time of the task ''(date on which the work is scheduled)''
Obligatory parameters:
  id - id of the task
  value - date
Optional parameters:
  employee_id - id of the initiating employee ''(to be recorded in the task history)''
  operator_id - id of the initiator operator ''(to be recorded in the task history) (before version 3.16dev2)''
==== change_state ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''
Description: Changing the state (status) of a task
Obligatory parameters:
  id - id of the task
  state_id - task state id
Optional parameters:
  employee_id - id of the employee on whose behalf to change the state
  operator_id - id of the operator on whose behalf to change the state ''(before version 3.16dev2)''
==== check_verify_code ====
Description: Checks the verification code to perform the request
Obligatory parameters:
  id - task ID
  verify_code - verification code
==== checklist_item_check ====
''Added in: 3.17dev1''
Description: Marks a checklist item in a task
Obligatory parameters:
  id - id of checklist item
  task_id - task id
  employee_id - id of the employee on whose behalf the item is marked
==== checklist_item_uncheck ====
''Added in: 3.17dev1''
Description: Uncheck a checklist item in a task
Required parameters:
  id - id of checklist item
  task_id - task id
==== comment_add ====
''Modified in: 3.17dev1 (added dateadd parameter)''
''Modified in: 3.16.19 (added reply_comment_id parameter)''
''Modified in: 3.16dev2 (removed operator_id parameter, added employee_id parameter)''
''Modified in: 3.12.89 (added author_operator_id parameter)''
Description: Add comment
Obligatory parameters:
  id - task ID
  comment - text
Optional parameters:
  dateadd - date-time of the comment
  employee_id - id of the employee on whose behalf the comment is made
  operator_id - id of the operator on whose behalf the comment is ''(before version 3.16dev2)''
  reply_comment_id - id of the comment we are replying to
==== comment_edit ====
''Added in: 3.18beta1''
Description: Edit comment
Obligatory parameters:
  id - comment ID
  task_id - task ID
  body - text
==== delete ====
''Added in: 3.14.35''
Description: Deleting a task
Obligatory parameters:
  id - id of the task
==== division_add ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''
''Added in: 3.13.36''
Description: Adding a division
Mandatory parameters:
  id - task id
  division_id - id of division
Optional parameters:
  employee_id - id of the initiating employee ''(to be recorded in the history by the task)''
  operator_id - id of the initiator operator ''(to be recorded in the task history)'' (before version 3.16dev2)''
==== division_delete ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''
''Added in: 3.13.36''
Description: Exclusion of division
Obligatory parameters:
  id - task id
  division_id - id of division
Optional parameters:
  employee_id - id of the initiating employee ''(to be recorded in the task history)''
  operator_id - id of the initiator operator ''(to be recorded in the task history)'' (before version 3.16dev2)''
==== edit ====
''Modified in: 3.18.30 (added deadline_hour parameter)''
''Modified in: 3.18beta1 (added address_id parameter)''
''Modified in: 3.16dev3 (added type_id parameter)''
''Modified in: 3.15.12 (added parent_task_id parameter)''
''Added in: 3.13.18''
Description: Task modification
Obligatory parameters:
  id - task id
Optional parameters:
  address_id - id of the address unit
  body - text of the task ''(descriptive part)''
  deadline_hour - time to complete the task ''(from the date of acceptance. In hours)''
  parent_task_id - id of parent task
  type_id - id of the task type
==== employee_add ====
''Added in: 3.16dev2''
Description: Adding an employee
Obligatory parameters:
  id - task id
  employee_id - employee id
Optional parameters:
  author_employee_id - id of the initiating employee ''(to commit to history by task)''
==== employee_delete ====
''Added in: 3.16dev2''
Description: Exclude employee
Obligatory parameters:
  id - task id
  employee_id - employee id
Optional parameters:
  author_employee_id - id of the initiating employee ''(to commit to the history by task)''
==== get_allow_staff ====
''Added in: 3.15.23''
Description: List of performers and divisions that are available for assignment to a task ''(according to settings)'''
Obligatory parameters:
  id - task id
==== get_catalog_type ====
''Added in: 3.12.22''
Description: Task types
Optional parameters:
  id - job type id ''(can be comma separated)''
==== get_catalog_type_group ====
''Added in: 3.16dev3''
Description: Task type groups
==== get_catalog_state ====
''Added in: 3.12.22''
Description: Task state classifier
Optional parameters:
  state_id - state id ''(can be comma separated)''
==== get_comment ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''
''Modified in: 3.14.67 (added id parameter)''
''Modified in: 3.14.53 (added operator_id parameter)''
''Modified in: 3.13.50 (added date_add_from and date_add_to parameters)''
''Added in: 3.12.75''
Description: Comments
Optional parameters ''(but there must be at least one)'':
  id - id of comment ''(can be comma separated)''
  task_id - id of tasks ''(can be comma separated)''
  date_add_from - date of adding comment ''(from)''
  date_add_to - date of adding a comment ''(to)''
  employee_id - id of the employee-author of the comment
  operator_id - id of operator-author of the comment ''(before version 3.16dev2)''
==== get_list ====
''Modified in: 3.18.30 (added parameters change_operation_type, change_employee_id)''
''Modified in: 3.18beta1 (added address_id parameter)''
''Modified in: 3.16dev3 (added task_position, task_position_radius parameters, excluded possible customer_id and house_id values from order_by parameter)''
''Modified in: 3.16dev2 (removed parameters closer_operator_id, staff_id, author_id, watcher_id, added parameters closer_employee_id, employee_id, author_employee_id, watcher_employee_id)''
''Modified in: 3.15.23 (added is_expired parameter)''
''Modified in: 3.14.71 (added node_id parameter)''
''Modified in: 3.14.62 (added closer_operator_id parameter)''
''Modified in: 3.14.56 (added division_id_with_staff parameter)''
''Modified in: 3.14.41 (added possible value -1 to staff_id parameter)''
''Modified in: 3.13.29 (added date_change_from, date_change_to parameters)''
''Modified in: 3.13.28 (added date_change to order_by parameter)''
''Modified in: 3.12.91 (added watcher_id parameter)''
''Modified at: 3.12.83 (added author_id parameter)''
''Modified at: 3.12.78 (added order_by, limit, offset parameters)''
''Modified at: 3.12.62 (added customer_id parameter)''
''Modified in: 3.12.24 (added date_do_from, date_do_to parameters)''
''Modified in: 3.12beta29 (added house_id parameter)''
Description: List of tasks (identifiers)
Optional parameters (sampling conditions):
  address_id - ID of the address object ''(can be comma separated)''
  author_id - ID of operator - task author ''(comma separated) (up to version 3.16dev2)''
  author_employee_id - ID of the employee - author of the task ''(can be comma separated)'''
  change_employee_id - ID of the employee - author of the task changes
  change_operation_type - type of actions to change the task ''(possible values: add_comment, change_state)''
  closer_employee_id - ID of the employee who closed ''(completed)'' the task ''(can be comma separated)'''
  closer_operator_id - ID of the operator who closed the ''(completed)'' task ''(can be comma separated) (before version 3.16dev2)''
  customer_id - ID of the user ''(can be comma separated)''
  date_add_from - task creation date (from)
  date_add_to - task creation date (to)
  date_change_from - task update date (from)
  date_change_to - task update date (to)
  date_do_from - date on which the task is scheduled to be executed (from)
  date_do_to - date on which the task is scheduled to be executed (to)
  date_finish_from - date on which the task is executed (from)
  date_finish_to - date on which the task is executed (to)
  division_id - division ID ''(can be comma separated)''
  division_id_with_staff - division ID ''(including tasks of employees of this division) (can be comma separated)''
  employee_id - employee ID ''(can be comma separated, use -1 to get tasks without employees)''
  house_id - ID of the work house
  is_expired - flag - output only expired tasks
  node_id - ID of the location object
  staff_id - ID of executor ''(can be comma separated, use -1 to get tasks without executors) (up to version 3.16dev2)''
  state_id - task status ID ''(can be comma separated)''
  task_position - task coordinates ''(where possible. In lat,lng format. e.g. 40.245218,52.333384)''
  task_position_radius - radius from task_position ''(in meters)''
  type_id - task type ID ''(can be comma separated)''
  watcher_id - task observer operator ID ''(comma separated) (up to version 3.16dev2)''
  watcher_employee_id - ID of the task observer employee ''(comma separated)''
  order_by - sorting field ''(possible variants: date_add, date_change, date_do, date_finish, state_id, type_id)''
  limit - record sampling limit
  offset - sampling offset
==== get_related_task_id====
Description: List of related tasks to the current task (identifiers)
Obligatory parameters:
  id - task ID
==== get_typical_comments ====
''Added in: 3.14.70''
Description: Get list of typical comments
==== remove_customer_from_task ====
''Added in: 3.15.23''
Description: Excludes a user from a task
Obligatory parameters:
  task_id - task id
  customer_id - id of user
==== set_rate ====
''Added in: 3.12.63''
Description: Specifies the individual rate ''(for employees)'' for the task
Obligatory parameters:
  task_id - task ID
  rate - rate
==== show ====
''Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)''
''Modified in: 3.13.29 (the id parameter can be a comma separated list)''
''Modified in: 3.13.25 (added is_without_comments parameter)''
''Modified in: 3.12.64 (added operator_id parameter)''
Description: Information about the task
Obligatory parameters:
  id - task id ''(can be comma separated)''
Optional parameters:
  employee_id - id of the employee who is viewing this task ''(to be recorded in the history by task)''
  is_without_comments - flag - do not display comments in the task information
  operator_id - id of the operator who is viewing this task ''(to be recorded in the task history) (before version 3.16dev2)''
==== (*) staff_add ====
''Deprecated in: 3.16dev2 (use API->task->[[API_task_EN#employee_add|employee_add]])''
''Added in: 3.12.83''
Description: Adding an executor
Obligatory parameters:
  id - task id
  staff_id - id of the executor
Optional parameters:
  operator_id - id of the initiating operator ''(to be recorded in the history by the task)''
==== (*) staff_delete ====
''Deprecated in: 3.16dev2 (use API->task->[[API_task_EN#employee_delete|employee_delete]])''
''Added in: 3.12.83''
Description: Exclude an executor
Obligatory parameters:
  id - task id
  staff_id - id of the executor
Optional parameters:
  operator_id - id of the initiating operator ''(to be recorded in the job history)''
==== watcher_add ====
''Modified in: 3.16dev2 (removed staff_id, operator_id parameters, added employee_id, author_employee_id parameters)''
''Added in: 3.14.21''
Description: Add observer
Obligatory parameters:
  id - task id
  employee_id - id of observer
  staff_id - observer id ''(before 3.16dev2)''
Optional parameters:
  author_employee_id - id of the initiating employee ''(to be recorded in the job history)''
  operator_id - id of the initiating operator ''(to be recorded in the job history) (before version 3.16dev2)''
==== watcher_delete ====
''Modified in: 3.16dev2 (removed staff_id, operator_id parameters, added employee_id, author_employee_id parameters)''
''Added in: 3.14.21''
Description: Exclusion of observer
Obligatory parameters:
  id - task id
  employee_id - id of observer
  staff_id - observer id ''(before 3.16dev2)''
Optional parameters:
  author_employee_id - id of the initiating employee ''(to be recorded in the job history)''
  operator_id - id of the initiating operator ''(to be recorded in the job history) (before version 3.16dev2)''

Текущая версия от 22:11, 26 апреля 2024

en | ru

Section API ERP "UserSide"

Purpose: Working with tasks

Additional parameters:
action - request subcategory (possible value: see below)

Subcategories

add

Modified in: 3.18.29 (added deadline_hour parameter)

Modified in: 3.17dev1 (removed usercode, uzelcode parameters and added customer_id, node_id parameters)

Modified in: 3.16dev2 (removed unit_id, author_operator_id parameters and added employee_id, author_employee_id parameters)

Modified in: 3.12.84 (added parent_task_id parameter)

Modified in: 3.12.38 (added unit_id, division_id parameters)

Modified in: 3.12.26 (added work_amount parameter)

Modified in: 3.12beta31 (added author_operator_id parameter)

Description: Task creation

Obligatory parameters:
 work_datedo - date on which the task is scheduled to run
 work_typer - task TYPE ID

Optional parameters:
 apart - flat number
 address_id - (for version 3.13 and later) address unit id
 author_employee_id - ID of the employee author of the task
 author_operator_id - task author operator ID (before version 3.16dev2)
 citycode - (for version 3.12 and earlier) the id of the location. If not specified, it is taken from the housecode data.
 customer_id - (for version 3.17 and later) user ID
 deadline_hour - time to complete the task (from the date of acceptance. In hours)
 division_id - division ID (multiple values separated by commas are allowed)
 dopf_N - value of additional field for field ID N
 employee_id - employee ID (several values separated by commas are allowed)
 fio - client's full name (meaning that 'client' is not yet a user)
 housecode - (for version 3.12 and earlier) the building id. If not specified, it is taken from the user data - customer_id, or from the communication facility data - node_id
 node_id - (for version 3.17 and later) communication facility ID
 opis - task notes
 parent_task_id - ID of parent task
 unit_id - ID of executor (multiple values separated by commas are allowed) (up to version 3.16dev2)
 usercode - (for version 3.16 and earlier) user ID
 uzelcode - (for version 3.16 and earlier) ID of communication facility
 work_amount - scope of work

add_customer_to_task

Added in: 3.13.70

Description: Add a user to a task

Required parameters:
 task_id - task id
 customer_id - id of customer

add_device_to_task

Added in: 3.19beta1

Description: Add equipment to a task

Obligatory parameters:
 task_id - task id
 device_id - equipment id

change_date_work

Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)

Added in: 3.12.83

Description: Change the date and time of the task (date on which the work is scheduled)

Obligatory parameters:
 id - id of the task
 value - date
Optional parameters:
 employee_id - id of the initiating employee (to be recorded in the task history)
 operator_id - id of the initiator operator (to be recorded in the task history) (before version 3.16dev2)

change_state

Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)

Description: Changing the state (status) of a task

Obligatory parameters:
 id - id of the task
 state_id - task state id
Optional parameters:
 employee_id - id of the employee on whose behalf to change the state
 operator_id - id of the operator on whose behalf to change the state (before version 3.16dev2)

check_verify_code

Description: Checks the verification code to perform the request

Obligatory parameters:
 id - task ID
 verify_code - verification code

checklist_item_check

Added in: 3.17dev1

Description: Marks a checklist item in a task

Obligatory parameters:
 id - id of checklist item
 task_id - task id
 employee_id - id of the employee on whose behalf the item is marked

checklist_item_uncheck

Added in: 3.17dev1

Description: Uncheck a checklist item in a task

Required parameters:
 id - id of checklist item
 task_id - task id

comment_add

Modified in: 3.17dev1 (added dateadd parameter)

Modified in: 3.16.19 (added reply_comment_id parameter)

Modified in: 3.16dev2 (removed operator_id parameter, added employee_id parameter)

Modified in: 3.12.89 (added author_operator_id parameter)

Description: Add comment

Obligatory parameters:
 id - task ID
 comment - text
Optional parameters:
 dateadd - date-time of the comment
 employee_id - id of the employee on whose behalf the comment is made
 operator_id - id of the operator on whose behalf the comment is (before version 3.16dev2)
 reply_comment_id - id of the comment we are replying to

comment_edit

Added in: 3.18beta1

Description: Edit comment

Obligatory parameters:
 id - comment ID
 task_id - task ID
 body - text

delete

Added in: 3.14.35

Description: Deleting a task

Obligatory parameters:
 id - id of the task

division_add

Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)

Added in: 3.13.36

Description: Adding a division

Mandatory parameters:
 id - task id
 division_id - id of division
Optional parameters:
 employee_id - id of the initiating employee (to be recorded in the history by the task)
 operator_id - id of the initiator operator (to be recorded in the task history) (before version 3.16dev2)

division_delete

Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)

Added in: 3.13.36

Description: Exclusion of division

Obligatory parameters:
 id - task id
 division_id - id of division
Optional parameters:
 employee_id - id of the initiating employee (to be recorded in the task history)
 operator_id - id of the initiator operator (to be recorded in the task history) (before version 3.16dev2)

edit

Modified in: 3.18.30 (added deadline_hour parameter)

Modified in: 3.18beta1 (added address_id parameter)

Modified in: 3.16dev3 (added type_id parameter)

Modified in: 3.15.12 (added parent_task_id parameter)

Added in: 3.13.18

Description: Task modification

Obligatory parameters:
 id - task id
Optional parameters:
 address_id - id of the address unit
 body - text of the task (descriptive part)
 deadline_hour - time to complete the task (from the date of acceptance. In hours)
 parent_task_id - id of parent task
 type_id - id of the task type

employee_add

Added in: 3.16dev2

Description: Adding an employee

Obligatory parameters:
 id - task id
 employee_id - employee id
Optional parameters:
 author_employee_id - id of the initiating employee (to commit to history by task)

employee_delete

Added in: 3.16dev2

Description: Exclude employee

Obligatory parameters:
 id - task id
 employee_id - employee id
Optional parameters:
 author_employee_id - id of the initiating employee (to commit to the history by task)

get_allow_staff

Added in: 3.15.23

Description: List of performers and divisions that are available for assignment to a task (according to settings)'

Obligatory parameters:
 id - task id

get_catalog_type

Added in: 3.12.22

Description: Task types

Optional parameters:
 id - job type id (can be comma separated)

get_catalog_type_group

Added in: 3.16dev3

Description: Task type groups

get_catalog_state

Added in: 3.12.22

Description: Task state classifier

Optional parameters:
 state_id - state id (can be comma separated)

get_comment

Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)

Modified in: 3.14.67 (added id parameter)

Modified in: 3.14.53 (added operator_id parameter)

Modified in: 3.13.50 (added date_add_from and date_add_to parameters)

Added in: 3.12.75

Description: Comments

Optional parameters (but there must be at least one):
 id - id of comment (can be comma separated)
 task_id - id of tasks (can be comma separated)
 date_add_from - date of adding comment (from)
 date_add_to - date of adding a comment (to)
 employee_id - id of the employee-author of the comment
 operator_id - id of operator-author of the comment (before version 3.16dev2)

get_list

Modified in: 3.18.30 (added parameters change_operation_type, change_employee_id)

Modified in: 3.18beta1 (added address_id parameter)

Modified in: 3.16dev3 (added task_position, task_position_radius parameters, excluded possible customer_id and house_id values from order_by parameter)

Modified in: 3.16dev2 (removed parameters closer_operator_id, staff_id, author_id, watcher_id, added parameters closer_employee_id, employee_id, author_employee_id, watcher_employee_id)

Modified in: 3.15.23 (added is_expired parameter)

Modified in: 3.14.71 (added node_id parameter)

Modified in: 3.14.62 (added closer_operator_id parameter)

Modified in: 3.14.56 (added division_id_with_staff parameter)

Modified in: 3.14.41 (added possible value -1 to staff_id parameter)

Modified in: 3.13.29 (added date_change_from, date_change_to parameters)

Modified in: 3.13.28 (added date_change to order_by parameter)

Modified in: 3.12.91 (added watcher_id parameter)

Modified at: 3.12.83 (added author_id parameter)

Modified at: 3.12.78 (added order_by, limit, offset parameters)

Modified at: 3.12.62 (added customer_id parameter)

Modified in: 3.12.24 (added date_do_from, date_do_to parameters)

Modified in: 3.12beta29 (added house_id parameter)

Description: List of tasks (identifiers)

Optional parameters (sampling conditions):
 address_id - ID of the address object (can be comma separated)
 author_id - ID of operator - task author (comma separated) (up to version 3.16dev2)
 author_employee_id - ID of the employee - author of the task (can be comma separated)'
 change_employee_id - ID of the employee - author of the task changes
 change_operation_type - type of actions to change the task (possible values: add_comment, change_state)
 closer_employee_id - ID of the employee who closed (completed) the task (can be comma separated)'
 closer_operator_id - ID of the operator who closed the (completed) task (can be comma separated) (before version 3.16dev2)
 customer_id - ID of the user (can be comma separated)
 date_add_from - task creation date (from)
 date_add_to - task creation date (to)
 date_change_from - task update date (from)
 date_change_to - task update date (to)
 date_do_from - date on which the task is scheduled to be executed (from)
 date_do_to - date on which the task is scheduled to be executed (to)
 date_finish_from - date on which the task is executed (from)
 date_finish_to - date on which the task is executed (to)
 division_id - division ID (can be comma separated)
 division_id_with_staff - division ID (including tasks of employees of this division) (can be comma separated)
 employee_id - employee ID (can be comma separated, use -1 to get tasks without employees)
 house_id - ID of the work house
 is_expired - flag - output only expired tasks
 node_id - ID of the location object
 staff_id - ID of executor (can be comma separated, use -1 to get tasks without executors) (up to version 3.16dev2)
 state_id - task status ID (can be comma separated)
 task_position - task coordinates (where possible. In lat,lng format. e.g. 40.245218,52.333384)
 task_position_radius - radius from task_position (in meters)
 type_id - task type ID (can be comma separated)
 watcher_id - task observer operator ID (comma separated) (up to version 3.16dev2)
 watcher_employee_id - ID of the task observer employee (comma separated)
 order_by - sorting field (possible variants: date_add, date_change, date_do, date_finish, state_id, type_id)
 limit - record sampling limit
 offset - sampling offset

get_related_task_id

Description: List of related tasks to the current task (identifiers)

Obligatory parameters:
 id - task ID

get_typical_comments

Added in: 3.14.70

Description: Get list of typical comments

remove_customer_from_task

Added in: 3.15.23

Description: Excludes a user from a task

Obligatory parameters:
 task_id - task id
 customer_id - id of user

set_rate

Added in: 3.12.63

Description: Specifies the individual rate (for employees) for the task

Obligatory parameters:
 task_id - task ID
 rate - rate

show

Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)

Modified in: 3.13.29 (the id parameter can be a comma separated list)

Modified in: 3.13.25 (added is_without_comments parameter)

Modified in: 3.12.64 (added operator_id parameter)

Description: Information about the task

Obligatory parameters:
 id - task id (can be comma separated)
Optional parameters:
 employee_id - id of the employee who is viewing this task (to be recorded in the history by task)
 is_without_comments - flag - do not display comments in the task information
 operator_id - id of the operator who is viewing this task (to be recorded in the task history) (before version 3.16dev2)

(*) staff_add

Deprecated in: 3.16dev2 (use API->task->employee_add)

Added in: 3.12.83

Description: Adding an executor

Obligatory parameters:
 id - task id
 staff_id - id of the executor
Optional parameters:
 operator_id - id of the initiating operator (to be recorded in the history by the task)

(*) staff_delete

Deprecated in: 3.16dev2 (use API->task->employee_delete)

Added in: 3.12.83

Description: Exclude an executor

Obligatory parameters:
 id - task id
 staff_id - id of the executor
Optional parameters:
 operator_id - id of the initiating operator (to be recorded in the job history)

watcher_add

Modified in: 3.16dev2 (removed staff_id, operator_id parameters, added employee_id, author_employee_id parameters)

Added in: 3.14.21

Description: Add observer

Obligatory parameters:
 id - task id
 employee_id - id of observer
 staff_id - observer id (before 3.16dev2)
Optional parameters:
 author_employee_id - id of the initiating employee (to be recorded in the job history)
 operator_id - id of the initiating operator (to be recorded in the job history) (before version 3.16dev2)

watcher_delete

Modified in: 3.16dev2 (removed staff_id, operator_id parameters, added employee_id, author_employee_id parameters)

Added in: 3.14.21

Description: Exclusion of observer

Obligatory parameters:
 id - task id
 employee_id - id of observer
 staff_id - observer id (before 3.16dev2)
Optional parameters:
 author_employee_id - id of the initiating employee (to be recorded in the job history)
 operator_id - id of the initiating operator (to be recorded in the job history) (before version 3.16dev2)