Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Function name

create-task-updates

Parameters

  • data (Required). It is an array of fields. The details of the fields are as follows :

creator_id (Required). The user ID or Name on behalf of which the time entry is being submitted.
date (Required). Date. The date for this update. The same date is used for the time entry.
task_id (Required). Integer. The task against which the task update needs to be made.
percent_complete (Optional). Integer between 0 and 100. The percent complete for this task.
actual_start (Optional). Date. The date this task started being worked on.
actual_finish (Optional). Date. The date this task was finished. Valid only when percent complete is 100.
comments (Optional). The comments for this task update. The same will be used while filling time.
hours_worked (Optional). Float. The number of hours. If not present, only task status is updated and no time entry is added.
time_code_id (Optional, Required if hours_worked parameter is submitted). The time code ID or Name for this time entry.
rate_type_id (Optional). Integer. 1 for standard, 2 for overtime (in case your organization uses overtime rates), defaults to 1.
send_for_approval (Optional). Boolean. Whether this time entry is to be sent for approval. If false, this will be saved.

Return values

Nothing

 

When your data format is XML, you should post something like this

<data>
    <item>  <!--  update task status and fill time..-->
      <creator_id>Mary Jane</creator_id>
      <date>2010-11-01</date>
      <task_id>12345</task_id>
      <percent_complete>50</percent_complete>
      <actual_start>2010-11-02T08:00:00</actual_start>
      <comments>Am half way there</comments>
      <hours_worked>2.5</hours_worked>
      <time_code_id>Meeting</time_code_id>
      <rate_type_id>1</rate_type_id>
     </item>
    <item>  <!--  the following just fills an update..-->
      <creator_id>100</creator_id>
      <date>2010-11-01</date>
      <task_id>18381</task_id>
      <percent_complete>100</percent_complete>
      <actual_finish>2010-11-02T17:00:00</actual_start>
      <comments>Done!</comments>
    </item>
</data>
send-for-approval=false

 

In case of JSON, you should submit an array of objects with the same properties. 

[
  {
    "creator_id" : "Mary Jane",
    "date" : "2010-11-01",
    "task_id" : "12345",
    "percent_complete" "50",
    "actual_start" : "2010-11-02T08:00:00",
    "comments" : "Am half way there",
    "hours_worked" : "2.5",
    "time_code_id" : "Meeting",
    "rate_type_id" : "1"
  }
  {     
    "creator_id" : "100",
    "date" : "2010-11-01",
    "task_id" : "18381",
    "percent_complete" : "100",
    "actual_finish" : "2010-11-02T17:00:00"
  }
]
send-for-approval=false
  • No labels