Crucible Workflow Conditions Plugin Module Tutorial

About the tutorial

The plugin created in this tutorial makes use of the workflow-condition modules. The plugin prevents a user from closing a review until at least one reviewer completes the review.

In this tutorial you will:

  • Create a Fisheye/Crucible plugin
  • Implement the WorkflowCondition SPI class
  • Configure the workflow-condition module
  • Implement simple Actions to engage user with interaction after failed transition

This tutorial teaches you how to:

  • Implement the WorkflowCondition SPI class
  • Render a warning or error message for the user performing the transition
  • Check the condition on important transitions only.

For general information about the plugin development, see FishEye and Crucible Plugin Guide - Atlassian Developers


We encourage you to work through this tutorial. If you want to skip ahead or check your work when you are done, you can find the plugin source code on Atlassian Bitbucket. Bitbucket serves as a public Git repository containing the tutorial's code. To clone the repository, run:
git clone


The Workflow Conditions API was introduced to FishEye/Crucible in version 4.2 as an experimental API and had changed in 4.3 release. From version 4.3, FishEye/Crucible is considered as final and there are no planned changes towards it anymore.




Was this page helpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport