Excel-Based Toolset For Financial Reporting Guide
Excel-Based Toolset For Financial Reporting Guide
Reporting Guide
Requirements
Recommendations
List Separator
The examples in this guide use a comma (,) as a list separator. You may
be using a different character as a list separator. Excel uses the default list
separator from your operating systems Region and Language settings
(the name of which is slightly different in different versions of Windows),
and different areas of the world have different default list separators.
3. Click Install. It may take a few minutes, but the Welcome to the SyteLineGLSetup
Setup Wizard screen appears.
The toolbar behaves like any other Excel toolbar. You can close it or drag it anywhere
you want. If the toolbar is closed, you can re-open it by selecting
View>Toolbars>SyteLine GL. If you choose Tools>Add-Ins from Excels menu bar,
you will see SyteLineGL.GLExtractor listed as one of the add-ins. If you delete
SyteLineGL.Extractor from this list, it reappears the next time you open Excel. You must
use your operating systems uninstall process to remove the tool once it is installed.
The toolbar contains the following fields and buttons:
SyteLine Add-In Information - Click this button to see the version of the SyteLine
GL Toolbar, the version of SyteLine that is compatible with this version of the
SyteLine GL Toolbar, the version of Excel, and the version of SyteLine you are
connected to (if you are connected).
Year - Use this field to select the year. The year value shows the current fiscal year
of the default site. You can change the year here. The default value is shown
whenever you change the value in the site field.
Query - This field lists all the possible queries. See list below:
Query Command
Description
Query Command
Description
GET DESCRIPTION
STARTING WITH
Tools - Use this drop-down to set up your company information as detailed in the
next step.
5. There are two ways to use this window. Either choose the Direct Connection option or
the IDO Web Service option.
Direct Connection - If you select this option, the Direct Connection area of the
window becomes enabled. Select this option if you plan to have a direct (non-web)
connection to the database. If you choose this option, jump to step 6.
IDO Web Service - If you select this option, the IDO Web Service area of the window
becomes enabled. Select this option if you plan to use a URL to connect to the
database. If you choose this option, jump to step 7.
Server Name - Enter the name of the server where the data you want to see resides.
DB Name - Enter the database name that contains the data you want to see.
User ID - Enter the user ID for the database.
Password - Enter the password associated with the user ID you supplied.
End Point - This is the URL address of IDO Web service. Use the following syntax:
http://utilityorwebservername/IDORequestService/IDOWebService.asmx
Active Configs - This is a list of check boxes that displays all available
configurations retrieved from the given End Point. This list may contain configuration
for the test environment or multiple configurations pointing to the same Site.
You must select at least one configuration from the list. The selected Config(s) is
used to retrieve the Site name that is available for selection from the Tool Bar within
Excel.
Default Config - This is the default site that is used when no Site name is explicitly
provided as a parameter. You can select the Default Config from the drop-down list.
This list is populated based on the selected items in the Active Config field.
NOTE: In order to use the IDO Web Service, the user must be assigned
a SyteLineAutomation license. For more information about this
license type, see the Infor ERP SyteLine Licensing guide.
8. Check or clear the Enable Logging check box. Query execution details and error log, if
any, are logged into the System Event Log if you check this check box. The event log is
named "Infor Global Solutions - SyteLine", and the entries are logged with the source
name "SyteLineGL Excel Add-Ins". Use Windows Event Viewer to access these logs.
NOTE: The Enable Logging should be enabled only for troubleshooting
purposes. Turn it off when the troubleshooting is complete.
The Add-ins creates an Event Log one time and writes entries into the log when Event
Logging is enabled. However, the event log creation may fail if you do not have
administrator privileges to create one. So, we recommen that you run EXCEL in
Administrative mode at least once to create the Event Log. A standard user can read or
write into an Event log unless there are special security settings that prevent doing so.
To run the Excel in Admin mode:
a. Click the Windows Start Button.
b. Type "Excel".
c. Press SHIFT + CTRL + ENTER.
9. Click OK.
10. Restart Excel after making any changes in the SyteLine GL Setup window.
10
Functions
The following are the User Defined Functions added to Excel when you installed the tool.
These are NOT SyteLine ERP functions or components; they are Excel functions. In the
example formulas used, you can substitute a cell reference for another item when
appropriate. For example, one of the examples below is SLGL(10200, "AUG", 2009,
"600"). If "AUG" or "August" is in cell C9, your formula could be SLGL(10200, C9, 2009,
"600") instead. The functions described below are SLDESC, SLGL, SLGLBAL, SLNGL,
SLNGLBAL, SLNGLTRAN, SLGLTRAN, and SLPARMS.
SLDESC - SLDESC returns the description associated with an account code or unit
code.
Use it in this way (proper syntax): SLDESC(Account/unit code, [Unit Segment],
[site]).
Account is the Chart of Account code or unit code.
0 returns the description for an Account Code. 0 is the default and can be omitted.
1 returns the description of Unit Code 1
2 returns the description of Unit Code 2
3 returns the description of Unit Code 3
4 returns the description of Unit Code 4
Site is a valid site name. Site is an optional parameter. If you do not provide this
parameter, the default site is used.
11
Examples:
SLDESC(102000) returns the description associated with the account.
SLDESC(600,1) returns the description associated with the unit code 1 (600).
SLDESC("101000") returns the description associated with the Chart of Account
101000 from Site OH when OH is the default site.
SLDESC("101000",,"MI") returns the description associated with the Chart of
Account 101000 from Site MI.
SLGL - SLGL returns the period balance amount for the given account code, period, and
fiscal year.
Use it in this way (proper syntax): SLGL(Account [: Account], [Period], [Fiscal Year],
[Unit Code 1[,...4]], [Type], [site]).
All parameters except the Account are optional. The system uses the default value when
other parameters are not supplied. To use the default value, the parameter value has to
be returned as a blank value supported by Excel using a pair of empty double quotes
("").
Account is a valid account code defined in the Chart of Accounts. A range of accounts
can be grouped by specifying a starting account and ending account separated by a
colon (:). Cell references can not be used when a range is specified.
Example:
"100100:100500"
Period is an optional parameter. If not supplied, the value from the Period column of the
toolbar is used. If the Period column in the toolbar is empty, it picks the current period
from SyteLine ERP.
The parameter value can be 1 to 13.
January (or Jan) to December (or Dec) also can be used to specify the accounting
period. If used, Jan or January reads as period 1, and Dec or December reads as period
12. This is useful for users who uses 12 month periods starting from January to
December.
Fiscal Year is an optional parameter. If not supplied, the value from the Year column of
the toolbar is used. If the Year column in the toolbar is empty, it picks the current fiscal
year from SyteLine ERP. Year should be specified in century format.
12
Example:
1999 or 2009.
Unit Code is a valid unit code/sub-account defined in the Unit code table. A maximum
of four unit codes (Unit Code 1, Unit Code 2, Unit Code 3 and Unit Code 4) can be used
as a single parameter separated by commas. If you dont want to use a certain unit code
in the formula, then use a comma.
Example:
Use "600" for Unit Code 1
Use "600,,,ABC" for Unit Code 1 and Unit Code 4
Use ",XYX,30,ABC" for Unit Code 2, Unit Code 3, and Unit Code 4
You can also use wild cards in formulas for unit codes.
Example:
Use "100, *, *, *" to return the total of Unit Code 1 (100) and everything for Unit
Codes 2, 3, and 4.
Use "100, 001, *, *" to return the total of Unit Code 1 (100), Unit Code 2 (001) and
everything for Unit Codes 3 and 4.
Use "*,*,*,A*" to return the total of all Unit Codes 1, 2, 3, and then any Unit Code 4
that begins with "A".
You can specify a range of codes in your formula.
Example:
Use "100:200, *, *,*" to return the total of the range of Unit Code 1 from 100 to 200
and everything for Unit Codes 2, 3, and 4.
Type is an optional parameter. Possible values are Actual, Budget, and Plan.
Actual or A returns the actual account balance for the given period
Budget or B returns the budget amount for the given period
Plan or P returns the planning amount for the given period
The default is 'Actual'.
Example:
SLGL(10200, "AUG", 2009, "600"). The Type parameter is returned as blank, and
the system takes the default value as Actual.
Use of empty quotations ("") can be omitted, if there is no subsequent parameter
returned with a value.
Example:
SLGL(10200, "AUG", 2009). The last three parameters Unit Code, Type, and Site
are omitted as there is no parameter supplied after them.
13
Site is a valid site name. Site is an optional parameter. If you do not provide this
parameter, the default site is used.
Examples:
SLGL(102000) returns the current period total.
SLGL(102000, 9, 2009) returns the period total for period 9 and year 2009.
SLGL(102000, 9, 2009, "1020") returns the balance of account code 102000 and
unit code 1 (1020) for period 9 and year 2009.
SLGL(102000, 9, 2009, "1020,,ABC") returns the balance of account code 102000,
unit code 1 (1020) and unit code 3 (ABC) for period 9 and year 2009.
SLGL(102000, 13, 2009, "", "B") returns the budget amount for the period of 13 and
fiscal year 2009.
SLGL(102200:102500, 8, 2009, "Actual") returns total balances of accounts
between 102200 and 102500 for the period of 8 and fiscal year 2009.
SLGL("101000") returns the amount associated with the Chart of Account 101000
from Site OH when OH is the default site.
SLGL("101000", 12,2008,,,"MI") returns the amount for the account code 101000
for period 12, fiscal year 2008, and site MI.
Examples:
102200 - Cash Account
102300 - Petty Cash
102400 - Cash at Branch x
102500 - Petty Cash Branch Y
The total of all above can be grouped into one 'cash balance' total using the range
option.
SLGLBAL - SLGLBAL returns the balance amount as on a period and fiscal year for the
given account and unit code.
Use it in this way (proper syntax): SLGLBAL(Account [: Account], [Period], [Fiscal
Year], [Unit Code 1[,...4]], [Type], [site]).
14
Account is a valid account code defined in the Chart of Account. A range of accounts
can be grouped by specifying a starting account and an ending account separated by a
colon (:). Cell references can not be used when a range is specified.
Example:
"100100:100500"
Period is an optional parameter. If not supplied, the value from the Period column of the
toolbar is used. If the Period column in the toolbar is empty, it picks the current period
from SyteLine ERP
The parameter value can be 1 to 13.
January or Jan to December or Dec also can be used to specify the accounting
period. If used, January or Jan reads as period 1, and December or Dec reads as
period 12. This is useful for users who uses 12 month periods starting from January
to December.
Fiscal Year is an optional parameter. If not supplied, the value from the Year column of
the toolbar is used. If the Year column in the toolbar is empty, it picks the current fiscal
year from SyteLine ERP. Year should be specified in century format; example - 1999 or
2009.
Unit Code is a valid unit code/sub-account defined in the Unit code table. A maximum
of four unit codes (Unit Code 1, Unit Code 2, Unit Code 3 and Unit Code 4) can be used
as a single parameter separated by commas. If you dont want to use a certain unit code
in the formula, then use a comma.
Example:
Use "600" for Unit Code 1
Use "600,,,ABC" for Unit Code 1 and Unit Code 4
Use ",XYX,30,ABC" for Unit Code 2, Unit Code 3, and Unit Code 4
You can also use wild cards in formulas for unit codes.
Example:
Use "100, *, *, *" to return the total of Unit Code 1 (100) and everything for Unit
Codes 2, 3, and 4.
Use "100, 001, *, *" to return the total of Unit Code 1 (100), Unit Code 2 (001) and
everything for Unit Codes 3 and 4.
Use "*,*,*,A*" to return the total of all Unit Codes 1, 2, 3, and then any Unit Code 4
that begins with "A".
You can specify a range of codes in your formula.
Example:
Use "100:200, *, *,*" to return the total of the range of Unit Code 1 from 100 to 200
and everything for Unit Codes 2, 3, and 4.
15
Type is an optional parameter. Possible values are Actual, Budget, and Plan.
Actual or A returns the actual account balance for all periods up to the given period
and fiscal year
Budget or B returns the budget amount for all periods up to the given period and
fiscal year
Plan or P returns the planning amount for all periods up to the given period and fiscal
year
The default is 'Actual'.
Site is a valid site name. Site is an optional parameter. If you do not provide this
parameter, the default site is used.
Examples:
SLGLBAL(102000) returns the current balance as of current period.
SLGLBAL(102000, 9, 2009) returns the current balance as of period 9, 2009.
SLGLBAL("101000") returns the amount associated with the Chart of Account
101000 from Site OH when OH is the default site.
SLGLBAL("101000", 12,2008,,,"MI") returns the amount for the account code
101000 for period 12, fiscal year 2008, and site MI.
SLNGL - SLNGL returns the balance amount for the given account code and fiscal
period with sign reversed. The syntax is the same as SLGL.
Example:
-1000 is returned as 1000 and vice versa
SLGLTRAN - SLGLTRAN returns the account balance for any given period other than
a fiscal period.
NOTE: Use of SLGLTRAN should be used sparingly as it is an overloaded
function. Use SLGLTRAN only when you need the balance amount other
than for a fiscal period. If you want a fiscal-period balance, use SLGL or
SLNGL instead.
SLGLTRAN is useful for preparing statements with a relatively short term
date range like a weekly cash flow or income statement for a week etc.
Use it in this way (proper syntax): SLGLTRAN (Account, [Start Date], [End Date],
[Unit Code 1[,...4]], [DebitOrCredit], [site]).
Account is a valid account code defined in the Chart of Account.
Start Date is the beginning date of transaction and should be used in the format yyyymm-dd; example: 2009-09-17. Date should be used as a string in two quotations.
Example:
SLGLTRAN(10200," 2009-09-01" ," 2009-09-15")
16
End Date is the end date of transaction and should pass in the format yyyy-mm-dd;
example: 2009-09-17. Date should be used as a string in two quotations.
Example:
SLGLTRAN(10200," 2009-09-01" ," 2009-09-15")
Unit Code is a valid unit code/sub-account defined in the Unit code table. A maximum
of four unit codes (Unit Code 1, Unit Code 2, Unit Code 3 and Unit Code 4) can be used
as a single parameter separated by commas. If you dont want to use a certain unit code
in the formula, then use a comma.
Example:
Use "600" for Unit Code 1
Use "600,,,ABC" for Unit Code 1 and Unit Code 4
Use ",XYX,30,ABC" for Unit Code 2, Unit Code 3, and Unit Code 4
You can also use wild cards in formulas for unit codes.
Example:
Use "100, *, *, *" to return the total of Unit Code 1 (100) and everything for Unit
Codes 2, 3, and 4.
Use "100, 001, *, *" to return the total of Unit Code 1 (100), Unit Code 2 (001) and
everything for Unit Codes 3 and 4.
Use "*,*,*,A*" to return the total of all Unit Codes 1, 2, 3, and then any Unit Code 4
that begins with "A".
You can specify a range of codes in your formula.
Example:
Use "100:200, *, *,*" to return the total of the range of Unit Code 1 from 100 to 200
and everything for Unit Codes 2, 3, and 4.
DebitOrCredit is the type of the balance. The possible values are Debit or Dr, Credit or
Cr, or blank.
Debit or Dr sums only debit balance.
Credit or Cr sums only credit balance.
Blank (the default) returns the net balance amount.
Site is a valid site name. Site is an optional parameter. If you do not provide this
parameter, the default site is used.
17
Examples:
SLGLTRAN(102000, "2009-08-15", "2009-09-15") returns the balance between
the given account and date range.
SLGLTRAN(102000, "2009-08-15", "2009-09-15", "Debit") returns the debit total
for the given account and date range.
SLGLTRAN("101000", "12-01-2009", "12-05-2009") returns the amount for the
account code 101000 for the period between 12-01-2009 and 12-05-2009.
SLGLTRAN("101000", ", "12-01-2009", "12-05-2009",,,"MI") returns the amount
for the account code 101000 for the period between 12-01-2009 and 12-05-2009
and site MI.
NOTE: Account codes can be used without double quotes as long as the
code is only numeric. This doesnt work if the account code is alpha
numeric. For example, SLGLTRAN(10-2000) returns an error. It
should be specified as SLGLTRAN(10-2000).
SLNGLBAL - SLNGLBAL returns the balance amount for the given account code and
fiscal period with sign reversed. The syntax is the same as SLGLBAL.
Example:
-1000 is returned as 1000 and vice versa
SLNGLTRAN - SLNGLTRAN returns the balance amount for the given account code
and fiscal period with sign reversed. The syntax is the same as SLGLTRAN.
Example:
-1000 is returned as 1000 and vice versa
18
The site must be on the same database server as the home site.
The site must be listed on the Sites/Entities form at the home site, and the Application
Database field on that form must be filled in for the site.
Any sites that meet this criteria display in the drop-down list on the toolbar.
19
You can insert SyteLine parameters (Site, Period, and Year) into specific cells. These cells
then have a drop-down which shows the available sites, periods, and fiscal years.
1. Right-click in a cell.
2. Select Insert SyteLine Parameters and then either Site, Period, or Fiscal Year. The
cell now has a drop-down containing all possible options for site or period or fiscal year.
20