merge

Author: chenxingyu-leopro

go.mod

@@ -1,3 +1,5 @@
 module github.com/larksuite/project-oapi-sdk-golang
 
-go 1.15
+go 1.22.0
+
+toolchain go1.22.2

service/workitem/api.go

@@ -77,6 +77,8 @@ const APIPathUpdateWorkingHourRecord = "/open_api/:project_key/work_item/:work_i
 
 const APIPathWbsView = "/open_api/:project_key/work_item/:work_item_type_key/:work_item_id/wbs_view"
 
+const APIPath_UniversalSearch = "/open_api/view_search/universal_search"
+
 func NewService(config *core.Config) *WorkItemService {
 	a := &WorkItemService{config: config}
 	return a
@@ -598,3 +600,27 @@ func (a *WorkItemService) WbsView(ctx context.Context, req *WbsViewReq, options
 	}
 	return resp, err
 }
+
+/*
+ * @name: openapi获取指定的工作项列表（极简链路，替代原有的GeneralSearch系列）
+ * @desc: openapi获取指定的工作项列表（极简链路，替代原有的GeneralSearch系列）
+ */
+func (a *WorkItemService) UniversalSearch(ctx context.Context, req *UniversalSearchReq, options ...core.RequestOptionFunc) (*UniversalSearchResp, error) {
+	// 发起请求
+	apiReq := req.apiReq
+	apiReq.ApiPath = APIPath_UniversalSearch
+	apiReq.HttpMethod = "POST"
+	apiResp, err := core.Request(ctx, apiReq, a.config, options...)
+	if err != nil {
+		a.config.Logger.Error(ctx, fmt.Sprintf("[UniversalSearch] fail to invoke api, error: %v", err.Error()))
+		return nil, err
+	}
+	// 反序列响应结果
+	resp := &UniversalSearchResp{APIResp: apiResp}
+	err = apiResp.JSONUnmarshalBody(resp, a.config)
+	if err != nil {
+		a.config.Logger.Error(ctx, fmt.Sprintf("[UniversalSearch] fail to unmarshal response body, error: %v", err.Error()))
+		return nil, err
+	}
+	return resp, err
+}

service/workitem/builder.go

@@ -1790,3 +1790,79 @@ func (builder *WbsViewReqBuilder) Build() *WbsViewReq {
 	req.apiReq.Body = builder.body
 	return req
 }
+
+type UniversalSearchReq struct {
+	apiReq *core.APIReq
+}
+type UniversalSearchReqBody struct {
+	DataSources []DataSource `json:"data_sources,omitempty"`
+
+	UserKey *string `json:"user_key,omitempty"`
+
+	SearchGroup *SearchGroup `json:"search_group,omitempty"`
+
+	Sort *Sort `json:"sort,omitempty"`
+
+	Pagination *Pagination `json:"pagination,omitempty"`
+
+	FieldSelected []string `json:"field_selected,omitempty"`
+
+	Features map[string]string `json:"features,omitempty"`
+}
+
+type UniversalSearchResp struct {
+	*core.APIResp `json:"-"`
+	core.CodeError
+	Data *string `json:"data,omitempty"`
+
+	Pagination *Pagination `json:"pagination,omitempty"`
+
+	ExtraInfo map[string]string `json:"extra_info,omitempty"`
+}
+
+type UniversalSearchReqBuilder struct {
+	apiReq *core.APIReq
+}
+
+func NewUniversalSearchReqBuilder() *UniversalSearchReqBuilder {
+	builder := &UniversalSearchReqBuilder{}
+	builder.apiReq = &core.APIReq{
+		PathParams:  core.PathParams{},
+		QueryParams: core.QueryParams{},
+		Body:        &UniversalSearchReqBody{},
+	}
+	return builder
+}
+func (builder *UniversalSearchReqBuilder) DataSources(dataSources []DataSource) *UniversalSearchReqBuilder {
+	builder.apiReq.Body.(*UniversalSearchReqBody).DataSources = dataSources
+	return builder
+}
+func (builder *UniversalSearchReqBuilder) UserKey(userKey *string) *UniversalSearchReqBuilder {
+	builder.apiReq.Body.(*UniversalSearchReqBody).UserKey = userKey
+	return builder
+}
+func (builder *UniversalSearchReqBuilder) SearchGroup(searchGroup *SearchGroup) *UniversalSearchReqBuilder {
+	builder.apiReq.Body.(*UniversalSearchReqBody).SearchGroup = searchGroup
+	return builder
+}
+func (builder *UniversalSearchReqBuilder) Sort(sort *Sort) *UniversalSearchReqBuilder {
+	builder.apiReq.Body.(*UniversalSearchReqBody).Sort = sort
+	return builder
+}
+func (builder *UniversalSearchReqBuilder) Pagination(pagination *Pagination) *UniversalSearchReqBuilder {
+	builder.apiReq.Body.(*UniversalSearchReqBody).Pagination = pagination
+	return builder
+}
+func (builder *UniversalSearchReqBuilder) FieldSelected(fieldSelected []string) *UniversalSearchReqBuilder {
+	builder.apiReq.Body.(*UniversalSearchReqBody).FieldSelected = fieldSelected
+	return builder
+}
+func (builder *UniversalSearchReqBuilder) Features(features map[string]string) *UniversalSearchReqBuilder {
+	builder.apiReq.Body.(*UniversalSearchReqBody).Features = features
+	return builder
+}
+func (builder *UniversalSearchReqBuilder) Build() *UniversalSearchReq {
+	req := &UniversalSearchReq{}
+	req.apiReq = builder.apiReq
+	return req
+}

service/workitem/model.go

@@ -612,3 +612,29 @@ type InstanceDeliverableItem struct {
 
 	Remark string `json:"remark"`
 }
+
+type DataSource struct {
+	ProjectKey *string `json:"project_key,omitempty"`
+
+	WorkItemTypeKeys *string `json:"work_item_type_keys,omitempty"`
+}
+
+type Sort struct {
+	FieldKey *string `json:"field_key,omitempty"`
+
+	FieldType *string `json:"field_type,omitempty"`
+
+	WorkItemTypeKey *string `json:"work_item_type_key,omitempty"`
+
+	Order *string `json:"order,omitempty"`
+
+	Params map[string]string `json:"params,omitempty"`
+}
+
+type Pagination struct {
+	PageNum *int64 `json:"page_num,omitempty"`
+
+	PageSize *int64 `json:"page_size,omitempty"`
+
+	Total *int64 `json:"total,omitempty"`
+}