云效使用ListWorkitems接口查询本月完成的工作项参数怎么设置?

在使用ListWorkitems接口查询本月完成的工作项时，你需要设置查询参数。

以下是一个示例的Python代码片段，演示如何使用云效SDK查询本月完成的工作项：

from yunji.client import YunJiClient
from datetime import datetime, timedelta

# 云效的Access Key ID和Access Key Secret
access_key_id = 'YOUR_ACCESS_KEY_ID'
access_key_secret = 'YOUR_ACCESS_KEY_SECRET'

# 创建云效客户端实例
client = YunJiClient(access_key_id, access_key_secret)

# 获取当前日期和时间
now = datetime.now()

# 计算上个月的开始和结束日期
start_date = now.replace(day=1, month=now.month-1, hour=0, minute=0, second=0, microsecond=0)
end_date = now.replace(day=1, month=now.month, hour=23, minute=59, second=59, microsecond=999999)

# 设置查询参数
query_params = {
    'status': 'completed',  # 工作项状态为已完成
    'startDate': start_date.strftime('%Y-%m-%d'),  # 开始日期为上月的第一天
    'endDate': end_date.strftime('%Y-%m-%d')  # 结束日期为上月的最后一天
}

# 调用ListWorkitems接口查询工作项
workitems = client.list_workitems(query_params)

# 打印查询结果
for workitem in workitems:
    print(workitem)

在上述代码中，你需要将YOUR_ACCESS_KEY_ID和YOUR_ACCESS_KEY_SECRET替换为你自己的云效访问密钥。然后，使用提供的日期和时间信息计算了上个月的开始和结束日期，并设置了相应的查询参数。最后，通过调用list_workitems方法执行查询操作，并将结果打印出来。

页面筛选获取conditons的条件
在页面上爬取conditon：1.打开开发者工具，在页面上制造出自己想要的过滤条件，然后粘贴这些数据 。2.有编码的话，可以在网站https://www.hake.cc/tools/urlencode/ 这里面URLdecode解除编码 去除%22 3.conditions里面有人员的话是userid，需要将人员类型的数据转化为aliyunPk。此回答整理自钉群“云效API反馈（外部用户）”

要使用云效的ListWorkitems接口查询本月完成的工作项，您需要设置conditions参数以过滤出满足特定条件的工作项。在这个例子中，我们希望筛选出在当前月份内已经完成的工作项。

通常，您可以将以下参数放入conditions对象中：

1. 状态（status）：设置为已完成的状态值，例如 "Done" 或者您的工作流中表示完成的其他状态。
2. 日期范围（时间属性）：指定开始和结束日期，以便只包含本月的工作项。这可能涉及到创建日期、更新日期或完成日期等字段，具体取决于您的需求和云效实例中的可用字段。

以下是一个示例请求结构，假设我们使用的是JSON格式，并且有一个名为finishedAt的时间属性代表工作项完成日期：

{
  "pageNumber": 1,
  "pageSize": 50, // 根据实际需求调整每页显示的数量
  "sortType": 1, // 排序类型，如按更新时间排序
  "conditions": [
    {
      "field": "status",
      "operator": "=",
      "value": "Done"
    },
    {
      "field": "finishedAt",
      "operator": ">=",
      "value": "YYYY-MM-01T00:00:00Z", // 替换为当月的第一天
      "type": "date"
    },
    {
      "field": "finishedAt",
      "operator": "<=",
      "value": "YYYY-MM-DDT23:59:59Z", // 替换为当月的最后一天
      "type": "date"
    }
  ]
}

请注意，上述示例中的YYYY-MM-DD部分需要替换为实际的年份、月份和日期。此外，根据云效的具体实现，日期格式可能会有所不同，因此请确保使用的日期格式与API文档中描述的格式相匹配。