Differences

This shows you the differences between two versions of the page.

--- planning:userguide:tutorials:plan_history [2016/10/24 14:48] – [Plan History] kerhart
+++ planning:userguide:tutorials:plan_history [2021/07/29 18:28] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Plan History ======
-The //Plan History// allows the user to see all changes and modifications made to a plan.Each modification to a plan will result in a new //Revision// of the plan (note: in a complex plan there may be hundreds of revisions). If the user is not satisfied with the results of a modification they may go back to any of the previous //Revision//s and make that instance the active instance. (note: this will cause another //Revision// to be created) Below is a walk through and explanation of each step.
+Since the Astroid system captures and stores the user inputs (rather than the results), it is able to maintain an exhaustive history of all edits made to your data with relatively low storage needs. Users are able to benefit from this information through the //Plan History// feature that is available within each treatment plan. The //Plan History// is a feature that allows the user to see and explore __all__ the changes and modifications made to a plan. Each modification to a plan will result in a new //Revision// of the plan (note: in a complex plan there may be hundreds of revisions). If the user is not satisfied with the results of a modification they may go back to any of the previous revisions and restore it to the active instance (note: this will cause another //Revision// to be created for the reversion). Below is a walk through and more detailed explanation of this feature.
-  - Open the //General// block from the Plan Overview
-  - Expand the //History// tree node. The number of plan revisions will be listed. In this below example there are 36 revisions
+  - Open the //General// block from the Plan Overview and the History item can be seen at the bottom of this block {{ :planning:userguide:tutorials:plan_history_general_tab.png?300 |}}
-  - Select the //More Details// option in the bottom right hand corner {{ :planning:userguide:tutorials:plan_history_open.png?300 |}}
+  - The summary of the latest revisions will appear in the right display pane {{ :planning:userguide:tutorials:plan_history_history_list.png?300 |}}
-  - The summary of the latest revisions will expand to the right {{ :planning:userguide:tutorials:plan_history_revisions_closed.png?300 |}}
+  - Expand the //History// details by clicking the small arrow (this is not mandatory)
-  - The user should then pick the revision they want to look at by selecting the blue //show//. This will expand that particular version of the plan and explain what was done
+    - The number of plan revisions will be listed (In the above example there are 4 revisions)
-    - "op": is the operation performed in this version that differs from the previous version (i.e. delete: an item was deleted)
+  - The user can now review the various revision summaries
-    - "path": is the item in the treatment plan data that had the operation performed
+    -  Clicking the blue //show// link will expand that particular version of the plan and explain what was changed
-    - "val": is the value in the path that had the operation performed
+     - "op": is the operation performed in this version that differs from the previous version (e.g. insert: an item was added)
-  - If the user would like to return to this version they may do so by selecting the blue //make active//
+     - "path": is the item in the treatment plan data that had the operation performed (e.g. points: a point geometry was changed)
-  - The use can close the expanded version by selecting the blue //hide// {{ :planning:userguide:tutorials:plan_history_revisions_expanded.png?300 |}}
+     - "val": is the value of the data that was changed (see image below for the "val" of an added point)
+  - If the user would like to return to this version they may do so by clicking the blue //make active// link
+  - The user can close the expanded version by clicking the blue //hide// link {{ :planning:userguide:tutorials:plan_history_revisions_details.png?300 |}}