Planfix API action.update

From Planfix
Jump to: navigation, search

Function for updating data in an action. Request format:

<?xml version="1.0" encoding="UTF-8"?>
<request method="action.update">
  <account></account>
  <sid></sid>
  <action>
    <id></id>
    <description></description>
    <taskNewStatus></taskNewStatus>
    <notifiedList>
      <user>
        <id></id>
        <id></id>
        <!-- ... -->
      </user>
    </notifiedList>
    <isHidden></isHidden>
    <dateTime></dateTime>
    <analitics>
      <analitic>
        <id></id>
        <analiticData>
          <key></key>
          <itemData>
            <fieldId></fieldId>
            <value></value>
          </itemData>
          <itemData>
            <fieldId></fieldId>
            <value></value>
          </itemData>
          <!-- ... -->
        </analiticData>
      </analitic>
      <!-- ... -->
      <analitic>
        <id></id>
        <analiticData>
          <itemData>
            <fieldId></fieldId>
            <value></value>
          </itemData>
          <itemData>
            <fieldId></fieldId>
            <value></value>
          </itemData>
          <!-- ... -->
        </analiticData>
      </analitic>
      <!-- ... -->
    </analitics>
    <deletedAnalitics>
      <key></key>
      <key></key>
      <!-- ... -->
    </deletedAnalitics>
  </action>
  <signature></signature>
</request>
Name Type Value Notes
id int action identifier
description string text with action/comment description
taskNewStatus enum this action changes the task statuses to the one specified not required; for a list of valid values, see the task statuses section; attempting to change to an invalid status or to change the status of an action that isn't the most recent will result in an error
notifiedList the following list of users must be notified of this action
notifiedList.user list of users who will receive a notification
notifiedList.user.id int user identifier
isHidden bool whether or not the action (comment) is hidden from all users, excluding the list of those notified not required, by default set to 0 (false)
dateTime DateTime date/time of creation; not required; by default not changed can only be used if an employee with admin rights is logged in
analitics list of data tags updated not required
analitics.analitic node containing data from a data tag
analitic.id int data tag identifier for a list of available data tags, use the analitic.getList function
analitic.analiticData list of field values
analiticData.key int data tag row identifier; if this attribute is used, the data tag with this identifier will be used; if it is not used, a new data tag row will be added
analiticData.itemData value of one of the parameters
itemData.feildId int parameter identifier identifier of the parameter equal to feild.id
itemData.value string value
deletedDatatags list of deleted data tags
deletedDatatags.key int key of deleted data tags this field is available after executing the function analitic.getData
signature string(32) signature


Remember, you can update ACTION and COMMENT actions. Attempts to update other types of actions will result in an error.

Result of successful request:

<?xml version="1.0" encoding="UTF-8"?>
<response status="ok">
  <action>
    <id></id>
  </action>
</response>
Name Type Value Notes
action.id int identifier of the modified action


Otherwise, an error response will be returned:

<?xml version="1.0" encoding="UTF-8"?>
<response status="error">
  <code></code>
</response>


Go To