Sign up Sign in Samples Blog contact support
history

Wagn stores a complete history of all changes to a card's name, type, and content.  Changes can easily be reviewed and reverted.

 

 
+example

If you go to "view > history" on the menu of any card, you'll see something like this:

150220 large

You can open up any grey bar to see all the related actions associated with that act.  From there you can choose view options and, if warranted, decide to revert.

 
+howto

You don't have to do anything to gather card histories; it all happens automatically.

 

Storage

 

Card histories are stored in three structures: acts, actions, and changes.

 

When a web request is made that involves transforming card data, it involves exactly one act. With the act we store a timestamp, an IP address, and, for signed-in users, the card id of the user.

 

Sometimes a single act involves adding or updating many cards, as when submitting a form for a structured card.  For each card affected, Wagn records an action.  An action is always associated to an act, a card, and an action_type (create, update, or delete).

 

Every action involves one or more changes. A change is connected to an action, a field (name, type, content, or trash), and a value for that field. 

 

Navigation

 

When you look at a card's history, you are looking at the history view of that card.  Like any view, you can use "history" in inclusions or via the RESTful Web API.  But the most common way to navigate to histories is via "view > history" on a card menu.

 

On each history view you will see a list of acts on the card.  These are acts that involve actions on the card itself on on cards included by the card.  Within each act you will see a short summary of the changes involved in each action associated with that act.  You can use the triangle on the right to expand the act and see a much more complete version of the changes.

 

+tips
  •  Support for tracking name and type changes began with version 1.14.
  • If someone was editing a card but didn't save it, a copy of what they were working on will also be accessible from the history. See auto save.

 

+discussion