跳至内容

发布任务

任务是您必须完成的活动或工作，通常作为更大发布或一般工作的部分。

属性

id （长整型）
用于识别任务的唯一标识符

id （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

标题 （字符串）
任务标题

标题 （字符串）
纯文本格式。不允许使用富文本或换行符。

示例 

CodeReviewTask

模板 （task_template）
表示用于创建此任务的模板

模板 （task_template）
表示用于创建此任务的模板

示例 

{
  "template": {
    "name": "test-template",
    "id": "234567890123456"
  }
}

描述 （html）
包含任务描述

描述 （html）
HTML 是一个文本区域，可使用 HTML 元素。

示例 

<b>The content to be displayed</b>

计划开始时间 （datetime）
任务计划开始的日期和时间

计划开始时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

计划结束时间 （datetime）
任务计划完成的日期和时间

计划结束时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

更多属性 全部展开

实际开始时间 （datetime）

任务实际开始的日期和时间

实际开始时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

实际结束时间 （datetime）

任务实际完成的日期和时间

实际结束时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

email_before （长整型）

指示在计划开始前以毫秒为单位发送通知的时间

email_before （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

percentage_completion （整数）

指示任务的完成百分比进度

percentage_completion （整数）
被认为数值较小的数字

示例 

39

additional_cost （双精度浮点数）

除任务实际成本外的开销

additional_cost （双精度浮点数）
可以包含小数的数字

示例 

23.08

estimated_effort_days （长整型）

估计完成任务所需的天数

estimated_effort_days （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

estimated_effort_hours （长整型）

估计完成任务所需的小时数

estimated_effort_hours （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

estimated_effort_minutes （长整型）

估计完成任务所需的分钟数

estimated_effort_minutes （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

status （状态）

指示任务的进展等级

status （状态）
指示任务的进展等级

示例 

{
  "status": {
    "name": "test_status",
    "id": "133333300000042011"
  }
}

group （组）

指派给发布任务的组

group （组）
指派给发布任务的组

示例 

{
  "group": {
    "name": "test_group",
    "id": "100333300111042099"
  }
}

owner （用户）

指派给任务的用户

owner （用户）
指派给任务的用户

示例 

{
  "owner": {
    "email_id": "test@test.com",
    "name": "test_user",
    "id": "100000000000042013"
  }
}

marked_technician （用户）

任务触发时指定的用户

marked_technician （用户）
任务触发时指定的用户

示例 

{
  "marked_techncian": {
    "email_id": "test@test.com",
    "name": "test_technician",
    "id": "100000000000042013"
  }
}

priority （优先级）

定义任务的紧急程度或重要性

priority （优先级）
定义任务的紧急程度或重要性

示例 

{
  "priority": {
    "name": "test_priority",
    "id": "1001100000042011"
  }
}

task_type （任务类型）

用于对类似案例的任务进行分类

task_type （任务类型）
用于对类似案例的任务进行分类

示例 

{
  "task_type": {
    "name": "test-task_type",
    "id": "234567890123456"
  }
}

attachments （附件）

附加到任务的文件。一个任务最多可附加10个文件

attachments （附件）
附加到任务的文件。一个任务最多可附加10个文件

示例 

{
  "attachments": {
    "name": "test_attachment_1",
    "id": "133333300000042011"
  }
}

udf_fields （自定义字段）

保存与任务相关的用户定义字段的值

udf_fields （自定义字段）
保存与任务相关的用户定义字段的值

示例 

{
  "udf_fields": {
    "udf_long2": "1225",
    "udf_long1": "1459402730964",
    "udf_date1": {
      "display_value": "Feb 26, 2016 11:00 AM",
      "value": "1456464639051"
    },
    "udf_char1": "abc@test.com",
    "udf_char2": "Ned Stark"
  }
}

module （字符串）read only

任务所属的模块

module （字符串）
纯文本格式。不允许使用富文本或换行符。

示例 

Sample Content

created_date （datetime）read only

创建任务的日期和时间

created_date （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

created_by （用户）read only

创建任务的用户姓名和ID

created_by （用户）
创建任务的用户姓名和ID

示例 

{
  "created_by": {
    "email_id": "test@test.com",
    "name": "test_user",
    "id": "100000000000042013"
  }
}

estimated_effort （长整型）read only

完成任务所需的估计工作量

estimated_effort （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

overdue （布尔值）read only

指示任务是否逾期

overdue （布尔值）
布尔值，可能的取值为true和false

associated_entity （字符串）read only

与任务关联的实体

associated_entity （字符串）
纯文本格式。不允许使用富文本或换行符。

示例 

Sample Content

release （发布）read only

任务将要关联的发布实体。仅当任务与发布关联时才提供发布信息

release （发布）
任务将要关联的发布实体。仅当任务与发布关联时才提供发布信息

示例 

{
  "release": {
    "id": "100000000000042013"
  }
}

添加发布任务

此操作用于添加新的发布任务。

必填字段：标题，模板

Url

<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks

属性

id （长整型）
用于识别任务的唯一标识符

id （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

标题 （字符串）
任务标题

标题 （字符串）
纯文本格式。不允许使用富文本或换行符。

示例 

CodeReviewTask

模板 （task_template）
表示用于创建此任务的模板

模板 （task_template）
表示用于创建此任务的模板

示例 

{
  "template": {
    "name": "test-template",
    "id": "234567890123456"
  }
}

描述 （html）
包含任务描述

描述 （html）
HTML 是一个文本区域，可使用 HTML 元素。

示例 

<b>The content to be displayed</b>

计划开始时间 （datetime）
任务计划开始的日期和时间

计划开始时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

计划结束时间 （datetime）
任务计划完成的日期和时间

计划结束时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

更多属性 全部展开

实际开始时间 （datetime）

任务实际开始的日期和时间

实际开始时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

实际结束时间 （datetime）

任务实际完成的日期和时间

实际结束时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

email_before （长整型）

指示在计划开始前以毫秒为单位发送通知的时间

email_before （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

percentage_completion （整数）

指示任务的完成百分比进度

percentage_completion （整数）
被认为数值较小的数字

示例 

39

additional_cost （双精度浮点数）

除任务实际成本外的开销

additional_cost （双精度浮点数）
可以包含小数的数字

示例 

23.08

estimated_effort_days （长整型）

估计完成任务所需的天数

estimated_effort_days （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

estimated_effort_hours （长整型）

估计完成任务所需的小时数

estimated_effort_hours （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

estimated_effort_minutes （长整型）

估计完成任务所需的分钟数

estimated_effort_minutes （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

status （状态）

指示任务的进展等级

status （状态）
指示任务的进展等级

示例 

{
  "status": {
    "name": "test_status",
    "id": "133333300000042011"
  }
}

group （组）

指派给发布任务的组

group （组）
指派给发布任务的组

示例 

{
  "group": {
    "name": "test_group",
    "id": "100333300111042099"
  }
}

owner （用户）

指派给任务的用户

owner （用户）
指派给任务的用户

示例 

{
  "owner": {
    "email_id": "test@test.com",
    "name": "test_user",
    "id": "100000000000042013"
  }
}

marked_technician （用户）

任务触发时指定的用户

marked_technician （用户）
任务触发时指定的用户

示例 

{
  "marked_techncian": {
    "email_id": "test@test.com",
    "name": "test_technician",
    "id": "100000000000042013"
  }
}

priority （优先级）

定义任务的紧急程度或重要性

priority （优先级）
定义任务的紧急程度或重要性

示例 

{
  "priority": {
    "name": "test_priority",
    "id": "1001100000042011"
  }
}

task_type （任务类型）

用于对类似案例的任务进行分类

task_type （任务类型）
用于对类似案例的任务进行分类

示例 

{
  "task_type": {
    "name": "test-task_type",
    "id": "234567890123456"
  }
}

attachments （附件）

附加到任务的文件。一个任务最多可附加10个文件

attachments （附件）
附加到任务的文件。一个任务最多可附加10个文件

示例 

{
  "attachments": {
    "name": "test_attachment_1",
    "id": "133333300000042011"
  }
}

udf_fields （自定义字段）

保存与任务相关的用户定义字段的值

udf_fields （自定义字段）
保存与任务相关的用户定义字段的值

示例 

{
  "udf_fields": {
    "udf_long2": "1225",
    "udf_long1": "1459402730964",
    "udf_date1": {
      "display_value": "Feb 26, 2016 11:00 AM",
      "value": "1456464639051"
    },
    "udf_char1": "abc@test.com",
    "udf_char2": "Ned Stark"
  }
}

module （字符串）read only

任务所属的模块

module （字符串）
纯文本格式。不允许使用富文本或换行符。

示例 

Sample Content

created_date （datetime）read only

创建任务的日期和时间

created_date （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

created_by （用户）read only

创建任务的用户姓名和ID

created_by （用户）
创建任务的用户姓名和ID

示例 

{
  "created_by": {
    "email_id": "test@test.com",
    "name": "test_user",
    "id": "100000000000042013"
  }
}

estimated_effort （长整型）read only

完成任务所需的估计工作量

estimated_effort （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

overdue （布尔值）read only

指示任务是否逾期

overdue （布尔值）
布尔值，可能的取值为true和false

associated_entity （字符串）read only

与任务关联的实体

associated_entity （字符串）
纯文本格式。不允许使用富文本或换行符。

示例 

Sample Content

release （发布）read only

任务将要关联的发布实体。仅当任务与发布关联时才提供发布信息

release （发布）
任务将要关联的发布实体。仅当任务与发布关联时才提供发布信息

示例 

{
  "release": {
    "id": "100000000000042013"
  }
}


$ curl <service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks\
      -X POST\
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      -d input_data='{
    "task": {
        "template": {
      "name": "Default Task",
      "id": "1822002620872075"
    },
        "title": "Feature SRS",
        "estimated_effort_days": "",
        "estimated_effort_hours": "",
        "estimated_effort_minutes": "",
        "owner": {
            "id": "100000000000033531"
        },
        "marked_technician": null,
        "group": null,
        "marked_group": null,
        "task_type": null,
        "priority": null,
        "status": {
            "id": "100000000000005126"
        },
        "scheduled_start_time": null,
        "scheduled_end_time": null,
        "actual_start_time": null,
        "actual_end_time": null,
        "email_before": "0",
        "percentage_completion": "",
        "attachments": [],
        "additional_cost": "",
        "description": "<div class=\"personalize-wrapper\" style=\"font-family: 'PT Sans',Arial,Helvetica,sans-serif, sans-serif;font-size: 13px;\" > <div>SRS must contain all the requirements for the feature<br></div> </div>",
        "release_stage": {
            "id": "100000000000029003"
        },
        "udf_fields": {
                "udf_long1": "1563389026964443",
                "udf_date1": {
                "value": "1478758440000"
                },
                "udf_char1": "test-udf_char1"
            }
    }
}'

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
    "task": {
        "template": {
              "name": "Default Task",
              "id": "1822002620872075"
         },
        "title": "Feature SRS",
        "estimated_effort_days": "",
        "estimated_effort_hours": "",
        "estimated_effort_minutes": "",
        "owner": {
            "id": "100000000000033531"
        },
        "marked_technician": null,
        "group": null,
        "marked_group": null,
        "task_type": null,
        "priority": null,
        "status": {
            "id": "100000000000005126"
        },
        "scheduled_start_time": null,
        "scheduled_end_time": null,
        "actual_start_time": null,
        "actual_end_time": null,
        "email_before": "0",
        "percentage_completion": "",
        "attachments": [],
        "additional_cost": "",
        "description": "<div class=\"personalize-wrapper\" style=\"font-family: 'PT Sans',Arial,Helvetica,sans-serif, sans-serif;font-size: 13px;\" > <div>SRS must contain all the requirements for the feature<br></div> </div>",
        "release_stage": {
            "id": "100000000000029003"
        },
        "udf_fields": {
              "udf_long1": "1563389026964443",
              "udf_date1": {
            "value": "1478758440000"
              },
              "udf_char1": "test-udf_char1"
            }
    }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: POST
    parameters: params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
    "task": {
        "template": {
              "name": "Default Task",
              "id": "1822002620872075"
            },
        "title": "Feature SRS",
        "estimated_effort_days": "",
        "estimated_effort_hours": "",
        "estimated_effort_minutes": "",
        "owner": {
            "id": "100000000000033531"
        },
        "marked_technician": null,
        "group": null,
        "marked_group": null,
        "task_type": null,
        "priority": null,
        "status": {
            "id": "100000000000005126"
        },
        "scheduled_start_time": null,
        "scheduled_end_time": null,
        "actual_start_time": null,
        "actual_end_time": null,
        "email_before": "0",
        "percentage_completion": "",
        "attachments": [],
        "additional_cost": "",
        "description": "<div class=\"personalize-wrapper\" style=\"font-family: 'PT Sans',Arial,Helvetica,sans-serif, sans-serif;font-size: 13px;\" > <div>SRS must contain all the requirements for the feature<br></div> </div>",
        "release_stage": {
            "id": "100000000000029003"
        },
        "udf_fields": {
              "udf_long1": "1563389026964443",
              "udf_date1": {
            "value": "1478758440000"
              },
              "udf_char1": "test-udf_char1"
            }
    }
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method post -Body $data -Headers $headers
$response

#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
    "task": {
        "template": {
              "name": "Default Task",
              "id": "1822002620872075"
            },
        "title": "Feature SRS",
        "estimated_effort_days": "",
        "estimated_effort_hours": "",
        "estimated_effort_minutes": "",
        "owner": {
            "id": "100000000000033531"
        },
        "marked_technician": null,
        "group": null,
        "marked_group": null,
        "task_type": null,
        "priority": null,
        "status": {
            "id": "100000000000005126"
        },
        "scheduled_start_time": null,
        "scheduled_end_time": null,
        "actual_start_time": null,
        "actual_end_time": null,
        "email_before": "0",
        "percentage_completion": "",
        "attachments": [],
        "additional_cost": "",
        "description": "<div class=\"personalize-wrapper\" style=\"font-family: 'PT Sans',Arial,Helvetica,sans-serif, sans-serif;font-size: 13px;\" > <div>SRS must contain all the requirements for the feature<br></div> </div>",
        "release_stage": {
            "id": "100000000000029003"
        },
        "udf_fields": {
              "udf_long1": "1563389026964443",
              "udf_date1": {
            "value": "1478758440000"
              },
              "udf_char1": "test-udf_char1"
            }
    }
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="POST")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
    "task": {
        "template": {
              "inactive": false,
              "name": "Default Task",
              "id": "1822002620872075"
            },
        "percentage_completion": null,
        "estimated_effort_hours": null,
        "attachments": [],
        "email_before": "0",
        "release": {
            "display_id": {
                "display_value": "RL-1",
                "value": "1"
            },
            "id": "100000000000034001",
            "title": "Demo Release"
        },
        "description": "<div class=\"personalize-wrapper\" style=\"font-family: &quot;PT Sans&quot;, Arial, Helvetica, sans-serif, sans-serif; font-size: 13px\"> <div>SRS must contain all the requirements for the feature<br /><\/div> <\/div>",
        "title": "Feature SRS",
        "marked_technician": null,
        "overdue": false,
        "additional_cost": null,
        "actual_end_time": null,
        "id": "100000000000040029",
        "actual_start_time": null,
        "group": null,
        "owner": {
            "email_id": "test@test.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": "",
            "user_scope": "0",
            "phone": null,
            "name": "Test",
            "id": "100000000000033531",
            "photo_url": "https://contacts.zoho.com/file?sample",
            "is_vip_user": false,
            "department": null,
            "first_name": "Test",
            "job_title": null
        },
        "associated_entity": "release",
        "module": "Release",
        "index": 1,
        "priority": null,
        "created_by": {
            "email_id": "test@test.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": "",
            "user_scope": "0",
            "phone": null,
            "name": "Test",
            "id": "100000000000033531",
            "photo_url": "https://contacts.zoho.com/file?sample",
            "is_vip_user": false,
            "department": null,
            "first_name": "Test",
            "job_title": null
        },
        "scheduled_end_time": null,
        "marked_group": null,
        "estimated_effort_minutes": null,
        "udf_fields": {
              "udf_long1": "1563389026964443",
              "udf_date1": {
            "display_value": "Nov 10, 2016 11:44 AM",
            "value": "1478758440000"
              },
              "udf_char1": "test-udf_char1"
            },
        "site": "null",
        "release_stage": {
            "internal_name": "submission",
            "inactive": false,
            "stage_index": 1,
            "name": "Submission",
            "id": "100000000000029003"
        },
        "deleted": false,
        "estimated_effort": null,
        "created_date": {
            "display_value": "Jan 27, 2022 12:31 PM",
            "value": "1643266899411"
        },
        "estimated_effort_days": null,
        "task_type": null,
        "scheduled_start_time": null,
        "status": {
            "in_progress": true,
            "internal_name": "Open",
            "stop_timer": false,
            "color": "#0066ff",
            "name": "Open",
            "id": "100000000000005126"
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

编辑发布任务

此操作用于编辑或更新发布任务。

Url

<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks/{task_id}

属性

id （长整型）
用于识别任务的唯一标识符

id （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

标题 （字符串）
任务标题

标题 （字符串）
纯文本格式。不允许使用富文本或换行符。

示例 

CodeReviewTask

模板 （task_template）
表示用于创建此任务的模板

模板 （task_template）
表示用于创建此任务的模板

示例 

{
  "template": {
    "name": "test-template",
    "id": "234567890123456"
  }
}

描述 （html）
包含任务描述

描述 （html）
HTML 是一个文本区域，可使用 HTML 元素。

示例 

<b>The content to be displayed</b>

计划开始时间 （datetime）
任务计划开始的日期和时间

计划开始时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

计划结束时间 （datetime）
任务计划完成的日期和时间

计划结束时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

更多属性 全部展开

实际开始时间 （datetime）

任务实际开始的日期和时间

实际开始时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

实际结束时间 （datetime）

任务实际完成的日期和时间

实际结束时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

email_before （长整型）

指示在计划开始前以毫秒为单位发送通知的时间

email_before （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

percentage_completion （整数）

指示任务的完成百分比进度

percentage_completion （整数）
被认为数值较小的数字

示例 

39

additional_cost （双精度浮点数）

除任务实际成本外的开销

additional_cost （双精度浮点数）
可以包含小数的数字

示例 

23.08

estimated_effort_days （长整型）

估计完成任务所需的天数

estimated_effort_days （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

estimated_effort_hours （长整型）

估计完成任务所需的小时数

estimated_effort_hours （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

estimated_effort_minutes （长整型）

估计完成任务所需的分钟数

estimated_effort_minutes （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

status （状态）

指示任务的进展等级

status （状态）
指示任务的进展等级

示例 

{
  "status": {
    "name": "test_status",
    "id": "133333300000042011"
  }
}

group （组）

指派给发布任务的组

group （组）
指派给发布任务的组

示例 

{
  "group": {
    "name": "test_group",
    "id": "100333300111042099"
  }
}

owner （用户）

指派给任务的用户

owner （用户）
指派给任务的用户

示例 

{
  "owner": {
    "email_id": "test@test.com",
    "name": "test_user",
    "id": "100000000000042013"
  }
}

marked_technician （用户）

任务触发时指定的用户

marked_technician （用户）
任务触发时指定的用户

示例 

{
  "marked_techncian": {
    "email_id": "test@test.com",
    "name": "test_technician",
    "id": "100000000000042013"
  }
}

priority （优先级）

定义任务的紧急程度或重要性

priority （优先级）
定义任务的紧急程度或重要性

示例 

{
  "priority": {
    "name": "test_priority",
    "id": "1001100000042011"
  }
}

task_type （任务类型）

用于对类似案例的任务进行分类

task_type （任务类型）
用于对类似案例的任务进行分类

示例 

{
  "task_type": {
    "name": "test-task_type",
    "id": "234567890123456"
  }
}

attachments （附件）

附加到任务的文件。一个任务最多可附加10个文件

attachments （附件）
附加到任务的文件。一个任务最多可附加10个文件

示例 

{
  "attachments": {
    "name": "test_attachment_1",
    "id": "133333300000042011"
  }
}

udf_fields （自定义字段）

保存与任务相关的用户定义字段的值

udf_fields （自定义字段）
保存与任务相关的用户定义字段的值

示例 

{
  "udf_fields": {
    "udf_long2": "1225",
    "udf_long1": "1459402730964",
    "udf_date1": {
      "display_value": "Feb 26, 2016 11:00 AM",
      "value": "1456464639051"
    },
    "udf_char1": "abc@test.com",
    "udf_char2": "Ned Stark"
  }
}

module （字符串）read only

任务所属的模块

module （字符串）
纯文本格式。不允许使用富文本或换行符。

示例 

Sample Content

created_date （datetime）read only

创建任务的日期和时间

created_date （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

created_by （用户）read only

创建任务的用户姓名和ID

created_by （用户）
创建任务的用户姓名和ID

示例 

{
  "created_by": {
    "email_id": "test@test.com",
    "name": "test_user",
    "id": "100000000000042013"
  }
}

estimated_effort （长整型）read only

完成任务所需的估计工作量

estimated_effort （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

overdue （布尔值）read only

指示任务是否逾期

overdue （布尔值）
布尔值，可能的取值为true和false

associated_entity （字符串）read only

与任务关联的实体

associated_entity （字符串）
纯文本格式。不允许使用富文本或换行符。

示例 

Sample Content

release （发布）read only

任务将要关联的发布实体。仅当任务与发布关联时才提供发布信息

release （发布）
任务将要关联的发布实体。仅当任务与发布关联时才提供发布信息

示例 

{
  "release": {
    "id": "100000000000042013"
  }
}


$ curl <service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks/{task_id}\
      -X PUT\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      -d input_data='{
    "task": {
        "title": "Feature SRS",
        "estimated_effort_days": "",
        "estimated_effort_hours": "",
        "estimated_effort_minutes": "",
        "owner": null,
        "marked_technician": null,
        "group": {
            "id": "100000000000005176"
        },
        "marked_group": null,
        "task_type": {
            "id": "100000000000005405"
        },
        "priority": {
            "id": "100000000000005157"
        },
        "status": {
            "id": "100000000000005126"
        },
        "scheduled_start_time": {
            "value": "1643353740000"
        },
        "scheduled_end_time": null,
        "actual_start_time": null,
        "actual_end_time": null,
        "email_before": "0",
        "percentage_completion": "",
        "attachments": [],
        "additional_cost": "",
        "description": "<div class=\"personalize-wrapper\" style=\"font-family: &quot;PT Sans&quot;, Arial, Helvetica, sans-serif, sans-serif; font-size: 13px\"><div>SRS must contain all the requirements for the feature<br></div></div>"
    }
}'

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks/{task_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
    "task": {
        "title": "Feature SRS",
        "estimated_effort_days": "",
        "estimated_effort_hours": "",
        "estimated_effort_minutes": "",
        "owner": null,
        "marked_technician": null,
        "group": {
            "id": "100000000000005176"
        },
        "marked_group": null,
        "task_type": {
            "id": "100000000000005405"
        },
        "priority": {
            "id": "100000000000005157"
        },
        "status": {
            "id": "100000000000005126"
        },
        "scheduled_start_time": {
            "value": "1643353740000"
        },
        "scheduled_end_time": null,
        "actual_start_time": null,
        "actual_end_time": null,
        "email_before": "0",
        "percentage_completion": "",
        "attachments": [],
        "additional_cost": "",
        "description": "<div class=\"personalize-wrapper\" style=\"font-family: &quot;PT Sans&quot;, Arial, Helvetica, sans-serif, sans-serif; font-size: 13px\"><div>SRS must contain all the requirements for the feature<br></div></div>"
    }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: PUT
    parameters: params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks/{task_id}"
$headers = @{"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
$input_data = @'
{
    "task": {
        "title": "Feature SRS",
        "estimated_effort_days": "",
        "estimated_effort_hours": "",
        "estimated_effort_minutes": "",
        "owner": null,
        "marked_technician": null,
        "group": {
            "id": "100000000000005176"
        },
        "marked_group": null,
        "task_type": {
            "id": "100000000000005405"
        },
        "priority": {
            "id": "100000000000005157"
        },
        "status": {
            "id": "100000000000005126"
        },
        "scheduled_start_time": {
            "value": "1643353740000"
        },
        "scheduled_end_time": null,
        "actual_start_time": null,
        "actual_end_time": null,
        "email_before": "0",
        "percentage_completion": "",
        "attachments": [],
        "additional_cost": "",
        "description": "<div class=\"personalize-wrapper\" style=\"font-family: &quot;PT Sans&quot;, Arial, Helvetica, sans-serif, sans-serif; font-size: 13px\"><div>SRS must contain all the requirements for the feature<br></div></div>"
    }
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method put -Body $data -Headers $headers
$response

#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks/{task_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
    "task": {
        "title": "Feature SRS",
        "estimated_effort_days": "",
        "estimated_effort_hours": "",
        "estimated_effort_minutes": "",
        "owner": null,
        "marked_technician": null,
        "group": {
            "id": "100000000000005176"
        },
        "marked_group": null,
        "task_type": {
            "id": "100000000000005405"
        },
        "priority": {
            "id": "100000000000005157"
        },
        "status": {
            "id": "100000000000005126"
        },
        "scheduled_start_time": {
            "value": "1643353740000"
        },
        "scheduled_end_time": null,
        "actual_start_time": null,
        "actual_end_time": null,
        "email_before": "0",
        "percentage_completion": "",
        "attachments": [],
        "additional_cost": "",
        "description": "<div class=\"personalize-wrapper\" style=\"font-family: &quot;PT Sans&quot;, Arial, Helvetica, sans-serif, sans-serif; font-size: 13px\"><div>SRS must contain all the requirements for the feature<br></div></div>"
    }
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="PUT")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
    "task": {
        "template": {
              "inactive": false,
              "name": "Default Task",
              "id": "1822002620872075"
            },
        "percentage_completion": null,
        "estimated_effort_hours": null,
        "attachments": [],
        "email_before": "0",
        "release": {
            "display_id": {
                "display_value": "RL-1",
                "value": "1"
            },
            "id": "100000000000034001",
            "title": "Demo Release"
        },
        "description": "<div class=\"personalize-wrapper\" style=\"font-family: &quot;PT Sans&quot;, Arial, Helvetica, sans-serif, sans-serif; font-size: 13px\"><div>SRS must contain all the requirements for the feature<br /><\/div><\/div>",
        "title": "Feature SRS",
        "marked_technician": null,
        "overdue": false,
        "additional_cost": null,
        "actual_end_time": null,
        "id": "100000000000040029",
        "actual_start_time": null,
        "group": {
            "site": null,
            "deleted": false,
            "name": "Printer Problems",
            "id": "100000000000005176"
        },
        "owner": null,
        "associated_entity": "release",
        "module": "Release",
        "index": 1,
        "priority": {
            "color": "#ff6600",
            "name": "Medium",
            "id": "100000000000005157"
        },
        "created_by": {
            "email_id": "test@test.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": "",
            "user_scope": "0",
            "phone": null,
            "name": "Test",
            "id": "100000000000033531",
            "photo_url": "https://contacts.zoho.com/file?sample",
            "is_vip_user": false,
            "department": null,
            "first_name": "Test",
            "job_title": null
        },
        "scheduled_end_time": null,
        "marked_group": null,
        "estimated_effort_minutes": null,
        "site": "null",
        "release_stage": {
            "internal_name": "submission",
            "inactive": false,
            "stage_index": 1,
            "name": "Submission",
            "id": "100000000000029003"
        },
        "deleted": false,
        "estimated_effort": null,
        "created_date": {
            "display_value": "Jan 27, 2022 12:31 PM",
            "value": "1643266899411"
        },
        "estimated_effort_days": null,
        "udf_fields": {
              "udf_long1": "1563389026964443",
              "udf_date1": {
            "display_value": "Nov 10, 2016 11:44 AM",
            "value": "1478758440000"
              },
              "udf_char1": "test-udf_char1"
            },
        "task_type": {
            "color": "#ff6600",
            "name": "Maintenance",
            "id": "100000000000005405"
        },
        "scheduled_start_time": {
            "display_value": "Jan 28, 2022 12:39 PM",
            "value": "1643353740000"
        },
        "status": {
            "in_progress": true,
            "internal_name": "Open",
            "stop_timer": false,
            "color": "#0066ff",
            "name": "Open",
            "id": "100000000000005126"
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

获取发布任务

此操作用于获取发布任务。

Url

<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks/{task_id}

属性

id （长整型）
用于识别任务的唯一标识符

id （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

标题 （字符串）
任务标题

标题 （字符串）
纯文本格式。不允许使用富文本或换行符。

示例 

CodeReviewTask

模板 （task_template）
表示用于创建此任务的模板

模板 （task_template）
表示用于创建此任务的模板

示例 

{
  "template": {
    "name": "test-template",
    "id": "234567890123456"
  }
}

描述 （html）
包含任务描述

描述 （html）
HTML 是一个文本区域，可使用 HTML 元素。

示例 

<b>The content to be displayed</b>

计划开始时间 （datetime）
任务计划开始的日期和时间

计划开始时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

计划结束时间 （datetime）
任务计划完成的日期和时间

计划结束时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

更多属性 全部展开

实际开始时间 （datetime）

任务实际开始的日期和时间

实际开始时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

实际结束时间 （datetime）

任务实际完成的日期和时间

实际结束时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

email_before （长整型）

指示在计划开始前以毫秒为单位发送通知的时间

email_before （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

percentage_completion （整数）

指示任务的完成百分比进度

percentage_completion （整数）
被认为数值较小的数字

示例 

39

additional_cost （双精度浮点数）

除任务实际成本外的开销

additional_cost （双精度浮点数）
可以包含小数的数字

示例 

23.08

estimated_effort_days （长整型）

估计完成任务所需的天数

estimated_effort_days （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

estimated_effort_hours （长整型）

估计完成任务所需的小时数

estimated_effort_hours （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

estimated_effort_minutes （长整型）

估计完成任务所需的分钟数

estimated_effort_minutes （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

status （状态）

指示任务的进展等级

status （状态）
指示任务的进展等级

示例 

{
  "status": {
    "name": "test_status",
    "id": "133333300000042011"
  }
}

group （组）

指派给发布任务的组

group （组）
指派给发布任务的组

示例 

{
  "group": {
    "name": "test_group",
    "id": "100333300111042099"
  }
}

owner （用户）

指派给任务的用户

owner （用户）
指派给任务的用户

示例 

{
  "owner": {
    "email_id": "test@test.com",
    "name": "test_user",
    "id": "100000000000042013"
  }
}

marked_technician （用户）

任务触发时指定的用户

marked_technician （用户）
任务触发时指定的用户

示例 

{
  "marked_techncian": {
    "email_id": "test@test.com",
    "name": "test_technician",
    "id": "100000000000042013"
  }
}

priority （优先级）

定义任务的紧急程度或重要性

priority （优先级）
定义任务的紧急程度或重要性

示例 

{
  "priority": {
    "name": "test_priority",
    "id": "1001100000042011"
  }
}

task_type （任务类型）

用于对类似案例的任务进行分类

task_type （任务类型）
用于对类似案例的任务进行分类

示例 

{
  "task_type": {
    "name": "test-task_type",
    "id": "234567890123456"
  }
}

attachments （附件）

附加到任务的文件。一个任务最多可附加10个文件

attachments （附件）
附加到任务的文件。一个任务最多可附加10个文件

示例 

{
  "attachments": {
    "name": "test_attachment_1",
    "id": "133333300000042011"
  }
}

udf_fields （自定义字段）

保存与任务相关的用户定义字段的值

udf_fields （自定义字段）
保存与任务相关的用户定义字段的值

示例 

{
  "udf_fields": {
    "udf_long2": "1225",
    "udf_long1": "1459402730964",
    "udf_date1": {
      "display_value": "Feb 26, 2016 11:00 AM",
      "value": "1456464639051"
    },
    "udf_char1": "abc@test.com",
    "udf_char2": "Ned Stark"
  }
}

module （字符串）read only

任务所属的模块

module （字符串）
纯文本格式。不允许使用富文本或换行符。

示例 

Sample Content

created_date （datetime）read only

创建任务的日期和时间

created_date （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

created_by （用户）read only

创建任务的用户姓名和ID

created_by （用户）
创建任务的用户姓名和ID

示例 

{
  "created_by": {
    "email_id": "test@test.com",
    "name": "test_user",
    "id": "100000000000042013"
  }
}

estimated_effort （长整型）read only

完成任务所需的估计工作量

estimated_effort （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

overdue （布尔值）read only

指示任务是否逾期

overdue （布尔值）
布尔值，可能的取值为true和false

associated_entity （字符串）read only

与任务关联的实体

associated_entity （字符串）
纯文本格式。不允许使用富文本或换行符。

示例 

Sample Content

release （发布）read only

任务将要关联的发布实体。仅当任务与发布关联时才提供发布信息

release （发布）
任务将要关联的发布实体。仅当任务与发布关联时才提供发布信息

示例 

{
  "release": {
    "id": "100000000000042013"
  }
}


$ curl -G <service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks/{task_id}\
      -X GET\
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks/{task_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};          
response = invokeurl
[
    url: url
    type: GET
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks/{task_id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}  
$response = Invoke-RestMethod -Uri $url -Method get -Headers $headers 
$response

#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks/{task_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
httprequest = Request(url, headers=headers)
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
    "task": {
        "template": {
              "inactive": false,
              "name": "Default Task",
              "id": "1822002620872075"
            },
        "percentage_completion": null,
        "estimated_effort_hours": null,
        "attachments": [],
        "email_before": "0",
        "release": {
            "display_id": {
                "display_value": "RL-1",
                "value": "1"
            },
            "id": "100000000000034001",
            "title": "Demo Release"
        },
        "description": "<div class=\"personalize-wrapper\" style=\"font-family: &quot;PT Sans&quot;, Arial, Helvetica, sans-serif, sans-serif; font-size: 13px\"><div>SRS must contain all the requirements for the feature<br /></div></div>",
        "title": "Feature SRS",
        "marked_technician": null,
        "overdue": false,
        "additional_cost": null,
        "actual_end_time": null,
        "id": "100000000000040029",
        "actual_start_time": null,
        "group": {
            "site": null,
            "deleted": false,
            "name": "Printer Problems",
            "id": "100000000000005176"
        },
        "owner": null,
        "associated_entity": "release",
        "module": "Release",
        "index": 1,
        "priority": {
            "color": "#ff6600",
            "name": "Medium",
            "id": "100000000000005157"
        },
        "created_by": {
            "email_id": "test@test.com",
            "is_technician": true,
            "sms_mail": null,
            "mobile": null,
            "last_name": "",
            "user_scope": "0",
            "phone": null,
            "name": "Test",
            "id": "100000000000033531",
            "photo_url": "https://contacts.zoho.com/file?sample",
            "is_vip_user": false,
            "department": null,
            "first_name": "Test",
            "job_title": null
        },
        "scheduled_end_time": null,
        "marked_group": null,
        "estimated_effort_minutes": null,
        "udf_fields": {
              "udf_long1": "1563389026964443",
              "udf_date1": {
            "display_value": "Nov 10, 2016 11:44 AM",
            "value": "1478758440000"
              },
              "udf_char1": "test-udf_char1"
            },
        "site": "null",
        "release_stage": {
            "internal_name": "submission",
            "inactive": false,
            "stage_index": 1,
            "name": "Submission",
            "id": "100000000000029003"
        },
        "deleted": false,
        "estimated_effort": null,
        "created_date": {
            "display_value": "Jan 27, 2022 12:31 PM",
            "value": "1643266899411"
        },
        "estimated_effort_days": null,
        "task_type": {
            "color": "#ff6600",
            "name": "Maintenance",
            "id": "100000000000005405"
        },
        "scheduled_start_time": {
            "display_value": "Jan 28, 2022 12:39 PM",
            "value": "1643353740000"
        },
        "status": {
            "in_progress": true,
            "internal_name": "Open",
            "stop_timer": false,
            "color": "#0066ff",
            "name": "Open",
            "id": "100000000000005126"
        }
    },
    "response_status": {
        "status_code": 2000,
        "status": "success"
    }
}

获取发布任务列表

此操作用于获取所有发布任务的列表。

Url

<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks

属性

id （长整型）
用于识别任务的唯一标识符

id （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

标题 （字符串）
任务标题

标题 （字符串）
纯文本格式。不允许使用富文本或换行符。

示例 

CodeReviewTask

模板 （task_template）
表示用于创建此任务的模板

模板 （task_template）
表示用于创建此任务的模板

示例 

{
  "template": {
    "name": "test-template",
    "id": "234567890123456"
  }
}

描述 （html）
包含任务描述

描述 （html）
HTML 是一个文本区域，可使用 HTML 元素。

示例 

<b>The content to be displayed</b>

计划开始时间 （datetime）
任务计划开始的日期和时间

计划开始时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

计划结束时间 （datetime）
任务计划完成的日期和时间

计划结束时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

更多属性 全部展开

实际开始时间 （datetime）

任务实际开始的日期和时间

实际开始时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

实际结束时间 （datetime）

任务实际完成的日期和时间

实际结束时间 （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

email_before （长整型）

指示在计划开始前以毫秒为单位发送通知的时间

email_before （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

percentage_completion （整数）

指示任务的完成百分比进度

percentage_completion （整数）
被认为数值较小的数字

示例 

39

additional_cost （双精度浮点数）

除任务实际成本外的开销

additional_cost （双精度浮点数）
可以包含小数的数字

示例 

23.08

estimated_effort_days （长整型）

估计完成任务所需的天数

estimated_effort_days （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

estimated_effort_hours （长整型）

估计完成任务所需的小时数

estimated_effort_hours （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

estimated_effort_minutes （长整型）

估计完成任务所需的分钟数

estimated_effort_minutes （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

status （状态）

指示任务的进展等级

status （状态）
指示任务的进展等级

示例 

{
  "status": {
    "name": "test_status",
    "id": "133333300000042011"
  }
}

group （组）

指派给发布任务的组

group （组）
指派给发布任务的组

示例 

{
  "group": {
    "name": "test_group",
    "id": "100333300111042099"
  }
}

owner （用户）

指派给任务的用户

owner （用户）
指派给任务的用户

示例 

{
  "owner": {
    "email_id": "test@test.com",
    "name": "test_user",
    "id": "100000000000042013"
  }
}

marked_technician （用户）

任务触发时指定的用户

marked_technician （用户）
任务触发时指定的用户

示例 

{
  "marked_techncian": {
    "email_id": "test@test.com",
    "name": "test_technician",
    "id": "100000000000042013"
  }
}

priority （优先级）

定义任务的紧急程度或重要性

priority （优先级）
定义任务的紧急程度或重要性

示例 

{
  "priority": {
    "name": "test_priority",
    "id": "1001100000042011"
  }
}

task_type （任务类型）

用于对类似案例的任务进行分类

task_type （任务类型）
用于对类似案例的任务进行分类

示例 

{
  "task_type": {
    "name": "test-task_type",
    "id": "234567890123456"
  }
}

attachments （附件）

附加到任务的文件。一个任务最多可附加10个文件

attachments （附件）
附加到任务的文件。一个任务最多可附加10个文件

示例 

{
  "attachments": {
    "name": "test_attachment_1",
    "id": "133333300000042011"
  }
}

udf_fields （自定义字段）

保存与任务相关的用户定义字段的值

udf_fields （自定义字段）
保存与任务相关的用户定义字段的值

示例 

{
  "udf_fields": {
    "udf_long2": "1225",
    "udf_long1": "1459402730964",
    "udf_date1": {
      "display_value": "Feb 26, 2016 11:00 AM",
      "value": "1456464639051"
    },
    "udf_char1": "abc@test.com",
    "udf_char2": "Ned Stark"
  }
}

module （字符串）read only

任务所属的模块

module （字符串）
纯文本格式。不允许使用富文本或换行符。

示例 

Sample Content

created_date （datetime）read only

创建任务的日期和时间

created_date （datetime）
以 JSON 对象表示日期/时间。包含 value 和 display_value 属性。

值 ：以长整型格式表示的时间（自 1970 年 1 月 1 日起的毫秒数）。

显示值 ：以用户个性化格式的可读形式显示时间。如果未个性化，则使用默认格式。

created_by （用户）read only

创建任务的用户姓名和ID

created_by （用户）
创建任务的用户姓名和ID

示例 

{
  "created_by": {
    "email_id": "test@test.com",
    "name": "test_user",
    "id": "100000000000042013"
  }
}

estimated_effort （长整型）read only

完成任务所需的估计工作量

estimated_effort （长整型）
被认为具有较大数值的数字位数。

示例 

234759602834500

overdue （布尔值）read only

指示任务是否逾期

overdue （布尔值）
布尔值，可能的取值为true和false

associated_entity （字符串）read only

与任务关联的实体

associated_entity （字符串）
纯文本格式。不允许使用富文本或换行符。

示例 

Sample Content

release （发布）read only

任务将要关联的发布实体。仅当任务与发布关联时才提供发布信息

release （发布）
任务将要关联的发布实体。仅当任务与发布关联时才提供发布信息

示例 

{
  "release": {
    "id": "100000000000042013"
  }
}


$ curl -G <service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks\
      -X GET\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      --data-urlencode input_data='{}'

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {};
params = {"input_data":input_data};           
response = invokeurl
[
    url: url
    type: GET
    parameters:params
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'{}'@
$data = @{ 'input_data' = $input_data}    
$response = Invoke-RestMethod -Uri $url -Method get -Body $data -Headers $headers 
$response

#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{}'''       
url += "?" + urlencode({"input_data":input_data})
httprequest = Request(url, headers=headers)
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
    "response_status": [{
        "status_code": 2000,
        "status": "success"
    }],
    "list_info": {
        "has_more_rows": false,
        "row_count": 2
    },
    "tasks": [{
        "template": {
          "inactive": false,
          "name": "Default Task",
          "id": "1822002620872075"
        },
            "percentage_completion": null,
            "estimated_effort_hours": null,
            "email_before": "0",
            "release": {
                "display_id": {
                    "display_value": "RL-1",
                    "value": "1"
                },
                "id": "100000000000034001",
                "title": "Demo Release"
            },
            "description": "SRS must contain all the requirements for the feature",
            "title": "Feature SRS",
            "marked_technician": null,
            "overdue": false,
            "additional_cost": null,
            "actual_end_time": null,
            "id": "100000000000040029",
            "actual_start_time": null,
            "group": {
                "site": null,
                "deleted": false,
                "name": "Printer Problems",
                "id": "100000000000005176"
            },
            "owner": null,
            "associated_entity": "release",
            "module": "Release",
            "index": 1,
            "priority": {
                "color": "#ff6600",
                "name": "Medium",
                "id": "100000000000005157"
            },
            "created_by": {
                "email_id": "pratiush.narayan@zohotest.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "",
                "user_scope": "0",
                "phone": null,
                "name": "Pratiush",
                "id": "100000000000033531",
                "photo_url": "https://contacts.zoho.com/file?sample",
                "is_vip_user": false,
                "department": null,
                "first_name": "Pratiush",
                "job_title": null
            },
            "scheduled_end_time": null,
            "marked_group": null,
            "estimated_effort_minutes": null,
            "site": "null",
            "release_stage": {
                "internal_name": "submission",
                "inactive": false,
                "stage_index": 1,
                "name": "Submission",
                "id": "100000000000029003"
            },
            "deleted": false,
            "estimated_effort": null,
            "created_date": {
                "display_value": "Jan 27, 2022 12:31 PM",
                "value": "1643266899411"
            },
            "estimated_effort_days": null,
            "udf_fields": {
                  "udf_long1": "1563389026964443",
                  "udf_date1": {
                "display_value": "Nov 10, 2016 11:44 AM",
                "value": "1478758440000"
                  },
                  "udf_char1": "test-udf_char1"
                },
            "task_type": {
                "color": "#ff6600",
                "name": "Maintenance",
                "id": "100000000000005405"
            },
            "scheduled_start_time": {
                "display_value": "Jan 28, 2022 12:39 PM",
                "value": "1643353740000"
            },
            "status": {
                "in_progress": true,
                "internal_name": "Open",
                "stop_timer": false,
                "color": "#0066ff",
                "name": "Open",
                "id": "100000000000005126"
            }
        },
        {
            "template": {
                  "inactive": false,
                  "name": "Default Task",
                  "id": "1822002620872075"
                },
            "percentage_completion": null,
            "estimated_effort_hours": null,
            "email_before": "0",
            "release": {
                "display_id": {
                    "display_value": "RL-1",
                    "value": "1"
                },
                "id": "100000000000034001",
                "title": "Demo Release"
            },
            "description": "Task to create validation plans",
            "title": "Validation plan",
            "marked_technician": null,
            "overdue": false,
            "additional_cost": null,
            "actual_end_time": null,
            "id": "100000000000040064",
            "actual_start_time": null,
            "group": null,
            "owner": null,
            "associated_entity": "release",
            "module": "Release",
            "index": 1,
            "priority": {
                "color": "#ff0000",
                "name": "High",
                "id": "100000000000005139"
            },
            "created_by": {
                "email_id": "pratiush.narayan@zohotest.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "",
                "user_scope": "0",
                "phone": null,
                "name": "Pratiush",
                "id": "100000000000033531",
                "photo_url": "https://contacts.zoho.com/file?sample",
                "is_vip_user": false,
                "department": null,
                "first_name": "Pratiush",
                "job_title": null
            },
            "scheduled_end_time": null,
            "marked_group": null,
            "estimated_effort_minutes": null,
            "udf_fields": {
                  "udf_long1": "1563389026964443",
                  "udf_date1": {
                "display_value": "Nov 10, 2016 11:44 AM",
                "value": "1478758440000"
                  },
                  "udf_char1": "test-udf_char1"
                },
            "site": "null",
            "release_stage": {
                "internal_name": "planning",
                "inactive": false,
                "stage_index": 2,
                "name": "Planning",
                "id": "100000000000029042"
            },
            "deleted": false,
            "estimated_effort": null,
            "created_date": {
                "display_value": "Jan 27, 2022 12:52 PM",
                "value": "1643268162007"
            },
            "estimated_effort_days": null,
            "task_type": null,
            "scheduled_start_time": null,
            "status": {
                "in_progress": true,
                "internal_name": "Open",
                "stop_timer": false,
                "color": "#0066ff",
                "name": "Open",
                "id": "100000000000005126"
            }
        }
    ]
}

删除发布任务

此操作用于删除发布任务。

Url

<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks/{task_id}


$ curl <service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks/{task_id}\
      -X DELETE\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks/{task_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
response = invokeurl
[
    url: url
    type: DELETE
    headers: headers
];
info response;

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks/{task_id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$response = Invoke-RestMethod -Uri $url -Method delete -Headers $headers
$response

#Python version - 3.10
from urllib.error import HTTPError
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/releases/{release_id}/tasks/{task_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
httprequest = Request(url, headers=headers,method="DELETE")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())

{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}