包信息
| 属性 | 值 |
|---|---|
| NuGet 包 | Bitzsoft.Integrations.TeamWork.Weaver |
| Provider ID | weaver |
| 鉴权方式 | REST 集成许可证 AppId(E9 异构认证) |
| 能力接口 | Workflow、Health(2 个) |
| 状态 | Preview |
配置字段(WeaverOptions)
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
AppId | string | 是 | — | REST 集成许可证 AppId |
BaseUrl | string | 是 | — | 泛微 e-cology 基地址(如 http://your-oa:port) |
Version | WeaverVersion | 否 | E9 | e-cology 版本(E10 待接入) |
OperatorUserId | string | 否 | — | 默认操作人用户 ID |
Username | string | 否 | — | 集成登录用户名(预留 SSO) |
Password | string | 否 | — | 集成登录密码(预留 SSO) |
CompanyId | int | 否 | 0 | 公司 ID(预留 SSO) |
HttpClientName | string | 否 | TeamWorkWeaver | 业务 HttpClient 命名 |
TokenHttpClientName | string | 否 | TeamWorkWeaverToken | 令牌刷新专用 HttpClient |
配置示例
{ "TeamWork": { "Weaver": { "AppId": "your-rest-license-appid", "BaseUrl": "http://your-oa-host:8080", "Version": "E9", "OperatorUserId": "sysadmin" } }}DI 注册
// ① 配置节绑定builder.Services.AddBitzsoftWeaverTeamWork(builder.Configuration.GetSection("TeamWork:Weaver"));
// ② 委托配置builder.Services.AddBitzsoftWeaverTeamWork(options =>{ options.AppId = "your-rest-license-appid"; options.BaseUrl = "http://your-oa-host:8080"; options.OperatorUserId = "sysadmin";});能力接口方法
ITeamWorkWorkflowProvider
Task<string> StartWorkflowAsync(WorkflowStartRequest request, CancellationToken ct = default);Task<WorkflowStatus> GetWorkflowStatusAsync(string requestId, CancellationToken ct = default);Task SubmitWorkflowNodeAsync(WorkflowSubmitRequest request, CancellationToken ct = default);Task CancelWorkflowAsync(string requestId, CancellationToken ct = default);ITeamWorkHealthProvider
Task<TeamWorkHealthStatus> CheckHealthAsync(CancellationToken ct = default);使用示例
public class OaWorkflowService(ITeamWorkWorkflowProvider workflow){ public async Task<string> SubmitAsync(string workflowCode, Dictionary<string, object> formData) { return await workflow.StartWorkflowAsync(new WorkflowStartRequest { WorkflowCode = workflowCode, FormData = formData, }); }}已知限制
- Preview 状态:工作流实现基于泛微 REST 集成接口,字段映射可能随 E9 补丁变动。
- 仅 E9:
Version默认E9,E10 接口差异较大,需专属适配。 - 不实现组织架构/消息:泛微核心价值在 BPM 流程,不实现 Org/Message/Todo 等接口。
相关
- TeamWork 域手册:Workflow 与 Approval 的区分
- 错误处理约定