0% found this document useful (0 votes)
37 views242 pages

SageX3 CommonTools FINAL NFR

The document is a training workbook for Sage X3, outlining various tools and functionalities within the software. It includes sections on general parameters, activity codes, transaction entries, and integration with Microsoft Office, among others. The content serves as a guide for users to understand and utilize the features of Sage X3 effectively, while also emphasizing the importance of consulting professionals for specific business needs.
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
37 views242 pages

SageX3 CommonTools FINAL NFR

The document is a training workbook for Sage X3, outlining various tools and functionalities within the software. It includes sections on general parameters, activity codes, transaction entries, and integration with Microsoft Office, among others. The content serves as a guide for users to understand and utilize the features of Sage X3 effectively, while also emphasizing the importance of consulting professionals for specific business needs.
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 242

Common tools

Sage X3
Important Notice
This is a publication of Sage Software, Inc.
© 2016 Sage Software, Inc. All rights reserved.
Sage, the Sage logos, and the Sage product and service names mentioned herein are
registered trademarks or trademarks of Sage Software, Inc. or its affiliated entities. All
other trademarks are the property of their respective owners.
This workbook provides general business information that should not be construed as
professional advice. Sage does not represent or guarantee that the information is
accurate or applicable to your business needs. Consult a tax, legal, financial, or other
business professional to assess its suitability before implementing the information in your
business. This information does not alter, amend, or become part of the license or
purchase terms applicable to your use of any Sage product or service. Sage may make
changes to this information at any time and without notice.
Your use of this document and the Sage product(s) described herein is governed by the
terms and conditions of the Sage End User License Agreement ("EULA") or other
agreement that is provided with or included in the Sage product. Nothing in this document
supplements, modifies, or amends those terms and conditions. Except as expressly
stated in those terms and conditions, the information in this document is provided by Sage
"AS IS" and Sage disclaims all express, implied, or statutory warranties of any kind,
including but not limited to the warranties of merchantability, fitness for a particular
purpose, or of noninfringement. No implied license is granted to you under any Sage
intellectual property or trade secret right. Sage reserves the right to revise, supplement, or
remove information in this document at any time without notice to you or others.
11/2016
Common tools

Table of Contents
1.0 WELCOME AND INTRODUCTION ..................................................................................... 4
2.0 INHERITANCE .................................................................................................................... 6

UNDERSTANDING INHERITANCE CONCEPTS....................................................................................... 7


3.0 GENERAL PARAMETERS ............................................................................................... 10
UNDERSTANDING PARAMETERS ..................................................................................................... 11
VIEWING AND EDITING PARAMETERS .............................................................................................. 13
EXPLORE WHAT YOU’VE LEARNED .................................................................................................. 20
4.0 ACTIVITY CODES ............................................................................................................. 21

UNDERSTANDING ACTIVITY CODES ................................................................................................. 22


CREATING ACTIVITY CODES ........................................................................................................... 24
EXPLORE WHAT YOU’VE LEARNED .................................................................................................. 27
5.0 LOCAL MENUS AND MISCELLANEOUS TABLES ......................................................... 28
UNDERSTANDING LOCAL MENUS AND MESSAGES............................................................................. 29
LOCATING DESCRIPTIONS IN LOCAL MENUS ..................................................................................... 30
VIEWING AND EDITING LOCAL MENUS ............................................................................................. 31
DEFINING MISCELLANEOUS TABLES ................................................................................................ 34
MODIFYING MISCELLANEOUS TABLES ............................................................................................. 36
EXPLORE WHAT YOU’VE LEARNED .................................................................................................. 37
6.0 ENTRY TRANSACTIONS ................................................................................................. 41
SETTING UP AND USING ENTRY TRANSACTION WINDOWS .................................................................. 42
EXPLORE WHAT YOU’VE LEARNED .................................................................................................. 51
7.0 SEQUENCE NUMBERS .................................................................................................... 52
UNDERSTANDING SEQUENCE NUMBERS ......................................................................................... 53
ASSIGNING SEQUENCE NUMBERS................................................................................................... 57
RESETTING SEQUENCE NUMBERS .................................................................................................. 59
EXPLORE WHAT YOU’VE LEARNED .................................................................................................. 60
8.0 SELECTING RECORDS.................................................................................................... 61
USING THE SELECTION OPTION ..................................................................................................... 62
SEARCHING FOR CUSTOMER RECORDS .......................................................................................... 67
EXPLORE WHAT YOU’VE LEARNED .................................................................................................. 68
9.0 FORMULAS....................................................................................................................... 69
UNDERSTANDING FORMULA CONCEPTS AND COMPONENTS .............................................................. 70
ENTERING FORMULAS ................................................................................................................... 80
EXPLORE WHAT YOU’VE LEARNED .................................................................................................. 85
10.0 ATTACHMENT MANAGEMENT AND COMMENTS ......................................................... 87

ATTACHING DOCUMENTS AND GRAPHICS ........................................................................................ 88


ADDING COMMENTS...................................................................................................................... 92
EXPLORE WHAT YOU’VE LEARNED .................................................................................................. 93

Sage course curriculum - Version 1.0 Page 1


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

11.0 MICROSOFT OFFICE INTEGRATION .............................................................................. 94


MICROSOFT OFFICE INTEGRATION WITH SAGE X3........................................................................... 95
EXPORTING DATA TO MICROSOFT OFFICE ...................................................................................... 97
EXPORTING DATA TO MICROSOFT EXCEL ....................................................................................... 99
EXPORTING DATA TO MICROSOFT WORD ..................................................................................... 109
EXPLORE WHAT YOU’VE LEARNED ................................................................................................ 121
12.0 IMPORTING AND EXPORTING DATA ........................................................................... 127
CONCEPTS FOR IMPORTING/EXPORTING TO A FILE ......................................................................... 128
SPECIFYING DIRECTORY PATHS ................................................................................................... 130
TRANSCRIBING IMPORT/EXPORT DATA .......................................................................................... 132
DEFINING FILE FORMATS FOR IMPORT/EXPORT .............................................................................. 134
EXPORTING DATA TO A FILE ......................................................................................................... 146
IMPORTING DATA FROM A FILE ..................................................................................................... 148
CORRECTING REJECTED RECORDS .............................................................................................. 150
EXPLORE WHAT YOU’VE LEARNED ................................................................................................ 152
13.0 PRINTING ........................................................................................................................ 156
PRINTING IN SAGE X3................................................................................................................. 157
CREATING AND MODIFYING REPORTS ........................................................................................... 163
EXPLORE WHAT YOU’VE LEARNED ................................................................................................ 164
14.0 WORKFLOW NOTIFICATIONS ...................................................................................... 165

UNDERSTANDING WORKFLOW NOTIFICATIONS .............................................................................. 166


DEFINING WORKFLOW RULES ...................................................................................................... 168
SETTING UP WORKFLOW NOTIFICATIONS ...................................................................................... 170
MONITORING WORKFLOW NOTIFICATIONS .................................................................................... 172
EXPLORE WHAT YOU’VE LEARNED ................................................................................................ 174
15.0 USER-DEFINED QUERIES ............................................................................................. 177

REQUESTER TOOLS .................................................................................................................... 178


CREATING SIMPLE REQUESTERS ................................................................................................. 179
USING THE SQL QUERY TOOL ..................................................................................................... 185
USING THE GRAPHICAL QUERY TOOL ........................................................................................... 187
VIEWING QUERY REQUESTS ....................................................................................................... 188
EXPLORE WHAT YOU’VE LEARNED ................................................................................................ 189
16.0 WORKING WITH PROCESS FLOWS ............................................................................. 193
VIEWING A PROCESS FLOW ......................................................................................................... 194
DESIGNING A PROCESS FLOW ..................................................................................................... 195
EXPLORE WHAT YOU’VE LEARNED ................................................................................................ 200
17.0 DEFINING MENU ITEMS ................................................................................................ 203
DEFINING MENU ITEM LINKS ......................................................................................................... 204
EXPLORE WHAT YOU’VE LEARNED ................................................................................................ 210
18.0 PERSONALIZING LANDING PAGES ............................................................................. 211

CREATING A LANDING PAGE......................................................................................................... 212


MODIFYING A LANDING PAGE ....................................................................................................... 215
EXPLORE WHAT YOU’VE LEARNED ................................................................................................ 217

Page 2 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

19.0 PERSONALIZING PAGES .............................................................................................. 218

PERSONALIZING THE LAYOUT OF PAGES ....................................................................................... 219


USING AUTHORING MODE ........................................................................................................... 221
EXPLORE WHAT YOU’VE LEARNED ................................................................................................ 229
20.0 PERSONALIZING INQUIRIES AND OBJECTS .............................................................. 231
PERSONALIZING INQUIRY SCREENS .............................................................................................. 232
PERSONALIZING OBJECTS ........................................................................................................... 233
EXPLORE WHAT YOU’VE LEARNED ................................................................................................ 234
LAB ……………………………………………………………………………………………………...236
SUMMARY .................................................................................................................................. 239

Sage course curriculum - Version 1.0 Page 3


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

1.0 Welcome and introduction

Welcome to the Sage X3 Common tools training class. This course is divided into
discussion of concepts and Practices, and is intended to provide you with a basic
understanding of the functions and features of the many common tools available in
Sage X3. This course is designed to provide you with the knowledge of:

 How to view and edit general parameters in the system.


 How to work with activity codes.
 How to locate and edit local menus.
 How to set up entry transaction screens to simplify data entry.
 How to set up and reset sequence numbers.
 How to select various data in the system.
 How to enter formulas to enhance your business needs.
 How to integrate with and export data to Microsoft Word, Excel, and PowerPoint.
 How to attach documents and graphics to business documents such as sales orders.
 How to import and export data to Microsoft Excel or to a file.
 How to print documents throughout the system.
 How to work with workflow notifications.
 How to run user-defined inquiries.
 How to access, view, and design process views.
 How to personalize inquiry screens and objects.

Page 4 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Welcome and Introduction (continued)


How to use this curriculum

The following table describes the conventions used in this curriculum

Convention Explanation
Exercise sequence Exercise sequences appear in bold and
are completed in class.
Italic font in an Items that are part of an Exercise and
Exercise appear in an italic font indicate you need to
select a task or perform a specific action to
complete the task (for example, click OK).
Courier font in an Items that are part of an Exercise and
Exercise appear in courier font indicate information
you should enter (for example, at the
Customer No. field, enter 01-ABS).

Logging on to the program


Use the following steps to log onto the program.
1. Click the Sage X3 icon on the desktop of your training image.
2. Type admin as the user name and admin as the password.
3. Click Sign in.

Sage course curriculum - Version 1.0 Page 5


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

2.0 Inheritance

In the following topic, you will learn about the principle of inheritance and how it affects
working in the program.

The topics in this lesson include:

 Understanding inheritance concepts

Page 6 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding inheritance concepts


 What is a folder in Sage X3?
– A folder in Sage X3 contains the rules, parameters, dictionaries, specific
developments, and data for several companies. This means that one folder
contains a Customers table, a Suppliers table, a Product table etc. common to all
companies managed by that folder.
– A folder can also contain general parameters (attached to a company or a facility,
or common to all companies), transactions (invoices, inventory movements, etc.)
and management rules.
– A folder can only be created with reference to another folder which:
– Exists on the same server
– Contains all the needed modules
– Becomes the reference folder for object inheritance
– When the software is installed on a system, the X3 folder is automatically created.
The X3 folder is the top reference for all other folders.
– The reference folder is an existing folder whose dictionary data is used during
folder initiation. A permanent parent link exists between a folder and the reference
folder.

 You can also place Crystal Reports in these folders. Crystal Reports may be in more
than one folder.

Sage course curriculum - Version 1.0 Page 7


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding Inheritance Concepts (continued)


– An endpoint is created for each folder and users are granted access to specific
endpoints. You can change the endpoint by clicking the user name in the Upper
bar as shown below. (This is also known as the User profile panel.)

 The folders comprising the Sage X3 system use the principle of inheritance. This
means when a folder is created, it can inherit software components, reports, and
settings from the parent folder.
– System: Sage X3 folders inherit and rely on software components and settings
from the parent. If a folder requires a program or setting that does not exist in the
folder, the parent folder is searched in order to find the program or setting.
– Reports: Sage X3 comes installed with many reports and uses Crystal Reports.
The reports also share the same principle of inheritance. When a new folder is
created, the original reports are copied from the X3 folder to the new folder
environment. From that point, you should be aware of report codes/names and
understand report inheritance.

Page 8 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding inheritance concepts (continued)


 The following depicts a possible Sage X3 solution. The solution has multiple folders
and each folder serves as a parent, a child, or both. This diagram shows the X3 folder
environment and the purpose for the various folders.
– The two-tier environment is the most commonly-used solution.

– The Test folder is sometimes called the “SEED” folder and contains demonstration
data that you can practice with.
– The Pilot folder is where you start setting up your system.
– The Live folder is the production environment.

Sage course curriculum - Version 1.0 Page 9


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

3.0 General parameters

In the following topics, you will learn about general parameters used to configure the
software, as well as how to view and edit parameters.

The topics in this lesson include:

 Understanding parameters
 Viewing and editing parameters
 Explore what you’ve learned

Page 10 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding parameters
The program is configured by many parameter settings. A parameter is a value influencing
the operation of the software independently from the database structure.

 These parameters allow an implementation team to tailor the program to the needs of
their customers.
 Each module has a set of parameters that govern its behavior.
 You can use parameters for activating and deactivating functionality in the software,
set conditions on a process decision, or influence interface operations.
 Parameters can have the following types:
– Alphanumeric: A series of characters are entered. If the value is controlled by a
table, the selection window is available.
– Numeric: Numbers are entered.
– Date: Enter a date.
– Local menu: A choice is made from a list of options, such as Yes/No. A local menu
is a table identified by a number.
 A parameter is characterized by an internal code, such as ADMUSER, a descriptive
title, and a localization level.
 Parameters available for the supervisor include:
– A default administrator code
– A maximum number of failed attempts at entering the password before locking
– A question relating to the operation trace
 Certain parameters must be defined for the whole folder, while other parameters can
be defined by company or site.
– When a parameter is not defined for a given site, the value for the company that it
is part of is used.
– When no value is defined at this level, the default folder value is used.
– In this way, even if a parameter can be defined by site, it is possible to give a
global value for the folder and then only define the exceptions for certain
companies and/or sites.

Sage course curriculum - Version 1.0 Page 11


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding parameters (continued)


 The most significant value for a parameter is always the one at the lowest level.
Priority is given to the user level, then to the site level, the company, and then to the
folder.

 Most of the parameters defined on a global level and at a user level have an
associated global variable.
– If there is not a global variable, the developer can access its value using a sub-
program.
 You can change some parameter settings for users (Setup > Users > Users, then click
the Parameter definition tab).

Page 12 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Viewing and editing parameters


Use Parameter values (ADPVAL) in the Setup > General parameters block to view and
edit the different parameters used in all the modules.

 In the Left list, select a folder to display the parameters for a particular module.
 The folder you choose is important because each folder can have its parameters set
differently.
– If a site is entered, only the parameters that can be defined at site level can be
modified. If a company code is entered, the parameters that can be defined at
company and site levels can be modified.
– The Folder column indicates the lowest definition level of a parameter group. At the
folder level, all the parameters can be modified, making it possible to assign default
values.
– Some parameters are defined at the user level. In general, the parameters can be
modified, because a default value can be assigned to the site level. On the other
hand, if the value needs to be modified for a given user, these modifications need
to be carried out in the user record.

Sage course curriculum - Version 1.0 Page 13


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Viewing and editing parameters (continued)


Changing parameters
You can access the options available for a parameter group by clicking the Actions icon
for the group in the Parameter values grid and then selecting Detail.

 You can then change a value by clicking the Selection icon in the field to choose a
new parameter value.

 After changing the value, click OK and then click Save in the Parameter values
function to save your changes.

Page 14 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Viewing and editing parameters (continued)


Viewing parameters by group
You can also view parameters within a group listing. In Parameter values, after selecting a
module, select Parameters per group in the Left list.

 By expanding a group, you can see the individual parameter settings.

Sage course curriculum - Version 1.0 Page 15


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Viewing and editing parameters (continued)


Viewing parameter definitions
You can access parameter definitions by developers and advanced users using other
tools, such as the Parameter definitions function. Select Parameter definitions under
Development setup in the Development > Data and parameters block.

Parameters are defined in the data dictionary and are organized into modules and by
group. As previously mentioned, the definition of general parameters is a development
function.

 This function controls the values of parameters and allows for the setup of a parameter
as a numeric, alphanumeric, date, or local menu.
– You can define the level, such as folder, company, site, or user.
– You can also specify how or when a parameter is modified.

Page 16 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Viewing and editing parameters (continued)


 During setup, you may need to know which parameters have an impact on a particular
function.
– The Help index provides information about how parameters work. You can use
Setup > General parameters help accessed from the question mark icon on the
menu bar to display a list of parameters the function uses.

Sage course curriculum - Version 1.0 Page 17


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Viewing and editing parameters (continued)


 Next, select General parameters to find parameters by their module and group.

Page 18 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Viewing and editing parameters (continued)


 Use the Properties option in the Right panel of a function window to identify the path
and view when the parameter definition was created and/or modified.

Sage course curriculum - Version 1.0 Page 19


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following exercises to explore the features you’ve learned in the previous lessons.

Modify and view parameter changes


Estimated duration: 10 minutes
In this exercise, modify default date range parameter and view the change A/P-A/R
accounting > Inquiries > Payments.

1. In the A/P-A/R accounting > Inquires, Select Payments. Make note of the Start date
and End date. ___________________
2. In Setup > General Parameters, select Parameter values.
3. In the Parameter values Left list, expand SUP Supervisor > Folder.
4. Select the SEED folder.
5. At the DEF (Default Values) group, click the Actions icon and then select Detail.
6. In the Parameter values window displayed, enter 01/01/2015 for the DATEDEBDFT
Default start date value and enter 12/31/2015 for the DATEFINDFT Default end
date.
7. Click OK, and then click Save and close the page.
8. Log out and Log In.
9. In the A/P-A/R accounting > Inquires, select Payments. Make note of Start date and
End date. ___________________
10. Close the page.

Page 20 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

4.0 Activity codes

In the following topic, you will learn about activity codes and how to create them.

The topics in this lesson include:

 Understanding activity codes


 Creating activity codes
 Explore what you’ve learned

Sage course curriculum - Version 1.0 Page 21


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding activity codes


Activity codes are character signature codes used to perform a variety of functions, such
as protecting and identifying specific developments, and activating/de-activating tables,
screens, fields, etc. For example, the LOT activity code is used to activate the
management of lots in Inventory.

 Activity codes are assigned at the folder level and influence the behavior of screen
structures and the database structure.
 When changing an activity code, the following is required:
– The modification of the activity code, in the folder record, from the parent folder.
– The validation of the child folder.
 An activity code can contain up to 5 characters.
 Specific activity codes that are customized or belong to verticals start with
 X, Y, or Z, indicating they are considered non-standard and are not affected by
patching.

Page 22 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding activity codes (continued)


Type - Functional
 Protect and identify specific developments.
 Activate and de-activate Sage X3 elements, such as tables, table indexes, tabs,
screen sections, or fields.
– For example, you can use activity codes to hide certain fields on a window.
– When a functional activity code is attached to dictionary elements, such as a
screen section, screen field, or table field, it is de-activated and the system acts as
if those dictionary elements do not exist. Screen fields no longer appear and are no
longer available in the [M] class. Table fields are no longer available in the [F] class
and are not present in the database. You will learn more about [M] and [F] classes
in the Formulas lesson.
 Protect from patches and upgrades.
 Used for identification of patch extraction and dictionary validation.
– Tables, table indexes, table fields
– Screens, screen blocks, screen fields
– Objects, individual object parameters
– Window tabs
Type – Dimension (Sizing)
 Attach a customizable dimension to array elements.
– Table fields
– Screen fields (lines)
 You can mark an activity code as a Sizing type and then use it to control, for example,
how many lines are available to add to a shipment.
 All elements attached to a dimension activity code take the same dimension. Modifying
the activity code dimension and revalidating the elements attached to it applies that
dimension to all the elements (mainly screen sections and screen and table fields).
Type - Localization
 Identify localizations.
– Localization activities start with the letter K
– Screen fields (lines)

Sage course curriculum - Version 1.0 Page 23


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Creating activity codes


Use Activity codes (GESACV) under Development setup in the Development > Data and
parameters block to activate or de-activate elements in the dictionary, such as tables,
table indexes, tabs, screen sections, or fields. For example, you can activate or de-
activate certain fields on screens.

Note: You will learn more about creating and working with activity codes in the System
Administration course.

 The activity code influences the screen and database structures of the software.
 If the Active check box is cleared, any tables, screens, or fields that are dependent on
the activity code will not be available.
 Select the module that the activity code pertains to.
 At the Sequence field, you can determine the order in which the activity codes display
in folder management. Depending on the formula, activity codes are calculated in
ascending order.
 The options at the Type drop-down are used to classify the activity codes in the tabs.
– Functional: Activate or de-activate dictionary elements, depending on whether they
are active or inactive.
– Sizing: This type of activity code has a dimension and is linked to screen fields or
table-type screen sections allowing you to size them or define the maximum
number of possible lines.
– Localization: This type of activity code allows you to enable or disable sets of
elements linked to a given legislation. This type of activity code begins with the
letter K.

Page 24 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Creating activity codes (continued)


 The following is an explanation of the Minimum dimension and Maximum dimension
fields:
– Minimum dimension: This value is always managed by the table. The reason for
using the minimum value is due to Crystal Reports. Although Sage X3 is able to
manage optional fields in the base, a Crystal Reports status that references a non-
existent field on the base will not function. The minimum values are programmed
this way in order for the standard statuses to work in all cases.
– Maximum dimension: This is the maximum possible size for the field. When
minimum and maximum values are identical (or not given, which means that there
is no impact on the base structure), the size only allows you to change the number
of columns or lines displayed on the screen. When the entered size is higher than
the minimum value, the entered size is used to define both the fields for the table
and the screens.
 At the Dependency field, you can determine if the value of an activity code is
automatically entered or not.
– None: The activity code is entered.
– Reverse: The activity code takes the inverse value of the activity code entered. In
other words, if the activity code is active, the corresponding activity code is
inactive.
 Sizing: The activity code is composed of a root followed by a number M (1 to 9), and if
associated with an activity code that can take the numeric values, 1 to N. The activity
code is active if the value of the associated code is greater than or equal to M;
otherwise, it is inactive.
 The Formula field is used to calculate the value of an activity code as a function of an
entry formula. This calculated expression can include constants, functions, and
variables in the form of other activity codes. These activity codes can be the entered
codes or previously calculated codes. The order of the calculation of the activity codes,
depending on the earlier codes, is defined by the rank. An activity code not acting on a
dimension is set to 1 if it is active and 0 if it is inactive.
– The formula field is used to enter a formula and indicate dependence on more than
one activity code. For example, activity code SLO depends on activity codes LOT
and SLT, and will be active only if both are active. The formula in this case is:
LOT<>0 & SLT<>0.

– At the Formula field, you can enter logical or numeric formulas:


o Logical formula: If a logical formula is true, the activity code will be active. If
not, it will be inactive.
o Numeric formula: A numeric formula returning a positive integer value (for
activity codes acting on a dimension).

Sage course curriculum - Version 1.0 Page 25


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Creating activity codes (continued)


Activity code examples
 Example: The ANA activity code is used to define the number of dimension views
managed in a folder and can have values 0 to 9. It is used to define the structure of the
different tables containing the analytical dimension fields and screens. If the ANA
activity code is associated by the dimension links to the codes AX1 to AX9, and if ANA
is set to 5, the codes AX1 to AX5 will be active.
 Example: If the formula given for XXX is max(XAA,XAB), XXX will be active if one of
the two activity codes XAA or XAB is active. If these codes act on a dimension, the
dimension obtained will be the maximum of the two dimensions.

Page 26 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following exercise to explore the features you’ve learned in the previous lessons.

Create an activity code


Estimated duration: 5 minutes
1. In this exercise, create a functional activity code.
2. Under Development setup, in the Development > Data and parameters block, select
Activity codes.
3. Click New.
4. At the Activity code field, type ZTAC and then type Training activity code as the
description. Press the TAB key.
5. In the Text window that appears, click New Text and then click OK when the
information message displays.
6. Select the Active check box, if it is not already selected.
7. At the Module field, select Supervisor.
8. Select Functional the Type field.
9. Click Create.
10. Click the Close button at the Record has been created message.
11. Return to the Navigation page.
Note: You will be using this activity code in a later lesson.

Sage course curriculum - Version 1.0 Page 27


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

5.0 Local menus and miscellaneous tables

In the following topics, you will learn about finding and editing local menus. Local menus
use tables that hold choice information for radio buttons, check boxes, and drop-down
lists. You will also learn how to define and modify miscellaneous tables, which are used
for storing codes, such as payment methods.

The topics in this lesson include:

 Understanding local menus and messages


 Locating descriptions in local menus
 Viewing and editing local menus
 Defining miscellaneous tables
 Modifying miscellaneous tables
 Understanding local menus and messages
 Explore what you’ve learned

Page 28 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding local menus and messages


Database information can be displayed in the form of a list with restricted choices, such as
Yes / No. This information is available in a table that holds the limited choices. This type of
data is called a local menu and the table used is identified by a module number.

 For all the fields in the database storing data of this type, the title row is stored in a
corresponding table.
 For example, if the instance in local menu number 1, is composed of choices No and
Yes (in that order), what is actually stored in the database is 1 for the value No and 2
for the value Yes.
 Local menus are used for the following throughout the software:
– Check boxes
– Radio buttons
– Drop-down lists
 Physically, a local menu type field stores the text number (0-255) and not the text
itself.
 Messages are sets of texts, grouped by local menu, and used for drop-downs and
error/information messages etc.

Sage course curriculum - Version 1.0 Page 29


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Locating descriptions in local menus


Use Message (RECHMESS) under Searches in the Development > Utilities block to
search for a string description in a message or local menu.

 For example, if you want to locate any local messages with the string description
“Yes”, enter Yes in the Message function to return a list of all local menus and
messages containing this string description.

 Enter the text you want to search for within the local menus and messages dictionary.
 You can also determine a string description using the mess(N,M,1) function in the
Calculator (Help > Diagnosis > Calculator).
– For example, to determine the first description from local menu 704 (Stock
Transaction Types), enter mess(1,704,1) in the Calculator as shown below and
then press ENTER.
– In this case, the first string description for the local menu is “Miscellaneous
Receipt.”

Page 30 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Viewing and editing local menus


Use Local menus – messages (TXT) under Tables in the Development > Data and
parameters block to view or modify local menus available in the program.

Note: Modifications of local menus may impose technical actions, such as re-validation
screens if the local menu is used as a radio button. After making a modification to a local
menu, the system automatically launches an update of the local menus.

 The Chapter field indicates the number assigned to the local menu or message.
 Select the Local menu check box to use the menu as a local menu.
 The Changeable check box allows you to indicate whether the local menu can be
modified.
 You can enter the maximum and minimum number of choices in the local menu as
well as the maximum length of the text of the local menu choices at the Length, Mini,
and Maxi fields.
– All local menus are numbered and placed in a range.
 Local menus store up to 254 values, but the code field (in the grid) only accepts
characters A to Z and 1 to 9; therefore, duplicates could occur. This code is only used
for import lookups if needed.

Sage course curriculum - Version 1.0 Page 31


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Viewing and editing local menus (continued)


 The Left list displays all the local menus and messages available in the system.

Page 32 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Viewing and editing local menus (continued)


 When entering a number at the Chapter field, it is important to note that certain ranges
are reserved for vertical developments and custom developments as shown below.

Validating local menus


 The validation process reloads the local menus when connecting to a folder.
 You can also update the local menus directly by using Local menu update
(GENMENULOC) under Dictionary in the Development > Utilities block.
 You would use this function, for example, if you responded No to the update message
in the Local menus – messages function and after performing mass modifications.

 Select the All languages check box to ensure all languages are taken into account by
the update process.
 After clicking OK, the update process begins.

Sage course curriculum - Version 1.0 Page 33


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining miscellaneous tables


Use Definition (GESADV) under Miscellaneous Tables in the Development > Data and
parameters block to define the characteristics of miscellaneous tables or modify existing
tables.

 Miscellaneous tables are used in all areas of the software for storing codes. Examples
of miscellaneous tables include payment methods and freight terms.
 If you are creating a new miscellaneous table, you start by specifying its number, a
title, the information it will store, and the titles for the four fields that can be entered.

 The Table number field uniquely identifies the miscellaneous table.


 Select the Changeable check box to allow the contents of miscellaneous tables to be
modified.
 The Modifiable length allows you to modify the length using the setup menu. The
default value is 5.

Page 34 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining miscellaneous tables (continued)


 Select the Filter company check box if you want to display the Company column in the
miscellaneous table.
 Use the Dependency table field to make the values in the miscellaneous table
dependent on the values entered in another field in the same screen (which is also
controlled by another miscellaneous table).
– A column titled Dependence displays in the miscellaneous table. It is in this column
that the values of the code coming from the dependent table are entered.
 Use the fields in the grid to define additional fields that are alphanumeric and numeric.
You can enter a maximum of 15 each for alphanumeric and numeric.

Sage course curriculum - Version 1.0 Page 35


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Modifying miscellaneous tables


Use Data under Miscellaneous tables in the Development > Data and parameters block to
edit miscellaneous tables.

 The table code identifies the miscellaneous table.


– A certain number of codes are predefined in the software, but you can add a code
using number ranges reserved for this purpose.
 The Dependency column must have a code that is in the Code column of the
dependent table.

Page 36 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following situations to explore the features you’ve learned in the previous lessons.

Edit a local menu


Estimated duration: 20 minutes
You have two new sales associates (Robert Davenport and Sue Klinger) who will be
joining your organization and you need to set up and define their access inside Sage X3.
In this exercise, add a new local menu that contains the days of the week.

1. Under Tables in the Development > Data and parameters block, select Local menus -
messages.
2. Click New.
3. At the Chapter field, enter 5201.
4. At the description field, type Days of week.
5. At the Module drop-down, select Supervisor.
6. At the Activity code field, enter the ZTAC activity code that you previously created.
7. Add the following in the grid:
Number Code Message
1 1 Monday
2 2 Tuesday
3 3 Wednesday
4 4 Thursday
5 5 Friday
6 6 Saturday
7 7 Sunday

8. Click Create.
9. Close the “Record has been created” message.
10. Close the page.
11. When prompted with the Local menu update function, click OK. (Do not select the All
languages check box for this exercise.)
12. Under Searches in the Development > Utilities block, select Message.
13. Type Monday at the Message field and click OK.
14. You should see menu 5201 display with an entry of "Monday" as shown below.

Sage course curriculum - Version 1.0 Page 37


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


15. Return to the Navigation page.
16. Next, you will add Class E to the local menu for the ABC Class field.
17. First, let's determine the local menu number. In the Common data > Products block,
select Products site.
18. Select the first product listed.
19. At the ABC Class field, review the options for this field.

20. While still in the ABC Class field, press ESC+F6.


21. What is the local menu number used for the ABC Class field? _________________
22. Click OK and return to the Navigation page.
23. Under Tables in the Development > Data and parameters block, select Local menus -
messages.
24. Select the local menu identified above.
25. Edit the List of values grid to include Class E.
26. Click Save.
27. Click the Close button at the Record has been modified message.
28. Close the page.
29. Click OK in the Local menu update window that appears. Leave the All languages
check box cleared.
30. Log out of Sage X3 and then log back in.
31. Access Product Site again and review the change. You should now see the option,
Class E, at the ABC Class field.
32. Return to the Navigation page.

Page 38 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


Modify a miscellaneous table
Estimated duration: 10 minutes
In this exercise, modify a miscellaneous table.

1. In the Development > Data and parameters block, under Miscellaneous, select
Definition.
2. In the Left list, select miscellaneous table 21.
3. Make sure the Changeable check box is selected.
4. Click Save if you made a change and close the page.
5. In the Development > Data and parameters block, under Miscellaneous, select Data.
6. Select table 21 (Group 2) in the Left list. Notice there is a dependence on table 20.
7. Insert a line before code line 13 and add a new code of 24 and Refurbished as the title
as illustrated below. Also create a dependency with table 20.
– Click the Actions icon for line 13 and select Insert to insert a line at this position.

8. Click Save.
9. Close the “Record has been modified” message.
10. Return to the Navigation page.
11. In the Common data > Products block, select Products.
12. Select product BMS007(Bike pump).
13. Click the Selection icon in the Group 2 field on the Identification tab.

Sage course curriculum - Version 1.0 Page 39


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


14. Notice the 24 code that you previously created is displayed in the table.

15. Close the Group 2 window.


16. Do not save any changes and return to the Navigation page.

Page 40 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

6.0 Entry transactions

In the following topic, you will learn how to set up and use entry transaction windows to
streamline frequently-used data entry processes in your system.

The topics in this lesson include:

 Setting up and using entry transaction windows

Sage course curriculum - Version 1.0 Page 41


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Setting up and using entry transaction windows


Use Entry transactions under a module’s Setup menu to define how your data entry
windows for transactions display. For example, you may need to hide a price or limit the
entry fields to speed up the entry process. The path to an entry transaction window varies
based on the transaction.

The following paths show how to access the entry transaction windows for various
modules in Sage X3.

– Setup > Purchasing > Entry transactions


– Setup > Sales > Entry transactions
– Setup > Stock > Entry transactions
– Setup > Manufacturing > Entry transactions
– Setup > Financials > Journal entry transactions
– Setup > Financials > Budgets > Budget entry transactions
– Setup > A/P-A/R Accounting > Payment entry types

 The Transaction field is used to identify the transaction you are setting up. You can
also modify or delete an existing transaction code.
 It is not recommended that entry transactions be deleted, especially those delivered
with Sage X3; however, the Active check box can be used to hide entry transactions
from the list that is displayed for the user.
 Use the Access code field to restrict access to certain users.

Page 42 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Setting up and using entry transaction windows (continued)


 The group of companies or sites entered at the Group field is used to filter the records.
 Most fields on entry transaction screens can be hidden completely, displayed, allow for
visibility with no changes made, or allow for both visibility and changes to be made.
For example, the ship-to address in the Orders function can be hidden and filled in
automatically when the customer is selected.
 The program allows the display of tabular data on an entry form for easy editing and
display. The entry transactions also control which fields display on a table, form, or
both. The following shows an example of table mode.

 Good practice is to limit the information on the table entry portion of the business
document to promote speed of entry and ease of use.
 Additional information, usually set automatically, can be set to be edited or viewed only
in form mode. This makes information available if needed but keeps it hidden until
needed. The following shows an example of a form mode window.

Sage course curriculum - Version 1.0 Page 43


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Setting up and using entry transaction windows (continued)


 Entry transactions can control other aspects of the entry process (depending on the
function), such as accounting codes, document sequence numbers, invoicing
elements, and printing options.
– For example, the choice of the entry transaction when using the miscellaneous
receipt or issue process can affect automatic journal entry.
– A function can have many entry transactions designed for a particular purpose.
When a user enters a function with a single entry transaction, it is displayed
immediately. If more than one possible transaction exists, the user is prompted to
select the transaction when entering the function.
– Entry transactions can be used to control the screen available to a user by placing
the transaction on the Users menu. They can also be controlled by access code.
Parameter definition tab
Use the Parameter definition tab to define several elements, such as the automatic
printing of the order acknowledgement, the automatic printing of the prepayment
document, and the display of some specific fields.

 The Document fields allow you to print a Crystal Report. Enter a code to automatically
print a Crystal Report.

Page 44 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Setting up and using entry transaction windows (continued)


Display tab
Use the Display tab to select the columns that will be displayed on the business document
(such as a sales order).

Sage course curriculum - Version 1.0 Page 45


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Setting up and using entry transaction windows (continued)


Header tab
Use the Header tab to specify the management mode (Entered, Displayed, or Hidden) of
some fields in the header of the entry transaction window.

Page 46 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Setting Up and Using Entry Transaction Windows (continued)


Line tabs (1 to 3)
Use the Line tabs (1 to 3) to specify the management mode (Entered, Displayed, or
Hidden) for fields in lines of the entry transaction window.

 Determine the entry mode for each field, such as whether they will be hidden,
displayed or if data can be entered.
 At the Form and table drop-down fields, select whether to view the field on the form,
tabular format, or both.

Sage course curriculum - Version 1.0 Page 47


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Setting up and using entry transaction windows (continued)


Analytical tab
Use the Analytical tab to define whether fields in the document should be entered,
displayed, or hidden, including the dimensions and stock movement fields. You can also
select the type of line dimension entry mode to use for the entry transaction (form table,
form, or table).

Page 48 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Setting up and using entry transaction windows (continued)


Accessing and using the new entry transaction window
 After defining the settings you want in the entry transaction function and validating it,
you can then access the new entry transaction screen from the module and function it
was designed for.
– In our example, we set up a new entry transaction for a sales order, so we will
select Orders from the Sales > Orders block. Notice your new transaction code
displays in the Transaction Selection window.
– Only active transactions are displayed in the Transaction Selection window (by
selecting the Active check box in Entry Transactions).

 You can also force a user to see/trigger a transaction using the Menu profile function
in the Setup > Users block.

Sage course curriculum - Version 1.0 Page 49


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Setting up and using entry transaction windows (continued)


 At the Option drop-down in the Right panel, select Transaction. The entry transaction
window displays allowing you to determine the setup of the transaction. Edits and
changes are not allowed.
– This allows you to view the limits that have been set for a user.

Page 50 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following situations to explore the features you’ve learned in this lesson.

Set up an entry transaction window


Estimated duration: 10 minutes
In the following exercise, set up an entry transaction window for a sales order.

1. In the Setup > Sales block, under Entry Transactions, select Orders.
2. Click New.
3. At the Transaction field, enter NEW as the transaction ID and Order management as
the description.
4. Select the Active check box, if not already selected.
5. Click the Display tab and select all the check boxes in the Header and Line sections.
Keep the Form and Table settings for the drop-down fields in the Line section.
6. Click the Header tab.
7. At the Price - / +tax field, select Displayed. Tab through the remaining fields. Notice
that all the other fields default to Entered. Keep these settings.
8. Click Create. The system will automatically validate the setup.
 You can also click Validate to validate the setup.
9. Close the “Record has been created” message.
10. Return to the Navigation page.
11. In the Sales > Orders block, select Orders.
12. In the Transaction selection window, select the transaction you created.
13. From the Option menu in the Right panel, select Transaction.
14. Take a minute to explore the window and notice how the settings you made in the
Orders function under Setup > Sales displays.
15. Return to the Navigation page.

Sage course curriculum - Version 1.0 Page 51


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

7.0 Sequence numbers

In the following topics, you will learn how to define and assign sequence numbers
associated with business documents.

The topics in this lesson include:

 Understanding sequence numbers


 Defining sequence numbers
 Assigning sequence numbers
 Explore what you’ve learned

Page 52 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding sequence numbers


Sequence numbers are codes that are associated with business documents within the
software, such as invoices, orders, and entries. Sequence numbers can also be
associated with records allowing you to define assignment rules of identifiers and/or
access keys.

– When a sequence number counter is created, or when the counter has never
issued a number, the first number is 1 by default.
– All sequence numbers contain an automatic number that is increased for each
occurrence.
 Sequence numbers are composed of several parts that can be constants or variables
set automatically by the program.
– Sequence number counters contain an incremental numeric segment. The current
value of this segment can be unique or depend on a site, company, month, period,
an additional code, or a combination of these elements depending on the situation.
 A counter always produces alphanumeric keys, but if the type declared is numeric, the
header zeros are deleted when the value is returned.
– For example, if a counter has been declared numeric with six numbers, it will start
with the value “1”; whereas, an alphanumeric counter with six characters starts with
“000001”.

Sage course curriculum - Version 1.0 Page 53


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining sequence numbers


Use Structures (GESANM) under Sequence number definition in the Setup > General
parameters block to define sequence numbers to use at the folder, company, or site level.

 The Sequence counter identifies a counter, which can be used for automatic
numbering of documents in the system.
– A counter is an alphanumeric field with 1 to 20 characters.
– It is composed of a concatenation of sub-fields that can be of different types, and
which are concatenated from left to right to form the counter value.
 You can choose to set the sequence number for use at the folder, company, or site
level.

Page 54 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining sequence numbers (continued)


Return to zero (RTZ) level
The RTZ Level section determines if there is a unique value in the counter at a particular
time, or by month, year, financial year, or accounting period.

 The combination of this setting with the definition level and additional components
defines how many numbering sequences will be assigned to the sequence number
counter.
 If the sequence number contains a year component, the automatic number can be
reset to zero every year.
Sequence type
The Sequence Type section defines the manner in which multi-users’ contentions are
managed on assignment of the number.

 Normal is the standard operating mode. Only one transaction at a time can create a
number by using a sequence number. With this principle, numbers are never lost.
 When a counter is set to Database Sequence, the code of the table used to manage
the sequence number is specified.
– In principle, the numbered documents can be found in the main table.
– This method is efficient if there is no locking involved.
– The numbers assigned are consecutive, but if the transaction is abandoned, there
is a significant risk that gaps may be created.
 The Grouped option defines the number of simultaneously assigned numbers.
– The numbers are assigned by groups of N. N users can then simultaneously obtain
a number without encountering locking problems.
– If the transaction is abandoned, the number is recovered so that they are not lost.
– However, as a result, there may be un-used numbers at the end of the numbering
period. Additionally, gaps may occur because numbers are not assigned in a
strictly sequential manner.

Sage course curriculum - Version 1.0 Page 55


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining sequence numbers (continued)


Components
The Components grid describes the data to be used to make up the sequence number.
Components can include constants, automatic components, customizable fields,
complements, etc. For example, the Complement component can be used to display the
module name in the sequence number.

 The following rules apply:


– A constant has a maximum of 10 characters
– The year is defined with 1, 2, or 4 characters
– The week is defined with 2 characters
– The month is defined with 2 to 3 characters (in this case, English abbreviation of
the month and 3 letters are used)
– The day is defined with 1, 2, or 3 characters (1 character for the day of the week, 2
characters for the day of the month, and 3 characters for the day of the year)
– The company is defined using 1 to 5 characters
– The site is defined using 1 to 3 characters
 Use the Formula field to evaluate a constant without dependence on the numbering.
Miscellaneous
 Use the Chronological control check box to activate the sequential control of
documents. You can also determine the length of the number created by the sequence
control number at the Length field.
 The Length field displays the total length of the number created by the sequence
control number.
 The Reset to zero check box allows you to set the counter to zero manually.

Page 56 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Assigning sequence numbers


Use Assignment (GESTCA) under Sequence number definition in the Setup > General
parameters block to assign a sequence number to each type of document or object used
in the software. Sequence numbers are assigned to the different documents by module.
They can also be set manually. Some documents have more complex sequence number
assignment methods (such as sales invoices).

 At the Module field, select the functional module for which you want to define the
sequence number assignment.
 The Document type field defines the document type to be numbered.
 Enter the sequence number associated with the document defined in the Document
Type field.

Sage course curriculum - Version 1.0 Page 57


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Assigning sequence numbers (continued)


 If the Manual field is set to Yes, the number can be entered manually. In this case,
automatic assignment is not attempted by the system. However, the sequence number
will be automatically assigned when the transaction is created if the document number
is not entered (that is, if the field is left blank).
 If the Manual field is set to No, the sequence number can only be automatically
assigned by the system and never entered or modified.
– Note: If you allow users to manually assign sequence numbers, you could lose the
integrity and chronological coherence of the series for the particular document or
transaction.
– It is recommended that sequence numbers always be assigned by the system
unless there is a compelling reason not to do so.
Applying sequence numbers
You can also apply sequence numbers in various function windows. For example, in the
Product category window shown below, you can select the product sequence number that
you created previously in the Structures function.

 The product sequence is a code defined in the Structures function under Sequence
Number Definition in the Setup > General Parameters block.

Page 58 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Resetting sequence numbers


Use Sequence number values (MODCPT) under Miscellaneous in the Development >
Utilities block to reset the initial value of the numbering sequence. You can also use this
function in case of data recovery to restart the number sequence with the number after the
last one used.

Note: The modification of the sequence number must be locked to other users and only
used in the initial phase of recovery.

 The Counter field identifies a counter, which can be used for the automatic numbering
of documents.
 When a sequence number counter is defined by company or site, the company or site
code is part of the key that determines the record of the table where the current
sequence number is stored.
 This function is not necessarily the only place you can assign sequence numbers - in
some cases, sequence numbers are defined directly in the database records.
 Note: It is important to increment higher than the number being used to prevent key
failures.
 The Next value field determines the next value of the counter.

Sage course curriculum - Version 1.0 Page 59


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following situations to explore the features you’ve learned in this lesson.

Define a sequence number


Estimated duration: 10 minutes
In this exercise, define a product sequence number.

1. In the Setup > General parameters block, under Sequence number definition, select
Structures.
2. Click New.
3. At the Counter field, enter ZINV.
4. At the Title field, enter Training invoice.
5. In the Definition level section, select the Site option.
6. In the RTZ level section, select the Monthly option.
7. In the Type section, select the Alphanumeric option.
8. In the Components section, add the following:
Component type Length Formula
Site 5
Year 2
Month 2
Constant 5 INVBC
Sequence 6
number

9. In the Sequence type section, select the Normal option.


10. In the Miscellaneous section, select Reset to zero.
11. Click Create.
12. Close the “Record has been created” message.
13. Return to the Navigation page.

Page 60 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

8.0 Selecting records

In the following topics, you will learn about the various selection processes available for
searching for and selecting records within the program.

The topics in this lesson include:

 Using the Selection option


 Searching for customer records
 Explore what you’ve learned

Sage course curriculum - Version 1.0 Page 61


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Using the Selection option


Use Selection in the Right panel to filter on advanced selection criteria or to filter on a
specific item. You can search a large list of documents making it easier to find information
or view only documents pertaining to the function at hand. For example, you may want to
see only products within a chosen category or planned by a particular buyer.

 Under Selection in the Right panel, you can choose an advanced search or keyword
search.

Page 62 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Using the Selection option (continued)


 When you select Advanced selection, the following Object selection window appears
allowing you to filter items to narrow your search.
– You can add multiple lines to filter on using the And / Or options. In the example
below only records with an invoice status of Not Invoiced and an order status of
Closed will display.
– Selecting the Memo parameters check boxes allows you to change the parameters
before each search is performed.

 You can also click the Selection icon in the field to select a specific item to filter on.

Sage course curriculum - Version 1.0 Page 63


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Using the Selection option (continued)


 After entering all the needed filters, click OK. The Left list redisplays with the filtered
information.

Page 64 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Using the Selection option (continued)


 You can also save a selection by clicking Memo in the Right panel of the Object
selection window to save the filter for future use and to access any previously saved
filters.
– Selecting the Global check box makes the selection available to all users when it is
saved.
– Entering the STD code causes the selection to run every time the user reenters the
function. This can make the selection display in a particular order or based on a
particular attribute of the object.
– Click OK to save the memo settings.

– After adding the selection menu, you must close out of the current function and
return in order to see the new code on the Selection drop-down menu.

– Selecting All shows everything in the screen, similar to not having any filters set.

Sage course curriculum - Version 1.0 Page 65


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Using the Selection option (continued)


Advanced object selection
Use Advanced object selection to use advanced search capabilities when searching for
specific objects in a field.

 For example, when entering a sales order, you can use the Advanced object selection
to search for specific products.
 It is accessed by clicking the Actions icon and selecting Advanced selection.

 Default settings automatically display for fields and operator based on the object;
however, you can remove and add fields.
 You can also define sort criteria for the list displayed and define the number of records
listed.

Page 66 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Searching for customer records


Use Customer search (FUNCUSSEA) in the Common data > BPs block to quickly and
easily locate existing customers or prospects. This is especially helpful in high-volume and
call center environments.

 From the Right panel, you can create a new customer, access inquiries such as
Quotes and Orders, and even create a CRM appointment, function, or project.
 Click Clear in the Right panel to clear all selection criteria in order to start a new
search.
 When entering a customer or prospect number, all addresses for that customer or
prospect display in the grid.
 As information is entered into fields, the results display dynamically within the grid.
– Selection criteria are combined using “and” logic. Only records that meet all the
criteria are displayed.
 The ship-to customer and contact tables are searched at the same time.

Sage course curriculum - Version 1.0 Page 67


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following situations to explore the features you’ve learned in the previous lessons.

Search using the Advanced selection


Estimated duration: 10 minutes
In this exercise, use Advanced selection to find all products with a product type of Part.

1. In the Sales > Orders block, select Orders.


2. Select STD as the transaction type.
3. Select any order sold to NA009.
4. In the Right panel, expand Selection.
5. Select Advanced selection.
6. In the first field, click the Selection icon and select INVSTA (from the SORDER table).
The description Invoice status appears.
7. Keep the Operator set to Equal and at the Values field select Not invoiced.
8. In the second row, click the selection icon and select ORDSTA (from the SORDER
table). The description Order state appears.
9. Keep the Operator set to Equal and at the Values field select Closed.
10. Click OK.
11. The Left list should now only display sales orders that have not been invoiced and that
are closed.
12. Return to the Navigation page.

Page 68 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

9.0 Formulas

In the following topics, you will learn about the language used to develop the Sage X3
environment. You will also learn about the components used in the Sage X3 language, as
well as how to create formulas.

The topics in this lesson include:

 Understanding formula concepts and components


 Entering formulas

Sage course curriculum - Version 1.0 Page 69


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding formula concepts and components


Sage X3 provides a way to use formulas or expressions that allow for setup,
parameterization, and personalization that relate directly to a company’s business needs.
The syntax used for these formulas and expressions is the same as used by developers.
Not all functions can be accessed and used by non-developers. The following table lists
some of the components available in the Sage X3 language.

Components Types Examples


Constants Signed / Un-signed numerical 5, -238, 3.14150
Character string “Test”
Dates [10/01/2010]
Data fields Table – belongs to class [F]
[F:Abr]FieldName [F:BPC]BPCNUM
Screen – belongs to class [M]
[M:Abr]FieldName [M:SOH]ITMREF
Variables Local – belongs to class [L]
System – belongs to class [S] date$
datesyst
nomap
Global – belongs to class [V] GUSER
GFONCTION
GOLDETAT
Functions Arithmetics Absolute value ‘abs(nbr)’
Strings Left part ‘left$(str,nbr)’
Dates Returns the year ‘year(date)’
Miscellaneous Formatting ‘format$(str,str)’
Functions Value of an Activity Code
‘func AFNC.ACTIV(COD)’
Operators Numeric +-*/^=
Comparison Different from ‘< >’
Logical And ‘&’
Or ‘|’
Not ‘!’
Or exclusive ‘?’

Page 70 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding formula concepts and components (continued)


 You can view the names of fields and screens by pressing ESC+F6 in any field in the
software. As shown below, the field and screen name displays.

 Examples of data fields:


– [F:BPC]BPCNUM matches the key of the Customer form (BPC is the abbreviation
for the BPCUSTOMER table).
– [M:BPC0]BPCNUM matches the value entered or displayed in the BPC object
header, which manages the customers.
– For an object named XXX, the screens are represented with [M:XXX0] for the
header and [M:XXXi] for the tabs.

 Note: The header is usually represented with 0 (zero) and tabs are represented with
1,2,3, etc.; however, if a screen does not have any tabs, the header is represented
with a 1. For example, [M:ABC1] uses a 1 for the header instead of a zero.

Sage course curriculum - Version 1.0 Page 71


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding formula concepts and components (continued)


Understanding variables
 A variable in programming is a symbolic name associated with a value. Some
variables can be changed and some cannot such as date$, time$, and datesyst.
 You can view all the system variables and functions in the Sage X3 Help system.
 Some global variables control various aspects of the behavior of the software and can
be viewed and changed.
– GNBGAUCHE: Controls the number of lines displayed in the QuickSelect left list.
– GNBSEL: Controls the number of lines displayed in an F12 selection window.
– GUSER: Gives the code of the connected user.
– GFONCTION: Gives the code of the function currently in use.
 Global variables usually start with the letter G, but can start with X, Y, or Z depending
on specific modifications.
– You can associate a parameter or process with a global variable. For example,
when used by a supervisor, you can load the global variable with the value of the
parameter during connection to a folder or when a user is changed.
– Global variables can be viewed and maintained in the Global variable (GESAGB)
function under Development setup in the Development > Data and parameters
block. The screen below shows a global variable (GDATEDEB) with a parameter
and process associated with it.

 The Parameter field on the Initialization tab is used to link the variable to a parameter.

Page 72 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding formula concepts and components (continued)


 The Script field on the Generation tab shows the process in which the variable will be
declared.
Understanding functions
 A function is a block of code that performs a certain function and can correspond to a
menu or a process.
 Standard functions are defined in the Sage X3 library.
 You can view the standard functions in Subprograms (GESASU) under Scripts in the
Development > Script dictionary block.

 The Subprograms field displays the sub-program or function that can be re-used and
accessed from the dictionary.
 Select the Function field to distinguish between functions and sub-programs and then
select the argument at the Argument type field. For example, you can select
Character, Date, or Integer.

Sage course curriculum - Version 1.0 Page 73


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding formula concepts and components (continued)


 Use the Parameter definition section to identify each parameter (10 character code)
using uppercase letters and numbers. There is no dictionary for these parameters.
 Use Functions (GESAFC) in the Development > Script dictionary block to view a list of
all functions in the software database that are called from a menu.

 At the Code field, enter a code to identity the function. Codes starting with GES are
automatically generated.
 Use the Options grid to define the option codes.
 Use the Variables grid to define a list of global variables that must be assigned in order
to give a calling process more specific context.
 Use the General tab to enter general characteristics of the function.
 Use the Action tab to identify the action to be executed.

Page 74 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding formula concepts and components (continued)


 The following are examples of the CPTANUSIM (Simulation Cancellation) and
FUNDBENCH (Planning Workbench) functions. Notice the options and variables
defined for these functions.

Sage course curriculum - Version 1.0 Page 75


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding formula concepts and components (continued)


 Many functions are available to apply to formulas. The following tables show
numerical, date, string, arithmetic, and miscellaneous functions that are available.
– N = numeric argument
– C = character string argument
– D = date argument
– X = any type of argument.

Numerical functions:

Numerical Functions Description


pi =3.14159265358
abs (N) =absolute value
mod (N,M) =modulation
rou (N,N) =rounding
rou2 (N) =rounding
Val © Converts string into a numerical value
day (D) Extracts the day from a date
month (D) Extracts the month from a date
year (D) Extracts the year from a date
ascii Returns the ASCII code of the first
character of a string
Instr (N,C,C) Searches a sub-string in a string

Date functions:

Date Functions Description


addmonth (D,N) Adds a number of months to a day
eomonth (D) The last day of the month
gdat$ (N,M,P) Date as day, month, year
date$ Current date

Page 76 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding formula concepts and components (continued)


String functions:

String Functions Description


string$(N,C) Repeats a string N times
num$(N) Transforms a number into a string
chr$(N) Creates a string from an ASCII code
left$(C,N) Extracts sub-strings from a string based
on position
right$(C,N) Extracts sub-strings from a string based
on position
seg$(C,N,M) Extracts sub-strings from a string based
on position
mid$(C,N,M) Extracts sub-strings from a string based
on position
format$(C,X) Formats any expression to a character
string
space$(N) Builds a string of N spaces
vireblc(C,N) Deletes spaces from a string (several
options)
ctrans(C,C,C) Translates strings

Arithmetic functions:

Arithmetic Functions Description


find(X,X…) Searches the first argument in the list of
values
sum(N…) Adds a series of numerical values or
concatenates a series of alphanumeric
variables
min(X…) Searches from Minimum in a series of
values
max(X…) Searches from Maximum in a series of
values
avg(N…) Calculates the average of a series of
values
prd(N…) Calculates the product of a sequence of
numerical values
Uni(X…) Searches the uniqueness of a value in a
table of variables

Sage course curriculum - Version 1.0 Page 77


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding formula concepts and components (continued)


Miscellaneous functions:

Miscellaneous Functions Description


Sigma (N,N,N) Used to find the sum of a sequence of
numerical expressions or the
concatenation of a sequence of
alphanumeric expressions depending
on an index. The index varies between
two ranges with an increment of 1.
evalue© Evaluates a formula contained in a
character string.
parse© Syntax analysis of an expression
contained in a character string.
filpath(C,C,C,C) Used to build the access path to a file,
based on the reference and current
applications.

 The following examples provide important information when working with


concatenations.
Example Result
“ABCD”+“EFGH” “ABCDEFGH”
Concatenation with no space
“ABCD” - “EFGH” “ABCD EFGH”
Concatenation with space
“ABCD” + “EFGH” “ABCD EFGH”
Concatenation with spaces
“ABCD” - “EFGH” “ABCD EFGH”
Concatenation with single space
date – date Gives a number of days
date +/- number Gives a date

Page 78 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding formula concepts and components (continued)


 Notes about grids:
– Indexes begin at 0 and lines begin at 1.
– In a grid of N lines, there is a system variable named nolign that gives the number
of the current line (from 1 to N), and an index system variable that gives the index
value (from 0 to N-1). These variables should be used with caution.
– All grids have an associated variable (declared in the definition of the ABS type
block in the screen) which contains the number of lines currently entered. The F6
key is used to find out its name when “focus” is on the grid without being in entry
mode.
 Notes about arguments:
– If an argument is followed by “…”, there may be a finite list of others following the
argument.
– If the argument is an array variable, the following syntax is valid:
CHAP (N..M) signifies that indexes from N to M are inclusive. N and M can also be
calculated.

CHAMP signifies the entire table.

Example: If NBLIG is the variable associated to a table, it may be possible to use


the following to obtain the minimum in the quantity column for all the invoice lines.

min([M:SOH3]QTY(0..[M:SOH3]NBLIG-1)

Sage course curriculum - Version 1.0 Page 79


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Entering formulas
Many windows within Sage X3 provide the capability for entering formulas or expressions
for the purpose of defining default values, specifying conditions, and constructing
messages.

Using the Calculator


Use the Calculator to evaluate formulas and ensure they conform with the Sage X3
language. The Calculator is typically used by developers.

 You can access the Calculator by clicking Help > Diagnosis in the Right panel.

– The Calculator window appears.

 You can enter up to 240 characters in your formula.

Page 80 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Entering formulas (continued)


 After entering a formula, press the ENTER key to evaluate the formula. The results
display below the formula.

 Click the Actions icon in the Calculation field and select Variable class to view
information about the variable.
– In the Debugger window that displays, enter the variable at the Class field, and
then press ENTER.

Sage course curriculum - Version 1.0 Page 81


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Entering formulas (continued)


Accessing the Formula Wizard
The main way to add formulas or expressions is to use the Formula wizard. To access the
Formula wizard, click the Actions icon in any field in which you can enter a formula and
then select Formula wizard.

Using the Formula Wizard


Use the Formula wizard to build a formula by selecting the existing fields, variables,
operators, and functions that are available.

 The Formula wizard is context sensitive and displays the appropriate open mask and
file classes. You can then select from the fields, functions, and operators that display.
 Use the Fields and Variables section to select fields and variables for your formula.
 Use the Formula section to build the formula
 Comparison operators allow you to determine if a variable is equal to, different from,
less than, or greater than another value.
 Click Verify to validate the formula.

Page 82 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Entering formulas (continued)


 If you select the New table/view or New screen options, a selection window displays
allowing you to select a table, view, or screen. The variable then becomes available in
the Fields and Variables section of the Formula wizard window. You can then use the
variable when building a formula.

Sage course curriculum - Version 1.0 Page 83


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Entering formulas (continued)


Adding variables and functions to the Formula wizard
Use Formula wizard setup (GESAVR) under Development setup in the Development >
Data and Parameters block to add local and global variables and functions to the Formula
wizard.

 The Function field defines the code for the function. This code is mandatory for local
variables.
 The Type field identifies the category for the elements that can be selected in the
Formula Assistant.
 In the grid, enter the function you want to add to the Function list. You select the
function or build the function using the Formula Assistant.

Page 84 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following situations to explore the features you’ve learned in the previous lessons.

Use the Calculator to test variables


Estimated duration: 10 minutes
In this exercise, use the Calculator to test and view certain variables.

1. In the Common data > BPs block, select Customers.


2. In the Right panel, select Calculator from Help > Diagnosis.
3. In the Calculator, test the following variables. Enter the values in the Entry column
below and then write your results in the Results column.
Variable Description Entry Results
GFONCTION Current function [V]GFONCTION
WOSTAUZ Authorized credit [M:BPC2]WOSTAUZ
PTE Payment terms [F:BPC]PTE
XREP0 Sales Rep [M:BPC4]XREP0
CRY Country [M:BPRC]CRY
FREINV Freight Invoicing [F:BPC]FREINV

4. In the Calculation field, click the Actions icon and select Variable class.
5. In the Debugger window that is displayed, at the Class field, enter [F:BPC].
6. Press the ENTER key.
7. Take a few minutes to view the information displayed.
8. Close all pages and return to the Navigation page.

Sage course curriculum - Version 1.0 Page 85


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


Add a function to the Formula Wizard
Estimated duration: 10 minutes
In this exercise, verify some global variables and add functions so they can be used in the
Formula wizard.

1. In the Development > Data and parameters block, under Development setup, select
Formula wizard setup.
2. In the Left list, select the first Global variables in the list.
3. Add the following global variables to the existing variables.
(Go to the next line in the grid and start entering the following.)
Variable Code Description
GDATEFIN Default end date
GCURFCY Current site
GFONCTION Current function
GNOTATI Price - Tax/+Tax

4. Click Save.
5. Close the “Record has been modified” message.
6. From the Help > Diagnosis menu in the Right panel, select Calculator.
7. Click the Actions icon in the Calculation field, and select Formula wizard.
8. In the Fields and variables section, expand the Global Variables list.
9. Verify that the global variables that you entered are displayed.
10. Close all pages and return to the Navigation page

Page 86 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

10.0 Attachment management and


Comments

In the following topic, you will learn about attaching documents and graphics to your
current function window and business document (such as an order or product). You will
also learn how to add comments to a page.

The topics in this lesson include:

 Attaching documents and graphics


 Adding comments
 Explore what you’ve learned

Sage course curriculum - Version 1.0 Page 87


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Attaching documents and graphics


Use Attachments icon represented by a paperclip in the Right panel to view and attach a
document or graphic to the current business document (such as a sales order).

 When the mouse pointer comes over this icon, a tool tip appears

 The attachment window displays in a single grid with all the information related to an
attachment

 Attaching a Text entry (stored in database), an Input image, or a File selection link to
an external document is available from the right panel
 The window shows the list of attachments in a grid with associated keywords
 View shows the corresponding file
 The file can be downloaded with file viewer program and can be opened to display the
file content and with the possibility to edit

Page 88 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Attaching documents and graphics (continued)


Text entry link
The text entry link allows you to enter text directly in a dedicated window which is stored in
the database

Input Image link


The Input image link allows you to select or drag and drop an image file to this dedicated
window

Sage course curriculum - Version 1.0 Page 89


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Attaching documents and graphics (continued)


File selection link
The File selection link allows you open the following window to select a file in one of the
volumes available

 It can be filtered by the value entered on the criterion field. * example; typing doc in
the criterion field will display only files containing the “doc”. Wild cards (*,?)
 Clicking on a sub-directory lists the files inside and gives the list of the sub-directory.
 When a file list is longer than 20 lines, a -more- message is displayed. Clicking on this
line will read all the remaining files in the list
 Database attachment and print is also possible for texts and images stored in
database
 For other documents, the document viewer – Office for instance – must be launched to
view documents

Page 90 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Attaching documents and graphics (continued)


File selection link
To attach files from your desktop or network, select action icon at the volume level to
Upload a file by Select file or Drag and drop.

Sage course curriculum - Version 1.0 Page 91


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Adding comments
Use Comments (comment icon) in the Right panel to add a comment to the function
window.

 Enter and format text, images, and links in the drawing area.

Page 92 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following situations to explore the features you’ve learned in the previous lessons.

Attach a document to a sales order


Estimated duration: 10 minutes
In this exercise, attach a Word document to a sales order.

1. Click the Navigation icon in the Upper bar.


2. In the Sales > Orders block, select Orders.
3. Select STD (Standard entry) for the transaction selection.
4. Select any order.
5. From the Right panel, click the Attachments icon.
6. From the Right panel, click Add file.
7. Click [ATT] Attached files
8. Click the Action icon and Upload a file.
9. Click Select file and browse on your desktop for a pdf file. Click OK.
10. At the Keyword 1 field, enter SEASONAL as a keyword for this file.
11. Click OK. Notice the check mark appears on the paperclip.
12. Next, locate the sales order associated with the attachment using the SEASONAL
keyword. From the Selection menu in the Right panel, select Keyword selection.
13. At the Key word field, enter SEASONAL.
14. Make sure the All types check box is selected.
15. Click OK.
16. In the Selection window displayed, click the order.
17. The order associated with the attachment displays.
18. Select the Attachments icon
19. Click the View icon and open the pdf file.
20. Close pdf file, click OK and close the page.

Sage course curriculum - Version 1.0 Page 93


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

11.0 Microsoft Office integration

In the following topics, you will learn how to export data to Microsoft Excel, Microsoft
Word, and Microsoft PowerPoint.

The topics in this lesson include:

 Microsoft Office integration with Sage X3


 Exporting data to Microsoft Office
 Exporting data to Microsoft Excel
 Exporting data to Microsoft Word
 Exporting data to Microsoft PowerPoint
 Explore what you’ve learned

Page 94 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Microsoft Office integration with Sage X3


Microsoft Office tools are the most used professional tools for reporting, data presentation,
and document generation. Through the Sage X3 Office integration:

 You have direct access from Microsoft Excel, Word, and PowerPoint to Sage X3 data
sources.
 You can define templates for reuse.
 Documents can be refreshed at any time.
 Access and user rights are controlled by Sage X3, when creating and refreshing
documents.
As a result of the integration, data is secured, coherent, and up to date, and you can
benefit from all the Microsoft Office presentation features.

 Representation pages, such as List pages, View pages, and Edit pages, as well as
grids within pages allow you to export data quickly and easily into Microsoft Office
applications such as Excel, Word, and PowerPoint.

Sage course curriculum - Version 1.0 Page 95


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Microsoft Office Integration with Sage X3 (continued)


Sage X3 Office add-in
A Sage X3 Office add-in is used to connect to the Web Server to obtain data. The add-in
accesses the Web Server platform as a client while applying access and user rights.

 To install the Sage X3 Office add-in:


– In Administration > Utilities > Installation, select Install addins for Office
– Or, Click one of the Office links (Word mass mailing, Word, Excel, or PowerPoint)
in the program. If the add-in is not yet installed, a link is available in the user
interface to download the add-in.
– Or, use the dedicated function from the following link:
– http://server:serv/msoffice/lib/general/addIn/SyracuseAddinsSetup.msi?&format=ap
plication/x-msi
– Where "server" is the server address and "serv" is the service number. This link is
also available as an Office Add-in download menu item that can be used in a
dashboard.
– In both cases, an .MSI file is downloaded and installed. The installation process
can also be used to uninstall the file.

Page 96 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Office


The actual page displayed determines the links that are available to Microsoft Excel,
Word, and PowerPoint from within Sage X3.

 For example:
– List pages and View pages can export data to Excel, Word, as well as a Word
Mass mailing.
– Edit pages can export data to Excel and Word.
– Grids can export data to Excel.
– Grids can export data to PowerPoint if the grids display numbers.
 In various functions, the Right panel includes Microsoft Office links.

 When in a grid, click the Actions icon to access Excel export.

Sage course curriculum - Version 1.0 Page 97


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Office (continued)


What data is exported?
When clicking a specific Microsoft Office link, the currently-displayed data is what is
exported.

 For example, if you click Excel while on a Customer List page, the list of customers in
the table is exported to Excel.
– If a filter is defined, only the filtered data is exported.
 If you select the Excel export option while in a grid, only the data in the grid is exported
to Excel.
 When exporting from a grid, you are prompted for a title and name for the tab that will
be created in Excel prior to the actual export.
Connecting to the server
The system prompts you for your Sage X3 login user and password, if passwords are
defined. The data being extracted into Microsoft Office is coming from the same server
you are logged into in your browser.

Data extraction
When the connection is completed, the data insertion automatically starts. The Office
client creates the column header and fetches the data in bulk mode.

 The server returns the data by blocks of 1,000 lines.


 A pop-up window displays the progress of the data insertion and can be stopped by
clicking the Stop button.

Page 98 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Excel


Integration with Microsoft Excel allows you to connect on any Web platform data source
(query page) and get and refresh multiple data grids while ensuring direct, fast and
secured access. You can export data from a List page, View page, Edit page, and a grid
to Microsoft Excel, as well as hyperlink from Excel to Sage X3.

Excel report
When exporting to Excel, you are given the option of using an existing template, creating
a template, modifying a template, or using no template at all.

 Select the Choose existing template option to create the report using an Excel
template.
– Click the Selection icon at the Template field. The List of templates window
appears, from which you can select a template.
– Only those templates matching the criteria defined for the template are available
for selection. For example, templates can be made available to only a specific
company.
– This is the only option that will extract data from the entity selected and prompt you
to connect with a valid user ID and password.
 Select the Create template option to create a new template in Excel using the data
from the entity (such as List).

Sage course curriculum - Version 1.0 Page 99


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Excel (continued)


 You can save the document created as a template and upload it using the Sage tab in
Excel.
– Select the Edit template option to modify a template that was previously uploaded
into Sage X3. The template to modify is selected at the Template field.
– After accepting an option, you may be prompted to install the Sage X3 Excel Add-
in if it is not already installed on your system.
– Follow the prompts in the Sage X3 Excel Add-ins installation wizard.
Sage X3 ribbon - Excel
After the Sage X3 Office add-in is installed, the Sage tab appears in the ribbon for
Microsoft Excel.

 Note: After installing Excel, you may need to click the Enable Editing button that
displays below the ribbon.
 When exporting directly to Excel, the server settings and connection are automatically
set based on your browser connection.
 When accessing Excel outside of Sage X3, you must define the server settings before
connecting.
– If you click Connect and a server setting is not defined, you are prompted for the
server settings before getting the connection window.
– The user ID and password entered are the same as those used when accessing
Sage X3 and all security defined applies.

Page 100 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Excel (continued)


Data sources
Click the Data sources button on the Sage ribbon to view, edit, or add additional data
sources to the spreadsheet.

 The window that appears displays any filters or sorts that are defined.
Editing the current data source
To define filter and sort information for the current data source, click the Actions icon in
the Workbook settings window next to the Name field and then select Edit.

Sage course curriculum - Version 1.0 Page 101


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Excel (continued)


The following window appears.

 You can define filter information for each of the columns in the spreadsheet.
– By clicking the Filter icon next to the column description, you can select the
operator and the values to define the filter.
 Clear the Fetch all check box to limit the number of records retrieved.
 In the Order bys section, you can define the extraction sorting order. You can select
multiple columns from the data source before selecting the ascending or descending
order option.

Page 102 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Excel (continued)


Adding data from a pre-defined data source
In the Workbook settings window, select Predefined data sources. The following window
appears

Sage course curriculum - Version 1.0 Page 103


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Excel (continued)


 The first step is to select the endpoint and the menu item at the Datasource field.
– You can either select an endpoint defined as a folder or the Sage X3 Web
(Syracuse) administration endpoint for accessing administration data.
– The data sources listed are based on menu items in Sage X3. For example, the
BPs function.

 After defining the information, click Apply in the Right panel to apply the new
rows/columns to the spreadsheet.

Page 104 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Excel (continued)


 The data from the data source selected is inserted at the current position of the cursor
in the Excel spreadsheet. This can be on the same tab or a new tab.
Adding data from a data source by entity
In the Workbook settings window, select Data model browse to add a data source by
entity.

 The data from the data source selected is inserted at the current position of the cursor
in the Excel spreadsheet. This can be on the same tab or a new tab.

Sage course curriculum - Version 1.0 Page 105


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Excel (continued)


Publishing
After creating the spreadsheet, you can publish the document so that it can be viewed and
edited through Sage X3. To publish the document on a collaborative space, click the
Publish as button on the Sage ribbon and select to publish as a document or an Excel
report template.

To publish as a document:

 Enter a description for the document.


 You can use the Teams field to assign the document to a specific team. Only users
assigned to the team can view the document.
 If the Read-only check box is selected, only the owner can edit the document.
 The owner automatically defaults to the current user’s ID.

Page 106 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Excel (continued)


To publish as an Excel report template:

Sage course curriculum - Version 1.0 Page 107


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Excel (continued)


Exporting data to Excel from a grid
The process for exporting to Excel is slightly different than the process used when
exporting from a List, View, or Edit page. When exporting from a grid (using the Excel
export option from the Actions icon), you can give the spreadsheet a title as well as define
the name of the tab generated.

 When Export is selected in the Right panel, the data is collected and an Excel icon is
added to the Export excel window. Click the Excel icon to view the spreadsheet in
Microsoft Excel.
 After clicking the Excel icon to view the spreadsheet, all other options previously
discussed, such as adding data sources and connecting to a server are the same.

Page 108 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Word


There are two types of links that can export information to Word: Mass mailing and Word.

 Word: This allows you to create a document containing the elements on the page,
defined by a Microsoft Word report template.
– The report option will display as either Word report or just Word in the Right panel.
 Mass mailing: Only available in a List view. This allows you to generate a list of mailing
pages by repeating a mail merge template document for every record in the list.
– A mail merge assistant aids you in the creation of the mail merge document.
Defining templates
Regardless of whether you are creating a mail merge or a report, you must have a defined
template to use before actual data is populated into the template from Sage X3.

Note: You can view a list of Microsoft Word templates already stored in Sage X3 using the
Word templates function in the Administration dashboard view.

Sage course curriculum - Version 1.0 Page 109


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Word (continued)


Word report
When using the Word link from the Right panel, you are given the option of using an
existing template, creating a template, or modifying a template.

 Select the Choose existing template option to create the report using a Word mail
merge template that was previously uploaded into Sage X3 through the Word
templates function.
– Click the Selection icon at the Description field. The List of template window
appears, from which you can select a template.
– Only those templates matching the criteria defined for the template are available
for selection. For example, templates can be made available to only a specific
company.
– This is the only option that will extract data from the entity selected and prompt you
to connect with a valid user ID and password.
 Select the Create template option to create a new template in Word using the data
from the entity (such as List).
– You can save the document created as a template and upload into Sage X3
through the Sage tab in Word.
 Select the Modify template option to modify a template that was previously uploaded
into Sage X3. The template to modify is selected at the Template field.

Page 110 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Word (continued)


Template layout
The layout of the template along with the field references is different based on the entity
from which you launch Word. The template is created based on all the fields present in the
page.

 When moving or deleting fields from the template, you must select the entire field
reference.

Sage course curriculum - Version 1.0 Page 111


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Word (continued)


Sage ribbon - Word
After the Office add-in is installed, the Sage X3 tab appears in the ribbon for Microsoft
Word.

 The Locale field defines the locale code of the user that created the template.
Show fields
If the Show Fields check box is displayed, all the fields associated with the function are
available in the Template fields panel in the right side of the window.

 All the fields are available, grouped by blocks. Standard blocks and collections have
different symbols, and each type of field is also identified by a symbol.

 You can add fields to the document by double-clicking the field in the Template fields
list.

Page 112 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Word (continued)


Viewing data using a template
When using a template, you can view actual Sage X3 data in the document and save the
document for future viewing.

 To view actual data using a template, click the appropriate Word link and select
Choose existing template. In the Template field, select an existing template.
 Clicking OK displays the document displays in Word showing the actual data.

Sage course curriculum - Version 1.0 Page 113


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Word (continued)


Publishing
After creating the actual document with data from Sage X3, you can publish the document
so that it can be viewed or edited through Sage X3. Use the Publish as button to publish
the document on the collaboration space, publish as mail merge template, or publish as a
word report template.

To publish as a document:

 If the Read-only check box is selected, only the owner can edit the document.
– The owner automatically defaults to the current users ID.
 At the Storage volume field, select the storage volume where the document will be
uploaded.
 After publishing the document, click the Save to X3 button again to resave the
document to Sage X3.
 You can also limit the user of the template to team(s) under Tags and Teams. Teams
are groups of users.

Page 114 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Word (continued)


To publish as a mail merge template or word template, the following windows appear
respectively:

 If you want to limit the use of the template to a specific endpoint, select the endpoint at
the Endpoint field.
– If an endpoint is selected, you can limit the use of the template to a specific
company, legislation, and activity code.

Sage course curriculum - Version 1.0 Page 115


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft Word (continued)


Mass mailing
When using Mass mailing, you are given the option of using an existing template, creating
a new empty document, or creating a new document using a defined template in Microsoft
Word.

 Select the Use existing template option to create the mail merge using a Word mail
merge template that was previously uploaded into Sage X3 through the Word
templates function.
– When selected, you can select the template at the Template field.
– Only those matching the criteria defined for the template are available for selection.
For example, templates can be made available to only a specific company.
 Select the New empty document option to create a new template in Word using the
data from the list.
– You can save the document created as a template and upload into Sage X3
through the Sage X3 tab in Word.
 Select the New document by word template option to create the mail merge using a
predefined template available through Microsoft Word.
– When selected, you will be prompted for the Word template to use when the
application is launched.

Page 116 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft PowerPoint


On pages or gadgets where an array of numbers is presented in a graph, the Actions icon
for the graph allows you to export the data and create a Microsoft PowerPoint slide. In the
following example, the Actions icon on the Sales Rep Forecast vs Ordered gadget
provides a link allowing you to create a Microsoft PowerPoint slide displaying the graph.

 The following message may appear: Click Yes if the Microsoft Office Integration addin
is already installed on your system. Click No if you need to install the addin.

 You are then given a choice to open or save the file.


 You may also be prompted to log onto the Web platform server.

Sage course curriculum - Version 1.0 Page 117


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft PowerPoint (continued)


 One of the following may happen:
– If Microsoft PowerPoint is not yet opened, a new presentation opens automatically,
and a graph based on the current series of data is inserted on the first page.
– If Microsoft PowerPoint is already opened, the following window appears, and
displays the different presentations opened. You can then choose the presentation
in which you want to insert your presentation page, as well as the position (after
the current page, at the beginning, or at the end of the presentation):

Page 118 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft PowerPoint (continued)


 Microsoft PowerPoint opens with the graph displayed on a separate slide using the
data array from the original gadget.

 You can right-click the graph to edit the data, format the data series, change the chart
type, along with other actions as shown below.

Sage course curriculum - Version 1.0 Page 119


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to Microsoft PowerPoint (continued)


Sage X3 ribbon - PowerPoint
After the Sage X3 Office add-in is installed, the Sage X3 tab appears in the ribbon for
Microsoft PowerPoint.

Saving the template for use in Sage X3


If you click the Publish as button on the Sage X3 ribbon in PowerPoint, the following
window appears.

 Selecting to publish as a document allows you to enter the different parameters


associated with the document.

Page 120 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following situations to explore the features you’ve learned in the previous lessons.

Export data to Excel


Estimated duration: 10 minutes
You been asked to export sales order data (List page) to an Excel spreadsheet and also
format the Excel spreadsheet.

 Select Read-only pages and then open Sales Orders from the Sales block.
– Click Excel in the Right panel.
– Select the No template option and accept the selection.
– Select Open with (Microsoft Excel).
– Based on security and settings defined on your browser, you may have additional
prompts to allow for the data to display.
– If you are prompted to install the Sage X3 Office Addin, follow the installation steps
you learned in the previous lesson.
 In Excel, you may need to click the Enable Editing button.
 In the connection window, use admin for the user ID/password.
Add data from a predefined data source
Estimated duration: 20 minutes
You’ve been asked to add data to a spreadsheet from a predefined data source on a new
worksheet tab. In this case, you will add data from POHSIGM (My orders) into a new tab
in the Excel workbook.

 In Excel, click the Sheet2 worksheet tab at the bottom of the window.
– Use cell A1.
– On the Sage tab, use Data Sources.
– If prompted, log in as admin for the user name and password.

Sage course curriculum - Version 1.0 Page 121


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


– Use Predfined datasources.

– Use the SEED Folder as the endpoint and STD_X3_ERP_POHSIGM as the


datasource.
– Select to fetch all.

Page 122 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


– The purchase order data displays on Sheet2 of the workbook.

– Click OK if a message appears at the top of the Datasources window.


– Notice that the Workbook settings window now displays information.

Sage course curriculum - Version 1.0 Page 123


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


Publish the spreadsheet
Estimated duration: 20 minutes
You have been asked to publish the spreadsheet you previously created to Sage X3.

 On the Sage tab, select Publish As and then select Document.


– Use SOPO Spreadsheet as the description.
– Use STD for the Storage volume.

 Click Save in the Right panel.


 Click OK when prompted with a message that the document has been successfully
saved.
 Click OK at the Resource has been saved message.

 Close the Document window and Microsoft Excel.


 Return to the Navigation page.

Page 124 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


Export data to Microsoft Word
Estimated duration: 10 minutes
In this exercise, export data in a view into a Word document.

1. On the Navigation page, click Read-only pages in the Left panel.


2. In the Common data block, select BPs.
3. Click Word in the Right panel.
4. In the Word report window, select the Create template option and accept the selection.
5. When prompted to open or save the document, select to open the document with
Microsoft Word and click OK.
Note: You may need to click the Enable Editing button at the top of the Word window.

Based on security and settings defined on your browser, you may have additional
prompts to allow for the data to display.

6. In the connection window that appears, type admin for the user ID and password and
click OK.
7. Your screen should look similar to the following.

Sage course curriculum - Version 1.0 Page 125


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


Move field references in the Microsoft Word template
Estimated duration: 10 minutes
In this exercise, practice moving some fields in the Word document you previously created
and then save the document.

1. With the Word document still open from the previous exercise, remove the Address 2
and 3, Province, Title, and Description columns from the Word document.
2. Adjust the size of the columns as needed.
3. Change the orientation of the document to Landscape.
4. Click the Preview button on the Sage X3 ribbon to preview the document. Close the
preview window.
5. Click the Save as button on the Sage X3 tab in Word to save the document.
6. Select the Save as report template option.
7. In the Document template window that appears, enter TRAIN for the code and
Training for the description.
8. Select the Seed Folder endpoint.
9. Click Save.
10. Click OK when prompted that the template was saved successfully.
11. Close the Word document.
12. Return to the BPs function in the Common data block.
13. Click Word in the Right panel.
14. Select Choose existing template.
15. At the Templates field locate the TRAIN template you previously saved.

16. Open the document.


17. In Word, you may need to click the Enable Editing button at the top of the window.
Notice the data from Sage X3 now populates within the document.
18. Close Word.
19. Return to the Navigation page.
20. .

Page 126 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

12.0 Importing and exporting data

In the following topics, you will learn about importing and exporting data in Sage X3. You
can export data to Excel, as well as export to a file.

The topics in this lesson include:

 Concepts for importing/exporting to a file


 Specifying directory paths
 Transcribing import/export data
 Defining file formats for import/export
 Exporting data to a file
 Importing data from a file
 Correcting rejected records
 Explore what you’ve learned

Sage course curriculum - Version 1.0 Page 127


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Concepts for importing/exporting to a file


When an import/export template is defined (parameterized), it is important to keep the
following concepts in mind:

 The choice of the structure of the files to be imported or exported depends on the
extraction or integration capabilities of the external software.
– The data must be organized in logical groups of lines, which can be different types
(such as header, detail, or sub-detail) or a single type. The organization of these
groups is defined in the Import/export template function discussed in the next
section.
 The import process allows for the creation and modification of actions.
– To determine the action to be carried out on the imported record, the system
performs a test on the object to make sure it exists.
– This test is carried out by loading the primary key for the object with the information
in the imported record.
– As a result, if the primary key is not parameterized, all the records will switch to
creation mode and only function if the key for the object to be created can be
assigned automatically, for example by means of a sequence number counter.
 An import corresponds to an entry simulation for all the screens linked to the imported
object.
– It processes all the fields in the screen by carrying out the same checks as an
interactive entry.
– It does not take into account the fields that cannot be entered in the screen (except
in specific and referenced cases). As a result, the fields parameterized in a
template corresponding to a field that cannot be entered are not imported.
 The order in which the fields are parameterized within the record has no importance.
– The import loads all the fields then imports them in the order of the fields in the
screens.
 Any number of data exports is possible regardless of the object, but this is not always
the case for the import.
– The automatic mechanisms for decoding the data flow and the call to the
conditions linked to the object greatly automate the import, but this is not sufficient
for an automatic import of complex objects. Therefore, not all objects can be
imported.

Page 128 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Concepts for Importing/Exporting to a File (continued)


 In the reference folder, an import template (modifiable) is supplied for each object
where the import is possible; however, there can be peculiarities linked to the import.
– For more information, see the on-line Help associated with the import templates for
which the specific cases exist.
 The following diagram indicates the steps that are covered in this document and the
functions within Sage X3 that are used to accomplish these steps.

Sage course curriculum - Version 1.0 Page 129


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Specifying directory paths


Use Import/export parameters (GIMPEXPPAR) under Imports/exports in the Setup >
Usage block to specify directory paths used by import or export processing on the server
or client. The entries here are not mandatory but supply consistent locations as well as
make the import/export processes more manageable and reliable. This function is
especially useful when running batch jobs.

 Default directories can be referenced with the % character.


 The table below provides information about the options available in the Export
parameters section.

Default This is the default directory in which the files to be exported


directory are created, if the file path given cannot be found.
Temporary This is the full path of the directory for the temporary files
directory used during the export phase. The file to be exported is
created in this directory, and then it is written. After the file is
completely written, it is transferred to the directory where the
file has been declared (the previous directory, if the path
given is related).
Sequence This is the last sequence number. This is the sequence
number number counter used to date the database fields (EXPNUM
field).

Page 130 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Specifying directory paths (continued)


 The table below provides information about the options available in the Import
parameters section.
Default directory This is the full path of the default directory in which the files to
exported will be searched for, if the path given cannot be found.
Temporary This is the full path of the temporary directory used (if
directory assigned) during the import phase. The file to be imported is
transferred in this directory, and then imported.
Final directory This directory corresponds to a directory where the imported
file is transferred after the end of the import. This transfer is
only carried out if a directory has been defined here.
Error directory This is the full name of the directory in which the files
containing the rejected movements during the import are
created (err type files). The name of the file is the same as the
import file, except that it has an “.err” extension.

Sage course curriculum - Version 1.0 Page 131


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Transcribing import/export data


Use Transcribe import/export (GESAOR) under Imports/exports in the Setup > Usage
block to transcribe data during the import/export process. This creates a correspondence
between the local and external codes.

 At the Local code field, define the code used internally in the software.
 At the External code field, define the code used in the files for the data to be imported
or exported.
 The following principles apply:
– A search is made on the value of the field to be exported in the list of values in the
Local code column.
– For an export, if a value is found, it is replaced with the corresponding external
code.
– For an import, if the value is not found in the External code field, and if an external
code is set to *, the corresponding internal code is taken.

Page 132 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Transcribing import/export data (continued)


 Transcribing example:
Local code External code
CHK CHECK
DIV *
* OTHER
– For an export:
o CHK is transcribed to CHECK
o DIV is not transcribed and remains DIV
o Any other choice is transcribed to OTHER
– For an import:
o CHECK is transcribed to CHK
o Any other choice is transcribed to DIV
o OTHER is not transcribed and remains OTHER

Sage course curriculum - Version 1.0 Page 133


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining file formats for import/export


Use Import/export templates (GESAOE) under Imports/exports in the Setup > Usage
block to define file formats for extracting data from the database. This function automates
the process of importing and exporting data through the use of customizable templates.
The following structures can be used when importing or exporting data:

 Flat file with fixed length fields


 Flat file with separator between the fields (and records)
 XML file
 CSV file
Note: An advantage of using XML is that it names the fields of the table and its values
so you can easily check the data in the file.

Page 134 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining file formats for import/export (continued)


 Templates can be customized to meet a company's specific needs.
 It is a good idea to copy an existing template (by modifying the code name with a "Z"
in front of it).
 Import/export template uses objects in order to update the database. An object is
defined by a group of tables and screens, as well as the standard actions associated
with the fields and the update.
– All the controls and actions necessary during the database update are carried out
because a single description for the object is used to generate the code relative to
an on-line update and an update by import.
– When an object only updates a single table, the import template describes the list
of fields from the table to be integrated, remembering that a block of data from the
file to be imported or exported contains the data for a record.
– When several tables are updated by an object (for example the header and the
lines), several blocks of data are found for an instance of the object to be
integrated.
 It is possible to import a table without associating an object with it. The empty object
field is left for this purpose and the table and the fields concerned are entered in the
grid on the Fields tab. The import is then made without any control apart from those
deduced from the formats associated with the data types of the fields in the table.
 The following table shows some commonly-used templates for importing/exporting
data to a file:
Import Type Template Code
Products ITM
Product Site ITF
Standard Cost ITC
Customers BPC
Suppliers BPS
Sales Price Book SPL
Sales Orders SOH
Customer BP Invoices BIC
Purchase Price Lists PPL
Purchase Orders POH
Supplier BP Invoices BIS
Accounting Entries GAS
Financial Budgets BUD

Sage course curriculum - Version 1.0 Page 135


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining file formats for import/export (continued)


Header tab
Use the Header tab to determine whether the template is used for exporting and/or
importing. It is also used to determine the file type and format of the import/export file,
define the character set to use, and organize data into logical group lines.

 The Object field indicates the object code to be imported or exported.


 Use the Function field to initialize the context, especially if the same object is used by
several functions.
 The grid may be empty if the data structure being imported or exported is based only
on a main table.
 You can define the links with any table in the database in which a theoretical link
exists, in order to extract the linked data.
 If the file has a fixed length, you must indicate the number of characters for each
record at the Length field.

Page 136 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining file formats for import/export (continued)


General section

Use the General section to enter the activity and access codes, as well as define the
standard or specific processes. The table below provides information about the options
available in the General section.

Activity code The Activity code field is used to:


Make an element in the dictionary optional if the
value associated with the activity code is null.
Identify the specific/custom elements for codes
starting with X, Y, or Z.
Size a maximum number of lines when the activity
code marks elements from a grid. If the activity
code is disabled, the marked element will not be
used and the associated code (if any) will not be
generated or activated.
Access code The Access code field makes it possible to limit the
access to the current record to certain users. Only
the users having this access code in their profiles
can view and modify the record. The execution
rights associated with a user code are processed in
a particular way in the case of the import/export
templates. If a user has not been granted the
execution rights, they cannot use the template to
import or export data.
Standard script The Standard processing field defines the standard
process which includes the labels of the actions
called in the import/export processes. These
processes are used to carry out initializations,
additional controls and, if required, updates.
Note: The standard processes usually named
IMPXXX, with XXX being the import code, are
supplied for a certain number of imports.
Specific script This field defines the specific/custom process
which is called before the standard process. Some
possible actions are: initializations, additional
controls, and updates.
Note: The standard processes usually named
IMPXXX, with XXX being the import code, are
supplied for a certain number of imports.
Specific script This field defines the specific/custom process
which is called before the standard process. Some
possible actions are: initializations, additional
controls, and updates.

Sage course curriculum - Version 1.0 Page 137


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining file formats for import/export (continued)


Structure section

Use the Structure section to define the structure of the file being imported or exported,
such as file type and format, and field and record separators.

File type The File type field defines the structure used to
manage the data in the file to be imported or
exported. The file types include ASCII 1, ASCII 2,
Delimited, Fixed Length, XML, Flat, and With
Header.
Field separator The Field separator field allows you to enter the
separator to use for separating fields in the file. To
enter a non-printable character, you must enter a
back slash “\” followed by three numbers
represented as ASCII code of the character in
decimal base.
Record separator Use the Record separator field to enter the
separator to use for separating lines in records. To
enter a non-printable character, you must enter a
back slash “\” followed by three numbers
represented as ASCII code of the character in
decimal base. Examples of field separators include
“:” and “,”.
Field delimiter The Field delimiter (usually a single or double
quote) is added in the first and last position for
alphanumeric fields. For numeric and date fields,
there is no requirement for a delimiter.
File format The File format field defines the format of the
characters used in the file, such as ASCII, UTF8,
and USC2.

Export section

Use the Export section to determine whether to use the template for an export. The table
below provides information about the options available in the Export section.

Export Select the Export check box to use the defined


template for exporting data.
Export sequence The Export sequence field stores the value of the
sequence number when the last export took place.
This is useful when performing chronological
exports to process only what has been modified
since the last export took place.

Page 138 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining file formats for import/export (continued)


Import section

Use the Import section to determine whether to use the template for an import. If so, you
can also determine if an existing record can be modified during import. The table below
provides information about the options available in the Import section.

Import Select the Import check box to use the defined


template for importing data.
Special import The Special import check box indicates that the
data imported into the database is made using
specific/custom actions.
Update allowed Select the Update Allowed check box to make it
possible to modify an already existing record during
import.
Tem storage space Select this check box to be able to use the
import/export temporary storage space. For more
information about setting up parameters for using
temporary storage space, see the Handling
Import/Export Anomalies topic in this document.

Sage course curriculum - Version 1.0 Page 139


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining file formats for import/export (continued)


Compiling section

Use the Compiling section to define the character set to use. The table below provides
information about the options available in the Compiling section.

Character set At the Character set field, select which character


set to use. When the ASCII character set is used, it
is possible to use the following various
standardized formats: ISO 8859, IBM PC, and
ASCII 7 bit.
Decimal separator The Decimal separator field defines the decimal
separator used for numbers. If this field is blank,
the system uses a period “ . “
Date format The Date format field defines how the date type
fields are coded (order and number of characters
for the year).
Local menu format At the Local menu format field, the fields of local
menu type are stored as a number representing
their rank in the table. The following choices are
available:
– 0 : Value: This option indicates the rank of the
menu in the table: 1 for the first choice, 2 for
the second etc. This also corresponds to the
internal format under which the local menu is
stored in the database.
– 1 : Code : This option uses the code (on one
character) associated with each choice of local
menu. This code is not visible in local menu
management. It can be defined in the
development functions in message
management.
– N : First Characters: (n>1) the first n
characters of the label are displayed in entry.
When using this option, the search algorithm
searches for the first character, then the
second and so on, until a single corresponding
title exists. If a search is carried out to find
CHQ in a local menu where the titles are
Cash, Transfer, Check, Draft, Bank/credit card,
the algorithm will find Check (the only title
whose first two letters correspond).

Page 140 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining file formats for import/export (continued)


Identifiers
When importing or exporting data, it must be organized in logical group lines, which can
be header, detail, or sub-detail or a single type. The organization of these groups is
defined in the Identifiers section.

 Each group is associated with one of the tables in the database, the first being the
main table of the object, and the others defined by the links from the previous table.
 If fields extracted from different tables are displayed in a single data group, the export
process attempts to resolve the links between tables by using the link structure
described in the dictionary. This supposes that there is only one link possible from the
main table in the group to the described table (if not, the first link encountered will be
used and even if it is not the correct one).
 If the template is defined with a fixed length, it is necessary to define the record length
somewhere and this is done in the group of tables.
– If the group indicator is not required to be present in the list of fields, it is sufficient
to define this group with an empty code. Only one group can then be defined.
 The table below provides information about the options available in the Identifiers
section.
Level This field defines the hierarchy of the different
tables. Level 1 is the main level, a N+1 level
defines a sub-level of the preceding N level.
Indicator This field identifies the group by a code containing
a maximum of five characters. This code is
mentioned in the field grid on the Fields tab and in
the file itself as a group header.
Table This field identifies the structure of the record
groups. Only the tables updated by the object are
usable. For example, it is not possible to
simultaneously import the order and the customer.
Key This field defines the key of the linked table used to
access the detail of the group records (from values
of the upper level tables used in the link
expression).
Link This field defines the link expression, which is a
series of values separated by a semicolon giving
the key values linking the detail table to the header
record.
Length For files with fixed lengths, you must indicate the
number of characters in each record at this field.

Sage course curriculum - Version 1.0 Page 141


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining file formats for import/export (continued)


Example: Entering groups in the Identifiers grid
In the following example, an export template uses companies and sites.

 The main table COMPANY is level 1.


 For this example, information is linked to the accounting currency (ACCCUR field),
which is required in the exported file. In this case, it is not necessary to define a new
group linked to the company table, but simply to define the fields of the TABCUR table
in the group. The export engine then runs through the dictionary to search for the link
between the COMPANY and TABCUR tables. Where there are several links found, it
is the first link that is used.
 If the purpose had been to export information connected with the currency of the
company's stock capital (RGCCUR field), it would have been necessary to create a
second block of data, also of level 1, based on the TABCUR table, and showing
RGCCUR in the link column. It is also what would have to be achieved if the link was
not explicit. For instance, the CREUSR field, which corresponds to the code of the
user having created the record, uses a generic type (A) which does not allow the link
to be made automatically. As a consequence, if information concerning the user
having created the record had to be displayed, it would have been necessary to define
the link by a group.
 Then, suppose that the list of the sites linked with the company needs to be displayed.
A level 2 group is then created, using the FACILITY table, with a link based on the
FCY index and whose value will be the CPY field of the main table.
 Eventually, if the parameter values directly related to each company need to be
extracted, a second level 2 group of data will be created, using the ADOVAL table,
with a link based on the ADW0 index and whose value will be the CPY field of the
main table.
 The grid below summarizes the Identifiers section information that would be entered:
Level Indicat Table Key Link
or
1 CPY COMPANY CPY0 Main
Group
record
1 CUR TABCUR TCU0 [CPY] 1 linked
RGCCUR record
2 FCY FACILITY FCY1 [CPY] N linked
CPY records
2 ADP AD0VAL ADW0 [CPY] M linked
CPY records

Page 142 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining file formats for import/export (continued)


Fields tab
Use the Fields tab to define the different fields being imported or exported. You can also
determine the order in which the fields are imported or exported.

 Note: It is not mandatory to define the fields in all the groups (in fact, some can only be
technical groups defining the links).
 Example: The fields from the order header and the fields from the pay-by customer
record are to be exported in a single group of data (no separator for the data group). In
this case, you need to define two groups (the first defining the orders, the second
associated with the customer with the appropriate link). However, only the lines
associated with the second group are entered in the field tab. These lines can include
both the information extracted from the customer and from the order header (because
both are one line).

 The first line of the file contains a slash ( / ).


 In the File generation section, select to generate the file to a client or server system.

Sage course curriculum - Version 1.0 Page 143


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining file formats for import/export (continued)


The table below provides information about some of the options available on the Fields
tab.

Table This field indicates the Sage X3 code of the table.


Field This field can contain:
The code of a field from the table.
A constant (“XXX” or ’XXX’) (ignored in import).
An expression (ignored in import).
A *n type code which refers to the GIMP(n) (import) variable.
Range This field makes it possible to use a field as a selection
criteria of the data in the export process. The choices include
the following:
No: Means that no start-end range will be entered for this
field when launching the export.
Yes: Means that a start-end range will be entered for this
field when launching the export.
Criteria not displayed: Means that a start-end range can be
entered for this field when launching the export, but that the
field will not be transferred during an import or export.
Table number This is the number identifying the data transcoding table.

Page 144 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining file formats for import/export (continued)


Additional options
 Click Copy in the Right panel to copy the record definition from one folder to another.
 Click Export in the Right panel to define the default values for the criteria to filter the
exported data. When the export is launched, the criteria is displayed and can be
modified. When a chain of exports is launched, the criteria are automatically applied
without entry, for each of the templates in which they have been defined.

 Use the Range section to enter fields for which ranges can be entered.
– Note: If nothing is entered for the First Value and Final Value ranges, all criteria is
selected for that field.
 The tables used in the import or export are listed in the Criteria section in order to
enable any filtering of the data.
– You can define a logical condition. Only those fields meeting this condition will be
exported.

Sage course curriculum - Version 1.0 Page 145


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to a file


Use Exports (GEXPOBJ) in the Usage > Imports/exports block to extract the data from the
database to an ASCII type file (with fixed length or variable with separators), whose
structure is described by an import/export template. This export can be total or
chronological - it will only export the data modified since the last export of this type.

 Select the template you want to use for the export process.
 If the Chrono management check box is selected, the export is only carried out on
records modified since the last export.
 The Data file field displays the path of the export file.
 The tables used in the import/export template are listed in the Criteria section in order
to enable any filtering of the data.
– You can define additional criteria to filter the data to be exported for the table using
logical expressions.

Page 146 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Exporting data to a file (continued)


Displaying the data decoding process
 Click Script in the Right panel to display the data decoding process (from the template)
that will be executed. The process is named WWE#####, where ##### is an
automatically assigned number.

Execution
In the Exports window, click Execution in the Right panel to start the export process. Once
completed, a log window displays indicating any errors, how many lines were exported,
and location and name of the export file.

Sage course curriculum - Version 1.0 Page 147


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Importing data from a file


Use Imports in the Usage > Imports/exports block to integrate the data in the database
from a structured file (XML, with fixed length, or variable with separators), whose structure
is described by an import/export template.

 The Template field specifies the template to be used for the import.
 If the Import/export temporary storage space check box is selected, any wrong lines
that are detected will be placed into a batch in the import-export temporary storage
space.
 The Data file field displays the path of the data file from which the import has been
launched.
 Click Test in the Right panel to import in test mode, where only the decoding of the file
is carried out. The data is not integrated in the database.

Page 148 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Importing data from a file (continued)


Importing the data
Click OK from the Right panel in the Imports window to begin the data decoding process
(comes from the template).

 The process is named WWE#####, where ##### is an automatically assigned


number.
 After clicking OK, you must select the import file. You can either drag and drop the file
into the File Upload window or click Select file to manually select the file.

 After the file is selected, click OK to continue with the import process. After the import
process is completed, the log file displays any errors. A log window then appears.

Sage course curriculum - Version 1.0 Page 149


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Correcting rejected records


Use Import/export temporary storage space (GESAOW) in the Usage > Imports/exports
block to store the details of the rejected data for a given import file. In a batch, each
rejected record is in 1 to N lines. In each line, there is a description of the line structure,
along with the field values in the file. When errors are detected in a given field, they are
highlighted with a preset style. You can use this function to perform the following:

 Modify the rejected data


 Add lines, if needed
 Re-extract the data of a set of batches into a file, so it can be imported again correctly
 Add records in a given batch

Page 150 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Correcting rejected records (continued)


 When setting up the parameters in Import/export template, you can select to use the
temporary storage space during the import process. For more information, see the
Defining File Formats for Import/Export topic in this document.
 The lot number is the batch number assigned from a sequence number counter. This
identifies a consistent group of data imported into the storage space.
 The Template field defines the import/export template that is used when feeding the
storage space.

Sage course curriculum - Version 1.0 Page 151


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following situations to explore the features you’ve learned in the previous lessons.

Specify a directory path


Estimated duration: 5 minutes
In this exercise, specify the default directories for importing and exporting files.

1. In the Setup > Usage block, under Imports/export, select Import/export parameters.
2. At the Default directory field in the Export parameters section, click the Selection icon
and select the ATT volume. Click OK.
3. For Temporary directory field, select the TMP volume and click OK.
4. Make sure 1 is entered at the Sequence number field.
5. At the Default and Final directories in the Import parameters section, click the
Selection icon and select the ATT volume. Click OK.
6. For the Temporary and Error directories, select TMP and click OK.
7. Click OK in the Import/export parameters window.

Page 152 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


Create an import/export template
Estimated duration: 10 minutes
In this exercise, create a customer import/export template by copying an existing
template.

1. In the Setup > Usage block, under Imports/exports, select Import/export templates.
2. Select the BPC Customers template.
3. At the Template field, enter the letter Z in front of "BPC". (We are using "BPC" as a
base and adding "Z" to create a new template.)
4. At the Description field type Customers modified.
5. Click Create.
6. Click Continue when prompted to confirm the duplication.
7. At Identifiers section remove Level Indicator lines C and R.
8. Click the Fields tab.
9. Remove lines 45 to 62.
10. Click Export in right panel.
11. At Range section enter NA001 in First value and NA005 in Final value.
12. Click OK.
13. Click Save and close the page.

Sage course curriculum - Version 1.0 Page 153


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


Export data to a file
Estimated duration: 10 minutes
In this exercise, review customer information, select an export template, and then export
the customers to a file.

1. In Common data > BPS, select Customers.


2. At left list filter the Customer column by NA.
3. Review customers NA001 to NA005, Delivery mode field on Ship-to customer tab.
Notice multiple shipment addresses, each with Delivery modes.
4. In Usage > Import / Exports, select Exports.
5. (Notice default Template to use is the template created) Click OK, you should see log
below.

6. At file prompt, select Open with and click OK and select Note pad. You should see the
image below

7. Select file and Save As "ZBPC", select Desktop, select and create New folder "BPC"
and Save to a new folder.
8. In file at the end of each line D, change 3 to ES01.
9. Save As ZBPCUPD and close.

Page 154 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


Import data
Estimated duration: 10 minutes
In this exercise, import updated customers.

1. In the Usage > Imports/exports block, select Imports.


2. Template will default, click OK.

3. At Select file, select the ZBPCUPD file and click Open.


4. Click OK. Below log will appear showing records updated

5. Close the page.


6. Verify changes at Common data > BPS > Customers.

Sage course curriculum - Version 1.0 Page 155


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

13.0 Printing

In the following topics, you will learn about printing within the software.

The topics in this lesson include:

 Printing in Sage X3
 Printing to Preview mode
 Creating and modifying reports
 Explore what you’ve learned

Page 156 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Printing in Sage X3
Several methods are available for printing documents and reports in Sage X3. You can
print from a report window or from the printing function. Printing from a report
automatically invokes the printing function and assigns the correct report code.

The following are different ways you can print in Sage X3:

 Use the Reports > Prints/group block which contains reports available by module.
– All reports in Sage X3 are organized under categories and located in the
Prints/group block. If more than one report can be printed from a category, clicking
a category opens a window with all the reports listed.

Sage course curriculum - Version 1.0 Page 157


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Printing in Sage X3 (continued)


 In the Reports > Reports block, select Reports to launch a window that displays all the
reports available in Sage X3.

Page 158 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Printing in Sage X3 (continued)


Printing from a function
You can print a report directly from a function. For example, if you are viewing or entering
a sales order, you can print by clicking Print or the Print icon in the Right panel.

 Click the drop-down arrow at the Print icon to have the option of printing the current
record or a list of what is on the screen. Sometimes when printing with the List option,
a summary report is produced. Selecting Record produces the same result as clicking
Print.

 Note: The user may also be automatically forced to print, based on the settings in
entry transactions.
 If two or more documents/reports can be printed from the function, a window displays
listing all the documents or reports that can be printed.

Sage course curriculum - Version 1.0 Page 159


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Printing in Sage X3 (continued)


Report parameters
After selecting one of the reports, the system launches the print function and prompts you
to enter parameters. Some parameters default based on the document being viewed
(such as customer, order number, etc.). You can then set the print destination and click
print to immediately print the document/report.

 The parameter definitions may be different depending on the report you select. You
must enter the required parameter definitions or accept the defaults.
 Use the First and Final value fields to enter a range of values.
 The Print selections line allows you to print the selections in a cover sheet.

Page 160 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Printing in Sage X3 (continued)


 When entering a range of values, any document falling within the range will print
(assuming another parameter value does not prevent printing the document).
 Depending on your setup, you may need to enter additional information, such as
copies, paper size, etc.
 Click the Print button to print or preview the document/report.
 You can defer the report for printing at a later time by clicking Deferred in the Right
panel.
 Note: Print destinations can vary depending on where the user can print to.
Print job
After clicking Print in the Right panel, the print list displays. It shows you the reports
currently set to print, the status, and provides a means of downloading and deleting the
print job.

 The List of field shows the destinations you have set up.
 The Phase field shows the status of the print job, such as Job started or Job finished.
 Click Details for more information about the print job.
 Reports remain in the list until you log out of your current session.
 When the job is finished, the following happens:
– The status bar turns from green and white stripes to solid blue.
– The Download button becomes available.
– “Job finished” is displayed.
– The message “Report available in storage area.” appears in the Details drop-down.

Sage course curriculum - Version 1.0 Page 161


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Printing in Sage X3 (continued)


 Click the Delete icon to remove the report after it is printed. Previewing
When previewing documents or reports, you are automatically given the option of opening
the report in Adobe Acrobat Reader or saving the report.

 Select Save File to save the file with the file name shown.
 Select Open with to open the file with Adobe Acrobat Reader.
– From Adobe Acrobat Reader, you can print or save the file.

Page 162 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Creating and modifying reports


You can create a new report or modify an existing one using Crystal Reports. After
completing a Crystal Report, it must be set up in Sage X3 to function properly. To do this:

 Place the report in the correct REPORT directory.


– The path is on the server in the REPORT directory.
– Note: It is possible to have the wrong version of the report due to inheritance.
 The report must be added to the Sage X3 dictionary.
– The dictionary entry has many controls, such as allowed report run times,
mandatory printers, activity codes, printing formats, and a link to the Crystal Report
name (usually the same as the dictionary entry).
– The parameters passed to the Crystal Report are also controlled in the dictionary.
 The report default parameters must be set up.
 This is done separately for each report.
 The report print codes must be set for it to work with a document/report.
 The report may need to be added to an entry transaction.

Sage course curriculum - Version 1.0 Page 163


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following situations to explore the features you’ve learned in this lesson.

Print a report
Estimated duration: 10 minutes
In the following exercise, access and preview a report.

1. In the Printouts > Prints/group block, under Financials, select A/P-A/R accounting.
2. In the window that appears, select the BPCINV Customer BP invoice report.
3. Select the NA10 company.
4. At the Destination field, select PREVIEW, if it is not already selected.
5. Click Print.
6. In the Print window that appears, click Download.

7. When prompted, select to open the Customer BP invoice with Adobe Acrobat Reader.
8. Review the information on the report using the various options available.
9. Close the Adobe Acrobat Reader window.
10. Close the function.

Page 164 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

14.0 Workflow notifications

In the following topic, you will learn how to define workflow rules, and well as set up and
monitor workflows notifications and events.

The topics in this lesson include:

 Understanding Workflow notifications


 Defining Workflow rules
 Setting up Workflow notifications
 Monitoring Workflow notifications
 Explore what you’ve learned

Sage course curriculum - Version 1.0 Page 165


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding Workflow notifications


Workflow notifications allow emails to be sent based on certain criteria that are met in the
system (alerts). For example, you could automatically generate an email to a recipient
when a sales shipment is created. Other examples include:

 Alert the sales and accounts departments when a key customer places an order that
goes on credit hold.
 Alert an inventory manager when a newly allocated item causes available stock to fall
below its reorder point.
 Alert a purchasing agent that a sales order line requires a direct purchase order to be
issued, or informing a production manager that an order line requires a new work order
to be set up.
 Alert a sales manager and track when orders for a specific sales representative falls
below the targeted gross margin values.
The following depicts a high-level view of the workflow notification process.

Page 166 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Understanding Workflow notifications (continued)


Differences between workflow notifications and workflow rules
 Creating a notification can be the first stage in the definition of a workflow process. In
fact, the creation of a notification leads to the automatic generation of a corresponding
workflow rule.
– After the notification is made, it is possible to modify the workflow rule in order to
include functions not covered by notifications.
– It is important to note, however, that after the workflow rule is modified, the original
notification is deleted.
 You can create workflow rules that trigger an event using the Workflow rules function.
– Creating workflow rules is more complex than creating workflow notifications.
– Compared to the Workflow rules function, the Notifications function has a simplified
entry window and is limited in the triggers that can be processed compared to the
Workflow rules function. Additionally, workflow notifications are limited to two
recipients and there is no associated signature process.
 The software comes with pre-configured workflows.

Sage course curriculum - Version 1.0 Page 167


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining Workflow rules


Use Workflow rules (GESAWA) in the Setup > Workflow block to define the execution of a
number of actions when specific events occur within the program.

 The possible actions are:


– Send messages by the e-mail system
– Display of notifications in Workflow monitor
– Update data through the execution of actions, either directly when the event occurs
or later when the recipient(s) of the notification have performed an action

 Use the Category field to group the workflow rules.


 Data coming from the trigger can be used in the messages, notifications, and actions.

Page 168 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining Workflow rules (continued)


 Use the Conditions column to enter additional conditions in the form of logical
expressions. If these conditions are true, a message is sent and a trace is written to
the log.
 There are many different events that can trigger a Workflow rule. The following shows
the options available at the Event type field.

– Action of the user in object management mode (creation, modification, triggering of


an action)
– Execution of a batch task, an import, or a report
– Signature action on a prior notification (in this case, it is possible to have complex
nested signature circuits)
– Batch process running through a group of tables in the database
 The sending of e-mails is dependent on the use of an e-mail system accepting a MAPI
interface when sending from the client workstation or SMTP POP3 when the message
is sent from the server (this is the case for the majority of e-mail systems available on
the market).
 The recipients of the Workflow notifications can be directly set up in the rule, either
through a user code or through a business partner code and a contact type of the
business partner. It is also possible to create multi-criteria tables called allocation rules
enable a business partner to specify the recipients on the basis of predefined criteria
values.

Sage course curriculum - Version 1.0 Page 169


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Setting up Workflow notifications


Use Notifications (GESAWX) in the Setup > Workflow block to define notifications/alerts.
You can create notifications (alerts) by sending e-mail messages to recipients. The actual
notifications can be viewed in the Workflow monitor, which is discussed later in this
lesson.

Page 170 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Setting up Workflow notifications (continued)


Triggering
 In the Triggering section, you can determine the workflow type:
– Object: An object is used to manage a record in a table or several tables and can
be a window made up of a header and several tabs or a window as a single
screen. An object corresponds to the complete management of the records,
including creation, modification, deletion, etc. For example, the management of
customer, invoices, and the entry of postings are implemented in the form of
objects. The event code corresponds to the object code.
– Functional entry: The rule is triggered when entering a function in the software. The
event code corresponds to the function code (an object coded as XXX corresponds
to the GESXXX function). This type of event can also be used for objects.
– Report: A report is launched. Its code can be specified in the adjacent event code
field.
– Task end: A workflow is triggered at the end of the batch task. Its code
corresponds to the event code (the batch task must have the User message check
box selected; otherwise, it will not work).
Conditions
 In the Conditions section, enter the conditions for the notification.
Recipients
 In the Recipient section, enter the information for the recipient and whether to send a
warning or send email. The expression in the example below identifies the recipient.

Message
 In the Message section:
– At the Object field, enter the contents of the Subject field in the form of a calculated
expression.
– Use the Text area to define the main content of the message.

Sage course curriculum - Version 1.0 Page 171


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Monitoring Workflow notifications


Use Workflow monitor (SAIWRKPLN) in the Usage > Usage block to view the events
pending signature by a given user. Workflow information can be viewed on three tabs in
this function and can be set up by the entry transaction as shown below.

 You can view information for each event, including the messages sent, or the
signature history. The event can also be signed or approved, depending on the
situation.

 If no recipient is selected, information for all recipients can be viewed (unless the
Exceptional delegate check box is selected).
 The workflow notifications for which a signature or approval rule are set up display in
the grid.

Page 172 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Monitoring Workflow notifications (continued)


 Select the Exceptional delegate check box to view users who have been set up as
exceptional delegates in the User delegates (GESAWU) function in the Setup >
Workflow block.
– A delegate is a user who can replace another user in a signature process and/or
receive a copy in the signature process.

Sage course curriculum - Version 1.0 Page 173


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following situations to explore the features you’ve learned in this lesson.

Create a workflow notification


Estimated duration: 20 minutes
In this exercise, create a workflow notification.

Note: The software used for this course may not have Microsoft Outlook implemented.

1. First, set up the e-mail addresses in Sage X3. Under the Setup > Users block, select
Users.
2. In the Left list, select the ADMIN user.
3. Enter admin@sageerpx3.com at the Workflow email address in the Email field, if it is
not already entered.
4. Click Save and return to the Navigation page.
5. Next, let's define the e-mail address for a supplier.
6. In the Common data > BPs block, select Customers.
7. In the Left list, select customer NA004 (Leisure Sports Inc).
8. Click the Contacts tab.
9. Define Derrick Reyes as a contact. Enter DERRICK as the code and enter the
appropriate name and first name information.
10. Enter the birth date of 09/15/74.
11. Enter dreyes@LSI.com as the e-mail address.
12. Click Save.
13. Return to the Navigation page.
14. Now create a notification. In the Setup > Workflow block, select Notifications.
15. Click New.
16. At the Workflow code field, enter ZSD with the description Training workflow
notification.
17. Select the Active check box.
18. Select the Object option and enter SDH for deliveries.
19. Select the adjacent Creation check box.

Page 174 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


20. In the Conditions section, add the following:
(Value) (Condition) (Value)
Sold to Equal to NA004
21. In the Recipients section, add the following:
Type (Value) (Valu Send Warning
e) mail
Business [F:SDH]BPCINV CEO  
partner
User GUSER  

22. At the Object field, type:


"Shipment of your order" - [F:SDH]SOHNUM

23. In the Text section, type:


"Your order shipped on -" |date$|

24. Click Create.


25. Click Validation.
26. Return to the Navigation page.
27. In the Sales > Orders block, select Orders.
28. Select ALL as the transaction.
29. Click New.
30. At the Sales site field, select NA012.
31. Keep the order type as SON.
32. At the Sold-to field, select NA004.
33. On the Lines tab, add the following:
Product Description Ordered Gross price
quantity
FIN004 Adult std mountain bike 1 595.7225

34. Click Create.


35. Close the "Record has been created" message.
36. Write down the sales order number: _______________________________________
37. Return to the Navigation page.
38. First ensure there are enough of product FIN004 to work with. From the Stock >
Receipt/issues transaction block, select Miscellaneous receipts.
– Select ALL as the transaction.
– Click New.

Sage course curriculum - Version 1.0 Page 175


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


– Select NA012 as the storage site.
– Use today's date as the allocation date.
– On the Lines tab, select the FIN004 product.
– Enter 10 for the quantity.
– Click Create.
– Return to the Navigation page.
39. Create a shipment from the sales order. This will trigger the notification. From the
Sales > Deliveries block, select Deliveries.
– Select ALL as the transaction.
– Click New.
– At the Shipment site and Sales site fields, select NA012.
– At the Ship-to field, select NA004 (Leisure Sports - Los Angeles).
– In the Left list, select Order selection.
– Select the sales order you previously created. It should look similar to the order
shown below.

– Complete the steps necessary to post the shipment to customer NA004. (Make
sure the FIN004 product displays on the Lines tab and then click Create.)
40. Return to the Navigation page.
View notification information
Estimated duration: 5 minutes
In this exercise, use the Workflow Monitor to view the notification information you created
from the previous Practice.

1. From the Usage > Usage block, select Workflow monitor.


2. In the Transaction Selection window, select ALL.
3. Click the To Be Read tab.
4. Can you see the workflow trace generated during the creation of the delivery?
5. Return to the Navigation page.

Page 176 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

15.0 User-Defined queries

In the following topics, you will learn about the Requester tools for creating queries (also
known as requesters).

The topics in this lesson include:

 Requester tools
 Creating simple Requesters
 Using the SQL Requester
 Using the Graphical Requester
 Explore what you’ve learned

Sage course curriculum - Version 1.0 Page 177


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Requester tools
A requester is a view of data that is user defined.

 You can create a graph or simple list and then view them on your Sage X3 dashboard.
 There are three main tools that can be used for creating requesters (queries) as
shown below.

Page 178 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Creating simple Requesters


Use Query tool (GESALH) under Printouts in the Setup > Usage block to construct, view,
and print queries. The Query tool uses the temporary extraction of data in a table and runs
a query on the table. The query is then made at several levels of detail by successive
page breaks. The structure of this temporary table allows each user to save the results of
the last request carried out.

Sage course curriculum - Version 1.0 Page 179


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Creating simple Requesters (continued)


 The Query tool:
– Allows you to enter range selections.
– View results in detail or grouped at various levels.
– Allows you to tunnel to the source data.
– View results in character and/or graph form.
– Store results in a temporary table.
– Allows for screen displays and printing.
Fields tab
Use the Fields tab to define the information that will display in the query, such as the order
of the columns, the grouping and page breaks that are to be carried out, the name of the
table from where the information is extracted, and the name of the field and title that will
be displayed on the query screen.

Page 180 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Creating simple Requesters (continued)


Advanced tab
Use the Advanced tab to enter additional information, such as the number of lines,
maximum lines and time, the report code that will be associated with the File > List menu,
selection criteria, and the conditions for the links between different tables in the request.

 Use the Number of lines field to define a logical number of lines by page in the query
screen.

 In the Selections section, enter selection criteria which are logical expressions applied
to the table fields and that can include constants, functions, and operators.

 In the Links section, you can define links that have not been defined in the dictionary.

Sage course curriculum - Version 1.0 Page 181


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Creating simple Requesters (continued)


Access tab
Use the Access tab to define the access conditions to the query and the extracted data.

 The Query type field is used to manage the display of the query with the following
possible behaviors:
– Normal: The query is displayed if the query has already been viewed by the user. If
this option is selected, each user launching the query creates a set of data
belonging to them that cannot be viewed by any other user.
– Shared: This query can be viewed by other users. Shared queries are useful when
a large query is launched by a single user. A group of users can access the
information. It is recommended that only one user run the query, with other users
having inquiry access. It is also preferred to run this type of query in batch mode if
it is large; the corresponding batch code is called CALALH.
– Recalculated: This query is never displayed automatically (must refresh or enter
the criteria). This makes it possible to avoid reloading data if the data is known to
become rapidly obsolete.

 Use the Access code field to limit access to the current record. Only users with this
access code can view or modify the record.

Page 182 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Creating simple Requesters (continued)


Graph tab
Use the Graph tab to define how to represent the data, such as in a grid or graphs. If you
select to present the data in a graph, you can further define the type and format of the
graph.

 The Type field allows you to display a single or multiple graph.


– Single graph: Only one column of values is displayed at a time.
– Multiple graph: All the columns are displayed, combined according to the setting at
the Presentation field.

 At the Representation field, you can determine how the series values are combined in
the display.
– Multiple: The values of each series are presented side by side, with one color per
series.
– Cumulative: The values are presented in a vertical total.
– Comparative: The values are presented in relative comparison. The height of the
graph remains constant.

 The Default graph field defines the graphical representation used for the data , such as
Bars, Lines, Area, or Sectors.
– If only one series of data is available, the graphical representation is fixed by the
setting made at this field by default.
– If several series of values are represented, you can mix the presentation modes. In
other words, one series can be in the form of bars and another can be in the form
of lines.

Sage course curriculum - Version 1.0 Page 183


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Creating simple Requesters (continued)


Running the requester
After setting up a requester, click Create and then Validate in the Query tool window. Click
Run to display the query window. In this window, you can execute the requester by
clicking Search. A screen displays the records that meet the criteria as illustrated below.

Page 184 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Using the SQL Query tool


Use SQL query tool (GESALQ) under Printouts in the Setup > Usage block to create
query requests directly using the SQL language.

 Note the following about using SQL coding in this function:


– You can give titles and a type to columns
– No totals on columns
– Ranges must be defined using two variables
– Variables are defined in SQL using the format %i% (l=1,2…N)
– Any SELECT statements, including complex ones can be written, provided it
returns a field number less than the maximum allowed.

Sage course curriculum - Version 1.0 Page 185


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Using the SQL Query tool (continued)


 At the Query field, enter a code identifying the request.
 Select the Shared query check box to allow others to view the query.
 At the Report field, enter the report that will be associated with the File > List function.
If this is not entered, the report ALISTE is used with the default page format.
 Use the SQL Query section to enter the SQL coding.
 The Graph tab works similarly to the Query tool function discussed in the previous
topic.

Page 186 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Using the Graphical Query tool


Use Graphical query tool (GESALT) under Printouts in the Setup > Usage block to create
the query screens used to display the results of the queries run on the database. It
operates by temporary extraction of the data in a table, then by running an inquiry on this
table. In the simplest use of this function, you can just use the Fields tab to design a
query.

 Use the Fields tab to define the query.


 The Advanced, Access, and Graph tabs work similarly to the tabs in the Query tools
function discussed in a previous topic.

Sage course curriculum - Version 1.0 Page 187


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Viewing Query Requests


Use View queries (EXEALH) under Printouts in the Printouts block to view the results of
the queries you created using the Query tool, SQL query tool, or Graphical query tool
functions.

 In the Selection Query tool window, select your request.

 The request is displayed as shown in the following example.

Page 188 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following situations to explore the features you’ve learned in this lesson.

Create a requester using the Query tool


Estimated duration: 20 minutes
In the following exercise, create a requester (query) and then verify it. The query allows
you to view open items.

1. In the Setup > Usage block, under Printouts, select Query tool.
2. Click New.
3. At the Code field, type ZOIRR and enter Open items to remind at the Title field.
4. Select the Active check box.
5. At the Representation field, select Char or Graph.
6. Set the default display as Graph.
7. Enter the following information in the grid. As you tab through the other fields, accept
those defaults. (Hint: You can also enter the information by selecting Popup view from
the grid’s Action icon.)
Table Field Type Total Sort Group Tunnel Graph
Type
GACCDUDAT DUDDAT D Ascendi No
E (Due Date) ng
(Open Items)
GACCDUDAT BPR BP Descen No No Descriptio
E (Bill-to BP/Ord) R ding n
BPCUSTOME BPCNAM NA None None
R (Company M
(Customers) Name)
GACCDUDAT LEVFUP C No None Value
E (Reminder
Level)
GACCDUDAT AMTLOC MD Yes None Value
E (Ref. amt. 1
curr.)
GACCDUDAT PAYCUR MD No None Value
E (Paid) 1
GACCDUDAT FCY FC None No None
E (Site) Y
GACCDUDAT BPRTYP M None Value
E (BP Type)
GACCDUDAT NUM VC None Yes None
E (Document R
No.)

Sage course curriculum - Version 1.0 Page 189


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


8. Click the Advanced tab.
9. Enter the following formulas in the Selection criteria field and Link expression field:

10. Make sure your formula conforms to programming standards. (Hint: You can do this by
clicking the Actions icon in the field and selecting Formula wizard.)
11. Enter the following at the Link expression field in the Links section.
12. Click the Access tab.
13. Select the Normal option for the type of request.
14. Click the Graph tab.
15. At the Representation field, select Multiple.
16. At the Default graph field, select Bars.
17. In the Right panel, click Create and then click Validate.
18. Click Run and then Search to verify there is data (you can also use the Criteria
button).
19. The requester should look similar to the following:

Page 190 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


Create a SQL requester using SQL Query
Estimated duration: 20 minutes
In the following exercise, create a SQL requester. This requester will display a product list
with descriptions.

1. Under Printouts in the Setup > Usage block, select SQL query tool.
2. Click New.
3. At the Query field, type ZTRAIN and then Training - Show product list at the
Title field.
4. Select the Active check box.
5. Select the Shared query check box.
6. At the Representation field, select Character or graph.
7. Enter the following information in the SQL query section on the Setup tab:
select DISTINCT ITM.TCLCOD_0, cat_count
FROM ITMMASTER ITM
INNER JOIN
(
SELECT C.TCLCOD_0, COUNT(*) cat_count FROM ITMMASTER C
GROUP BY C.TCLCOD_0
) b
ON ITM.TCLCOD_0 = b.TCLCOD_0
8. In the Columns section, enter Product category with a type of CLS. In the second
row, enter Count with a type of L.
9. Click the Graph tab.
10. At the Type field, select Multiple graph.
11. At the Representation field, select Multiple.
12. At the Default graphic field, select Bars.
13. Click Create.
14. Click Validate.
15. Click Run.
16. Click Search to verify there is data (you can also click Criteria).
17. Take a few minutes to review the results.
18. Return to the Navigation page.

Sage course curriculum - Version 1.0 Page 191


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


View a query request
Estimated duration: 5 minutes
In the following exercise, view a query request.

1. In the Reports > Reports block, select View queries.


2. In the Selection window, select ACH039 (Orders not Invoiced).
3. Click Search.
4. Take a few minutes to explore the window that displays. How many orders are there?
______________________________________
5. In the Right panel, click Level - and then click Level +. What are the results of clicking
these options?
__________________________________________________________________
6. Return to the Navigation page.

Page 192 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

16.0 Working with Process flows

In the following topics, you will learn about process flows and how to design your own
process flows.

The topics in this lesson include:

 Viewing a Process flow


 Designing a Process flow
 Understanding Gadgets
 Defining Gadgets
 Explore what you’ve learned

Sage course curriculum - Version 1.0 Page 193


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Viewing a Process flow


Process flows provide an easy way to access applicable functions for a process, such as
order entry for an order entry clerk.

 The process flow window allows you to access all the functions associated with the
entity (in this case, orders). This can be a good feature to use for employees who use
the same tasks daily, such as an order entry clerk.

Page 194 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Designing a Process flow


Use Processes (GESAPR) on the Setup > Interactive dashboard block to create or modify
process flows.

 In addition to selecting the access code and activity codes, you can select whether the
process is of type process or menu.
– The menu type is used to organize the sub-menus in the processes’ browser.
 Use the Description section to design your own shapes and then add links and
actions.
 In the Right panel, select Process import to export the process to a text file. You can
then copy the text and past it into the import phase.

Sage course curriculum - Version 1.0 Page 195


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Designing a Process flow (continued)


 In the example below, a button titled Website was created using the “Create a button”
icon and the “Change the font of the selected text” button.

 You can then create a link to a URL by clicking the “Create/modify a HTTP link” button
and entering a URL to a website in the Location – Webpage Dialog.

Page 196 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Designing a Process flow (continued)


Drawing tab
Use the Drawing tab to design the interface for your process flows. The Drawing tab
provides a wide variety of editing tools that can be used to create graphics and set links to
graphics, for example.

 The File menu allows you to open and save a process flow as well as import or export
the process flow as text (HTML coding).

Sage course curriculum - Version 1.0 Page 197


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Designing a Process flow (continued)


 The Page menu allows you to show page limits and resize the process flow page.

 The Element menu allows you to add a link or actions to an object in the process flow.
Note: You must first select an object using the Selection arrow before adding a link or
action.

 The Help menu provides helpful shortcuts and information when using the editing
tools.

Page 198 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Designing a Process flow (continued)


 The buttons located below the menus allow you to open and save a file, undo or
repeat, link an element to a function and attach actions to an element.

 The buttons allow you to perform various activities such as add links or add actions to
elements.
 The actions you can attach to an element include:
– Show as mini menu
– Lock/unlock mini menu
– Show as tooltip
– Show/hide

Sage course curriculum - Version 1.0 Page 199


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following situations to explore the features you’ve learned in this lesson.

Create a process flow


Estimated duration: 25 minutes
In this exercise, export and copy the HTML coding for an existing process flow to another
process flow. You will also add two new buttons to a process flow.

1. In the Setup > Interactive dashboard block, select Processes.


2. At the Process code field, select VEN05_002 (Process orders) for all legislations.
3. Click the Drawing tab.
4. Select the File menu, and then select Export as text.
5. In the window that displays copy the HTML coding (CTRL A, and then CTRL + C).
6. Click OK.
7. Close the window without saving.

Paste the text into a new process flow.

1. In the Setup > Interactive dashboard block, select Processes.


2. Click New.
3. At the Process code field, enter ZOP and then Order process as the title.
4. On the Description tab, type ZTAC at the Activity code field.
5. Click the Drawing tab.
6. On the File menu, select Import.
7. In the window that appears, paste the HTML coding that you previously copied into the
window that displays. Press CTRL+V to paste the text and then click OK.
8. Notice that the process flow from VEN05_002 now displays for the ZOP process flow.
9. Click Create.

Page 200 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


Add two new buttons to the process flow.

1. Still in the Processes function (Setup > Interactive dashboard), select ZOP as the
process code.
2. Add two new buttons as shown below:

3. Add two buttons as follows:


– Add a button that acts as a tooltip for the first point in the process flow. Type:
Note concerning 'Search price lists'… for the tooltip text.
– Add a button that links to the Contracts (GESSOR) function. Add the text Quick
access to Contracts… on the button.
4. Click Save.
5. Return to the Navigation page.

Sage course curriculum - Version 1.0 Page 201


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


After creating a process, it can be added to a home page (landing page) or the
Navigation page.

Page 202 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

17.0 Defining menu items

In the following topics, you will learn about menu items located within sub menus and my
landing pages

The topics in this lesson include:

 Defining menu item links


 Explore what you’ve learned

Sage course curriculum - Version 1.0 Page 203


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining menu item links


Menu items are located within sub menus (blocks) on navigation pages as shown below.
Menu items can be used to link to representations, functions, processes, queries,
statistics, dashboard pages, and external links.

Page 204 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining menu item links (continued)


Accessing the Menu items function
Use Menu items under Pages in the Administration > Authoring block to define menu item
links.

Sage course curriculum - Version 1.0 Page 205


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining menu item links (continued)


Information section

Use the Information section to define the main characteristics of the link, including the
following:

 Code: Not mandatory. If no entry is made, it will be assigned with an internal code that
will not be displayed.
 Title: This field is mandatory and appears when a menu item is referenced. For Classic
functions, it is recommended to use the function code. For Entities / Representations
pages, it is recommended to use the representation code.
 Description: This is a user-friendly description of the menu item.
 Link type: Indicates what kind of page will be called if the link is activated. The
following choices are available:
– Representation is a page that manages a facet of an entity. Thus, the user will
have to enter an entity, an associated representation and a facet.
– Function (Classic) is a page that manages a function in Classic mode. Therefore,
the function code must be entered.
– Dashboard page is a link that brings the user to another dashboard. The code of
the dashboard is required.
– External link is used when the menu item links to a URL that will have to be given.
 Icon: Indicates the file name and repository of the icon to display.
 Application menu: This check box is used to define how the menu item appears on
mobile clients. This is subject to change in a near future.
Content section

Use the Content section to define additional information:

 Application: Entered for Representation and Function (Classic) link types. This field
refers to the application used for the link.
– The Syracuse collaboration application is used to connect administrative,
collaboration, and authoring pages directly managed by the node server.
– The application is mandatory if the link is a Classic type link.
 Endpoint: Can only be entered for Representation and Function (Classic) link types. If
entered, the link will automatically be displayed in a vignette (if the vignette is
associated with the right endpoint).
 Representation: Entered for Representation link types only. Defines the representation
used for the user interface. This representation is linked to the entity; therefore, only
some representations are available for a given entity. A selection is possible in the
same conditions as for the entity definition. Only a representation attached to the
previous entity can be used.

Page 206 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining menu item links (continued)


 Action: Entered for Representation link types only. Determines the facet of the
representation that will be used. The following facets can be selected:
– Query is used to display a page that lists the entity values and allows to display the
detail of an entity instance, or to edit it, or to create a new instance.
– Details is used to display the detail of an entity instance. A key value must be
entered.
– Edit is used to modify the detail of an entity instance. A key value must be entered.
– Statistics is used when a statistical inquiry page is displayed.
Parameters section

Use the Parameter section contains additional values depending on the link previously
defined. The value that can be sent to the function is usually for the object types function
called GES_xxx_.

 Depending on the entity, additional parameters may have to be entered. If this is the
case, the name and title columns will be filled and the value column must be entered.
 The parameters available may depend from the page called. But some standard
parameters exist especially for query facets, and are documented here.
Display

 Open in: The choice can be:


– Same window: where the page opened by the menu item link will replace the
current page,
– New window: where a new tab will open in the browser to display the page called
by the item link.
Classification section

The Classification section is used for organization purposes and is optional.

 Module: Select the module where you want to place the menu item.
 Categories: Item menus can be associated with categories. The assignment can be
done in categories with a selection window allowing multiple selections.

Sage course curriculum - Version 1.0 Page 207


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining menu item links (continued)


Creating a menu item
To create a menu item, click Create menu item in the Right panel from the List of menu
items window.

Page 208 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Defining menu item links (continued)


Modifying a Menu item
To modify a menu items, click the pencil icon for the menu submodule in the List of menu
items or click the Edit button from the Right panel in the Menu items function window.

Sage course curriculum - Version 1.0 Page 209


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following situation to explore the features you’ve learned in this lesson.

Create a new process flow menu item


Estimated duration: 10 minutes
In this exercise, create new menu item that links to ZOP process flow that you previously
created.

1. In the Administration > Authoring block > Pages, select Menu items.
2. At the right panel, select Create menu item.
3. Enter ZOP as the code and Order process as the title and description.
4. Select Process as the link type.
5. Click in Application and select X3 ERP.
6. Click in Endpoint and select SEED.
7. At Process name, enter ZOP.
8. In Classification section, click Module and select Sales.
9. Click Categories and select Orders, and then select check mark.
10. Click Save.

Page 210 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

18.0 Personalizing landing pages

Landing pages are accessible from the Home page and are initially displayed when
logging onto the program. You can create your own landing pages displaying information
that has been previously defined as accessible by your system administrator.

The topics in this lesson include:

 Creating a landing page


 Modifying a landing page
 Explore what you’ve learned

Sage course curriculum - Version 1.0 Page 211


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Creating a landing page


A landing page is a collection of gadgets. A gadget is a component of a landing page that
can contain:

 A list of links that point to other pages (Normal pages, Classic pages, List pages, View
pages, Edit pages, and other URLs.)
– Normal pages are those that are built to fit with the size of the gadget in the portal.
 Visual processes with or without a menu process.
 Reports or statistical inquiries.
To create a new landing page, from your Home page, click the New option in the Left bar.

 You cannot enter spaces in the page name; however, they can be entered in the title.
 If the Use current endpoint checkbox is selected, any gadgets added to a landing page
must use the current endpoint for execution or displaying of data.
– If the checkbox is cleared, you can use the landing page to display information
from several endpoints.
– The endpoint is always defined when creating the gadget.
 The landing pages you create are listed under My Landing pages in the Left bar.

Page 212 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Creating a landing page (continued)


Adding Gadgets
Gadgets are created using system administrative functions. Once created, they are
available to the user when creating their landing page. The Add new gadgets page
displays automatically when creating a new landing page.

 The endpoint selected is the endpoint used for the gadgets selected.
 Under Browse Category, select the type of gadget you want to add.
– Click Queries to add user-defined reports done by the Requester.
– Click Statistics to add statistical aggregated data set up by the statistical tool.
– Click Web to display a defined web page which includes a specific URL.
– Click Processes to add visual process maps.
– Click Representations to add any page defined by a menu item. This does not
include Classic pages displayed in a full page and not in a gadget.
 Depending on the option selected under Browse Category, different pages display;
however, they all have the same behavior.
– A search field is available to select the gadget by its name. You can add multiple
gadgets by simply clicking on the ones to add before clicking the Finish icon.
– A selection can be done by selecting first a module, then a category, and finally the
gadget.

Sage course curriculum - Version 1.0 Page 213


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Creating a landing page (continued)


 Once the first gadget is selected, the landing page is created and displayed.

 If you place your mouse pointer over the gadget added, you can personalize the
gadget, refresh the gadget, delete the gadget, and minimize the gadget.

– The Personalize icon is not available for all gadgets and is typically used to change
how the data is displayed. For example, you can personalize a gadget to show
data in a grid in a card format.
Assigning Landing Pages
By default, any landing pages you create are automatically available to you under My
Landing pages.

 Using the Home pages function, a system administrator can assign landing pages to
other users based on their role.
 Users with access to this function can also define the endpoint used for each gadget
and change the owner of the landing page.
– Only the owner can edit the landing page.

Page 214 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Modifying a landing page


Once a landing page is created, you can add new tabs and gadgets, change how the
gadgets display, and even share the landing page with other users.

Editing the Landing Page Title & Deleting


 To edit the title of the landing page, click the Pen icon for the landing page name in the
Left bar.
 To delete a landing page, click the Delete icon for the landing page name in the Left
bar.
– You can only delete landing pages you have created and are listed under My
Landing pages.

Adding a New Tab


You can create a landing page that includes information displayed on different tabs. The
first tab is created automatically after selecting the first gadget. To add a new tab, simply
click the “+” next to the existing tab.

 Any new tabs added can be deleted by clicking the Delete icon displayed on the tab
page.
Adding a Gadget
To add a gadget to a page, click the Add gadget icon displayed in the upper right corner of
the page.

 The options available for adding a gadget are the same as when selecting one after
creating a new landing page.

Sage course curriculum - Version 1.0 Page 215


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Modifying a landing page (continued)


Personalizing a Landing Page
When personalizing the landing page, you can change the tab names and delete a tab. If
the tab contains multiple gadgets, you can also select a template which organizes the
layout of the gadgets on the tab.

 To add personalize the landing page, click the Personalize Landing Page icon
displayed in the upper right corner of the page.

 The tab currently displayed on the landing page is the one affected when you click the
Personalize Landing Page icon.
 Templates only display if more than one gadget is added to a tab.
Changing the Order of Landing Pages
You can modify the order in which landing pages display. This is done by pointing to the
landing page to move and clicking on the three dots displayed to the left of the landing
page name.

 Once you click on these dots, you can drag the landing page to a new position in the
list.

Page 216 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following situation to explore the features you’ve learned in this lesson.

Create a new landing page and add Gadgets


Estimated duration: 10 minutes
In this exercise, create a new landing page.

1. Click the Home button in the Upper bar to take you to landing pages.
2. From the Left bar, under My Landing pages, click New to create a new landing page.
3. Type TrainingPage as the page name and Training Page as the title.
4. Click OK.
5. At the Please Select Endpoint field, verify that SEED is selected. If not, select it now.
6. Under Browse Category, click Processes to add a visual process map to the landing
page.
7. Under Modules, select Sales.
8. Under Categories, select Orders.
9. Under Gadgets, select Process Orders.
10. Click OK.
11. Once a gadget is selected, the landing page created displays. You should
automatically see the process flow you selected.

Sage course curriculum - Version 1.0 Page 217


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

19.0 Personalizing pages

In the following lesson, you will learn how to customize the pages displayed including a
new dashboard, Classic page, List page, View page, and Edit page.

The topics in this lesson include:

 Personalizing the layout of pages


 Using Authoring mode
 Explore what you’ve learned

Page 218 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Personalizing the layout of pages


You can personalize the layout of List, View, and Edit pages to meet a company, a group
of users, or an individual user’s specific needs. For example, you can easily change the
order of fields and even the field labels and have those changes appear for a specific
user.

 When personalizing pages, you are able to:


– Change the order of the information on a page.
– Organize hierarchically groups of information that can appear as tabs, columns,
etc.
– Hide elements or make them collapsible.
– Change the widget used for the input of information.
– Change the labels associated with the elements.

Sage course curriculum - Version 1.0 Page 219


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Personalizing the layout of pages (continued)


 You can customize List pages, View pages, Edit, page, Classic pages, and Portal
pages.
– Using the authoring to change the order or to hide fields on a Classic page that
have controls defined may bring unexpected results and should be avoided.
– For example, if you have
 Modified pages are referred to as variants. A variation of the original page.
 For a single page, different authored variants can be defined and assigned to different
users and/or roles.
 If a displayed page has at least one variant that is not the factory page, the name of
the variant used displays to the right of the page title along with a drop-down allowing
you to switch to different authored variant pages.

– Only those variants associated with the user or role assigned to the user are
available for selection.
– If several authored variants are relevant to the user, the variant that matches the
different criteria the best is displayed.
 A default page called SAGE is delivered for all standard pages and cannot be
modified.

Page 220 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Using Authoring mode


When you click the Personalize page icon (looks like a paint brush), you are placed in
authoring mode. The screen layout displays in the middle of the page with structure
selection and drag and drop capabilities. When in authoring mode, the screen is divided
into several sections.

Navigation bar
Use the top Navigation bar to:

 Access global functions for Help and Undo/Redo modifications.


 Access the update functions which are used to save, delete, and close the authoring
mode.

Sage course curriculum - Version 1.0 Page 221


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Using Authoring mode (continued)


 Select the mode displayed in the Navigation bar. There are three modes: Preview,
Display, and Structure.

– Preview mode is used to display the final result. You cannot modify the layout while
in the Preview mode.
– Display mode shows the page components and allows you to modify the layout
using the drag-and-drop method. In this mode, the page can be enlarged to give
the closest view of the final results by hiding the Left list.
– Structure mode shows sections and block as a single field. This is useful when
changing the structure of larger pages. The focus for this mode is organizing the
page. Switch back to the Display mode to fine-tune the details..
Left panel
The Left panel lists the complete structure of the page. This structure is displayed as a
hierarchical tree, in which every level displays in a green color. A page is organized in four
levels.

 A page is organized as a list of sections.


 A section is organized as a list of blocks.
 A block is organized as a list of fields.

Page 222 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Using Authoring mode (continued)


 Clicking on an element in the tree selects the element in the central authoring area.
– The central authoring area displays the element in its color.
– You can also select an element by clicking on it in the central authoring area.
 It is important to keep in mind the level you are modifying. Changes made to such
things as the layout affect everything associated with the level.
For example, if you select the Page definition level, changes can affect the entire level
including any sections, blocks, and fields.

Left panel - Insert tab


Use the Insert tab in the Left panel to insert a new section or a new block onto the page.
You can also use this tab to insert sections, blocks, and fields that were previously
discarded during the authoring session or during a previous by using the Exclude me
option in the Right panel.

 Click and drag either the drop new Section or drop new Block option into the
appropriate area on the Central Authoring page.
– Review the prompt displayed to ensure you are dropping the section or block into
the appropriate area.
 After fields are added, you can drag existing fields into the new sections and/or blocks.

Sage course curriculum - Version 1.0 Page 223


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Using Authoring mode (continued)


 You can delete sections or blocks added by clicking the Delete icon.

Right panel
The options available in the Right panel depend on the level of the selected element.

 The Exclude me option allows you to exclude the corresponding element from the
page.
– Once excluded, the section and all related elements appear on the Insert tab in the
Left list. You can insert the excluded element back onto the page from this tab.

Page 224 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Using Authoring mode (continued)


Appearance
Under Appearance for sections and blocks, you can select to show them as a tab or a
stacked section or block.

 Stacked means the sections and/or blocks are stacked showing one after the other.
Templates
Under Templates you can select from a predefined page layouts and the number of
columns to display.

 Clicking one of the icons applies the model.


– The Smart template is used for the standard deliveries of pages.
– The Default template is the model where no authoring appears and all elements
are stacked.
 For the Page, Section, and Block levels, you can organize them into columns by
selecting the number of columns.
 For fields, the column choice allows you to create columns where fields are
placed. The first column contains the current fields and the next columns are empty
and used as placeholders.
– - You can delete the additional columns added by click the Delete icon
displayed in the column.
Title
Under Title for sections and blocks, you decide if the title is shown, hidden, or displays as
blank.

Behavior
Under Behavior you can determine if a section or block is collapsible or maximizable. The
options under Behavior are only available if the title is not hidden.

 If the collapsible check box is selected, a chevron displays in front of the title.
– By clicking the chevron, it hides and displays the section or block.
 If the maximizable check box is selected, a square icon appears in the upper right
corner of the section or block.
– By clicking the maximizable icon, you can enlarge the section or block to the size
of the current page.

Sage course curriculum - Version 1.0 Page 225


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Using Authoring mode (continued)


Fields label
Under Fields Label, you define the default rules for all field labels on the page, section,
clock, or specific field. They can be hidden, displayed at the top of the field, displayed at
the left of the field, and you can determine if they are left or right aligned.

Row
When multiple columns are used on a page, section, or block, rows are created. If you
click on a row separator, the Right panel displays options for the entire row.

 You can add more rows, selecting the content alignment, and even add columns.
Moving fields
You can click and drag fields to change their location. If you drag a field out of an existing
section or block a new section or block is created automatically.

Page 226 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Using Authoring mode (continued)


Grids
When a page includes a grid, the Gear icon allows you to change how the grid displays.
You cannot modify the actual fields in the grid.

 The options available under Presentation determine if the grid displays as cards,
columns, or columns with details.
– If you select Cards, separate cards are created for each row displaying all the
fields. You can determine if the cards display one right after the other or across a
number of columns you define. You can also select to design card giving you the
ability to change the order of the fields.
– If you select Grid + detailed view, the original grid displays but the details are also
displayed showing the entry in each column of the grid. You can select where the
details display (e.g. bottom of the grid, bottom of each row, top of the grid, left of
the grid, or right of the grid).
– Grid is the original presentation. When selected, you can select whether to hide the
number of records and page size by clicking Hide pager. If hidden, click Show
pager to redisplay the information.
 There are separate help and undo options available specific to the grid.

Sage course curriculum - Version 1.0 Page 227


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Using Authoring mode (continued)


Save & Save As
At the first authoring of a page, only the Save As icon is available. In the Save as window,
you define the characteristics of the authored page such as the code, title, description and
to whom it is available.

 You must enter a code and title for the authored page and an option description.
 Under Save as, select:
– Personal – Creates a personal copy that is only used by the current user.
– Shared with – Allows you to share the authored page with users based on their
role, a specific user, and/or an endpoint.
– Global – Makes the newly authored page available to all users with no restrictions.
 If you are authorizing a page that has already been personalized, you have the option
of either saving the new changes or saving them under a new code.

Page 228 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following situation to explore the features you’ve learned in this lesson.

Personalize a page
Estimated duration: 10 minutes
In this exercise, modify the layout of the Supplier invoices page for your specific user.

1. Click the Navigation icon.


2. In the A/P-A/R accounting > Invoicing block, select Supplier BP invoices.
3. Click the Personalize page icon.
4. You are now in Authoring mode for the Supplier invoices function.
5. In the Left panel, select the page title.
6. In the Right panel, select the Smart template.
7. What happened to the page? ____________________________________________
8. You realize you do not like this page layout. Undo the change you made.
9. In the Left panel, click the Insert tab.
10. Drop a new so that it appears above the existing section.
11. It should appear similar to the following.

12. Move the Site field so that it appears in the new section.
13. Move the Accounting date field to the right of the Site field.
14. Did the Left panel change to reflect the changes you have made? ______________
15. (Hint: Click the Content tab to view the change.)

Sage course curriculum - Version 1.0 Page 229


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


16. In the Left panel, click the Lines section.
Customize a grid
Estimated duration: 10 minutes
In this exercise, customize the grid on the Lines tab.

1. Continuing from the previous exercise, click the Lines tab.


2. Click the Gear icon above the Details grid.
3. Under Presentation, click Grid + detailed view.
4. What happened to the grid? _____________________________________________
5. Change the number of columns to 2.
6. Click design card.
7. Notice the focus is now set to the card and the Right panel includes options similar to
those displayed when selecting the page title.
8. Click the Close button to exit out of the card design mode.
9. Click the Close button without making any changes.
10. Take a few moments to practice making changes and using the Undo button when
necessary.
Save the personalized page
Estimated duration: 10 minutes
In this exercise, save the personalized page you previously modified.

1. Continuing from the previous exercise, click the Save As icon in the Navigation bar.
2. Enter Training as the code and title.
3. Select Personal as the Save as option.
4. Click the OK icon.
5. A note should display at the top of the page indicating the page design has been
saved. Close out of Authoring mode.
Note: If you close without saving changes, a prompt displays giving you the option of
closing without saving the changes or return to Authoring mode to save before closing.

6. The drop-down option next to the function title should now show the personalized page
you created as well as allow you to go back to the default.
7. Close the Supplier invoice function.

Page 230 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

20.0 Personalizing inquiries and objects

In the following topics, you will learn how to personalize inquiry screens and objects
across the software.

The topics in this lesson include:

 Personalizing inquiry screens


 Personalizing objects
 Explore what you’ve learned

Sage course curriculum - Version 1.0 Page 231


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Personalizing inquiry screens


Use Inquiry screens (GESGTC) in the Setup > General parameters block to personalize
inquiry screens across the software.

 Use the grid to change the order in which fields display.

Page 232 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Personalizing objects
Use Objects (GESAOC) under Personalization in the Setup > General parameters block
to modify certain object characteristics. These objects include the selection windows,
QuickSelect lists, report printing, statistics, and automatic links.

 At the Object code field, enter a three-character object code.


 The Index field is used to define an index for the principal file for the display in the Left
list in selection windows.
 In the Selection Fields grid, enter the table in which the field to be displayed is located.

Sage course curriculum - Version 1.0 Page 233


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned


Use the following situation to explore the features you’ve learned in this lesson.

Personalize an inquiry screen


Estimated duration: 20 minutes
In this exercise, personalize an inquiry screen by modifying the position of the Period
column.

1. In the Development > Script dictionary block, select Inquiries.


2. In the Left list, select SCB (MRP – MPS Results).
3. At the Default screen code field, note the screen code. ____________________
4. Enter APL at the Activity Code field.
5. Click Save and return to the Navigation page.
6. Now create a new screen code and change the position of the Period column. From
the Setup > General parameters block, select Inquiry screens.
7. In the Left list, select SCB (MRP – MPS Results).
– Expand the SCB MRP – MPS Results folder.
– Select STD MRP/MPS results Standard.
8. At the Screen code field, enter ZIS to replace STD.
9. In the grid, change the order of the Period field to be first (enter 1 in the Order column
for the Period field).
10. Click Create.
11. Click Continue to confirm the duplication.
12. Click Validation.
13. Return to the Navigation page.
14. Now check the new screen code. Under Reorder results in the Manufacturing >
Inquiries block, select MRP results.
15. Select site NA022 and product RAW411 (Tartaric Acid).
16. Click Search and note the position of the Period column.

Page 234 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Explore what you’ve learned (continued)


17. Click Criteria.
18. In the MRP – MPS results window, enter ZIS at the Screen code field.
19. Click OK.
Note how the position of the Period column has now changed to the first column.

20. Return to the Navigation page.


Personalize an object
Estimated duration: 10 minutes
In this exercise, personalize a Left list for the BPSUPPLIER table by adding a new
column:

1. Under Personalization in the Setup > General parameters block, select Objects.
2. Select BPS at the Object code field.
3. In the Selection fields section, add the following field:
Table Field Title
BPSUPPLIER DOUFLG Dispute

4. Click Save.
5. Return to the Navigation page.
6. Access the Suppliers function to see if the Dispute column was added to the left list.
(Hint: Select Suppliers in the Common data > BPs block.)

Sage course curriculum - Version 1.0 Page 235


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Lab
The purpose of this lab is to review the information learned in the previous lessons:

1. Look up the parameter definition for ACCWIPEOA (Sub-con WIP auto journal) under
the ACH Purchase parameter group.
2. Create a training activity code.
– Use the Supervisor module.
– Make the code active.
Write the code here. ___________________________________________

3. Modify local menu 61 (Graph Type) to include a Bar Chart as code B.


4. Create an entry transaction for receipts using the following settings (Setup > Inventory
> Entry Transactions).
– Use your initials for the transaction code
– Active = Yes
– Auto Print = Yes
– Receipt at dock = Yes
– Manual stock movement = Yes
– Calculate stock to issue = Yes
– Display the Net Price as a form only.
– Display the Line Amount – Tax field as a form only
– Display the Invoiced Line as a form only
– On Line 1 tab, set the Order number and line field to Displayed
– Leave all other fields as they are
5. Create and validate your new entry transaction code.
6. Access the entry transaction window that you created in the previous step (Inventory >
Flow of receipts/issues > Receipts).
– Add a selection using the Selection option that will only display a certain range of
receipt numbers.
– Explain the different ways to access the Calculator.
__________________________________________________________________

– Use the Calculator to determine the current user.


____________________________
– Explain where you can go in the software to view all the system variables and
functions.
_________________________________________________________________

Page 236 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Lab (continued)
7. Explain which field and table [F:ITF]STOFCY represents. ______________________
____________________________________________________________________

8. Explain which field and table [M:ITM1]EANCOD represents. What does “1” in “ITM1”
mean?
9. List three global variables that cannot be changed.
___________________________________________________________________

10. Which numerical function can you use to search a sub-string within a string?
___________________________________________________________

11. Explain how to access and use the Formula wizard.


___________________________________________________________________

12. Explain how to add a variable to the Formula wizard.


___________________________________________________________________

13. Create a text file and attach it to a receipt using the entry transaction you created in
step 4.
14. Using the entry transaction window you created in step 4, export the data on the Lines
tab in a grid to Excel.
15. Locate a graph on a landing page and export it to PowerPoint.
16. Create an import/export template by copying DUD (Open Items Due Date).
– Add “Z” in front of “DUD” as the template code.
– Delete line 6 – GACCDUDATE *2 Devise and save the template.
17. In the Exports function, select the import/export temple you created in step 17 to
export the data.
18. Explain two different ways you can print data in Sage X3.
___________________________________________________________________

___________________________________________________________________

19. Preview a receipt from the entry transaction window you created from step 4.
Which products are listed on the receipt?

___________________________________________________________________

20. In the Customers function, select a customer and make sure there is an email
address. (Hint: Access the Customers function in the Common data > BPs block.)

Sage course curriculum - Version 1.0 Page 237


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Lab (continued)
21. Create a new workflow notification that notifies the customer in step 21 when an
invoice is created and indicates the shipment has been delivered and use an
expression that returns the value of the invoice number.
22. Access the CRDHLD (Credit Hold Orders) requester.
– Change the presentation to be Char or Graph.
– In the Selections section, change the [F:SOH]CDTSTA>1expression so that the
credit status is equal to 1.
– Save and validate the change.
– On the Graphic tab select Multiple graph as the type.
23. Modify an existing process flow.
– Select the POASSIGN process flow.
– Add a new text button near the Purchase Orders function with the text “Note
concerning purchase orders.”
– Add a Time tracking function between the Assignment Workbench and Receiving
functions. Be sure to link it to the Time tracking function in the software.
24. Access the Orders function in the Sales > Orders block and apply the following
personalization to the page:
– Change the field labels in the Header section so they appear to the left of the fields
and also left aligned.
– On the Delivery tab, display the sections in three vertical columns.
– On the Lines tab, move the MARGIN/TOTAL section to the right of the
VALUATION section.

Page 238 Sage course curriculum - Version 1.0


Copyright © 2016 Sage, Inc. All Rights Reserved
Common tools

Summary
You have learned:

 How to view and edit general parameters in the system.


 How to work with activity codes.
 How to locate and edit local menus.
 How to set up entry transaction screens to simplify data entry.
 How to set up and reset sequence numbers.
 How to select various data in the system.
 How to enter formulas to enhance your business needs.
 How to integrate with and export data to Microsoft Word, Excel, and PowerPoint.
 How to attach documents and graphics to business documents such as sales orders.
 How to import and export data to Microsoft Excel or to a file.
 How to print documents throughout the system.
 How to work with workflow notifications.
 How to run user-defined inquiries.
 How to access, view, and design process views.
 How to personalize inquiry screens and objects.

Sage course curriculum - Version 1.0 Page 239


Copyright © 2016 Sage, Inc. All Rights Reserved
Visit Sage University for your training needs.
www.SageU.com

 2016 Sage Software, Inc. All rights reserved. Sage, the Sage logos, and the Sage product and
service names mentioned herein are registered trademarks or trademarks of Sage Software, Inc., or its
affiliated entities. All other trademarks are the property of their respective owners.

You might also like

pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy