GL Wand Installation & User Guide
Excel4Apps (Pty) Ltd
All rights reserved.
Using GL Wand
The GL Wand toolbar gives you access to all the functionality of GL Wand.
Functions can also be accessed from the GL Wand drop down menu.
Frequently used functions like calculate Range, calculate Sheet and calculate All can also be
executed with ALT+CTL+R, ALT+CTL+S and ALT+CTL+A.
- Not logged on, click to log on
- Logged on, click to log on again
The first step in using GL Wand is to log on to the Oracle instance that you intend using.
You can log on to the online Vision instance or you can log on to your own Oracle
See also the Creating Connections section.
There are two possible logon methods that GL Wand can use. The method is determined by
a setting on the GL Wand Options form. The method can be “Oracle” or “Excel”. It is also
possible to access your segment values descriptive flexfields by enabling the option during
Oracle Logon Method
The “Oracle” option is the new logon method which utilizes the Oracle web based screen to
capture your user name and password. This method is also compliant with Oracle Single Sign
On. When you click the sign on button you are presented with the screen below where you
select which Oracle connection you wish to use.
When you click the logon button the Oracle log on screen will appear. Enter your applications
user name and password.
When you click Login on this web browser the window will close and you will be presented
with a list of responsibilities that are linked to your user name. You will see one of the two
windows displayed below. If your site is licensed to use the GL Wand Multiple Sets of Books
feature, you will see the image on the right. Else the screen will appear like the image on the
left. Trial users using an in-house trial key will by default have access to the Multiple Set of
Books (MSOB) feature.
Select the responsibility that you wish to use and click ok. If you are licensed to use the GL
Wand MSOB feature you can select multiple responsibilities. Click an item to select it and
click it again to unselect it.
If you are licensed to use the MSOB feature you also have the option of logging on to all the
available sets of books. This option must be enabled by setting the applicable profile option
at user level. With the profile option set to yes for a particular user, that user will have an
extra item in the list of available responsibilities. This “All Sets of Books” option allows a user
to log on to all the sets of books configured in the Oracle instance without needing to select
Please note that when logging on with the “All Sets of Books” option, no security rules are
enforced. For this reason you must enable this option for those GL Wand users that are
authorized to report across all the configured sets of books. By default this options is
disabled for all users.
If you log on to an Oracle Release 12 instance and the data access set linked to the chosen
responsibility contains more than one ledger or ledger set you will be logged on to all the
Excel Logon Method
The “Excel” logon method is the same mechanism that was used in previous GL Wand
versions. This method should not be used unless the “Oracle” method does not function
correctly. Again there are two possible windows that you will be presented with depending in
whether you are licensed to use the GL Wand Multiple Sets of Books feature.
If you wish to report on segment value descriptive flexfields, tick this option on the logon
form. This will load the descriptive flexfield information. This option is by default un-ticked as
loading this information unnecessarily would slow down the logon process.
If you are connecting to an Oracle instance on the Internet and your organization uses a
proxy server that requires authentication to access the Internet (in addition to the domain
logon), GL Wand will prompt you for your proxy user name and password if required.
Enter the required user name and password and click OK. Then click the logon button again.
If you have not yet obtained a trial license key for the instance that you are logging on to,
you will prompted with the option to request a key. Click “Yes” to open a web page where
you can request a trial key or “No” to continue without requesting a key.
Customers that have licensed GL Wand will use this exact same process to request the final
Set of Books and Segment Selector
- Set of Books and Segment selector
Once you have logged on, the set of books and segment list dropdowns will be populated.
Set of Books
The set of books drop down list can be used to select the set of books that you wish to work
with. If you log on to a single set of books this dropdown list will contain a single value only.
However, if you are licensed to use the GL Wand Multiple Sets of Books feature or are in
trial, then this list will contain multiple values in the following situations:
If you selected multiple responsibilities during the logon process all the sets of books
linked to those responsibilities will be listed.
If you selected the special “All Sets of Books” option all the sets of books configured
in the Oracle instance will be listed.
If you log on to an Oracle Release 12 instance and the data access set linked to the
chosen responsibility contains more than one ledger or ledger set, then each of these
ledgers will be listed.
The number in brackets () indicates the Set of Books identifier. This number can be used in
various GL Wand formulas and other functionality in order to obtain information from a
specific Set of Books.
This dropdown list will be populated with a list of the segments that are available in the
currently selected Set of Books. The number in brackets indicates the segment number. The
segment list also includes the special value “Period” which is used for discovering the period
names in your set of books.
In the example shown the selected segment is “Company” and it is identified as segment 1.
Certain dynamic functions require the segment number as an input parameter.
The discover tools allow you to extract segment information from the Oracle Applications
database and populate Excel cells with this information. You can use the discover tools to
extract segment values, segment properties, periods or child ranges or the full segment
hierarchy. For segment values you can use the discover level to choose whether to retrieve
child values, parent values or both.
Discover Segment Values
- Discover Down
- Discover Down All
- Discover Up
1. Select a cell and enter a valid starting segment value e.g. “1000” into the cell.
2. Choose the relevant segment from the segment list e.g. “Account”.
3. Now click the “Discover Down” button.
GL Wand finds the next valid account segment value after account “1000” and enters this
value in the cell below the one that you started in.
In the same way you can click the up arrow and the previous segment value will be entered
in the cell above the one that you started in.
- Discover Left
- Discover Right
- Discover Right All
The left and right arrows work in a similar manner, retrieving the next and previous segment
values but they populate the cells to the left and right of the cell that you start in. When
discovering segment values you will notice that some of the values are entered with a bold
font. This is because these have been identified as parent values.
You do not need to discover segment values one at a time.
You can enter a starting segment value, choose the segment from the segment list
and then highlight a range of cells.
When you click one of the discover buttons now, GL Wand fills the selected range
with the next or previous segment values depending on which arrow you click on.
The Discover Down All and Discover Right All buttons can be used to retrieve all the
segment values in one operation.
Discover Period Names
You can discover period names in much the same way that you can discover segment
1. Select a cell and enter a valid starting period name e.g. Jan-03 into the cell.
NB – make sure that you enter this starting period name as text by first formatting the Excel
cell as text or entering the period name pref