DataMap Guide.

book Page 1 Tuesday, April 19, 2005 11:28 AM

SyteLine ERP DataMap Guide

for SyteLine ERP 7.04

MAPICS, Inc.
1000 Windward Concourse Parkway, Suite 100
Alpharetta, GA 30005-8001

www.mapics.com
DataMap Guide.book Page 2 Tuesday, April 19, 2005 11:28 AM

SyteLine ERP DataMap Guide

Copyright © MAPICS, Inc. 2005

All Rights Reserved

Printed in the USA April 2005

Restricted Rights Legend

Use, duplication, or disclosure by the Government is subject to

restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in
Technical Data and Computer Software clause at DFARS 252.227-7013,
and Rights in Data-General at FAR 52.227.14, as applicable. Name of
Contractor: MAPICS, Inc., 1000 Windward Concourse Parkway, Alpharetta, GA 30005-8001.
SyteLine is a trademark of MAPICS, Inc. All other product names used in this manual are
trademarks, registered trademarks, or trade names of their respective companies.
DataMap Guide.book Page i Tuesday, April 19, 2005 11:28 AM

Contents____________________________________
DataMap Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
DataMap Spreadsheets .......................................................................................... 1-1
Form-Collection ................................................................................................ 1-2
Collection-Schema ......................................................................................... 1-3
Schema-Properties ........................................................................................... 1-4
Form-Folder...................................................................................................... 1-5
Form-Group-Authorization ................................................................................ 1-5
Form-Events ..................................................................................................... 1-6
SL-CRM-Map.................................................................................................... 1-6
Collection-Method............................................................................................. 1-7
Rpt-Form-SP .................................................................................................... 1-7
Relationships Between the Data in the Spreadsheets ............................................ 1-7
DataMap Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
Starting the DataMap .............................................................................................. 2-1
Copying and Modifying the DataMap ...................................................................... 2-1
Using the DataMap ................................................................................................. 2-1
Customizing SyteLine ERP ..................................................................................... 2-2
Customize SyteLine ERP Forms and Field Labels........................................... 2-2
Customize SyteLine ERP Help Topics ............................................................. 2-2
Searching for a Field ............................................................................................... 2-3
Searching for a Field’s Data Source ....................................................................... 2-4
Finding Database Schema Details.......................................................................... 2-8
Using the DataMap with SyteLine Workflow Automation ........................................ 2-8
Getting Help on a Field ........................................................................................... 2-9
Finding Program Information for Forms ................................................................ 2-10
Events Used in a Form ................................................................................... 2-10
Methods and Stored Procedures Used by a Collection .................................. 2-12
Stored Procedures Used by Reports .............................................................. 2-13
Finding Which SyteLine ERP Fields Map to CRM Adapter XML Elements .......... 2-14
Determining Authorization Levels for Forms ......................................................... 2-16
Finding a Form in the Explorer.............................................................................. 2-16
Contacting MAPICS .............................................................................................. 2-17
Contacting MAPICS Support .......................................................................... 2-17
Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Index-1

© 2005 MAPICS, Inc. SyteLine ERP DataMap Guide i

DataMap Guide.book Page ii Tuesday, April 19, 2005 11:28 AM

Contents

ii SyteLine ERP DataMap Guide © 2005 MAPICS, Inc.

DataMap Guide.book Page 1 Tuesday, April 19, 2005 11:28 AM

1
DataMap Overview _________________________
The SyteLine® DataMap is an analytical tool designed to help you learn and
analyze relationships between SyteLine forms, collections, stored procedures,
and database schema. It also allows you to track and record changes you
make using user-defined fields or otherwise modifying the standard product.
The DataMap consists of a set of Microsoft Excel® spreadsheets that list
SyteLine ERP forms and fields and their data relationships, default
authorization levels, CRM mapping, and so on.
The DataMap is a tool, not standard documentation. As such, it is not
warranted to exactly match the schema and forms, but it does closely
approximate the supported SyteLine ERP version at the time the DataMap was
created.

DataMap Spreadsheets
The DataMap includes these spreadsheets. Each spreadsheet is described in
more detail, with sample data, in the following pages.

Spreadsheet Description
Form-Collection Lists forms in SyteLine ERP, and both the component name
and the label for most fields on each form. Then it lists the data
source (collection and object or variable) for the form/
component combination. Help on fields or forms is also
available through a button.
Collection- Lists the modules (IDOs), collections, and collection properties
Schema (usually objects) found in the application database. Then,
where applicable, it lists the underlying database tables and
columns relating to collection/object pairs.
Schema- Lists the properties for the application database tables and their
Properties columns (base data type, user-defined type, storage length,
precision, scale, default value, whether the data allows nulls,
and whether the column is a primary key).
Form-Folder For each form, lists the Explorer folder and subfolder where that
form is found.
Form-Group- For each form, lists the group authorization that is set by
Authorization default. You can filter and sort either by group or by form.

© 2005 MAPICS, Inc. SyteLine ERP DataMap Guide 1-1

DataMap Guide.book Page 2 Tuesday, April 19, 2005 11:28 AM

DataMap Overview

Spreadsheet Description
Form-Events For each form, lists the possible events and responses.
SL-CRM-Map Lists, in separate worksheet tabs, the SyteLine ERP and CRM
database tables and fields whose data may be exchanged
through XML request and response documents or flat-file
transfers.
Collection- For most collections, lists any methods/stored procedures used
Method in the collection, and the parameters used in the methods.
Rpt-Form-SP For each report form, lists the background task, .RPT (Crystal
Reports) file and the SQL stored procedures used in the report.

Form-Collection

The Form-Collection spreadsheet has these columns:

• Form Name - SyteLine ERP form. This is the "hungarianized" form name,
not the title.
• Component Name - The underlying component name for the field, which
you see when you go into Edit mode on the form and double-click on the
field.

The following component types are not included in the

spreadsheet, because they do not logically map to data
sources: static, groupbox, pushbutton, defpushbutton, toolbar
button, notebook, tab, and grid. If a form (for example,
CTPResults) has no components other than the types listed
here, that form does not appear in the spreadsheet.
• Label - The field label. An asterisk * indicates a description for an
unlabeled field (for example, Account Unit Code 1 *).

Since field labels can be derived from various areas of the

application, the field labels you see on your forms may not
match the labels in the spreadsheet.

1-2 SyteLine ERP DataMap Guide © 2005 MAPICS, Inc.

DataMap Guide.book Page 3 Tuesday, April 19, 2005 11:28 AM

DataMap Overview

• Primary Collection - The application does not directly connect to the

database. It uses "collections" to compile the data. Once you know the
primary data source (usually a collection), and the name of the object in
the collection, you can usually determine the database table and field from
which the field derives. Examples and explanations of primary collection
values are shown on page 2-5.
• Data Element - The direct source of the data, usually the component in the
collection that relates to the field on the form. Examples and explanations
of data element values are shown on page 2-6.
• Container - In some cases, a value in this column may help you find the
field on the form. For example, if the container name is "GeneralTab" you
could find the field on the form’s General tab.
• Help ID and Help File - Used internally to find the proper help topic to
display when you click the Help button. These columns are hidden by
default.
Collection-Schema

The Collection-Schema spreadsheet has the columns listed below. Used in

conjunction with the Form-Collection spreadsheet, this information can help
you find the underlying schema for a field on a form.
• Module - The module (IDO) to which the collection belongs.
• Collection - Collections belonging to the application are listed in this
spreadsheet.

Collections that are part of the framework may not be included

in this spreadsheet; however, you may be able to use the
combination of the MGCore collection name (usually similar to
the schema table name) and object (usually similar to the
schema field name) in the Forms-Collections table to find the
related database table and field.
• Property - The property in the collection. If this property is a bound object,
it relates to a database schema table and field.
• Property Type - Determines whether the property is bound to a table/
column. If the property type is Derived, the Property Value column may
contain useful information.

© 2005 MAPICS, Inc. SyteLine ERP DataMap Guide 1-3

DataMap Guide.book Page 4 Tuesday, April 19, 2005 11:28 AM

DataMap Overview

• Table - Database schema table (if any) that contains the schema column
that maps to this collection and object.
• Column - Database schema column (if any) that maps to this collection
and object.
• Property Value - May contain useful information for properties whose type
is Derived.
Schema-Properties
The Schema-Properties spreadsheet describes the application database
table and column properties. This information is similar to what you see when
you right-click and select Properties for a database table in SQL Enterprise
Manager.

This spreadsheet shows the following information:

• Table Name - Application database schema table.
• Column Name - Column in the table.
• Base Type - SQL base data type for values in this column.
• User Defined Data Type - The name that MAPICS has defined for a
particular combination of Base Type, Precision, and Scale.
• Length - The number of bytes used to hold the data.
• Precision - The number of digits in a number value.
• Scale - The number of digits to the right of the decimal point. For example,
the number 321.40 has a precision of 5 and a scale of 2.
• Nullable - Indicates whether the column can contain NULL values.
• Default - The default value, if any, for the column.
• Primary Key - Indicates whether this column is a primary key for the table
and, if there are multiple keys for the table, their hierarchy.

Your custom database tables or columns, or any other changes

made to the database after the DataMap was created, will not
appear in this spreadsheet unless you add them manually. To
view up-to-date schema information, print SyteLine ERP’s
Database Schema Report.

1-4 SyteLine ERP DataMap Guide © 2005 MAPICS, Inc.

DataMap Guide.book Page 5 Tuesday, April 19, 2005 11:28 AM

DataMap Overview

Form-Folder
The Form-Folder spreadsheet tells where in SyteLine ERP’s Explorer folder
hierarchy you can find certain forms. The Main Folder is sometimes, but not
always, equivalent to the name of a module or IDO. The Sub Folder, if any,
indicates an additional layer of folders in the Explorer. The Parent Folder is the
folder containing the form.

Non-entrypoint forms (those that open only from within another

form) do not appear in this list, because they do not appear in the
Explorer folder hierarchy.

Form-Group-Authorization
The Form-Group-Authorization spreadsheet lists the default group
authorizations set up for SyteLine ERP, and the forms to which the groups
apply. You can sort or filter this information by either group or form.

© 2005 MAPICS, Inc. SyteLine ERP DataMap Guide 1-5

DataMap Guide.book Page 6 Tuesday, April 19, 2005 11:28 AM

DataMap Overview

Form-Events
The Form-Events spreadsheet lists the events, sequences, and responses
available from each form.

SL-CRM-Map
The SL-CRM-Map spreadsheet maps the CRM adapters and CRM database
to SyteLine ERP database table.columns, where appropriate. It includes a tab
for each SyteLine - CRM adapter. Each tab includes the following information:

• XML data elements used in the adapter, and descriptions of the data
elements.
• CRM database table and column to which the element maps.
• SyteLine ERP database table and column to which the element maps.

1-6 SyteLine ERP DataMap Guide © 2005 MAPICS, Inc.

DataMap Guide.book Page 7 Tuesday, April 19, 2005 11:28 AM

DataMap Overview

Collection-Method
The Collection-Method spreadsheet lists the module (IDO) to which a
collection belongs and the methods/stored procedures used in the collection.
It also lists parameter information for each method. There may be some
collections not represented in this spreadsheet.

Rpt-Form-SP
Since reports generally do not have associated collections, the Rpt-Form-SP
spreadsheet provides information about the stored procedures, background
tasks, and RPT (Crystal Reports) files associated with reports. A report form
may be associated with multiple tasks, stored procedures and RPT files.

Relationships Between the Data in the

Spreadsheets
The colors and arrows in the graphic on the following page indicate the
relationships between data in the different spreadsheets. For example, you
can use the Form-Collection spreadsheet to find the relationship of a field on a
form to an object in a collection, and then use the Collection-Schema
spreadsheet to find the relationship of that collection object to a database
table.column, and then use the Schema-Properties spreadsheet to find the
properties of that table.column.

© 2005 MAPICS, Inc. SyteLine ERP DataMap Guide 1-7

DataMap Guide.book Page 8 Tuesday, April 19, 2005 11:28 AM

DataMap Overview
DataMap Spreadsheet Relationships

1-8 SyteLine ERP DataMap Guide © 2005 MAPICS, Inc.

DataMap Guide.book Page 1 Tuesday, April 19, 2005 11:28 AM

2
DataMap Procedures _______________________
This chapter describes in detail some of the tasks you can perform using the
DataMap.

Starting the DataMap

To start the DataMap, place the CD in the drive and double-click on any of the
spreadsheets. The spreadsheets are described in Chapter 1, “DataMap
Overview."
If prompted, select Enable Macros.

Copying and Modifying the DataMap

The files on the CD are read-only files. To modify them:
1. Copy all the files from the CD to your computer. The Help button’s
underlying macro assumes the related help files are in a subdirectory
named "Help" under the spreadsheets’ directory. The files require at least
50 MB of disk space.
2. For the spreadsheet copies on your computer, change the file permissions
to writable.
3. Open the writable spreadsheets from the directory on your computer.

Using the DataMap

You will probably come up with other ways to use the DataMap, but the
following suggestions provide a starting point. Additional information is
provided on the pages listed below.

Task See Page

Keep a record of your customizations to forms, collections, 2-2
databases, etc.
Find all the forms where a certain field or component is displayed 2-3
Find a field’s data source (collection and object, or variable name) 2-4

© 2005 MAPICS, Inc. SyteLine ERP DataMap Guide 2-1

DataMap Guide.book Page 2 Tuesday, April 19, 2005 11:28 AM

DataMap Procedures

Task See Page

Find application database details - a list of all columns in a specific 2-8
table, and their data types, size, nullability and default value
Get help on a field 2-9
Find information you need for SyteLine Workflow Automation 2-8
Find programming details: the collection(s) used by a form; the 2-4, 2-10,
methods and stored procedures used by a collection; the events 2-12, 2-13
associated with a form; or the stored procedures and Crystal RPT
files associated with a report
Find where a modal form is called from 2-11
Find SyteLine ERP fields that map to CRM adapter XML elements 2-14
Find permissions required to access a form 2-16
Find the Explorer folders and subfolders where a form appears 2-16

Customizing SyteLine ERP

Customize SyteLine ERP Forms and Field Labels
SyteLine ERP allows you to customize your forms by changing field labels,
adding fields, or moving fields to different tabs.
Make a writable copy of the DataMap files and change your copy of the Form-
Collection spreadsheet to match the changes you make to the SyteLine ERP
forms. This gives you a record of your custom fields and the schema fields or
variables to which they map.

We recommend that you add a "Notes" column to the DataMap

spreadsheets, where you can note any changes you make to a row.
Then, if you upgrade to a new version of the DataMap, you can
more easily find and copy your customizations into the new
spreadsheets.
Customize SyteLine ERP Help Topics
You can create your own documentation for SyteLine ERP screens and fields
(perhaps describing procedures specific to your company or industry) by
modifying the SyteLine ERP online help. For more information, see the
SyteLine ERP online help topic "Customizing the SyteLine Help."
The Form-Collection spreadsheet has two hidden columns containing the Help
ID and HelpFile for field help topics. These columns are used in the
spreadsheet to display a help topic when you click the Help button. However,
you may also find the Help ID and helpfile information useful when customizing
the help, since it displays the help context number called when a user requests
help in a field.

2-2 SyteLine ERP DataMap Guide © 2005 MAPICS, Inc.

DataMap Guide.book Page 3 Tuesday, April 19, 2005 11:28 AM

DataMap Procedures

Searching for a Field

The Form-Collection spreadsheet lists all forms and their components (with the
exceptions listed on page 1-2).
Because field labels may be customized or nonexistent, the best way to find all
occurrences of a field is to filter the ComponentName column for similar
names. For example, to list forms where a "Bank Code" field appears:
1. Right-click on the down-arrow next to the ComponentName column
heading.
2. Select Custom from the list.
3. In the Custom Auto Filter dialog, specify the text and wildcards you want
(in this case, select contains and type BankCode, then click OK).

4. The DataMap then displays only the rows where the ComponentName
column contains the text you specified.

5. Be sure to un-filter again later by selecting All from the column’s drop-
down box.

Normally in Excel, the Auto-Filter dropdown box lists all the different
values from the column’s rows, and you select one. Because we
have pushed Excel beyond its normal limits, our dropdown filter may
NOT list all available values. Use the Custom option on the
dropdown box, as shown above, to filter for a specific value.

© 2005 MAPICS, Inc. SyteLine ERP DataMap Guide 2-3

DataMap Guide.book Page 4 Tuesday, April 19, 2005 11:28 AM

DataMap Procedures

Searching for a Field’s Data Source

This may require the use of two spreadsheets to drill down to the database
level.
1. Find the field’s component name by going into edit mode on the form and
double-clicking the field.

Your ability to go into edit mode may be limited by your editing

permissions.

2. Open the Form-Collection spreadsheet and filter to display the form and
component from step 1.

3. Look at the Primary Collection and Data Element values.

• Primary Collection - The application does not directly connect to the
database. It uses "collections" to compile the data. Once you know the
primary data source, which is usually a collection, and the name of the
object in the collection, you can usually determine the database table
and field from which the field derives. The Primary Collection column
generally contains a value similar to one of the examples on the next
page.
• Data Element - The direct source of the data, usually the component
in the collection that relates to the field on the form. This column
generally contains a value similar to one of the examples on page 2-6.
The spreadsheet’s Primary Collection and Data Element generally contain
the names you see on the Form Component Properties dialog’s Data tab
when you click the Binding button:

2-4 SyteLine ERP DataMap Guide © 2005 MAPICS, Inc.

DataMap Guide.book Page 5 Tuesday, April 19, 2005 11:28 AM

DataMap Procedures

Primary Collection Examples:

SL.SLCustomers(xxxxx)

"SL" indicates that this "SLCustomers" If the collection name is

collection relates to the is the collection followed by parentheses ( ),
application. name. you can find the schema table
and column by going to the
Collection-Schema
spreadsheet and filtering for
the collection and object.

SL.SLItemprices.ItemPriceChangeSp(xxxxxxx)

"SL" indicates that this "SLItemprices" If the collection name is

collection relates to the is the collection followed by a period and
application. name. additional text, the form
component is populated by a
method whose name follows
the period.

MGCore.AccountAuthorizations( xxxxx)

"MGCore" indicates that "AccountAuthorizations" Anything following the

this collection is part of the is the collection name. collection name may be
MAPICS framework. useful, or not.

NULL

Indicates that the field value is coming

from a variable and is not part of a
collection.

© 2005 MAPICS, Inc. SyteLine ERP DataMap Guide 2-5

DataMap Guide.book Page 6 Tuesday, April 19, 2005 11:28 AM

DataMap Procedures

Data Element Examples:

object.Addr_1

"Object" indicates that the "Addr_1" is the object’s name

following name is an in the collection.
object in the collection.

object.DerNewStat

"Object" indicates that the "Der" is a naming convention indicating

following name is an the object is derived and does not map
object in the collection. directly to a database table.column.

object.UbRangeQty

"Object" indicates that the "Ub" is a naming convention indicating

following name is an the object is unbound and does not map
object in the collection. directly to a database table.column.

object2.CheckDate

"Object2" indicates that The object does not map directly to a

the data is based on a database table.column.
secondary collection.

filter.AdditionalValue

"Filter" indicates that the The object does not map directly to a
data is based on a filter and database table.column.
is used in a query form.

variables.AgingBasis(xxx)

"Variables" indicates that the Anything following the variable name

following name is a variable and may be useful. For example, it may
does not derive from a database give the variable’s initial value.
table.

2-6 SyteLine ERP DataMap Guide © 2005 MAPICS, Inc.

DataMap Guide.book Page 7 Tuesday, April 19, 2005 11:28 AM

DataMap Procedures

4. If the data source is a bound object related to a collection in the application,

you can find its underlying database table and column by opening the
Collection-Schema spreadsheet and filtering for the collection and object.
Continuing the previous example, the collection name from the Primary
Collection column is SLCustomers. The object name from the Data
Element column is CorpCust. If you open the Collection-Schema
spreadsheet and filter for these values, you see this row:

Collections that are part of the framework may not be included

in this spreadsheet; however, you may be able to use the
combination of the MGCore collection name (usually similar to
the schema table name) and object (usually similar to the
schema field name) in the Form-Collections spreadsheet to find
the related database table and column.

© 2005 MAPICS, Inc. SyteLine ERP DataMap Guide 2-7

DataMap Guide.book Page 8 Tuesday, April 19, 2005 11:28 AM

DataMap Procedures

Finding Database Schema Details

If you want to know the properties (data type, precision, scale, nullability, and
default value) of a specific database table.column, open the Schema-
Properties spreadsheet and filter for that table and column. This spreadsheet
also indicates whether a column is a primary key for the table.

For definitions of the spreadsheet column headings, see page 1-4.

Your custom database tables or columns, or any other changes

made to the database after the DataMap was created, will not
appear in this spreadsheet unless you add them manually. To
view up-to-date schema information, print SyteLine ERP’s
Database Schema Report.

Using the DataMap with SyteLine Workflow

Automation
If your system includes SyteLine Workflow Automation, use the Collection-
Schema and Form-Collection spreadsheets to determine the fields and forms
where the data listed in your workflow appears. In addition, the Schema-
Properties spreadsheet is useful for cross-checking and verification of data
types and names.

2-8 SyteLine ERP DataMap Guide © 2005 MAPICS, Inc.

DataMap Guide.book Page 9 Tuesday, April 19, 2005 11:28 AM

DataMap Procedures

Getting Help on a Field

If you are using the Form-Collection spreadsheet and need a definition or
description of a component, you can get help.
1. Select the field in the DataMap:

2. Click the Help button. This displays the SyteLine Help for that field:

If you get an error message that macros are not enabled, change the
security level in Excel. It should be set to Medium, to allow macros. You
can change the security level by selecting the Excel menu options
Tools>Macro>Security. Then save and reopen the spreadsheet.
3. You can go from the displayed help topic to any other topic in the SyteLine
online help.

Help is not available for hidden components, menu options, or

components that appear on read-only grids or report forms.

© 2005 MAPICS, Inc. SyteLine ERP DataMap Guide 2-9

DataMap Guide.book Page 10 Tuesday, April 19, 2005 11:28 AM

DataMap Procedures

Finding Program Information for Forms

There are three spreadsheets that contain program information relating to
forms, collections, and reports:
• Form-Events
• Collection-Method
• Rpt-Form-SP
Events Used in a Form
You can filter the Form-Events spreadsheet to show either:
• Forms where a specific event is used, or
• Events used in a specific form
The response, sequence, and response type for each event is also listed.

The sequence number helps to distinguish occurrences of an event when the

event appears more than once in a form.
The response types are listed below. For more information about response
types, see the Winstudio online help (in SyteLine ERP, select
Help>Customizing Forms and select the index entry Response Types.)

Response Description
Type
0 Method call
2 Execute EXE or other program
3 Run form as modal child
4 Goto form - replace this form with the new form
5 Goto form -page - make the new form page current
6 Run form as linked child
7 Run form
8 Run script
16 Run form to retrieve filter
19 Run background task

2-10 SyteLine ERP DataMap Guide © 2005 MAPICS, Inc.

DataMap Guide.book Page 11 Tuesday, April 19, 2005 11:28 AM

DataMap Procedures

Response Description
Type
21 Generate event
22 Set values
23 Collection navigate
24 Collection new
25 Collection copy
26 Collection save
27 Collection delete
28 Collection refresh
29 Collection refresh current
30 Collection notes
31 Collection notes for current
32 Collection init with auto insert row
33 Inline script
34 Collection make current
35 ActiveX script method
36 Conditional action
37 Binary value action
38 Add entry to the audit log
39 Goto URL
40 Print preview
41 Goto Explorer folder

Finding Which Form Calls a Modal Form

If you know the name of a modal form (for example,
ShippedCustomerOrdersSelection), but you do not know which form it is being
called from, use the Form-Events spreadsheet to find out. In the Response
column, filter for the modal form name (for example, specify "contains
shippedcust"). This displays:
• the parent form name (in our example, DeliveryOrderLineSequences)
• the event name, which usually indicates the button or menu option that
does the calling
• the response type (in our example, "Run form as modal child").

© 2005 MAPICS, Inc. SyteLine ERP DataMap Guide 2-11

DataMap Guide.book Page 12 Tuesday, April 19, 2005 11:28 AM

DataMap Procedures

Methods and Stored Procedures Used by a Collection

First, use the Form-Collection spreadsheet to find the collection, if any,
associated with a form. (Some forms, for example most reports, do not have
associated collections.)
Then open the Collection-Method spreadsheet and filter for the collection. The
methods/ stored procedures used in the collection are displayed, along with
their parameters.

Some notes about methods:

• Method names are often, but not always, the same as the stored
procedure names.
• Not all methods map to stored procedures.
• There is not necessarily a correlation between the methods used by a form
and the collection used by the form. A form bound to the SLCustomers
collection does not have to use any of the methods contained in
SLCustomers, and the form can use methods from other collections.

2-12 SyteLine ERP DataMap Guide © 2005 MAPICS, Inc.

DataMap Guide.book Page 13 Tuesday, April 19, 2005 11:28 AM

DataMap Procedures

Stored Procedures Used by Reports

The Rpt-Form-SP spreadsheet lists the report forms, the related backgroun
task and stored procedures, and the Crystal Reports RPT file(s) associated
with the report.

To filter for a specific stored procedure or RPT file (where there may be more
than one SP or RPT listed for a form):
1. Right-click on the down-arrow next to the Stored Procedure or RPT column
heading.
2. Select Custom from the list.
3. In the Custom Auto Filter dialog, specify the text and wildcards you want
to look for.

© 2005 MAPICS, Inc. SyteLine ERP DataMap Guide 2-13

DataMap Guide.book Page 14 Tuesday, April 19, 2005 11:28 AM

DataMap Procedures

Finding Which SyteLine ERP Fields Map to CRM

Adapter XML Elements
CRM adapters are used to create an interface between SyteLine ERP and
CRM.
1. Display the SL-CRM-Map.xls spreadsheet.
This spreadsheet lists all the SyteLine ERP database table.columns and
the adapters where they are mapped.

2. Select a link in the Overview, or click the tabs at the bottom of the
spreadsheet, to go to the worksheet that shows the appropriate adapter’s
XML mapping.

2-14 SyteLine ERP DataMap Guide © 2005 MAPICS, Inc.

DataMap Guide.book Page 15 Tuesday, April 19, 2005 11:28 AM

DataMap Procedures

The following tab/worksheets are available:

• Customer - CRM to ERP
• Customer - ERP to CRM
• Product - ERP to CRM
• Inventory - ERP to CRM
• Order - CRM to ERP
• Order Status - ERP to CRM
• Quote - CRM to ERP
• Quote Status - ERP to CRM
• RMA Status - ERP to CRM
• Site - ERP to CRM
• Site Address - ERP to CRM
• Currency Codes - ERP to CRM
• Exchange Rate - ERP to CRM
• Country Codes - ERP to CRM
• Shipping Codes - ERP to CRM
3. To find out which XML elements in the adapter a specific table.column
maps to, find the table and column in the worksheet.
For more information about the adapters or about the integration between
SyteLine ERP and CRM, see the guide titled SyteLine ERP Integration with
CRM, Customer Center, and Supply Chain Management.

© 2005 MAPICS, Inc. SyteLine ERP DataMap Guide 2-15

DataMap Guide.book Page 16 Tuesday, April 19, 2005 11:28 AM

DataMap Procedures

Determining Authorization Levels for Forms

The Form-Group-Authorization spreadsheet lists default group authorizations
by form. These authorizations are already set up in SyteLine ERP. If you
change the groups or add new ones, you can keep track of the changes in this
spreadsheet.

You can filter the spreadsheet to show:

• All groups that allow access to a specific form.
• All forms that can be accessed by a specific group.

Finding a Form in the Explorer

If you want to know where to find the form in the Explorer hierarchy of folders,
use the Form-Folder spreadsheet.

The Main Folder is usually, but not always, the module. The Sub Folder, if any,
indicates an additional layer of folders in the Explorer.The Parent Folder
indicates the type of form (as well as the subfolder in the Explorer). You can
filter or sort by any of the columns.

Non-entrypoint forms (those that open only from within another

form) do not appear in this list, because they do not appear in the
Explorer folder hierarchy.

2-16 SyteLine ERP DataMap Guide © 2005 MAPICS, Inc.

DataMap Guide.book Page 17 Tuesday, April 19, 2005 11:28 AM

DataMap Procedures

Contacting MAPICS
Contacting MAPICS Support
If you cannot find the answer to a question in this document or in the product’s
online help, contact MAPICS Support using one of these methods:
• Go to our support Web page (http://support.mapics.com) and log in,
selecting your product area. From the Support web page, you can search
for answers to your questions about the product in our Knowledge Base,
or report issues.
• Find the support contact phone number or email address for your region at
http://support.mapics.com/phonelist.htm.

© 2005 MAPICS, Inc. SyteLine ERP DataMap Guide 2-17

DataMap Guide.book Page 18 Tuesday, April 19, 2005 11:28 AM

DataMap Procedures

2-18 SyteLine ERP DataMap Guide © 2005 MAPICS, Inc.

DataMap Guide.book Page 1 Tuesday, April 19, 2005 11:28 AM

Index _______________________________________

Symbols Database Schema Report 1-4, 2-8

* in Field Labels 1-2 Database Table Properties 1-1
Database Tables 1-1, 1-2
A DataMap
Application Database Tables 1-4 Copying 2-1
Asterisk, in Field Labels 1-2 Starting 2-1
Authorization Levels for Forms 1-1, 2-16 Default, in Schema-Properties spreadsheet 1-4

B E
Base Type, in Schema-Properties spreadsheet 1- Enable Macros 2-1
4 Enabling Macros 2-9
Binding Button 2-4 Event
Name 1-6
C Response Type 1-6
Changing the DataMap 2-1 Sequence 1-6
Collection 1-1, 2-4 Event Handler Responses 2-10
in Collection-Schema Spreadsheet 1-3 Events Used in Forms 1-2, 2-10
Methods 2-12 Explorer Folders 1-1, 2-16
Stored Procedures 2-12
Collection-Method Spreadsheet 1-2, 1-7, 2-12 F
Collection-Schema Spreadsheet 1-1, 1-3 Field Length 1-4
Column Name, in Schema-Properties Field Name 1-4
spreadsheet 1-4 Field Type 1-4
Column, in Collection-Schema Spreadsheet 1-4 Fields
Component Name 1-2, 2-3 Customizing 2-2
Components 1-1 Getting Help 2-9
Contacting MAPICS 2-17 Map to XML Elements in Adapter 2-15
Container, in Form-Collection spreadsheet 1-3 Searching for 2-3
Copying the DataMap Files 2-1 Folder 2-16
CRM Adapters 1-6, 2-14 Form Name, in Form-Collection spreadsheet 1-2
CRM Database 1-2 Form-Collection Spreadsheet 1-1, 1-2, 2-9, 2-12
CRM Database Table 1-6 Customizing Fields 2-2
Crystal Reports 1-2, 2-13 Customizing Help 2-2
Custom Auto Filter Dialog 2-3, 2-13 Searching for Data Source 2-4
Custom Option in Excel 2-3 Searching for Fields 2-3
Customizing Form-Events Spreadsheet 1-2, 1-6, 2-10
SyteLine ERP 2-2 Form-Folder Spreadsheet 1-1, 1-5, 2-16
SyteLine Help Topics 2-2 Form-Group-Authorization Spreadsheet 1-1, 1-5,
2-16
D Forms
Data Element 1-3, 2-4 Authorizations 2-16
Data Length 1-1 Components 1-1
Data Source 1-1 Customizing 2-2
Database Schema Details 2-8

© 2005 MAPICS, Inc. SyteLine ERP DataMap Guide Index-1

DataMap Guide.book Page 2 Tuesday, April 19, 2005 11:28 AM

Index
G 1-4
Group Authorizations 1-5 Programming Information 2-10
Groups 1-1 Properties 1-1, 1-3
Property Type 1-3
H Property Value 1-4
Help
Button 1-1 R
Customizing 2-2 Relationships between Spreadsheets 1-7
on a Field 2-9 Reports 1-2
Help ID RPT files 2-13
and Help File 1-3 Stored Procedures 2-13
Column Description 1-3 Response 1-2, 2-10
Using with Custom Help 2-2 Response Types, list of 2-10
Response, Events 1-6
I RPT files 1-7
IDO 1-1, 1-5, 1-7 Rpt-Form-SP Spreadsheet 1-2, 1-7, 2-13

L S
Label (Field) 1-2 Scale 1-1, 1-4
Schema-Properties Spreadsheet 1-1, 1-4, 2-8
M Searching for Data Source 2-4
Macros 2-1 Searching for Fields 2-3
Macros, Enabling 2-9 Security Level 2-9
Main Folder 1-5 Sequence, Events 1-6
MAPICS, Contacting 2-17 SL-CRM-Map Spreadsheet 1-2, 1-6, 2-14
Metadata 2-8 Starting the DataMap 2-1
Methods 1-2, 2-12 Storage, in Schema-Properties spreadsheet 1-4
Notes about 2-12 Stored Procedures 1-2
Populating Form Components 2-5 in Collection-Method Spreadsheet 1-7
MGCore 1-3 in Rpt-Form-SP Spreadsheet 1-7
Modifying the DataMap 2-1 Used by a Collection 2-12
Module 1-1 Used by Reports 2-13
in Collection-Method Spreadsheet 1-7 Sub Folder 1-5
in Collection-Schema Spreadsheet 1-3 Support 2-17
SyteLine ERP Database Table 1-6
N SyteLine Workflow Automation 2-8
Nullable, in Schema-Properties spreadsheet 1-4
T
O Table Name 1-4
Object 1-1 Table Name, in Schema-Properties spreadsheet
1-4
P
Table, in Collection-Schema Spreadsheet 1-4
Parent Folder, in Form-Folder Spreadsheet 1-5
Permissions for Forms 2-16 U
Phone Numbers 2-17 Unfiltering a Column 2-3
Precision 1-1, 1-4 User Defined Data Type, in Schema-Properties
Precision, in Schema-Properties spreadsheet 1-4 spreadsheet 1-4
Primary Collection 1-3, 2-4 User-Defined Type 1-1, 1-4
Examples 2-5
Primary Key, in Schema-Properties spreadsheet

Index-2 SyteLine ERP DataMap Guide © 2005 MAPICS, Inc.

DataMap Guide.book Page 3 Tuesday, April 19, 2005 11:28 AM

Index
V Winstudio Online Help 2-10
Variable 1-1
X
Variable, in collections 2-5
XML Data Element 1-6
W XML Elements in CRM Adapters 2-15
Web Page 2-17 XML Requests and Responses 1-2
Wildcards 2-3, 2-13

© 2005 MAPICS, Inc. SyteLine ERP DataMap Guide Index-3

DataMap Guide.book Page 4 Tuesday, April 19, 2005 11:28 AM

Index

Index-4 SyteLine ERP DataMap Guide © 2005 MAPICS, Inc.