impl and update docu

Issue #850

imixs-workflow-core/src/main/java/org/imixs/workflow/WorkflowKernel.java

@@ -1057,12 +1057,14 @@ private void evaluateSplitEvent(ItemCollection event, ItemCollection documentCon
 
     }
 
-    /**
+
+ /**
      * This method creates a new instance of a sourceWorkitem. The method did not
      * save the workitem!.
      * <p>
      * The new property $UniqueIDSource will be added to the new version, which
      * points to the $uniqueID of the sourceWorkitem.
+     * In addtion the item $created.version marks the point of time. 
      * <p>
      * The new property $UniqueIDVersions will be added to the sourceWorktiem which
      * points to the id of the new version.
@@ -1084,7 +1086,8 @@ private ItemCollection createVersion(ItemCollection sourceItemCollection) throws
 
         // update $unqiueIDSource
         itemColNewVersion.replaceItemValue(UNIQUEIDSOURCE, id);
-
+        itemColNewVersion.replaceItemValue(CREATED+".version", sourceItemCollection.getItemValueDate(LASTEVENTDATE));
+
         // remove $UniqueIDVersions
         itemColNewVersion.removeItem(UNIQUEIDVERSIONS);
 

src/site/markdown/core/workflowkernel.md

@@ -67,6 +67,7 @@ The current process instance is called the _Source Workitem_. The _Source Workit
 |$workitemId    	| x      | x       |A unique shared key across all versions and the source workitem.	|
 |$uniqueIdSource	|        | x       |A reference to the $UniqueID of the Source workitem.				|  	 	
 |$uniqueIdVersions	| x      |         |A list of $UniqueIDs of all created versions.	|
+|$created.version   |        | x       |Date of creation of a version. 
 |$isVersion			| 		 | x	   |This temporary attribute indicates that the current instance is a version. | 
 
 The temporary attribute _'$isVersion'_ flags the version during the processing phase and can be used by Plugins to handle these workitems. See also the section: [Workflow Data](../quickstart/workitem.html#Temporary_Attributes).