Workflow Commons 3.6.0

README.md

@@ -1,9 +1 @@
-# Workflow Commons module
-
-Provides out-of-the-box content to get you started with building workflows in Mendix. Read more about this module and how to set it up in the documentation at https://docs.mendix.com/appstore/modules/workflow-commons.
-
-## License
-https://www.mendix.com/terms-of-use/
-
-## Mendix marketplace
-https://marketplace.mendix.com/link/component/117066
+Please see [Workflow Commons](https://docs.mendix.com/appstore/modules/workflow-commons) in the Mendix documentation for details.

ReleaseNotes.md

@@ -1,3 +1,14 @@
+## Release 3.6.0
+
+* We introduced the audit trail feature to track all events and actions that have taken place in the workflows in your application. Refer to the module documentation for more details on how to configure a workflow event handler for audit trails.
+* We added a key attribute to WorkflowView and UserTaskView entities, that uniquely identifies the workflow and user task instances. The value is helpful for correlating audit trail data to the related workflow or user task.
+
+Note: If you want to add the keys to existing WorkflowView and UserTaskView data you need to run a migration, you can either:  
+* Use the migration microflow 'ACT_Key_Migrate' (also added to the 'WorkflowAdminCenter' page), or:
+* Add the 'ASu_Key_Migrate' microflow to the project's after startup microflow.
+
+_______
+
 ## Release 3.5.0
 
 * We added support for React client, introduced as public beta in Mendix 10.7.0. As part of this, we updated all dropdown and reference selector widgets to the new Combo Box widget. 

Source/javasource/workflowcommons/actions/JA_WorkflowUserTask_GetKey.java

@@ -0,0 +1,57 @@
+// This file was generated by Mendix Studio Pro.
+//
+// WARNING: Only the following code will be retained when actions are regenerated:
+// - the import list
+// - the code between BEGIN USER CODE and END USER CODE
+// - the code between BEGIN EXTRA CODE and END EXTRA CODE
+// Other code you write will be lost the next time you deploy the project.
+// Special characters, e.g., é, ö, à, etc. are supported in comments.
+
+package workflowcommons.actions;
+
+import com.mendix.core.Core;
+import com.mendix.systemwideinterfaces.core.IContext;
+import com.mendix.webui.CustomJavaAction;
+import com.mendix.systemwideinterfaces.core.IMendixObject;
+
+public class JA_WorkflowUserTask_GetKey extends CustomJavaAction<java.lang.String>
+{
+	/** @deprecated use workflowUserTask.getMendixObject() instead. */
+	@java.lang.Deprecated(forRemoval = true)
+	private final IMendixObject __workflowUserTask;
+	private final system.proxies.WorkflowUserTask workflowUserTask;
+
+	public JA_WorkflowUserTask_GetKey(
+		IContext context,
+		IMendixObject _workflowUserTask
+	)
+	{
+		super(context);
+		this.__workflowUserTask = _workflowUserTask;
+		this.workflowUserTask = _workflowUserTask == null ? null : system.proxies.WorkflowUserTask.initialize(getContext(), _workflowUserTask);
+	}
+
+	@java.lang.Override
+	public java.lang.String executeAction() throws Exception
+	{
+		// BEGIN USER CODE
+		if (workflowUserTask == null)
+			throw new RuntimeException("No WorkflowUserTask object provided");
+
+		return Core.workflows().getUserTask(getContext(), workflowUserTask.getMendixObject()).getKey();
+		// END USER CODE
+	}
+
+	/**
+	 * Returns a string representation of this action
+	 * @return a string representation of this action
+	 */
+	@java.lang.Override
+	public java.lang.String toString()
+	{
+		return "JA_WorkflowUserTask_GetKey";
+	}
+
+	// BEGIN EXTRA CODE
+	// END EXTRA CODE
+}

Source/javasource/workflowcommons/actions/JA_Workflow_GetKey.java

@@ -0,0 +1,57 @@
+// This file was generated by Mendix Studio Pro.
+//
+// WARNING: Only the following code will be retained when actions are regenerated:
+// - the import list
+// - the code between BEGIN USER CODE and END USER CODE
+// - the code between BEGIN EXTRA CODE and END EXTRA CODE
+// Other code you write will be lost the next time you deploy the project.
+// Special characters, e.g., é, ö, à, etc. are supported in comments.
+
+package workflowcommons.actions;
+
+import com.mendix.core.Core;
+import com.mendix.systemwideinterfaces.core.IContext;
+import com.mendix.webui.CustomJavaAction;
+import com.mendix.systemwideinterfaces.core.IMendixObject;
+
+public class JA_Workflow_GetKey extends CustomJavaAction<java.lang.String>
+{
+	/** @deprecated use workflow.getMendixObject() instead. */
+	@java.lang.Deprecated(forRemoval = true)
+	private final IMendixObject __workflow;
+	private final system.proxies.Workflow workflow;
+
+	public JA_Workflow_GetKey(
+		IContext context,
+		IMendixObject _workflow
+	)
+	{
+		super(context);
+		this.__workflow = _workflow;
+		this.workflow = _workflow == null ? null : system.proxies.Workflow.initialize(getContext(), _workflow);
+	}
+
+	@java.lang.Override
+	public java.lang.String executeAction() throws Exception
+	{
+		// BEGIN USER CODE
+		if (workflow == null)
+			throw new RuntimeException("No Workflow object provided");
+
+		return Core.workflows().getWorkflow(getContext(), workflow.getMendixObject()).getKey();
+		// END USER CODE
+	}
+
+	/**
+	 * Returns a string representation of this action
+	 * @return a string representation of this action
+	 */
+	@java.lang.Override
+	public java.lang.String toString()
+	{
+		return "JA_Workflow_GetKey";
+	}
+
+	// BEGIN EXTRA CODE
+	// END EXTRA CODE
+}