Tag Name Protocols

Tags names are arbitrary lower case alphanumeric strings, that don't contain special characters. Stick to lower-case letters, digits, underscores and hyphens. Avoid special characters like /\!@#$%^&*()|{}~<> and punctuation characters.

Examples of partition tags for a transaction header include:

The second item above shows a list of two partition tags (i.e. financial and sub_company_a). Several "sub-partitions" can be aggregated by sharing the tag financial.

Examples of allocation tags for transaction detail items include:

The second item above shows a list of two allocation tags (i.e. financial.project_101 sub_company_a.project_101). All other examples listed show one allocation tag.

Notice that an allocation tag is actually a path, with two components separated by a "." (inserted by NewViews). The first part of the path is the partition tag (inherited from the transaction header), and the second part is the allocation tag (optionally selected per detail item). Together they uniquely identify the tag.

Tag names are important and you should try to think it through before you set it all up. For example, looking at the tag names used above, one might be tempted to use short partition tag names:

And together with short allocation tag names, the result is short paths: You have to balance "screen real-estate" with readability. If tag names are long-winded, transaction and posting columns that display tags become wider and more difficult to read, but picking a tag is friendlier. If tag names are cryptic-short, transaction and posting columns that display tags become skinny and easy to read, but picking a tag is less friendly.

A middle ground to the examples shown above might use partition tag names:

And short allocation tag names:

The most important point is that you establish a consistent naming protocol. Finally, tag names can be changed at any time, the only caveat being that all transactions using the tag will be reindexed, and this may be a long duration task.


Copyright (c) 2003-2022 Q.W.Page Associates Inc., All Rights Reserved.