YouTrack Workflow API 的状态

Read this post in other languages:

之前,我们 宣布 了 YouTrack 2019.1 不再支持旧版本 Workflow。

所谓旧版本 Workflow 是指在旧版 Workflow 编辑器中编写的工作流,该编辑器是在 2018.3 版本后停止使用的外部应用程序。

我们看到一些客户仍在使用这些旧版本 Workflow。 根据我们的功能使用率统计,几乎 6.5% 的 YouTrack InCloud 实例还启用一个或多个旧版本 Workflow。 我们已决定将旧版继续保持 6 个月,这意味着这些 Workflows 将从 2019.3 版本起停止支持。

也就是说,我们强烈建议您尽快升级旧版本 Workflow。 旧版编辑器不可用(您无法在旧规则中进行任何更改),而且新的 API 更加强大和便捷。 旧版 API 也不支持某些新功能,例如您不能执行操作规则

要升级您的 Workflow,我们建议您执行以下步骤:

  1. 检查是否还有任何活动的旧版本 Workflow。 为此,请转到 YouTrack 服务器的 Workflows 页面,并检查是否存在标题为纯文本而非链接的工作流:

LegacyWorkflows

  1. 其中一些旧版本 Workflow 可能是我们在版本 2017.3 之前为每个 YouTrack 安装提供的工作流程。他们的名字以 “jetbrains-youtrack-“ 开头。 我们尽可能自动地升级到新的 Workflow API,但是某些使用旧版 Workflow 编辑器编辑过的工作流程无法自动升级。
    确定您的确从未修改过 Workflows。 要升级时,请选择它们,然后单击“Restore Selected” (还原选中项目)按钮:

RestoreWorkflow

  1. 如果您修改了任何默认工作流程,建议您从文档的默认工作流 (Default Workflows)部分获取相应的 JS Workflow,并进行相应的更新。

例如,如果您使用“Due Date”(到期日工作流)中的“未设置截止日期,则不允许提交问题” 规则,并且已修改显示的消息,您需要:

  • 在基于 Web 的编辑器中创建工作流
  • 添加新模块。
  • 复制以下规则的文本。
  • 编辑消息。
  • 保存 Workflow 并将其附加到相应的项目。

DueDateDefaultWorkflow

  1. 其他旧版本 Workflows 可能源自我们的 公共 Workflow 存储库。 要升级这些 Workflow,请访问存储库,在其中找到相应的 Workflow,然后用新的 Workflow 替换旧版:

Repository

  1. 如果还有其他旧版本 Workflow,则应将其重写到新的 API。 如果您尚未使用新的 API,我们建议您观看此网络研讨会阅读快速入门指南

  2. 为了帮助加快重写过程,我们实现了 Workflow 转换器。 但是,请注意,此转换器是完全自动化的,因此它生成的 Workflow 质量比手工编写的代码差一些。

要升级旧版本 Workflow:

WorkflowConverter

如果您对将 Workflow 升级有任何疑问或需要帮助,请 联系 我们的支持团队或者加入 YouTrack Slack 社区频道。将随时为您提供帮助!

Discover more