rest - 如何使用 workfront api 将小时对象添加到任务中？

Question

我想编写一个休息客户端，它将增加特定工作前任务的时间。即添加更多这些：

但是，文档对此并不是很清楚。他们对任何 TBF 都不是很清楚，它只是一个对象列表，没有如何关联它们的示例。这就像试图用一本字典来学习西班牙语！

我试图做一个新小时的POST：

POST https://company.attask-ondemand.com/attask/api/v7.0/hour?apiKey=<api key>

身体

{
    "objCode": "HOUR",
    "entryDate": "2018-01-18",
    "hours": 1,
    "status": "SUB",
    "taskID" : "<task id>"
}

但我从工作区得到的只是：

{
    "data": {
        "objCode": "HOUR",
        "ID": null
    }
}

有趣的是，如果我搜索任务的时间：

GET https://company.attask-ondemand.com/attask/api/v7.0/hour/search?taskID=<task ID>&apiKey=<api key>

我回来了几个小时，但它们不包含任何 TaskId：

{
    "data": [
        {
            "ID": "<id>",
            "objCode": "HOUR",
            "entryDate": "2018-01-16",
            "hours": 3,
            "status": "SUB"
        },
        {
            "ID": "<id>",
            "objCode": "HOUR",
            "entryDate": "2018-01-15",
            "hours": 1,
            "status": "SUB"
        },
        {
            "ID": "<id>",
            "objCode": "HOUR",
            "entryDate": "2018-01-18",
            "hours": 0.75,
            "status": "SUB"
        }
    ]
}

即使文档声明该对象包含一个taskId字段？

有没有人有这方面的经验？如何向 Task 对象添加新的 Hour？

Answer 1

您快到了。您只需要发送更多数据。我不确定最低必填字段是什么，但我能够在给定用户下为给定日期的给定任务记录 1 小时，并让它出现在任务下就好了。

POST https://x.my.workfront.com/attask/api/v7.0/hour?taskID=<id of task>&ownerID=<user to log hours under>&hours=1.0&entryDate=2017-12-27&apiKey=<key>"

请注意，您可以传递其他有效的 ID 类型（例如问题），而不是 TaskID。