workfront-sdk 0.22.1

安装

通过pip：

$ pip install workfront-sdk

从源安装：

$ git clone git://github.com/BridgeMarketing/workfront-sdk.git
$cd workfront-sdk
$ python setup.py install

示例

如何创建Workfront服务对象

创建workfront对象并登录：

>>> fromworkfrontimportWorkfront>>> wf=Workfront("ay.caramba@thebridgecorp.com","1234wfpass")>>> wf.login()

那你就可以用了。

如何创建用户对象

使用Workfront服务对象，您可以通过电子邮件或ID创建用户：

>>> fromworkfront.objectsimportuser>>> user_by_email=user.from_email(wf,"ay.caramba@thebridgecorp.com")>>> user_by_id=user.from_id(wf,"<WORKFRONT_USER_ID>")

然后您可以访问用户的某些字段：

>>> printuser_by_email.wf_id# print the workfront id>>> printuser_by_email.name# print the name of the user>>> printuser_by_email.emailAddr# print the email of the user

如何创建任务并与之交互

根据工作区ID创建任务并提供工作区服务

>>> fromworkfront.objects.taskimportWFTask>>> task=WFTask(wf,"<WF_TASK_ID>")

更改任务的状态

>>> fromworkfront.objects.statusimportWFTaskStatus>>> task.set_status(WFTaskStatus.in_progress)

将任务分配给其他用户

一旦有了wf用户和任务，您就可以：

>>> fromworkfront.objectsimportuser>>> fromworkfront.objects.taskimportWFTask>>> user_by_email=user.from_email(wf,"ay.caramba@thebridgecorp.com")>>> task=WFTask(wf,"<WF_TASK_ID>")>>> task.assign_to_user(user_by_email)

获取并设置自定义字段

可以使用方法set_param_values和get_param_values修改和访问任务自定义字段。

>>> task=WFTask(wf,"<WF_TASK_ID>")>>> task.get_param_values()>>> {"custom_field":"value","list_field":["value1","value2"]}>>> task.set_param_values({"custom_field":"other_value"})>>> task.get_param_values()>>> {"custom_field":"other_value","list_field":["value1","value2"]}

如何使用项目

您可以从id加载项目，并访问模板id:

>>> fromworkfront.objectsimportproject>>> p=project.WFProject(wf,"<WF_PROJECT_ID>")>>> project_template_id=p.get_template_id()

使用模板ID，您可以创建另一个项目：

>>> fromworkfront.objectsimportproject>>> new_project=project.crt_from_template(wf,project_template_id,"NEW PROJECT NAME")>>> new_project.wf_id