.title "Total-to Graph Above"
.id 314120060213142558
.tags "manual"
.body {
[h1 "Total-to Graph Above"]
[p {
The [qw_menu_command "Tools" "Totalto" "Graph Above"] command creates a graph
of the total-to structure above any selected set of accounts.
You can use this command to follow the total-to structure to every
account affected by the selected accounts, and therefore see
the effect they have throughout the set of books.
}]
[h2 "Changing Options"]
[p {
When displaying a graph, you can change the graph options to control the
format of the graph.
You can control the maximum depth of the total-to structure that will be displayed,
the format of the nodes and edges, and so on.
Fonts, colors, and which fields are displayed can all be controlled using
the graph options.
}]
[p {
After changing the options you can save them and the saves options will
be used the next time you display a graph.
}]
[p {
The options are generally self-evident and we invite you to change them and
view the effects until you have what you want.
}]
[h2 "Total-to Graph Above and Security"]
[p {
When you are granted access through the NewViews security system
to any account, you are automatically also granted access to the accounts
[qw_term below] that total to it.
However, the reverse is not true.
When you are granted access to an account, you are [bold not]
automatically granted access to all of the accounts it totals to.
}]
[p {
So you may not have access to all of the accounts [qw_term above] the
account you have selected.
The graph above command will graph everything you do have access to,
and will display a node with the shape of a [qw_term "stop sign"] and
the text [qw_term "Access Denied"], whenever access is denied to an account
in the total structure above.
}]
[h2 "Tips"]
[ul {
[li {
[p {
The maximum depth is set to 8 by default.
}]
[p {
By default the graph shows only eight levels.
You can increase the number of levels by changeing the
[qw_field_name "Maximum Depth"] option.
}]
}]
[li {
[p {
Turn fields and field labels on/off as desired.
}]
[p {
The original options have most of the available graph node fields
turned off.
You may want to turn some of the fields on, and until you become more
familiar with the nodes, also turn the field labels on.
However, you will quickly become familiar with the information
displayed in the graph nodes and you will want to
turn the labels off to save graph real-estate.
}]
}]
[li {
[p {
The options are persistent.
}]
[p {
You can change the options and click the [qw_button Apply] button
to see their effect.
However, the options must be saved using the graph [qw_menu_command "Options" "Save"]
command if you want to use the new options the next time you issue the graph command.
}]
}]
[li {
[p {
Amounts are displayed according to the current cell selected.
}]
[p {
If you position on an amount cell in a table of accounts (blue)
then the type, tag, and period for that amount are respected by the graph.
For example, suppose you are on a multi-column income statement
and you position on the amount for January 2006 sales.
Then the resulting graph will display amounts for January 2006.
}]
[p {
Of course you must turn the amount field on in the graph options
to see amounts in graph nodes.
}]
}]
[li {
[p {
Amounts are formatted according to the user's currency format.
}]
[p {
If amounts are displayed, and the amount type is [qw_term amount] or [qw_term quantity], the
amount is formatted in the graph node according to the user's
[qw_field_name .options.currency.format] field in the user options.
If the current cell is displaying a count, then no formatting is used.
}]
}]
}]
[h2 "Account Types"]
[p {
A total-to graph identifies three basic types of accounts and lets
you set their options individually.
The [qw_term "total"] and [qw_term "posting"] accounts type have the
expected meaning.
}]
[p {
A [qw_term "class"] account is a (non-total) account that has sub-accounts.
An account's sub-accounts automatically total to it so an account
that has sub-accounts is a [qw_term branch] in the total-to hierarchy, and is exactly
the same as a total account for many purposes.
A total-to graph could have treated class accounts as total accounts,
always displaying them in the same shape and color as total
accounts.
However, it is more general to be able to control class accounts separately.
}]
[p {
Examples of class accounts include
[qw_field_value ".../ACCOUNT"] (the root account), [qw_field_value ".../ACCOUNT/TOTAL"],
[qw_field_value ".../ACCOUNT/AR"], [qw_field_value ".../ACCOUNT/AP"], [qw_field_value ".../ACCOUNT/INVENTORY"],
and so on are all account classes.
Generally, you do not total accounts to class accounts explicitly using the total parent fields.
However, you might total a class account to a total account.
For example, you may total the AR, AP, INVENTORY, and other class accounts
to their controlling total accounts on the trial balance.
}]
[h2 "Node Shapes"]
[p {
See [bold "node shapes"].
}]
[h2 "Arrow Head/Tail Shapes"]
[p {
See [bold "arrow head/tail shapes"].
}]
}
/314120060213142619 {
.title "Setting Graph Options"
.id 314120060213142619
.tags "manual"
.body {
[h2 "Setting Graph Options"]
[ol {
[li {
[p {
While displaying a graph, Issue the [qw_menu_command "Graph" "Options"] command.
}]
[p {
The graph options window pops up.
}]
}]
[li {
[p {
Click on the desired option type in the left pane of the options window.
}]
[p {
As you click on each item in the left pane, a different
set of options appears in the right pane.
}]
[p {
There is a separate tree node in the left pane for each basic group of options.
There are overall graph options, edge options, and separate options
for posting and total accounts.
}]
}]
[li {
[p {
Change the desired options in the right pane.
}]
[p {
You can change any number of options.
You can switch from item to item in the left pane and
change options on different option pages.
The changes take effect only when you click
[qw_button "ok"] or [qw_button "Apply"].
}]
}]
[li {
[p {
Click [qw_button "Ok"] or [qw_button "Apply"] to see the effects of the changed options.
}]
[p {
If you click [qw_button "Ok"] the options window will be dismissed
and the options take effect.
If you click [qw_button "Apply"] then the options take
effect buts the options window remains displayed.
You can continue to change options and click [qw_button "Apply"] to
see the results.
}]
}]
[li {
[p {
Issue the [qw_menu_command "Options" "Save"] to save the options.
}]
[p {
If you dismiss the graph any changes to options made since the last time they were
changed are discarded.
You must explicitly save the options.
This feature lets you play around with the display of the graph
without lasting effect.
}]
}]
}]
}
}
/314120060213142635 {
.title "Saving a graph to a file."
.id 314120060213142635
.tags "manual"
.body {
[h2 "Saving a graph to a file."]
[p {
You can save a total-to graph to a file in any of three formats: GIF, EPS, and PDF.
PDF is the most useful and very possibly the only one you will ever use.
EPS and GIF are provided mainly because they have been historical popular.
However GIF has a rather serious limitation in that only the
visible region of the graph is captured to the file.
}]
[ul {
[li {
[p {
PDF - Portable Document Format
}]
[p {
You can view the resulting .pdf file using Adobe Reader,
ghostscript or any of a large number of PDF viewer and/or manipulation
programs.
PDF is the most popular format.
}]
}]
[li {
[p {
EPS - Encapsulated Postscript
}]
[p {
With the advent of pdf, Postscript (also from Adobe) has become less
popular but is still widely in use.
You can view an eps file using ghostscript, a freely available
program.
}]
}]
[li {
[p {
GIF - Graphics Interchange Format
}]
[p {
The major limitation is that only the visible region of the
graph is captured to the gif file.
This format is provided mainly for historical reasons.
Any browser or image viewer program can view gif files.
}]
}]
}]
}
}
/314120060213142649 {
.title "Displaying Posting Accounts"
.id 314120060213142649
.tags "manual"
.body {
[h2 "Displaying Posting Accounts"]
[p {
Generally you want to disable or limit the display of posting accounts
because they do not add much insight about the total-to structure of a set
of books.
}]
[p {
There could also be a very large number of posting accounts under any given
total account.
For example, there could be a very large number of customer accounts which
are of course posting accounts.
Displaying potentially thousands of such accounts does little to
enhance your understanding of the total-to structure, and will more likely
make it harder to focus on the total accounts.
It may also take much longer to display the graph.
}]
[p {
You can control the display of posting accounts as follows:
}]
[ul {
[li {
[p {
Turn off the display of posting accounts altogether.
}]
[p {
There is a general graph option to control the display of posting accounts.
If the check button is cleared, posting accounts are simply
not displayed.
}]
}]
[li {
[p {
Limit the number of posting accounts displayed under any total account.
}]
[p {
When the display of posting accounts is turned on, you can still
limit the maximum number that will be displayed under any parent node.
This is controlled separately in the [qw_field_name "Display Maximum"]
option for each node type, so you can set a maximum for total and
class accounts as well.
}]
[p {
Suppose the [qw_field_name "Display Maximum"] option is set to [qw_field_value 10] for posting accounts.
Then if [qw_field_value 10] or fewer posting accounts total to another account they will
be displayed.
But if more than [qw_field_value 10] total to the same account, only one [qw_term "placeholder"] node representing
all of them will be displayed.
The placeholder will have the shape configured for posting accounts,
but it will be gray and its text will indicate the number of
accounts it replaces.
}]
}]
}]
}
}
/314120060213142707 {
.title "Totalto Graph Above Command Summary"
.id 314120060213142707
.tags "manual"
.body {
[h1 "Totalto Graph Above Command Summary"]
[h2 [qw_menu_command "Graph" "Exit"]]
[p {
Dismisses the graph window.
}]
[p {
You can also click on the graph window close button in the upper-right corner.
}]
[h2 [qw_menu_command "Graph" "Save"]]
[p {
Saves the graph to a gif file.
You will be prompted for the file name.
It should have the extension [qw_directory ".gif"] but if no extenion
is provided [qw_directory ".gif"] is added automatically.
}]
[p {
Currently, only the visible portion of the graph is saved.
We are working on this limitation.
}]
[h2 [qw_menu_command "Options" "Edit"]]
[p {
Pops up the options window, allowing you to change the graph options.
These options control what types of nodes are displayed,
colors, fonts, fields, graph depth, and so on.
}]
[h2 [qw_menu_command "Options" "Save"]]
[p {
This saves the current options.
You can change options and apply them to the current graph without saving
them.
When you have the options the way you want them you should issue this command
to save them.
}]
[p {
Because options are saved only when you issue this command, you can
[qw_term "play around"] with the options without any lasting effect.
Save them only when you have them the way you want them.
}]
[p {
Whenever you issue the [qw_menu_command "Tools" "Totalto" "Graph Above"] command
from a blue table to create a new graph window, the most recently
saved options are used.
}]
[h2 [qw_menu_command "Help" "Graph"]]
[p {
Pops up the general graph help.
[qw_key F1] does the same thing.
}]
}
}