system setup and management coursedocshare01.docshare.tips/files/30623/306238461.pdf · 2016. 5....

Epicor ERPSystem Setup and ManagementCourse10.0.700.2

Disclaimer

This document is for informational purposes only and is subject to change without notice. This document and itscontents, including the viewpoints, dates and functional content expressed herein are believed to be accurate as of itsdate of publication. However, Epicor Software Corporation makes no guarantee, representations or warranties withregard to the enclosed information and specifically disclaims any applicable implied warranties, such as fitness for aparticular purpose, merchantability, satisfactory quality or reasonable skill and care. As each user of Epicor software islikely to be unique in their requirements in the use of such software and their business processes, users of this documentare always advised to discuss the content of this document with their Epicor account manager. All information containedherein is subject to change without notice and changes to this document since printing and other important informationabout the software product are made or published in release notes, and you are urged to obtain the current releasenotes for the software product. We welcome user comments and reserve the right to revise this publication and/ormake improvements or changes to the products or programs described in this publication at any time, without notice.The usage of any Epicor software shall be pursuant to an Epicor end user license agreement and the performance ofany consulting services by Epicor personnel shall be pursuant to Epicor's standard services terms and conditions. Usageof the solution(s) described in this document with other Epicor software or third party products may require the purchaseof licenses for such other products. Where any software is expressed to be compliant with local laws or requirementsin this document, such compliance is not a warranty and is based solely on Epicor's current understanding of such lawsand requirements. All laws and requirements are subject to varying interpretations as well as to change and accordinglyEpicor cannot guarantee that the software will be compliant and up to date with such changes. All statements ofplatform and product compatibility in this document shall be considered individually in relation to the products referredto in the relevant statement, i.e., where any Epicor software is stated to be compatible with one product and alsostated to be compatible with another product, it should not be interpreted that such Epicor software is compatiblewith both of the products running at the same time on the same platform or environment. Additionally platform orproduct compatibility may require the application of Epicor or third-party updates, patches and/or service packs andEpicor has no responsibility for compatibility issues which may be caused by updates, patches and/or service packsreleased by third parties after the date of publication of this document. Epicor® is a registered trademark and/ortrademark of Epicor Software Corporation in the United States, certain other countries and/or the EU. All othertrademarks mentioned are the property of their respective owners. Copyright © Epicor Software Corporation 2014.All rights reserved. No part of this publication may be reproduced in any form without the prior written consent ofEpicor Software Corporation.

ED861905

90521-10-9287-58310702

10.0.700.2

Revision: July 25, 2014 2:48 a.m.

Total pages: 80

course.ditaval

Contents

Introduction............................................................................................................................6Before You Begin....................................................................................................................7

Audience.........................................................................................................................................................7

Prerequisites....................................................................................................................................................7

Environment Setup..........................................................................................................................................7

User Accounts.........................................................................................................................9User Accounts Details......................................................................................................................................9

Workshop - Manage User Accounts...............................................................................................................10

Create User Account...............................................................................................................................10

Test the Account....................................................................................................................................12

Startup Configurations.........................................................................................................13Configuration Settings File.............................................................................................................................13

Multiple Configuration Files....................................................................................................................14

Workshop - Modify Configuration Setting Files.......................................................................................14

Copy the Default Configuration File.................................................................................................14

The Configuration Editor.................................................................................................................14

Run Time Arguments.....................................................................................................................................16

Workshop - Activate Run Time Arguments..............................................................................................16

System Setup........................................................................................................................17Workshop - Company Maintenance...............................................................................................................17

Define General Settings..........................................................................................................................17

Define Emailing and Reporting Options...................................................................................................19

Define Attachments................................................................................................................................20

Enable BAQ External Datasources...........................................................................................................21

Enable Tax Connect................................................................................................................................22

Workshop - Company Configuration.............................................................................................................22

Enter Company Details...........................................................................................................................23

Define Module Options...........................................................................................................................24

Workshop - Site Maintenance........................................................................................................................24

Create a Site...........................................................................................................................................25

Workshop - Site Configuration.......................................................................................................................26

Modify Site Options................................................................................................................................26

Workshop - Company and Site Rights............................................................................................................28

Assign Company/Site Rights....................................................................................................................28

Assign External Companies.....................................................................................................................29

Test User Account...................................................................................................................................29

Automatic Data Processing..................................................................................................30System Agents...............................................................................................................................................30

Workshop - Modify the System Agent....................................................................................................31

Modify a System Agent...................................................................................................................31

3Epicor ERP | 10.0.700.2

ContentsSystem Setup and Management Course

Create a Schedule...........................................................................................................................32

Workshop - Manage the System Agent...................................................................................................33

Select a Schedule.............................................................................................................................33

View Task Parameters......................................................................................................................34

Process Sets...................................................................................................................................................34

Workshop - Manage Process Sets...........................................................................................................34

Create a Process Set........................................................................................................................34

Add Tasks to a Process Set...............................................................................................................35

Schedule a Process Set.....................................................................................................................36

System Monitor.............................................................................................................................................37

Workshop - Use the System Monitor.......................................................................................................37

Security..................................................................................................................................39Security Privileges...........................................................................................................................................40

Company Security...................................................................................................................................40

Security Group Maintenance...................................................................................................................40

Workshop - Create a Security Group................................................................................................40

User Security...........................................................................................................................................42

Security Manager............................................................................................................................42

Workshop - Manage User Security...................................................................................................42

Assign Security Privileges..........................................................................................................43

Assign Security Groups.............................................................................................................45

Assign Security...............................................................................................................................................45

Run Time Argument Menu Control.........................................................................................................45

Workshop - Define Run Time Arguments.........................................................................................46

Security Group Conflicts.........................................................................................................................46

Workshop - Menu Security.....................................................................................................................47

Create a Security Code....................................................................................................................47

Assign Menu Security......................................................................................................................49

Test Menu Security..........................................................................................................................49

Workshop - Field Security.......................................................................................................................50

Assign Global Field Security.............................................................................................................51

Security Group Field Security............................................................................................................52

Test Field Security............................................................................................................................53

Security Management....................................................................................................................................53

Menu Security Report.............................................................................................................................53

System Activity Log.................................................................................................................................54

Customization Management...............................................................................................55Workshop - Customization Rights..................................................................................................................56

Assign Customization Rights...................................................................................................................56

Workshop - Personalization Purge..................................................................................................................57

Use Personalization Purge.......................................................................................................................57

Workshop - Customization Maintenance.......................................................................................................58

Review, Update, and Delete Customizations...........................................................................................59

Export Customizations............................................................................................................................60

Epicor ERP | 10.0.700.24

System Setup and Management CourseContents

Import Customizations............................................................................................................................61

Verify Customizations.............................................................................................................................62

Run or Modify Customizations................................................................................................................63

Workshop - Dashboard Maintenance.............................................................................................................64

Review Dashboards.................................................................................................................................64

Manage and Generate Dashboards.........................................................................................................66

Workshop - Help Annotations Maintenance...................................................................................................67

Update an Annotation............................................................................................................................67

Workshop - Solution Management................................................................................................................68

Review Solution Elements.......................................................................................................................68

Add a Solution Element..........................................................................................................................69

Review Solution Types............................................................................................................................71

Add a Solution Type...............................................................................................................................72

Use Solution Workbench........................................................................................................................73

Track Your Activity..................................................................................................................................73

Add Items to Solution.............................................................................................................................75

Build a Solution......................................................................................................................................75

Install a Solution.....................................................................................................................................76

Verify the Solution Installed....................................................................................................................77

Conclusion.............................................................................................................................79

5Epicor ERP | 10.0.700.2

ContentsSystem Setup and Management Course

Introduction

This course explores how you set up and manage the Epicor ERP application. By understanding these tools, youcontrol how users access and run the application as well as manage automatic processes and customizations.

You leverage several tools to configure the Epicor ERP application so it reflects the structure of your organizationand the requirements of your business. This course begins by setting up a basic user account, and then reviewsconfiguration settings files and run time arguments. Configuration settings (.sysconfig) files contain parametersyou can modify; these parameters then activate when a user logs into the client. Likewise, run time argumentsare switches which launch alternate menus and processes (like automatic updates) when users log in.

If you use the Multi-Site module, the Epicor ERP application can have multiple companies, and then each companycan contain multiple sites. Use these features to reflect the structure of your organization. Through thesemanagement tools, you define how each company and site interacts with the modules licensed by yourorganization. Then on user accounts, you determine which users have access to each company and site. To furtherimprove security, use the security tools. Through these management programs, you restrict user access to specificprograms, processes, and fields.

Reports, processes, and executive dashboards can generate automatically through recurring schedules. You firstcreate these recurring schedules on a system agent, and then users link a report or process to these recurringschedules. These processing tasks then activate automatically at times that work best for your organization -generating the data when its needed and when it can be most efficiently processed.

Lastly, users can modify the application through personalizations, customizations, and other tools. You canmanage these custom modifications using a series of maintenance programs. Through the features on theseprograms, you can evaluate each modification, correct errors, and remove the modification. To complete thecustomization management options, you can use the Solution Management module to bundle toether selectedcustomizations, personalizations, BAQs, and other items and distribute them from one Epicor ERP applicationserver to another server.

Together these setup and management tools give you control over how your organization and users interactwith the Epicor ERP application. By leveraging these tools, you can maximize your investment in the application.

Upon successful completion of this course, you will be able to:

• Create a user account.

• Modify startup configurations on client machines.

• Configure companies and sites so they reflect the needs your organization and industry.

• Grant user access to companies and sites.

• Set up schedules that automatically generate data for reports and processes.

• Restrict user access to the ERP application through the security features.

• Manage customizations, personalizations, dashboards, help annotations, and other custom items in the EpicorERP application.

• Create solutions that combine various items for installation in other companies.

Epicor ERP | 10.0.700.26

System Setup and Management CourseIntroduction

Before You Begin

Read this topic for information you should know in order to successfully complete this course.

Audience

Specific audiences will benefit from this course.

• System Administrators

• IT/Technical Staff

• Security Managers

Prerequisites

To complete the workshops in this course, the necessary modules must be licensed and operating in your trainingenvironment. For more information on the modules available, contact your Epicor Customer Account Managerat [email protected]. It is also important you understand the prerequisite knowledge contained in othervaluable courses.

• Interface Navigation Course - This course introduces navigational aspects of the Epicor application's userinterface. Designed for a hands-on environment, general navigation principles and techniques available intwo user interface modes - Classic Menu and Modern Shell Menu. Workshops focus on each of thesemodes and guide you through each navigational principle introduced.

• System Administration Course - This course explores how Microsoft ® SQL Server interacts with the Epicor

application. Designed for database administrators, this course describes the SQL Server features administratorsmanage to run the Epicor application.

Environment Setup

The environment setup steps and potential workshop constraints must be reviewed in order to successfullycomplete the workshops in this course.

Your Epicor training environment, in which the Epicor demonstration database is found, enables you to experienceEpicor functionality in action but does not affect data in your live, production environment.

The following steps must be taken to successfully complete the workshops in this course.

1. Verify the following or ask your system administrator to verify for you:

• Your Epicor training icon (or web address if you are using Epicor Web Access) points to yourEpicor training environment with the Epicor demonstration database installed. Do not completethe course workshops in your live, production environment.

Note It is recommended that multiple Epicor demonstration databases are installed. ContactSupport or Systems Consulting for billable assistance.

7Epicor ERP | 10.0.700.2

Before You BeginSystem Setup and Management Course

• The Epicor demonstration database is at the same service pack and patch as the Epicorapplication. Epicor's education team updates the Epicor demonstration database for each service packand patch. If your system administrator upgrades your Epicor application to a new service pack or patch,he or she must also download the corresponding Epicor demonstration database from EPICweb > Support> Epicor > Downloads and install it. If this is not performed, unexpected results can occur when completingthe course workshops.

• Your system administrator restored (refreshed) the Epicor demonstration database prior tostarting this course. The Epicor demonstration database comes standard with parts, customers, salesorders, and so on, already defined. If the Epicor demonstration database is shared with multiple users(that is, the database is located on a server and users access the same data, much like your live, productionenvironment) and is not periodically refreshed, unexpected results can occur. For example, if a courseworkshop requires you to ship a sales order that came standard in the Epicor demonstration database,but a different user already completed this workshop and the Epicor demonstration database was notrestored (refreshed), then you will not be able to ship the sales order. Epicor's education team has writtenthe course workshops to minimize situations like this from occurring, but Epicor cannot prevent usersfrom manipulating the data in your installation of the Epicor demonstration database.

2. Log in to the training environment using the credentials epicor/epicor. If you are logged in to your trainingenvironment as a different user, from the Options menu, select Change User.

3. From the Main menu, select the company Epicor Education (EPIC06).

4. From the Main menu, select the Main site.

Epicor ERP | 10.0.700.28

System Setup and Management CourseBefore You Begin

User Accounts

Each person who will access the Epicor ERP application must have a user account. This user account contains theprimary information for each user and defines both program access and system permissions.

You create user accounts within User Account Security Maintenance. You will frequently launch this programto add and update user accounts. As users change roles within your organization, you manage what programsthey can launch and what tools they can use. User Account Security Maintenance can only be launched by userswho have Security Manager rights, so be sure at least one account is set up with this permission option.

During this section of the course, you will create a basic user account. This account is then used later throughoutother parts of this course.

User Accounts Details

Use the Detail sheet to enter basic user account information such as user ID, name, address, phone numbers,and password information. You typically use this sheet when you are creating a new user account.

You enter this information on the Detail sheet:

User ID and Password

Each user account has a User Identifier (ID) and a Password, and users are prompted for these items when theylog into the application. The User ID displays in many entry programs like Sales Order Entry and Purchase OrderEntry; this feature indicates who created the initial record. The User ID field is alphanumeric and can be up to 20characters long.

Tip Consider using employees' network login ID as their Epicor ERP application User ID. The network loginID defaults in the Name field when users log into the Epicor ERP application. If you use Information Worker,the network login ID is used to integrate Information Worker with the Epicor ERP application.

Address and Contact Information

Use this area to enter the mailing address, the e-mail address, and phone numbers for each user. These fieldsare optional and are used for reference purposes only. Some users must be set up in other areas of the application.For example, a sales force member would also be set up in Work Force Maintenance with a sales role. In thissituation, consider leaving the address and contact information blank in the user account record and place a notein one of the fields to direct people to the Work Force record for the address and contact information.

Disable Account

Select the Disable Account check box to temporarily or permanently stop a user account. You may also want todisable an account if someone is on an extended leave or if someone leaves the company. Once an account isdisabled, that user cannot log into the application. They will receive an Invalid log on message.

Tip The application defines a new account as disabled by default. You can then complete the setup for auser before activating the account.

9Epicor ERP | 10.0.700.2

User AccountsSystem Setup and Management Course

Workshop - Manage User Accounts

The following exercises illustrate how you create and activate user accounts.

Create User Account

Do the following to create a user account.

1. Navigate to User Account Security Maintenance.

Menu Path: System Setup > Security Maintenance > User Account Security Maintenance

Important This program is not available in the Epicor Web Access.

2. Click the New button.The fields on the Detail sheet activate for data entry.

3. Enter the User ID for this user. For this workshop, enter XXX_User (where XXX are your initials).

When the user launches the Epicor ERP application, the user first needs to enter this identifier value andthen enter a password. You will not be able to access this password through User Security AccountMaintenance, but you can clear this password and manage when it expires.

4. Now enter the Name, Address, City, and other contact details. Enter the values you need in these fields.

This information is primarily for your reference. As described previously, you can enter this user informationin other programs like Work Force Maintenance or Employee Maintenance. If this is the case, considerleaving these fields blank and just enter a reference stating which program contains the user's contactinformation.

5. Click the Language drop-down list to review the languages available. If this user needs to display theinterface in a different language from the default, you can select it from the drop-down list. However if thisuser will use the default language, leave this value blank.

When the Epicor ERP application is installed, you select a default language that displays for all users. Howeveryou can use this drop-down list to override the default. If the selected language pack is installed, the interfacetext uses strings from the language pack. To determine what language to display, the system first checksthe user account, then the default language specified in the .sysconfig file, and lastly checks the currentWindows language.

6. If you select a different language for the user, you may also need to select a different Format Culture. Clickthis drop-down list to review the cultures available. This value defines cultural modifications the selectedlanguage requires to display properly on the interface. If this user can use the default format culture, leavethis value blank.

Each Format Culture code defines the date format, number format, currency symbols, field layout, and otheritems applicable to a world culture. For example, a culture code can change the interface so the user canread and enter data from right to left instead of left to right.

7. Through the Single-Sign On feature, you can set up accounts so users can automatically log into theapplication using their Windows account. When users launch the application, they avoid the login window.You activate this feature by selecting the Require Single Sign-On check box and then entering the Domainand Domain User ID values.

Epicor ERP | 10.0.700.210

System Setup and Management CourseUser Accounts

Do not activate this feature during this workshop. You will set this up later through a different method onthe configuration settings file.

8. Enter the Session Timeout Minutes you need for this user; for this example, enter 30 minutes. This valuedetermines how long this user account can be inactive before the application times out the session. Thisvalue cannot be less than 15 minutes.

Tip When the application times out, the user's account licenses are released, allowing additionalusers to log in. If you have enough licenses available for all the users, consider increasing this valueso the user account never (or rarely) times out.

9. You can limit this user to only see a specific set of programs by entering a menu identifier in the ClientStart Menu ID field.

When this user logs in, only the modules or module nodes available under this menu display on the MainMenu. For example if you enter the identifier for the Job Management module, only the programs in thismodule display on the Main Menu.

You use Menu Maintenance to find the menu ID you need. This feature is described more detail later in theSecurity section of this course.

10. You manage account passwords through the fields in the Account Actions group box. Select the ExpirePassword check box.

11. Now in the Password Expires Days field, enter how long the user's password can be active. For thisworkshop, enter 75 and then click Save.

The current password for this user account can now stay active for 75 days. The Password Expires fieldpopulates with the last date on which this password can be used.

12. Now select the Clear Password check box. This forces the user to create a new password during the nextlogin.

13. A requisition is a request for material from a supplier, and it can be used to acquire parts for a job ormiscellaneous item. To give users the ability to create these records, select the Allow Requisitions checkbox.

14. To indicate how long before the data refreshes in the Shop Tracker, enter a value in the Shop TrackerRefresh Minutes field. The default value is 10 minutes.

15. Each user account must have access to at least one company and site. Click the Down Arrow next to theNew button; select New Company.The Company > Detail sheet displays.

16. Click the Company drop-down list and select Epicor Education.The Available Sites list displays the current sites set up for this company.

17. Select the Main site option and click the Right Arrow button.

18. To complete the user account, you need to activate it. Return to the Detail sheet and clear the AccountDisabled check box.

19. Click Save.

20. Close User Account Security Maintenance.

11Epicor ERP | 10.0.700.2

User AccountsSystem Setup and Management Course

The user account is active. The new user can now log into the Epicor ERP application.

Test the Account

You will use this account later in this course, so you need to set up the password for this new user account.

1. Return to the Home screen and click the Settings tile.

2. Select General Options.

3. Click the Change User... option.The Log in window displays.

4. For the User name, enter XXX_User (where XXX are your initials) and a Password.

5. Press the Arrow button.

6. Because you selected the Clear Password check box on the user account, the Password Expired dialogbox displays. It asks you if you want to change the password; click Yes.The Change Password dialog box appears.

7. Enter the Current password again.

8. Now enter the New Password and then enter it again in the Confirm new password.

Important Be sure you remember this password. You will use this password again later in the course.

9. Click OK.

The Epicor ERP application launches, and it uses the permissions you set up on the new user account.

10. Click on the Menu tile.

11. Notice you can access the modules in the Main site, but you can't access the Evanston, Los Angeles,Orange County, and Rockford sites.

12. You need to logon as a system administrator again. Return to the Main Menu and click the Settings tile.


14. Login using the User Name/Password of epicor/epicor.

Epicor ERP | 10.0.700.212

System Setup and Management CourseUser Accounts

Startup Configurations

You can modify application launch settings throughout your system and on specific workstations. To do this, youleverage configuration settings files and run time arguments.

By using different startup configurations and run time arguments, you define how the application runs on eachworkstation and interacts with the server.

For example, if you want the application help hosted on a separate server from the deployment server, you wouldmodify the configuration settings file by entering the server's URL in the helpServerURL attribute. You wouldthen update this parameter on configuration setting files you use throughout the company. You can also changehow the application launches on a specific workstation with these tools; for example you can activate a run timeargument that launches the application using the MES interface.

Startup Flow

Configuration Settings File

When you launch the application, it activates the configuration settings file. This file defines the settings for theclient installation, including the server connection, user settings, sort method, and many other options.

The application cannot launch unless it locates a configuration settings file. If the .exe file can see thedefault.sysconfig file or an alternate .sysconfig file you have defined through a run-time argument, the applicationlaunches.

This section explains how you modify the .sysconfig files. It also describes one of the most common changes,setting up a user to automatically log into the system.

13Epicor ERP | 10.0.700.2

Startup ConfigurationsSystem Setup and Management Course

Multiple Configuration Files

As a best practice, you should never update the default.sysconfig file. Instead make copies of this default fileand then modify the copied .sysconfig files as you need.

You make a copy of this file by using the copy and paste functions in Windows Explorer. By copying thedefault.sysconfig file, you will always have the original settings available for reference. This also creates a backupfile you can use to restore the original configuration settings.

By using alternate .sysconfig files, you can experiment with different startup configurations. To indicate whichalternate .sysconfig file you will launch through each client, you add a run time argument to the Epicor ERPapplication's desktop icon. You will learn how to do this later during the Run Time Arguments section of thiscourse.

Workshop - Modify Configuration Setting Files

The following exercises demonstrate how you modify configuration settings files.

Copy the Default Configuration File

As a best practice, you should always make a copy of the default.sysconfig file and then modify the copied fileas you need.

To make a copy of the default configuration file:

1. Launch Windows Explorer.

2. Navigate to the C:\Epicor\ERP10\ERP10.00.000\ClientDeployment\Client\Config directory.The configuration files available for your client installation display in this folder.

3. Right-click on the default.sysconfig file; from the context menu, select Copy.

4. Now right-click on an empty space in the window; from the context menu, select Paste.The default - Copy.sysconfig file displays.

5. Right-click this file. From the context menu, select Rename.

6. Change this file name to XXX.sysconfig (where XXX are your initials).

You can now modify this .sysconfig file to use the settings you need.

The Configuration Editor

After you copy the default.sysconfig file, you can modify the settings in this file. You do this using the ConfigurationEditor.

This tool is automatically installed with your client application. Use Windows Explorer to locate and launch thisprogram.

1. Open your Client Installation folder. In this example, you open the C:\Epicor\ERP10\ERP10.0.100\Clientdirectory.

2. Locate and double-click the ConfigEditor.exe icon.The Please select a configuration file window displays.

Epicor ERP | 10.0.700.214

System Setup and Management CourseStartup Configurations

3. Notice this window automatically displays all the files contained within your Config folder. Select the fileyou want to edit. In this example, you select the XXX.sysconfig file (where XXX are your initials).

4. Click Open.The Configuration Editor displays.

5. The configuration file settings are divided into several sheets. Available sheets:

a. The Application sheet displays all the settings that apply to the overall application. You define settingslike AppServerURL, ResourceFile, and Version here.

b. The User sheet contains the settings you can adjust for the specific user on this client workstation.

c. The Deployment sheet contains the settings for moving, or deploying, files from your server to the clientinstallation.

d. The Help sheet contains the settings that define the directory paths for the application help, on-linesupport, and the Feature Summary. Use these options to define where this configuration file looks fordocumentation and support resources.

e. Use the Sort sheet to define the method used globally to sort strings within the application. Your optionsare stringSort and wordSort. You can also create exceptions to the default sort method on this sheet.

f. The Tools sheet contains the default settings needed to use the Software Developer Kit (SDK). Soldseparately from the application, this toolset enables developers and advanced users to extend theapplication to create new tables, business objects, and UI forms. If you use the SDK, these default valuesare automatically added to your configuration file. However if you need, you can edit them on this sheet.

To change a setting, enter an expected value in its field. An expected value is a parameter compatible withthe setting.

Tip For details on the settings contained on these sheets, read the Settings – The Complete List topicin the application help. You can also review the Startup Configurations chapter in the EpicorImplementation User Guide.

6. You want to modify this .sysconfig file so that you can automatically log into the application when youlaunch the Epicor ERP application. Click the User tab.

7. Enter a UserID. This value is the identifier for the user who is logging into the application from thisworkstation. Enter the XXX_User identifier you created for the new account within User Account SecurityMaintenance.

8. Enter a Password. This value is the password for the user who is automatically logging into the applicationfrom this workstation. Enter the password you defined for this account.

9. Click Save.

10. Click Close. This configuration file is saved with the new settings.

The selected configuration file now has your revised settings. You next add a run-time argument to the EpicorERP application icon so it launches using your XXX.sysconfig file (where XXX are your initials).

15Epicor ERP | 10.0.700.2

Startup ConfigurationsSystem Setup and Management Course

Run Time Arguments

Each workstation can be set up to launch the application in a specific mode. These modes, or Run TimeArguments, activate when a user double-clicks on the application icon.

Several run time arguments are available. You can for example, indicate that instead of the default Main Menu,the application launches either the Dashboard or the MES interface. As described previously, you can launch theapplication using a different configuration file so it uses the settings you defined in the alternate .sysconfig file.

Run time arguments are also useful when you are customizing programs. Normally during runtime, you can haveseveral favorites groups that autoload their programs into memory. This improves the performance of theseprograms. However you cannot customize autoloaded programs. To disable this feature while you are customizing,you enter the /AUTOLOADSUPPRESS run time argument.

You can also use multiple run time arguments at the same time to further define how the application launcheson the workstation. For example, you want a workstation to only use the MES interface and you also want it toupdate to the latest version. For this workstation, you use both the /MES and /UPDATE run time arguments.

Workshop - Activate Run Time Arguments

You add run time arguments to the properties of the Epicor ERP application icon. During this workshop, you addan argument that launches the configuration settings file that contains your automatic login settings.

1. On the desktop for the workstation, right-click the Epicor ERP application icon.

2. A Context Menu displays; select the Properties option.

3. The application’s Properties window appears, displaying the Shortcut tab.

4. In the Target field, enter a [Space] after the target directory path.

5. Enter a right slash ( / ) or en dash ( - ), followed by the run time argument. EnterC:\EUQA\Epicor\ERP10\ERP10.0.100\Client\Epicor.exe /config=XXX.sysconfig orC:\EUQA\Epicor\ERP10\ERP10.0.100\Client\Epicor.exe -config=XXX.sysconfig (where XXX are your initials).

Tip For details on the available run time arguments, review the Run Time Arguments List topic in theapplication help or the Startup Configurations chapter in the Epicor Implementation User Guide.

6. Click Apply.

7. Click OK.

8. Return to the desktop and launch the Epicor ERP application.

The Main Menu automatically displays, bypassing the Log in window. Notice the application launches with theuser account settings as well, so you can only access the Main site.

You need to log back into using the system manager account. From the Home screen, click the Settings tile.Select General Options and launch the Change User... option. Enter manager/manager and log back into theEpicor ERP application.

Epicor ERP | 10.0.700.216

System Setup and Management CourseStartup Configurations

System Setup

You set up the structure of your organization through companies and sites. Each company and site has a uniqueset of programs that handle transactions within this area of the organization.

A company is a related section of business functions. How you structure companies within the Epicor ERPapplication reflects how your organization runs its various areas of business activity. A company could representa product line, a different location, a recent acquisition, and so on. A site defines a location, like a distributionor manufacturing center, for which your organization needs to separately record and track transactions.

Tip To use multiple companies and sites, you must have the Multi-Site module. This module contains theprograms and network protocols that allow companies to share global records like customers and invoices.

You create companies using the Epicor Administration Console. Use this separate program to create the SQLdatabases and application servers that run the Epicor ERP application. You can then create multiple companiesfor each application server. After you set up the companies through this console, they appear the next time youlog into the Epicor ERP application. You then launch the Company Maintenance and Company Configurationprograms to define the system and module options for each company.

Each company can have multiple sites, and unlike companies, you create sites within the Epicor ERP application.You launch the Site Maintenance and Site Configuration programs to define the system and module optionsfor each site.

This section of the course guides you through how you set up the companies and sites that make up yourorganization. It also illustrates how you grant users access to specific companies and sites.

Workshop - Company Maintenance

After a system administrator creates a company through the Epicor Administration Console, users can access itfrom the tree view in the Epicor ERP application.

Each company has its own unique set of module groups that users launch separately from other companies. Tobegin setting up the overall parameters for the new company, launch Company Maintenance. This set upprogram contains the primary options used across the company. You use this program to enter the company'sdefault address, email setup, document attachments, and external BAQ sources.

Define General Settings

The General Settings sheet contains the primary information you need to define, including the company addressand URLs for linking the company to other Epicor ERP applications.

1. Click the Menu tile and navigate to Company Maintenance.

Menu Path: System Setup > Company/Site Maintenance > Company Maintenance


The program displays the General Settings sheet by default. Notice the current company's identifier displaysin the Company field.

2. Use the Company Info section to enter name and address information for the current company. For thisworkshop, enter a Phone number.

17Epicor ERP | 10.0.700.2

System SetupSystem Setup and Management Course

This address information is used on various reports and records to identify they originate from this company.

3. If this company will use Service Connect, define how the current company links to this separate applicationthrough the fields in the Service Connect Options group box.

a. Server - Enter the server where Epicor Service Connect is installed. For this workshop, enter EpicorSI.

b. User and Password - Now enter the user account that can access the Service Connect server. For thisworkshop, enter admin for the User and leave the Password blank.

c. To verify the connection works, click the Test Connection button.

d. The UBAQ Workflow Package is the folder on the Service Connect server that contains the workflowprocesses required to modify data through updatable business activity queries (BAQs). If you will useService Connect to update business activity queries, select the package you need from this drop-downlist.

When users enter data through a dashboard that has an external BAQ, this workflow package connectsthe company with the external Service Connect application.

4. The options available in the Activity Tracking group box indicate how you want to record user actions atthe current company.

a. System Activities - Select this check box. The activity log now track updates to the application like BAQdefinitions, dashboard definitions, customizations, BPM directives, and so on.

b. Personalization - Select this check box. The activity log trackers user personalizations in the currentcompany.

Tip You review each system and personalization change through the System Activity LogTracker.

Menu Path: System Setup > Security Maintenance > System Activity Log

5. If this company will run Enterprise Search, use the fields in this group box to link this company to thesearch index. Enterprise Search is an optional search feature which you can use to retrieve indexed contentfrom within your Epicor ERP application and then quickly launch specific programs to display the datareturned from the search.

a. Search URL - Defines the Uniform Resource Locator (URL) for Enterprise Search. For example:http://EpicorApps:8098/search/default

b. Global URL - Verify this check box is selected. This indicates the Search URL is the global location forEnterprise Search. Users can then search for records located in other companies within your organization.

6. Now use the Web Access section to indicate how this company connects with the web form version of theEpicor ERP application.

a. Web Access URL - Defines the uniform resource locator for the Epicor Web Access forms. For example:http://lis-t60/EpicorWeb

b. MetaData Output Path - Defines the directory location used by this company to receive metadata.When metadata generates through Epicor Web Access, this metadata is stored in this directory path.For example: C:\Inetpub\wwwroot\EpicorWebAccess

Epicor ERP | 10.0.700.218

System Setup and Management CourseSystem Setup

7. If this company uses Epicor Enterprise Performance Canvas, use the Performance Canvas URL field toindicate the web location that contains this company's performance canvases.

Each performance canvas is a visual display of selected information from your Epicor database. To use thisfunctionality, the Epicor Enterprise Performance Canvas must be installed and active on your system.

8. Use the fields in the Social Enterprise section to define how this company interacts with the Epicor SocialEnterprise (ESE) application. Epicor Social Enterprise is an information network designed to supportinformation exchange across your business enterprise. Available options:

a. Social Enterprise URL - Indicates the URL for the Epicor Social Enterprise website associated with thisEpicor ERP application. Users who access Epicor Social Enterprise from within the Epicor ERP applicationconnect to ESE through this website. Your Epicor Social Enterprise administrator will have the URL youenter in this field.

b. Notification Source ID - Indicates the name of the notification source created by the Epicor SocialEnterprise administrator to connect to this Epicor ERP application. When users access Epicor SocialEnterprise functionality from within the Epicor ERP application, the notification source named here, alongwith the URL specified in Social Enterprise URL field, enable interactions with the Epicor Social Enterprisewebsite. Your Epicor Social Enterprise administrator will have the notification source ID you enter in thisfield.

9. When you finish defining the general settings, click Save.

Define Emailing and Reporting Options

Use the Email and Reporting sheet to indicate how you will distribute email through the current company. Thissheet also has the fields for setting up print form options as well as SSRS reporting parameters.

1. Click the Email and Reporting sheet.

2. The Port field specifies the email link port number for distributing global alert messages with attachments.Enter an unused port number in this field. When a user receives a global alert message and clicks on theattachment, the Epicor ERP application retrieves the record attached to the alert email. For this workshop,validate that 7778 displays.

3. Use the fields in the Global Alert From section to indicate where global alert messages are sent.

a. Email Address - Specifies the default From email address used to send global alert email. This addressappears in the From field on the global alert messages. For this workshop,[email protected] displays.

b. Email Label - Specifies the default From label used to send global alert email. This label displays on theglobal alert messages. For this workshop, enter Epicor Alert.

4. Use the fields in the SMTP group box to set up how email is sent between users in the current company.

a. SMTP Server - Use this field to enter the name of the server. For example: ExchangeServer

b. Port - Specifies the SMTP port number that handles your company email. This value is the port numberon the SMTP Server, for example, 25 (default port number).

c. Use SSL - Use this option to specify that SMTP communication is encrypted using SSL/TLS protocols.

19Epicor ERP | 10.0.700.2


d. You can connect to the SMTP Server using the following ways:

• Authenticate Anonymously - used for performing anonymous access to your exchange server. Inorder to use this feature, anonymous access must be allowed on the SMTP server.

• Use Specified Credentials - used to connect to your email server using the specified account. Whenselected, this option enables User and Password fields. Use these fields to enter your SMTP accountcredentials.

If Use Specified Credentials is selected, but no User name is entered, the application uses the AppPoolaccount to connect to SMTP server.

5. The Form Print Options group box contains fields that define how reporting is handled in the currentcompany.

a. Allowed Report Style - Use this drop-down list to select what report generation systems are availableto use in the company. Select SSRS Only.

Tip You can also select the Crystal and SSRS option. Use this option if you used Crystal Reportsin a previous Epicor version, and you need to run these legacy Crystal Reports while yourorganization makes the transition into SSRS reports.

b. Work Station Method - This selection defines what method is used to calculate the workstation ID.The method determines what reports a user can print or preview in the System Monitor. For thisworkshop, select Machine Name + User ID.

c. Epicor SSRS URL - This value defines the uniform resource locator (URL) the current company uses forthe Epicor SQL Server Report Portal web site.

Tip Use the Configure Epicor SSRS Service Utility to verify the URL you enter in this field. Todo this, press the Windows + F keys to display the Charms bar. Select the Configure Epi SSRSService icon to display the Configure Epicor SQL Report Monitor. Review the value in the EpiSSRS site field.

6. The Auto-Print Defaults section indicate the default printers used for printing reports and labels.

a. Reports Printer - Select the default printer this company uses for reports. Whenever a user within theselected company prints a report, the report is sent to this printer machine.

b. Labels Printer - Select the default printer this company uses to print out label forms. Whenever a userwithin this company prints labels, the labels are sent to this printer machine.

7. When you finish setting up the email and form options, click Save.

Define Attachments

Use the Attachments sheet to indicate where you store files attached to emails within the current company.

You can attach files to various records throughout the application. These files are stored in either a server directorylocation or a SharePoint

® site library. When users attach these files, they save within this central location to ensure

other users in the company can access these file attachments. During this workshop, you will set up a SharePoint®

site library.

Epicor ERP | 10.0.700.220


Tip For more information on how you set up the entire document attachment system, review the EnterpriseContent Management chapter in the Epicor Implementation User Guide.

1. Click the Attachments sheet.

2. In this environment, attachments will be stored in a SharePoint library. However if the attachments will bestored in a file system folder, use the fields in the File System Location section to define the location ofthis field.

a. To activate this storage option, select the Enable File System check box.

b. Now enter the Default Base URL for this file system location. The value you enter is a directory pathon your server; this folder will be the repository for attachment files when you use a central file system.For example: \\myserver\sharedfolder\attachments

3. The attachments will be stored in a SharePoint® library, so use the fields in the SharePoint Integration

section to set up this library.

a. Select the Enable SharePoint check box.

b. Now enter the SharePoint Site for the current company. This web site location defines the repositorythat will contain the attached files. Enter http://epicorsi/EpicorDocuments/_layouts/15/start.aspx#/ in thisfield.

c. Click the Create Site Library button. The SharePoint library is created and attachments are stored inthis site library.

4. Select the Allow Default Document check box to indicate attachments can be dragged onto theAttachments nodes on the tree view for a specific record. Users can then right-click the tree view in anentry or maintenance program and attach a file to the current record.

5. You then need to define the storage Method when users attach a file to a record. Select the SharePointDocument option.

Available options:

• File System Document - The attachment is automatically saved to the Default Base URL directory path.

• SharePoint Document - The attachment is automatically saved to the SharePoint Site location.

• Attachment Link - Causes a default attachment value to populate the File Name field on the Attachmentwindow.

6. When you finish defining the attachment options, click Save.

Enable BAQ External Datasources

Use the BAQ External Datasources sheet to activate the external datasources used for the current company.

1. Click the BAQ External Datasources sheet.

2. In the Datasources grid, review the external databases created in External Datasource Maintenance.Select the Enabled check box next to the EPIC03-AWCustAddress_EPIC03 datasource.Users can now access these databases through the External BAQ Designer.

21Epicor ERP | 10.0.700.2


Tip For more information about creating external datasources, review the External DatasourceMaintenance topics in the application help.

3. If you do not want to run security checking against the selected datasource, select the Skip Filter checkbox.

4. Likewise if you want to skip security for a specific group in the datasource, navigate to the Filter Groupsgrid and select the Skip Filter check box.

5. If the selected filter group uses a BAQ constant to filter data, you can use the Filter Definitions grid tooverride this constant. The current value of the BAQ constant displays in the ConstantValue field. To dothis, clear the Use Default check box.

6. Enter a custom constant in the FilterValue field.

7. When you finish defining the BAQ external databases and their filters, click Save.

Enable Tax Connect

Use the options under the Actions menu to activate the Tax Connect functionality for the current company.

The Tax Connect service eliminates determining sales tax jurisdictions of ship-to addresses, maintaining tax codesand rates, and dealing with jurisdiction-specific and commodity-specific taxation rules. Epicor Tax Connect useshosted, on-demand address validation, sales tax calculation, and sales tax reporting and returns generation. Thisservice is run by Avalara® AvaTax®. To use this service, you need licenses for both Epicor Tax Connect andAvalara®AvaTax® .

Do the following to activate this service:

1. Click Actions > Tax Connect.

2. From the sub-menu, select the Tax Connect Enabled option.A check now displays next to this option.

3. Now from the sub-menu, select the Test Connection option.You receive a message that the Tax Connect service is running.

4. Click OK.

Workshop - Company Configuration

Use Company Configuration to define the module options for companies in the Epicor ERP application. Usethese options to define how this company interact with the modules licensed for it.

Each company has its own set of modules and programs. Users within each company can engineer parts, makesales orders, request quotes, manage financial information, and so on. You can quickly switch between companiesby clicking different company icons from the Main Menu. Besides being different in name, you can further definethe separate companies by creating different visual styles for each company. When users switch companies, theycan then identify the current company based on the different look of the interface.

Tip To create different company styles, you use the Styling and Themes functionality. For more information,review the Styling topics in the application help or the Styling and Themes chapter in the Epicor ICECustomization User Guide.

Epicor ERP | 10.0.700.222


Enter Company Details

You access the Detail sheet to enter the main financial and schedule information for the current company.

1. Navigate to Company Configuration.

Menu Path: System Setup > Company/Site Maintenance > Company Configuration

The Detail sheet displays; its fields contain information about the current company. Notice the CompanyInfo group box contains information you entered in Company Maintenance.

2. Enter the Federal ID. This value specifies the federal tax identification number you will use this company.Be sure to enter the punctuation you may need to validate this number.

3. Now enter the state tax identification number in the Tax ID field.

4. Use the Tax Liability drop-down list to specify the tax region used for all reports used the current company.You can then report on taxes both inside or outside the selected region. If the country already has a taxregion associated with it, this region displays by default. However you can change this value.

5. If your company will use the Electronic Data Interchange (EDI) feature set, enter the identifier the EDIsupplier has assigned to this company. Before you can run EDI options to import or export data, you mustenter this identifier in this field.

6. Click the Production Calendar... button to find and select the base production calendar you wish to usefor scheduling and material requirements planning (MRP) at this company. Find and select the calendar fromthe available options.

Tip You create production calendars in Production Calendar Maintenance. Review the applicationhelp or the Epicor Implementation User Guide for more information about how to create thesecalendars.

Menu Path: Production Management > Job Management > Setup > Production Calendar


7. Likewise, click the Fiscal Calendar... button to find and select the base fiscal calendar you will use with thiscompany. The financial records users enter in this company then follow this financial schedule.

Tip You create fiscal calendars in Fiscal Calendar Maintenance. Review the application help or theEpicor Implementation User Guide for more information about how to create these calendars.

Menu Path: Financial Management > General Ledger > Setup > Fiscal Calendar

8. Click the Employment Code drop-down list to select either the 941 (Option R) or the 944 (Option F) taxform.

The option you select depends on the tax form this company will file. Your selection is used when W2 formsare exported by W2 Processing to generate the W2 files.

9. Select the Kind of Employer radio button to define tax exempt status, if needed, for the company. Bydefault, the None Apply radio button option is selected.

10. When you finish modifying the company details, click Save.

23Epicor ERP | 10.0.700.2


Define Module Options

You primary use Company Configuration to define the options for each module. These options affect how themodule runs within the current company.

This workshop is intended as a tour to show you where the main sheets and module sheets are located. Fordetails on the options you can change on each module sheet, review the application help or the CompanyConfiguration chapter in the Epicor Implementation User Guide.

1. Navigate to the Modules > All Modules > General sheet.

The General sheet contains the main options that apply to all the modules. Use this sheet to define thedefault site, default warehouses, and costing method for the current company.

2. The Localization tab contains a series of sheets you use to reflect legal requirements for a specific countryor region.

a. Use the Detail sheet to select a localization, define Restrictions on Hazardous Substances (RoHS) options,and set up taxing requirements.

b. The Intrastat tab contains sheets that define how this company will handle Intrastat codes and reports.To turn on the Intrastat features, access the Intrastat>Detail sheet and select the Active check box.

c. Modify the options on the Invoice Banking References sheet to indicate how this company will useoptical character recognition (OCR) numbers or banking reference numbers on sales and purchaseinvoices.

Tip Banking reference numbers (Customer Identification Numbers, or KID numbers) are requiredin some countries to match and allocate electronic payments to invoices.

d. Country Specific Options - Depending on the country specific functionality (CSF) you have installed,an additional sheet may also appear that contains options you need to define so the company can conductbusiness in a specific country.

If you have a CSF component installed, review the application help for documentation for the specificCSF feature set.

3. The rest of the tabs organize the options by module groups. For example, click on the Sales tab.Sheets for each module within this group display.

4. You can now access the options for the Quote, Order, CRM, Case Management, and Demand modules.You would use the module sheets to configure how the current company interacts with each module.

5. When you finish making changes to the company configuration, click Save.

Workshop - Site Maintenance

Use Site Maintenance to add and update sites available in the current company. A site defines a location, like adistribution or manufacturing center.

When a company is created in the Epicor ERP application, one site record is created automatically by default. Thissite record is the default site selected for each part created within Part Maintenance for the current company.

Epicor ERP | 10.0.700.224


To add more than one site record through this program, license the Multi-Site module. You can then set up asmany sites as you need for each company.

Create a Site

During this workshop, you add a new site to the current company.

1. Navigate to Site Maintenance.

Menu Path: System Setup > Company/Site Maintenance > Site Maintenance

2. Click the Down Arrow next to the New button; select New Site.The fields on the Detail > Detail sheet activate for data entry.

3. Enter the Site ID that will help you quickly identify this site. Enter XXX_Site (where XXX are your initials).

This value displays throughout the application within various programs and reports.

4. For the Name, enter XXX Site (where XXX are your initials).

5. If another site will performance equipment maintenance at the new site, select a Maintenance Site fromthe drop-down list.

This optional value is available if you use the Maintenance Management module. You select a maintenancesite when the current company has multiple sites and a maintenance team is responsible for maintainingthe equipment at one or more site locations. You then consolidate the maintenance demands through onesite. If you do not select a maintenance site, maintenance transactions are handled by the current site.

6. You now define various production and scheduling details for this site. For example, click the SchedulingSend Ahead For drop-down list and select Production.

This options specifies if the start-to-start job operation offset will be used for Production or Setup time.

• If you choose Production, the production time of the secondary operation is scheduled to start XXXminutes (where XXX is the number of minutes defined in the operation) after the production starts onthe primary operation.

• If you choose Setup, a secondary operation with a start-to-start relationship will schedule setup to beginXXX minutes (where XXX is the number of minutes defined in the operation) after the production startson the primary operation.

Tip For more information on the fields on the Planning group box, review the Site Maintenancetopics, the Scheduling Technical Reference Guide, and the MRP Technical Reference Guide. Thisdocumentation is available in the application help.

7. Select a Production Calender for the new site. This calendar determines how many hours for productionare available each week. Click the Calendar ID... button.The Production Calendar Search window displays.

8. Click Search.The production calendars available in your Epicor ERP application display in the Search Results grid.

9. Select the D5H16 (5 Days 16 Hrs per day) option and click OK.

This calendar indicates that this site has 16 hours of production capacity available five days each week.

25Epicor ERP | 10.0.700.2


Tip You create production calendars in Production Calendar Maintenance.

Menu Path: Production Management > Job Management > Setup > Production Calendar


10. Enter your name in the Manager Name field. This value identifies the person in charge of this new site.

11. Click on the Address sheet to enter the Mailing Address and Phone/Fax details for the new site. Placean address in these fields.

12. Now click the GL Controls tab.

You use this sheet to select the general ledger controls used to record financial transactions for the newsite. GL controls define the account and journal contexts used to generate GL accounts for the site.

13. To add a new GL control, click the Down Arrow next to the New button; select New Site GL Control.

14. Click the Type... button to select the GL Control Type that contains the general ledger controls you wishto use.

15. Now click the Control... button to select a general ledger control available in this general ledger controltype.

16. When you finish setting up the site, click Save.

Workshop - Site Configuration

Use Site Configuration Control to define how each site interacts with various functions in the Epicor ERPapplication such as the Inventory Management, Production Management, Shipping/Receiving, Time Management,and Expense Management modules.

You first create site records through Site Maintenance. You can then open each record within Site ConfigurationControl to define parameters for several application and module functions.

Modify Site Options

This workshop is intended as a tour to show you where the main sheets and module sheets are located. Fordetails on the options you can change on each module sheet, review the application help or the Sites chapter inthe Epicor Implementation User Guide.

1. Navigate to Site Configuration Control.

Menu Path: System Setup > Company/Site Maintenance > Site Configuration


2. Click the Site... button to find and select your new XXX_Site (where XXX are your initials).The XXX_Site record populates the sheets in this program.

3. Click on the Modules tab to access the configuration sheets for each module. Work with your distributionand production managers to determine the values to define for each module.

Epicor ERP | 10.0.700.226


4. Notice tabs organize the options relating to Inventory, Time and Expense, Production, AdvancedMaterial Management (AMM), and Shipping/Receiving. Some tabs have multiple child sheets thatcontain several options. For example, select the Inventory Management tab.

5. You use the General > Detail tab to define the warehouses the site uses

a. For the Receiving warehouse, select Receiving Area.

b. For the Shipping warehouse, select Shipping Area.

c. For the DMR Processing and Inspection warehouses, select Inspection Area.

d. For the General warehouse, select Main.

Tip To learn about the rest of the fields on this sheet, review the Site Configuration Control >Modules > Inventory Management > General > Detail topic in the application help.

6. You can define a number of items on the other Inventory Management sheets:

a. Use the Shared Warehouses sheet to indicate which remote warehouses share inventory with this site.

b. You use the Transfer Definition and Transfer Resources sheets to define transfer orders by settingup the definitions for transferring part quantities and the resources involved in transfer orders.

c. You define the Serial Tracking and Cycle Counting for parts manufactured and/or distributed througheach site.

7. Click on the Time and Expense tab.

These settings determine whether labor hours and/or incurred expenses entered by employees requireapproval by other authorized employees. If approval is required, you also define approver rights.

8. Now click the Production Management tab.

These settings define the prefixes used on unfirm, firm, and kanban jobs at the site. You can also definesome production yield parameters and other production options.

9. Use the Maintenance Management sheet to determine the job template for maintenance jobs at this site.You can also enter a job prefix for the maintenance jobs; this prefix automatically displays in front of thegenerated job numbers.

10. Click on the Advanced Material Management (AMM) tab.

You use these settings to indicate how the site interacts with the Material Request Queue and other AMMfunctionality.

11. Click on the Shipping/Receiving tab.

Through this functionality, you enter the various manifests this site uses for General, International, FedEx,and UPS shipping. You also define how shipment Billing is handled by the current site.

12. When you finish modifying the site configuration parameters, click Save.

27Epicor ERP | 10.0.700.2


Workshop - Company and Site Rights

After you create the company and site structure for your organization, you can then determine which users canaccess specific companies and sites.

If you work in a multi-company environment, each user can access one or multiple companies. When users login, they can only access the companies and sites for which they have security rights. After you determine thecompanies the user can access, you can then limit the sites within each company the user can open. When theyattempt to switch to a secured company or site, an information message displays explaining they cannot accessthis node.

You assign companies and sites to user accounts through User Account Security Maintenance.

Assign Company/Site Rights

Through this workshop, you will assign additional companies and sites to the XXX_User account (where XXX areyour initials).

1. Navigate to User Account Security Maintenance.



2. In the User ID field, enter XXX_User (where XXX are your initials).

3. Navigate to the Company > Detail sheet.

4. From the tree view, select the EPIC06 company.

5. Notice your new site displays in the Available Sites list. Highlight the XXX Site (where XXX are your initials)and click the Right Arrow button.

6. You need add a company to this user account. Click the Down Arrow next to the New button; select NewCompany.

7. Now click the Company drop-down list and select the Epicor Financial Co.

8. If the user will use the Manufacturing Execution System (MES), select the appropriate Employee for thisuser at this company; select David L. Brown.

This employee record will be used for MES transactions entered by the current user.

Tip You create the employee records that appear on this drop-down list in Shop EmployeeMaintenance.

Menu Path: Production Management > Job Management > Setup > Employee

9. Optionally, select a Work Station for this user account. Workstations, or packing stations, establish thescale and manifest interface for shipping and receiving at this company. If the user is involved with shippingand receiving, select the work station for the user. Select the Shipping Station option.

Epicor ERP | 10.0.700.228


Note You create the workstation records that appear on this drop-down list in WorkstationMaintenance.

Menu Path: Material Management > Shipping / Receiving > Setup > Workstation

10. If this user can update time and/or expense records for employees in this company, select the Can UpdateTime for All Employees and/or Can Update Expenses for All Employees check boxes. For this workshop,do not select either check box.

11. Now determine the sites this user can access. The Available Sites list displays the current sites in the selectedcompany. Highlight Main from the list and click the Right Arrow button.

12. Click Save.

Assign External Companies

If your organization has the Multi-Site license, you can also give the current user access to external companies.

1. Navigate to the Company > External Company > Detail sheet.

2. Click the Down Arrow next to the New button; select New External Company.The External Company field activates.

3. Click the External Company... button to find and select the external company you wish to link to the useraccount.

Tip You create external company records within External Company Maintenance.

Menu Path: System Setup > External System Integration > External Company Configuration


4. Click Save.


Test User Account

Now test this account to verify the companies and sites you selected display.

1. Return to the Home screen and click the Settings button.


3. Log in with the XXX_User account (where XXX are your initials).

Notice you can now access the companies, sites, and external companies you defined on the account. When youclick on a company or site you cannot access, an error message displays.

29Epicor ERP | 10.0.700.2


Automatic Data Processing

You can generate data when you need it so the refreshed data is available for use through processes, reports,and entry programs. By setting up the automatic data processing features, you can automatically generate datathrough a regular schedule you define.

You do this by first creating the schedules you need in System Agent Maintenance. You can create interval(hours/minutes/seconds), daily, weekly, or monthly schedules. These schedules are then available on drop-downlists throughout the application. Users assign specific reports, processes, and executive queries as tasks to eachschedule. When a schedule activates, the selected tasks run, refreshing data they contain and generating theresults for display in reports/dashboards or use in other programs.

To further control how the data is automatically processed, organize the tasks to run in a specific sequencethrough process sets. This feature is important when one process needs to calculate data required during thenext process. For example, to generate schedules for display on the scheduling boards, you need to first run theCalculate Global Scheduling Order process and then the Global Scheduling process. To accomplish this, you firstcreate a Scheduling process set. You add the Calculate Global Scheduling Order and Global Scheduling processesto this process set and indicate you want the Calculate Global Scheduling Order process to run first. You thenassign the process set to an automatic schedule.

You can check on the status of automatic processing by launching the System Monitor. This management tooldisplays the scheduled tasks, active tasks currently running, and the tasks that recently completed processing.You can also review the reports that were recently generated.

The next section takes you through creating schedules and process sets. It also explains how to assign programsto schedules and process sets, and then how to manage automatic processes through the System Monitor.

System Agents

Use System Agent Maintenance to modify the system agent, define schedules that occur during specificintervals, and create rules to divide processing between different application servers. A powerful tool, use SystemAgent Maintenance to streamline the flow of data throughout your company.

When you first install the Epicor ERP application or update your existing application, the system agent isautomatically created. You use the Detail sheet to modify how the system agent interacts with the applicationserver. You can have only one system agent, so you cannot delete it. However if the system agent is accidentallydeleted by an external method, you can create a new agent using System Agent Maintenance.

You will primarily use System Agent Maintenance to define schedules users select on reports, processes, andexecutive queries. Each schedule is set up to activate at regular, specific intervals - seconds, minutes, days, weeks,and months. When the system clock activates a schedule, all the tasks assigned to this schedule run. Dependingon the task, this could cause a specific report to generate and print, a business activity query to export, a globalalert to be sent, and so on.

What Can Be Automated

Many reports and process programs throughout the application have a Schedule list. If a program has this list,you can automate it through the system agent.

All schedules you create through System Agent Maintenance appear on this Schedule list. To automate theprogram, first select the Recurring check box. This activates the Schedule list. When you select a schedule otherthan Now, this program is added to the selected schedule's tasks. When the system agent launches the selectedschedule, this program runs automatically.

Epicor ERP | 10.0.700.230

System Setup and Management CourseAutomatic Data Processing

You can automate these types of programs:

• Processes - These application programs can become tasks, like the Mobile Connect Server Process, theBusiness Activity Query Export Process, Process MRP Process, and so on. For a complete list of theprocesses you can automate, review the System Agent Processes Working With topic in the applicationhelp.

• Reports - Most reports have a Schedule list. Your users can select a schedule for various reports. This reportdefault is linked to each user record, so your users can automate the specific reports they need. When thereport is linked to a schedule, it then generates and prints through the system agent. For more informationon reports, review the Report Defaults topic.

• Executive Queries - You use executive queries to create a cube of data gathered for display on an executivedashboard. You define the cube of data you wish to collect within the Executive Query program; for moreinformation, review the Executive Query topics.

Task Agent Rules

You can also create task agent rules that distribute the processing load to different application servers. Thisimproves application performance by causing a resource heavy process, like MRP Processing, to run on anapplication server that can better handle this load, and then creating an different task agent rule that moves agroup of financial reports that require less processing to a different application server. These tasks can now runsimultaneously, improving how quickly they generate data.

This performance tuning feature is beyond the scope of this course. However you can learn how to set up taskagent rules in the Performance Tuning Guide in the Distribute the Load section. This guide is located in theSystem Management > Working With > node in the application help. The Performance Techniques course alsoexplores task agent rules along with other techniques you can use to improve application performance.

Workshop - Modify the System Agent

Do the following exercises to make changes to the company's system agent.

Modify a System Agent

When you first install the Epicor ERP application or update your existing application, a default system agent isautomatically created. Use the Detail sheet to indicate how each system agent interacts with the applicationserver.

This series of steps are intended as a tour. Because the system agent is already set up in the Education environment,there is not much that can be modified in this exercise.


2. Click Change User... and login using the epicor/epicor account.

3. Return to the Home screen and click the Menu tile. Navigate to System Agent Maintenance.

Menu Path: System Setup > System Maintenance > System Agent


When the program launches, the SystemTaskAgent automatically displays on the Detail sheet.

4. Optionally enter a different Description for the system agent.

5. By default the Auto Start check box is selected. This indicates the system agent is running. If you need toturn off this system agent, clear this check box.

31Epicor ERP | 10.0.700.2

Automatic Data ProcessingSystem Setup and Management Course

6. Use the Processing Delay field to regulate how long the system agent waits before looking for new tasks.Enter 30 (seconds) in this field.

If you have a fast server that can accommodate the network traffic, enter a lower number. A value of 10indicates ten seconds must pass before the system agent looks for new tasks to run; a value of 60 indicatesa minute must pass before the next batch of tasks is processed.

7. The User Name and Password fields define the name and password of the user who logs onto theapplication server (AppServer). Enter the user name and password combination in these fields; this accountis validated against the existing user accounts in the database. If the application cannot find a valid username/password combination, an error message displays.

Important This user account must also have permission to use the system agent. You set up thispermission within User Account Security Maintenance; find the user account you need, navigateto the Options sheet, and select the Allow Session Impersonation check box.

8. You next define the various directories used with the application server connection. The Server File Directorydefines the root directory for files created by tasks run by the system agent. This directory should be a sharedlocation. Typically it is a local directory located on the same machine that runs the application server. Forexample, C:\EpicorData10.

9. The Client File Directory is the name of the root directory for common client files such as configuration,photos, and drawings. This should be a shared directory, normally on the same machine where the applicationserver is running. For example: \\Server\EpicorData10

10. The Client Program Directory defines the location of the server deployment directory. You must enterthis path using the UNC convention. Typically this value uses the \\Server\Epicor10\Server format.

11. The Status group box indicates the current state of the system agent and when it was started.

12. When you finish modifying the system agent details, click Save.

Create a Schedule

You can create as many schedules as you need. These schedules display as options on reports, processes, andother tasks you can link to a recurring schedule.

1. Click the Down Arrow next to the New button; select New Schedule.

2. The Schedules > Detail sheet displays.

3. The Schedule Number defines each schedule as it is added to the system agent. This number is automaticallyassigned.

4. Enter a Description for the schedule. For this workshop you need a schedule that runs once every Sunday,so you enter Sunday Tasks in this field.

5. Click the Next Run drop-down list to define the first date during which this schedule should run. Selecttoday's date.

6. Select a Schedule Type. You can select Interval (hours/minutes/seconds), Daily, Weekly, or Monthlyschedule types. Select the Weekly type.The Weekly sheet becomes active.

7. You want this schedule to run one time each week. Enter a "1" in the Recur every <value> week(s) field.

Epicor ERP | 10.0.700.232


8. From the On: drop-down list, select Sunday.

9. To activate the schedule, select the Enabled check box.

10. When you finish, click Save.

11. As tasks run using this schedule, you can review them within System Agent Maintenance. To do this, navigateto the Schedules > Tasks > List sheet.

Tip You can also review them through the System Monitor; this program is explained later in thiscourse.

Your new schedule is available throughout the application. Users can select it on reports, processes, executivequeries, and process sets.

Workshop - Manage the System Agent

The following workshops illustrate how to use the system agent.

Select a Schedule

After you enter the schedules, you can set up programs to run using a specific schedule. These programsautomatically refresh and generate data when the schedule activates them.

During this workshop, you set up the Production Detail report to automatically generate its data through theweekly Sunday schedule you previously created.

1. Navigate to the Production Detail report.

Menu Path: Production Management > Job Management > Reports > Production Detail

2. Select the Schedule during which you want this report to generate. Because you want this report to generateon Sunday, select the Sunday Tasks schedule.

3. You now indicate you want this report to run each time the system agent launches the Sunday Task schedule.To do this, select the Recurring check box.

4. Lastly indicate these selections are the default values you want for this report. From the Actions menu,select Save Defaults.

Tip Additional options are available on this Actions menu. To restore the program to its originalparameters, select Get Defaults. To clear the current default parameters, select Remove Defaults.

5. Close the Production Detail Report window.

Now each time the system agent launches the Sunday Tasks schedule, the Production Detail report automaticallygenerates. This report would then be available for users when they arrive for at work on Monday. You can verifythis report has run by launching the System Monitor.

33Epicor ERP | 10.0.700.2


View Task Parameters

When tasks are assigned to a schedule, you can review and change their parameters directly through SystemAgent Maintenance.

1. Use the Tree View to expand a schedule with tasks assigned to it. In this example, you expand the Startupschedule.

2. Now expand the Tasks node. Notice several processes are listed under this node.

3. From the Actions menu, select View Task Parameters.

4. The selected task (report, process) displays.

5. Define the parameters you want to use for this process.

6. When you finish, click the Submit button.

Process Sets

Use Process Set Maintenance to create process sets; these records group together related tasks you want torun automatically.

You mainly use process sets when you have tasks that need to run through a specific sequence. Process sets cancontain an extensive number of tasks - like reports, processes, and executive queries. When the process set isactivated by the system agent, these tasks automatically run in the sequence you define.

Workshop - Manage Process Sets

The following workshops demonstrate how you create and use process sets.

Create a Process Set

You will create a process set that closes and completes jobs. It will then generate the Job Traveler.

1. Navigate to Process Set Maintenance.

Menu Path: System Management > Process Sets > Process Set Maintenance


2. Click New on the Standard toolbar.

3. Enter the Process Set ID; this value is the identifier for this process set throughout the application. EnterJobTasks.

4. Enter a Description for the process set. This value displays on drop-down menus; enter Job Tasks ProcessSet.

5. If this process set is required for the application to run, select the System Process check box. Users cannotmodify or delete system process sets. For this workshop, do not select this check box.

Epicor ERP | 10.0.700.234


6. Optionally, select the Allow Simultaneous Processing of Tasks check box to cause the process set toasynchronously run and complete tasks.

These tasks run at the same time, improving performance. Activating this option causes the application toignore the task sequence defined in the Process Set Tasks grid. For this workshop, do not select this checkbox.

Tip If the tasks only generate a small amount of data and you have the system resources to handlethese tasks simultaneously, consider selecting this check box.

7. As tasks are added to this process set, they display within the Process Set Tasks grid. However no tasksare currently added to this process set, so the grid is empty.

8. Click Save.

9. Close the program.

This process set is now available. Executive queries, processes, and reports can be added to this process set.

Add Tasks to a Process Set

For this example, you add the Job Traveler report, the Auto Job Closing Process, and the Auto Job CompletionProcess to your new process set.

1. Navigate to the Job Traveler report.

Menu Path: Production Management > Job Management > Reports > Job Traveler

2. Click the Save Process Set button.The Save to Process Set window displays.

3. Click the Process Set drop-down list and select the Job Tasks Process Set.

4. Click OK. The Job Traveler is added to this process set.

5. Close the Job Traveler.

6. Now launch the Auto Job Closing Process.

Menu Path: Production Management > Job Management > General Operations > Auto Job Closing Process

7. Repeat the previous steps. Click the Save Process Set button.

8. Select the Job Tasks Process Set and click OK.

9. Close the Auto Job Closing Process.

10. To add the last task, launch the Auto Job Completion Process.

Menu Path: Production Management > Job Management > General Operations > Auto Job CompletionProcess

11. Repeat the previous steps. Click the Save Process Set button.

12. Select the Job Task Process Set and click OK.

35Epicor ERP | 10.0.700.2


13. Now review the sequence this process set uses when it launches each task. Return to Process SetMaintenance.

Menu Path: System Management > Process Sets > Process Set Maintenance


14. Click the Process Set ID button to find and select the JobTasks process set.

15. The tasks you added to this process set display within the Process Set Tasks grid.Notice each task is assigned a number. In this example, the Job Traveler is run first, the Auto Job ClosingProcess is run second, and the Auto Job Completion Process is run third. When a schedule activates thisprocess set, the tasks launch in this order.

16. You want the Job Traveler to print after the close and complete processes. Highlight the Job Traveler andclick the Move Down button until the Job Traveler is below the Auto Job Completion Process.

17. Click Save.

When the process set activates, it now processes the tasks in this sequence:

1. Auto Job Close Process

2. Auto Job Completion Process

3. Job Traveler

Schedule a Process Set

To cause the tasks assigned to this process set to activate, assign the process set to an automatic, recurringschedule. When the recurring schedule activates, the tasks assigned to the process set run in the sequence youdefined.

1. You assign a schedule to a process set within the Schedule Process Set program.

Menu Path: System Management > Process Sets > Schedule Process Set

2. Click the Process Set drop-down list to select the process set you need. Select the JobTasks process set.

3. Click the Schedule drop-down list and select the Sunday Tasks schedule.

4. This activates the Recurring check box. Select this check box to indicate this process set launches each timethe selected schedule activates.

5. Enter a User Description that identifies the purpose for the process set. When you review tasks on theSystem Monitor, this description displays. Enter Job Refresh for the Week.

6. Click the Submit button.

Now each time the system agent launches the Sunday Tasks schedule, this process set activates. The task runsin the sequence you defined.

Epicor ERP | 10.0.700.236


System Monitor

Use the System Monitor to verify the processes, reports, and other scheduled tasks you have run.

This program interacts with the data by displaying items scheduled to run within your Epicor ERP application.The sheets in the System Monitor display records that indicate a specific program such as a report, executivequery, or process (for example, Process MRP) is run. The status of the record determines the sheet where eachrecord displays. Use the System Monitor to do the following tasks:

• Manage - Review the status of the item being run.

• Preview - Click the Print Preview button to preview a report/form on your screen before it prints. Thisfunctionality is only available on the Reports sheet.

• Print - Click the Print button to print a generated report/form. You can also reprint reports/forms. Use thisfunction to reprint a report (for instance, the Stock Status Report) from a previous date. This functionality isonly available on the Reports sheet.

Workshop - Use the System Monitor

The System Monitor automatically runs when you first launch the application.

1. From the System Tray, double-click the System Monitor icon. You can also access this program from withinthe Epicor ERP application.

Menu Path: System Setup > System Maintenance > System Monitor


The System Monitor displays.

2. The Active Tasks sheet shows tasks currently in process. These include reports, processes, and executivequeries.

3. To end a task, highlight it and then click the Delete button.

4. Use the History Tasks sheet to review the reports, processes, and executive queries recently run on theapplication server (AppServer).

5. Use the Scheduled Tasks sheet to review and work with tasks scheduled to run at a later time.

6. You can end a scheduled task by highlighting it and then clicking Delete.The task is removed from the Scheduled Tasks grid.

7. You can verify that scheduled reports ran on the Reports sheet. If a report failed to generate, this situationis indicated on this sheet as well.

Tip While the report programs run on the application server, they generate physical files. These filesare the data source the System Monitor (running on the client) uses to perform the actual printing.The task agent works through the tasks assigned to the application server, and by default this programruns a purge of the reports approximately every 15 minutes. To keep a specific report file availablefor a longer length of time, use the Archive Period field on the report/form program. When youenter a value in this field, the task agent does not purge it until the system clock passes this definedArchive Period.

37Epicor ERP | 10.0.700.2


The System Monitor is an important tool that helps you manage tasks sent to the server - both manual andautomatic tasks. Use this program to verify data processing generates as expected.

Epicor ERP | 10.0.700.238


Security

You use the security tools to control user access to the Epicor ERP application.

Through the security feature set, you can:

• Protect sensitive data.

• Guard against users accidentally making harmful changes.

• Grant users access to the programs, reports, and processes they need to perform their specific tasks, streamliningtheir use of the Epicor ERP application.

• Prevent users from accessing areas of the Epicor ERP application that fall outside of their work functions.

You leverage both Security Group Maintenance and User Account Maintenance to set up security levels. Youcan then grant users, or groups of users, security privileges for specific areas in the application. Security privilegescan be set at the menu, field, business object, and method levels.

To manage security, you can run the Menu Security report and the System Activity Log to review the securitysettings within the current company. You can then make adjustments to the security settings you need.

39Epicor ERP | 10.0.700.2

SecuritySystem Setup and Management Course

Security Privileges

This section of the course describes how you establish security privileges for users within your current company.

Company Security

If your organization has multiple companies, you will need to set up security separately within each company.The users within each company will then access the Epicor ERP application using the security plan you havedefined.

Note each database will have at least one company in it. During installation, the Epicor ERP application automaticallycreates a blank company (TEST) and a single user (EPICOR) with Security Manager privileges in every database.You can then successfully log into the Epicor ERP application for the first time.

Security Group Maintenance

Use Security Group Maintenance to establish security groups that define various functions either throughoutyour organization or for a specific company. You then use these security groups to assign or limit access to variousareas within the Epicor ERP application.

You can assign a user to a security group in User Account Maintenance, and then you can select security groupson various security sheets in other programs. While optional, security groups are useful because they can categorizeemployees by role or department.

Epicor recommends you create security groups and assign all users to specific groups. You then simplify yoursecurity setup, as you do not need to assign security to individual users. This approach also ensures you implementsecurity through an organized and clearly defined method.

Before you begin assigning security, consider the various areas of security your company needs. You should thendesign a security plan and enter security groups that reflect this plan. While you set up this plan, consider thatroles tend to be more generic, while job titles tend to be more specific. Several job titles can fulfill the responsibilitiesof a single role.

Workshop - Create a Security Group

During this workshop, you will create a new security group.

1. Navigate to Security Group Maintenance.

Menu Path: System Setup > Security Maintenance > Security Group Maintenance


2. Click New.

3. In the Group Code field, enter XXX_PROD (where XXX are your initials).

This defines the identifier used for the security group.

4. In the Description field, enter _Production Staff.

This text displays within the security programs, so enter a brief, concise explanation for the group in thisfield.

Epicor ERP | 10.0.700.240

System Setup and Management CourseSecurity

Tip If you place an underscore (_) or a period (.) in front of the Description, the security group sortsto the top of the list in the security programs. This makes the new security group much easier to find.

5. Click Save.

6. Exit Security Group Maintenance.

You have now created the Production Staff security group. You will select this group in various programs duringthe next workshops.

41Epicor ERP | 10.0.700.2


User Security

Launch User Account Security Maintenance to assign users to both security privileges and security groups.

The security privileges give a specific user access to various Epicor ERP application features. For example, you cangive a user access to the customization tools, but not allow this user to make language string changes. You canalso give a user Security Manager rights; this user can then modify security settings for other users.

Through the security group functionality, you can assign a single user to multiple security groups. When youallow or disallow a security group on security sheets in other programs, the users assigned to this security groupwill either have access or have no access to functionality assigned to the security group.

Security Manager

The Security Manager status is a special permission granted to certain users. If your user account has these rights,you can modify menu and process security options to restrict a module, program, or process to specific users.

The Epicor ERP application restricts access to the System Management module; the programs used to create asecurity strategy are available within this module. Epicor creates a single user (manager) with security managerprivileges in every database. This default record is created during installation, and you use this account to createuser account records - including other accounts that have the Security Manager status.

As a good business practice, you should not give yourself Security Manager access on your normal user account.This ensures the menu choices you make on your normal login are appropriate for your typical daily routine. Italso ensures that other employees do not grant security access to themselves when you are away from yourcomputer. Instead, create a separate Security Manager account that you only use for security tasks.

Workshop - Manage User Security

The next workshops illustrate how you assign security permissions to user accounts.

Epicor ERP | 10.0.700.242


Assign Security Privileges

You assign security privileges to a user on the group sheet.

Navigate to User Account Security Maintenance.



1. In the User ID field, enter XXX_User (where XXX are your initials).

2. You can limit what this user sees on the Main Menu by entering a value in the Client Side Menu ID field.Enter a menu identifier for either a sub-menu or a program. Enter XAMN2000 in this field.

When this user launches the Epicor ERP application, only the contents under the specific sub-menu identifieror the specific program appear on the Main Menu.

Tip You can find the specific menu identifier you need within Menu Maintenance. This program isdescribed later within this course.

3. Exit User Account Security Maintenance. Click Save and Close.




7. For the User name, enter XXX_User (where XXX are your initials) and a Password.Navigate to the Menu screen. Notice you only have access to the programs under the ProductionManagement node.


9. Click Change User... and log in using epicor/epicor.

10. Navigate to User Account Security Maintenance again and display the XXX_User account (where XXX areyour initials).

11. Clear the value in the Client Start Menu ID field.

12. Click on the Options sheet.

13. Notice the Security Manager check box.

Users with this security access can define and change the profiles of themselves and other users. They canalso access all security programs; only select this option for user accounts that will handle security tasks. Forthis workshop, do not select this option.

14. In the Tools Options group box, select the Allow Personalization check box.

Use the check boxes in the Tools Options group box to assign or prevent this user from accessing varioustools and functions. By selecting this option, the XXX_User (where XXX are your initials) account will be ableto personalize programs.

43Epicor ERP | 10.0.700.2


15. In the Access Options group box, verify the Allow Password Change check box is selected.

Use the check boxes in the Access Options group box to allow or prevent this user from updating the loginpassword. You can also allow this user to view information within a web browser, mobile device, andenterprise-wide searches.

16. In the System Options group box, verify the Can Maintain Favorites Programs and Can Change SaveSettings On Exit check boxes are selected.

With these permissions selected, users can add program tiles to the Favorites box and define default optionslike automatic data processing on reports, processes, and executive queries.

17. After you finish defining the options, click Save.

Tip To learn more about each security privilege available on this sheet, review the User Account Maintenance> Options topic in the application help.

Epicor ERP | 10.0.700.244


Assign Security Groups

You add user accounts to security groups on the Group sheet.

1. Navigate to the Group sheet.

The Available list displays the security groups available in the application.

2. Highlight the _Production Staff group from the list.

3. Click the Right Arrow button.

4. The _Production Staff security group now moves to the Authorized list.

5. Click Save.


The XXX_User (where XXX are your initials) is now an official member of the Production Staff security group.

Assign Security

You explore how to assign security to programs, processes, and fields during this section of the course.

You assign security through the following features:

• Run Time Arguments - Limit access to a specific menu node on a client installation.

• Menu Maintenance - Use security groups and user accounts to prevent or allow access to specific programs.

• Process Security Maintenance - Use security groups and user accounts to prevent or allow access to specificbusiness objects (Iike customers, parts, sales orders, and so on) and/or methods within these business object(like Get New, Update, Delete, and so on).

• Field Security Maintenance - Use security groups and user accounts to prevent or allow access to specificfields in programs.

Run Time Argument Menu Control

You can assign security on specific desktop icons by using run time arguments. Use this functionality to limit theprograms that display when users launch the Epicor ERP application.

This security functionality is an effective way to quickly set up a level of security on workstations. You do notneed to use security groups or user accounts with this functionality. Each workstation can have a number ofdesktop icons available for launching the Epicor ERP application. Each desktop icon can in turn be set up to launchthe Epicor ERP application in a specific mode defined by a run time argument.

You can use the /MENUID run time argument to cause the Main Menu to only display a specific sub-menu orprogram. The user who launches the Epicor ERP application through this icon is limited to the programs accessiblewithin either the menu or the specific program.

You can also use the /TE and /CRM run time arguments to set up unique concurrent user licenses. The /TEargument limits the Main Menu to display only the Time and Expense functionality, while the /CRM argumentlimits the Main Menu to display the Customer Relationship Management functionality. These unique licensesconsume a different concurrent user pool. Activate these licenses either when you want to limit a workstation

45Epicor ERP | 10.0.700.2


to display only these specific functions or when you want to set up additional licenses separate from the generaluser pool.

Workshop - Define Run Time Arguments

To leverage this feature, you display the Properties window for the Epicor icon and then modify the Target fieldto include a menu ID.

During this workshop, you will limit a workstation to only display programs in the CRM module.

1. Exit the Epicor application.

2. On the desktop for the workstation, right-click on the application's icon; from the context menu, selectProperties.The application’s Properties window appears, displaying the Shortcut tab.

3. In the Target field, enter a [Space] after the -CONFIG run time argument you previously entered.

4. Add a dash ("-") and enter the identifier for the menu or program that you want to display. To restrict theworkstation to display only the CRM module, enter: -menuid=CRMN0000

5. Click Apply.

6. Click OK.

7. Launch the Epicor ERP application through this icon.The Main Menu only displays the Job Management module node. Now this user can only see the programsin the Job Management module on the Main Menu.

The -menuid method may not limit access to all the programs you intend. Several programs can still be launchedby right-clicking various fields. For example, users could still launch Part Maintenance the Part field's contextmenu. If the modules that contain these programs are licensed in your Epicor ERP application, users will be ableto access them through context menus. You will need to use other security methods described later in this courseto restrict access to the programs available on context menus.

Security Group Conflicts

The application handles conflicts between security groups through an access hierarchy.

1. If a user is assigned to security group _Production Staff, which allows access to the Engineering Workbench,and security group Purchasing, which does not, the user will still be able to launch the EngineeringWorkbench. The security group with more access overrides the security group with less access.

2. Likewise, if a user is assigned rights to a program, but is assigned to a security group which is not, the useris still able to launch the program. User rights have precedence over group rights.

3. The Allow Access mode also has precedence over the Disallow Access mode. You select these modes inthe Menu Maintenance, Process Security Maintenance, and Field Security Maintenance programs.

Epicor ERP | 10.0.700.246


Workshop - Menu Security

Use Menu Maintenance to define security options for users in the current company.

Menu security is the highest level where you can set security privileges. You can use the security in this managementprogram to hide a program or a folder on the Main Menu from security groups or specific users. Changes youmake in this program display on all the workstations that run the application.

Module groups and modules are organized by folders. Module function categories, such as Setup, GeneralOperations, and Reports, are also organized by folders. Most menu folders, except those in the System Managementmodule group, are initially available to all users, so you have a lot of flexibility determining which users haveaccess to different parts of the Menu.

Important You can only use this program if your user account has customization rights.

Create a Security Code

During this workshop, you will create a security code and indicate which users have access to this code.

1. Return to the Home screen and click the Settings button.

2. Click Change User... and login using the epicor/epicor account.

3. Click the Menu tile and navigate to Menu Maintenance.

Menu Path: System Setup > System Maintenance > Menu Maintenance


4. Click the Down Arrow next to the New button and select New Security.

5. In the Security ID field, enter UD_XXX (where XXX are your initials).

6. In the Description field, enter Prevent Financial Access.

This value briefly describes the purpose of the new security code.

7. The Current Company Only check box to apply this security code against the Main Menu structure forthe current company. For this workshop, do not select this check box.

If this check box is selected, only users with access through this security code can display and launch theprograms within this company node, but this security code is not applied against other companies. If theCurrent Company Only check box is not selected (check box is clear), this security code is applied againstall companies.

8. Notice the Security Manager Access Only option. Do not select this option for this workshop. Howeverthis option is useful when you are first setting up security, as it blocks all access until you create a securityplan. As described previously in the course, you assign security rights to user accounts within User AccountSecurity Maintenance.

9. Select the Exclude Epicor Web Access check box. This prevents users assigned to this security code fromlaunching the Epicor ERP application through an internet browser.

10. Verify the Allow Access sheet is active.

47Epicor ERP | 10.0.700.2


Important You can use either the Allow Access and Disallow sheets to assign security; rememberthe Allow Access method overrides the Disallow Access method. If a user is assigned to both sheets,the user has access to the programs assigned to this security code.

11. Clear the Allow Access to All Groups/Users check box.

12. Click Save.

The Groups/Users and Selected Groups/Users lists become active. However note that until you add usersand/or groups to the Selected Groups/Users list, nobody has access through this security level. Be sure youare ready to assign security before you clear this check box.

13. Click the Double-Right Arrow button.All the users and security groups display in the Selected Groups/Users list.

14. Highlight the _Production Staff security group.

15. Click the Left Arrow button.The _Production Staff security group displays on the Selected Groups/Users list. this indicates the ProductionStaff security group does not have access through this security code.

16. Click Save.

17. Remain in Menu Maintenance.

Now only users assigned to the _Production Staff security group do not have access to programs linked to thissecurity code. Any groups or users that remain in the Selected Groups/Users list do have access to the programsassigned to this security level.

Epicor ERP | 10.0.700.248


Assign Menu Security

During this workshop, you will assign your new security code to AR Invoice Entry.

When you assign a security code to a selected program, only those users given access through this security codecan launch the program.

1. Navigate to the Detail sheet.

2. Now from the tree view, select the AR Invoice Entry.

Menu Path: Financial Management > Accounts Receivable > General Operations > Invoice Entry

Important Be aware when you change the security code for a standard menu item like the AR InvoiceEntry, this code reverts back to its original security code when you install the next service pack. Youshould only use this functionality for custom programs or be prepared to reassign the menu securitycodes after a service pack installation.

3. Click the Security ID… button.

The Security Search window displays.

4. Search for and select the UD_XXX (where XXX are your initials) security code you created and click OK.

The Security ID… field now displays the new security level you have selected.

5. Click Save.This program is assigned to this security level.

6. Exit Menu Maintenance.

You can also review which programs are assigned to this security code. To do this, return to the Security sheetand find/select your UD_XXX security code (where XXX are your initials). The Menu Options field displays theprograms that currently use this security code.

Test Menu Security




4. For the User name, enter XXX_User (where XXX are your initials) and a Password.

5. Navigate to AR Invoice Entry.

Menu Path: Financial Management > Accounts Receivable > General Operations > Invoice Entry

6. When you try to launch the program, you will receive an error message that states you cannot access themenu item. Click OK.

49Epicor ERP | 10.0.700.2


Workshop - Field Security

Use Field Security Maintenance to establish security privileges at the field level in specific database tables,extended user defined tables, and fields throughout the application.

Field Security Maintenance contains functionality you leverage to define security privileges on fields for all users,selected users, and groups. You use this program to first select a table and then allow, limit, or prevent accessto specific fields within the selected table. Each field can have a unique security level assigned to it; this level canbe globally defined for the whole organization, specifically defined for the current company, or specifically definedfor a selected user or group.

You can reset the security privileges for a selected field or the whole table to the default values initially grantedall users. You can also view the security privileges for the fields in the table for the selected user.

Be sure you set up user accounts and security groups before using this program.

Important Table and field security can only be applied to actual database tables and columns. Usecustomization to secure temporary table information. You can also use Business Process Managementmethod directives to secure temporary tables. The application's Field Help displays several pieces ofinformation including the External check box. If the External check box is selected and no data displays forthe database field, this is a Calculated Column or belongs to a temp table.

You can use Extended Properties Maintenance to verify the table type. If the dataset table is temporary,Temp Table displays in the Table Type field. Use the Fields > Detail sheet to determine if the field is External.Typically, temp tables have a Like value that points to the actual table or column used to retrieve and storethe data.

Example The SrcGLTran table is a temp table and not an actual database table.

Epicor ERP | 10.0.700.250


Assign Global Field Security

You can assign security to a specific field that then applies to the entire organization or a specific company.

1. Navigate to Field Security Maintenance.

Menu Path: System Setup > Security Maintenance > Field Security Maintenance


2. Click the Schema drop-down list and select the Erp schema option.

3. In the Table field, enter ShipVia and press <Tab>.

The Description field displays the purpose of the selected table.

4. In the tree view, select the Description field.

The Field Name displays the name of the selected field.

Tip If the Primary Key check box is selected, it indicates the current field is required by the database.You cannot change the security option for a Primary Key field; usually these fields are for identifierslike the customer ID, part ID, and so on. However the Description field is not a primary key, so for thisexample, the check box is clear.

5. In the Default Access field, select Read.

This option assigns display-only (read-only) rights to the current field. Users can only view data within thisfield; users cannot enter data within this field.

Other options:

• Full - Users can both view and enter data within this field. This security option is the default.

• None - This security option causes the field to be blank. No data displays in this field, and users cannotenter data in it. Be aware that the None setting also causes the field's data to not be included when thedataset is sent to and from its program. This can have unintended consequences for processes, like BPMdirectives, which may require this data.

6. Select the Current Company Only check box.

You want this security level to only apply to the field within the current company. If you keep this checkbox clear, the Read security level you defined for this field is used globally in all companies.

7. Click Save.

8. Remain in the Field Security Maintenance.

Now users can only review the text in the Description field. Note that after you finish this Security course, undothis setting so that it does not cause issues for other courses that may use this company.

51Epicor ERP | 10.0.700.2


Security Group Field Security

You can also assign security to a field that only applies to a specific user or security group.

1. Navigate to the Users/Groups sheet.

2. In the grid, select the _Production Staff security group.

3. In the Tree View, select the WebDesc field.

4. Click in the Access column to display the drop-down list and select the Full option.

Just like the previous workshop, you have the Full, Read, and None security options. You also have theDefault option; select this option when you want the user or security group to use the global security levelassigned for this field on the Detail sheet.

5. Select the Carrier field.

You want to give members of the _Production Staff security group read-only rights to this field.

6. Click in the Access column and select the Read security option.These users can only view the value in the Carrier field; they cannot change it.

7. Select the IStatCode field.

8. Click in the Access column and select the None security option.The users in this Production Staff group cannot see the value in the Intrastat Code field, nor can they editit.

9. Click Save.

10. Exit Field Security Maintenance.

Epicor ERP | 10.0.700.252


Test Field Security

Now that you have defined field security for the _Production Staff security group on the ShipVia table, you cansee the security options in action.

1. Return to the Main Menu, click the Settings tile and the Change User... option.

2. Log into the application using the XXX_User account (where XXX are your initials).

3. Click the Menu tile and navigate to Ship Via Maintenance.

Menu Path: Sales Management > Order Management > Setup > Ship Via

Tip The CRM menu path is: Customer Relationship Management > Order Management > Setup >Ship Via

4. Click the Code... button and find/select all the ship via codes.The ship via codes display in the tree view. You can now see each of the security settings you defined forthe _Production Staff security group.

5. The Description field displays a value, but you cannot change it.

6. You can enter a value in the Web Description field.

7. A Carrier option displays, but you cannot click on the drop-down list to change this option.

8. The Intrastat Code does not display a value and you cannot enter text in this field.

Security Management

You can use the Menu Security report to review the security settings defined for your organization and the SystemActivity Log to monitor user database activity.

Menu Security Report

Use the Menu Security report to review the current access users and security groups have on the Main Menu.

Generate this report to evaluate the security currently defined for your programs. You can review the securityfor users, security groups, or both. You can also filter this report to only display access for a specific program,user, or security group. This key report can give you a complete overview of the security plan currently in place.

Available controls:

• Use this Selection sheet to choose the parameters for the report.

• Use the Filter sheet(s) to select the User and Security Group to include on the report.

Important For more information on how to review the status of the reports/forms you print, preview, orgenerate, review the System Monitor topic in the Interface Navigation section of online help.

53Epicor ERP | 10.0.700.2


System Activity Log

Use the System Activity Log dashboard to review all database modifications that occurred within the application.

This valuable tool can help you determine where and when specific database changes were carried out and whoinitiated these changes. You can quickly locate the database activity you wish to review by filtering the dataactivity that displays through several advanced search parameters.

Menu Path: System Setup > Security Maintenance > System Activity Log

Epicor ERP | 10.0.700.254


Customization Management

The Epicor ERP application contains a diverse suite of customization tools. Through these tools, users can modifythe application to better reflect the needs of your organization and industry.

Customization refers to a series of related tools embedded in the Epicor ERP application. The customization tools:

• Personalization - Each user has limited access to personalize the look of programs and grid layouts. Certainusers can also have additional personalization rights to modify how fields are placed on the interface. Thesechanges are linked to a specific user account, so other users cannot access these personalized programs.

• Customization - Users can also create customization layers of programs which are available to the entirecompany. Besides manipulating program interfaces, users can also add new fields and entire sheets to programs.They can also enter custom code that runs unique processes.

• Styling - Users can modify the look and feel of the application through the styling tools. Users with stylingrights can create new themes that change the color, font, and other characteristics of the interface. Thisfunctionality is typically used to differentiate between companies and sites available in the Epicor ERP application.

• Dashboards - Through the dashboard functionality, users with dashboard developer rights can create customviews of data. They can first create a custom business activity query (BAQ) that pulls in data from one ormultiple tables. These BAQs can be read only views or updatable BAQs through which users can enter companyspecific data. These users then define what columns display from each BAQ and they can also create calculatedfields to further customize the data results. These BAQs can then be placed on custom dashboards where thedata is further organized through grids and charts. If the BAQ is updatable, these dashboards can be customentry programs.

• Localization - The localization tools display the interface using different language and culture options. Theseusers can change the base strings to the selected language, and then update specific strings to reflect usagespecific to a region or culture.

• Business Process Management (BPM) - By creating method, data, and updatable BAQ directives, users canbetter manage data transactions. Users can intercept data before it's recorded to a database, send alertmessages to selected users, and other automatic data monitoring tasks.

• Help Annotations - The application help system can be customized to document processes and proceduresspecific to your company or area within your company. Each topic in the application help can contain twoannotations, a User annotation and a Company annotation. User annotations are personalized help noteslinked to a user account; only the specific user can display these annotations. Company annotations arecustom help notes available for all users in a specific company.

• Solution Management - When users finish customizing the application, they need a way to distribute theirnew items – custom programs, business objects, new dashboards, Business Process Management directivegroups, user-defined codes, extended properties, and so on – at the same time. Users can bundle these itemstogether using the Solution Workbench. This program can track current user's activity, for example, newdashboards, and then automatically add these items into the solution. Another way of adding objects is toselect existing database items, such as previously created customizations, menu items, and so on. Users thenbundle these items together by creating a .cab file. This single file can be distributed and imported into anotherEpicor ERP application environment.

You grant users different levels of customization rights through User Security Maintenance. By controlling whocan modify the Epicor ERP application, you reduce the chance an issue occurs from a poorly created customization,personalization, and dashboard. You also have a better idea of what customization layers are added to the system,so you can prepare these custom programs for a smooth transition when you upgrade the system.

This section of the course explores how you manage customization rights. It also shows you the managementprograms available for monitoring the personalizations, customizations, dashboards, and help annotations. Thesection concludes with Solution Management overview - through this section you will learn how to use solutiontypes, get to know predefined solution elements, and add custom items into the solution.

55Epicor ERP | 10.0.700.2

Customization ManagementSystem Setup and Management Course

Workshop - Customization Rights

You assign user access to the customization tools through User Account Security Maintenance. To do this, youselect a user account and then identify the customization tools this account can access.

Assign Customization Rights

1. Navigate to User Security Maintenance.



2. Click the User ID... button to find and select the XXX_User account (where XXX are your initials).

3. Click the Options sheet.This sheet displays the privileges available for each user account.

4. To grant access to the customization tools, select the Customize Privileges check box.This user can then switch the Epicor ERP application to Developer Mode and create customization layersfor most programs.

5. Select the Allow Personalization check box to give this user access to Personalization mode.This user can then change fonts, font sizes, colors, and tab stops on program interfaces; these changes onlyappear when the user logs in with this account.

6. To grant localization privileges, select the Allow Translation check box.

This user can then select different language sets for the text strings displayed throughout the application.This user can also run the Translation Utility to modify the default language strings to reflect regionalspellings and phrases.

Important Selecting this check box slows down performance. This option causes the translationfunctionality to load with each form. As a best practice, create a separate account for this user thathas translation privileges. When the user needs access to Language Maintenance and the othertranslation tools, the user logs in with this specific translation account.

7. Select the Dashboard Developer check box to give the current user right to switch the dashboard programinto Designer Mode.This user can then modify existing dashboards or create new ones.

8. To give this user access to the entire business process management (BPM) feature set, select the BPMAdvanced User check box.This user can then work with the source code that runs each method directive.

9. Select the BAQ Advanced User check box to indicate the current user can create updatable business activityqueries (BAQs).

This user can then create BAQs that allow data entry; these BAQs can then be placed on dashboards tocreate custom entry programs.

Important To create updatable BAQs, the current user must also have BPM Advanced User rights.Because updatable BAQs run through business process management (BPM) methods, the current user

Epicor ERP | 10.0.700.256

System Setup and Management CourseCustomization Management

requires permission for both advanced BPM and advanced BAQ to create and modify updatable BAQs.This user can also create BPM methods that activate when users enter or modify data through anupdatable BAQ.

10. Select the Allow Creation of Cross Company BAQ check box to give this user the ability to build BAQsthat can store data from multiple companies.

11. Select the Can Build Solutions check box to indicate a user can build a solution in the Solution Workbenchby exporting and packaging objects that are part of the solution into a .cab file.

12. To provide a user with the ability to install solutions created in the Solution Workbench, select the CanInstall Solutions check box.

13. To provide a user with the ability to use the solution tracking feature, select the Can Track Solutions checkbox. This user can then start tracking Epicor ERP application activity within the Solution Workbench and addthe tracked items into the solution.

14. To give this user access to the styling tools, select the Can Maintain Themes check box. This user can thenmodify the look and feel of the application. This feature set is used when a user wants to create differentinterface styles for different companies.

15. You define help annotation rights through two check boxes. To give this user permission to write and edituser annotations, select the Can Edit User Annotations check box; these annotations only display for thecurrent user account. To give this user rights to create and edit company annotations, select the Can EditCompany Annotations check box.

16. When you finish, click Save.

The next time this user logs into the Epicor ERP application, the tools you activated for the user account areavailable.

Workshop - Personalization Purge

Use Personalization Purge to remove personalizations from the Epicor ERP application.

Through this program, you first locate the personalizations created by a specific user. You can then remove apersonalization this user no longer wants or remove all personalizations created by this specific user. For example,you might use this program when an individual leaves your organization.

This program only removes personalizations. If you wish export and import a personalization, useCustomization/Personalization Maintenance. This program contains more functionality, as you can correctissues with personalizations and export/import personalizations into a new company. The next CustomizationMaintenance section describes how to use this program.

Use Personalization Purge

1. Navigate to Personalization Purge.

Menu Path: System Management > Purge/Cleanup Routines > Personalization Purge


57Epicor ERP | 10.0.700.2


2. Click the Search button to find and select the specific user's personalizations you wish to review; select thepersonalizations linked to the Chris Fullerton user account.The selected personalizations display in the Search Results grid.

3. Click the Select All button and the OK button.

4. Select one of the personalizations.

5. Review the following fields:

a. The Company field displays the name of the company record that contains the personalizations.

b. The Product ID field indicates the Epicor ERP application used to create the personalizations.

c. The User field displays the identifier for the user who created the personalizations.

d. The Type Code indicates what kind of personalization was made to the selected item.

e. The Last Updated By field indicates the user who most recently updated the personalization, and theLast Updated field displays the date on which this personalization was most recently modified.

f. The Description field contains additional information about the personalization.

g. The Form Name field displays the application filename of the modified program.

6. You can also review this user's activity recorded in Epicor Social Enterprise (ESE). This may help you decidewhether you should remove the personalization. To do this, click Actions > Activity Stream.

7. Click on the Activity Stream tab.This user's activity displays on this sheet.

8. Remove the selected personalization. click Actions > Purge Selected.

9. If you wanted to delete all the personalizations created by this user, click Actions > Purge All.

The selected personalizations are removed from the Epicor ERP application.

Workshop - Customization Maintenance

Use Customization/Personalization Maintenance to manage the customizations and personalizations thatexist within your Epicor ERP application. Its primary feature is the verification functionality which you use to detectproblems within customizations or personalizations.

This maintenance program also contains the tools you need to correct issues. Customization/PersonalizationMaintenance is especially useful when you upgrade the application to a new version, as it can help you makecustomized and personalized programs compatible with the current version.

Tip When users attempt to launch a customized or personalized program that is not compatible, an errormessage displays which prevents the user from launching the program. Customization/PersonalizationMaintenance can then be used to upgrade the program. However if the customized or personalized programis compatible, no error message displays and the user can run the program.

This program has additional functionality for importing and exporting your customizations and personalizations.Leverage these functions to make user modified programs available throughout your organization. You can alsouse this maintenance tool to delete a customization or personalization. Run this feature when you want to either

Epicor ERP | 10.0.700.258


remove custom program stages you no longer need or remove personalizations made by employees who are nolonger with your company.

If you work in a multi-company environment, you can display and update customizations/personalizations in thecompanies for which you have access. Any personalized and customized programs created in the companiesselected on your user account within User Account Security Maintenance display within this program. If you workin an Epicor Express environment, you can display and update customizations/personalizations made within thecurrent company.

For System Administrators with Security Manager rights, this program can be used to modify fields and deletecustomizations and personalizations. For System Administrators without Security Manager rights, this programdisplays in a read-only format.

Review, Update, and Delete Customizations

1. Navigate to Customization/Personalization Maintenance.

Menu Path: System Management > Upgrade/Mass Regeneration > Customization Maintenance


2. To display customizations and personalizations, click the Name button. The Customization/ PersonalizationSearch program displays.

3. Click Search.The customizations and personalizations display in the Search Results grid.

4. Click Select All and then click OK.The customizations and personalizations populate the tree view.

5. Highlight the first epicor option; this should be personalization created for AR Invoice Entry.

6. The Description field displays the brief explanation entered by the user when thepersonalization/customization was created. If you need, you can update the description; enter XXX ARInvoice Personalization (where XXX are your initials).

7. Review the following fields:

a. The Form Name field contains the .xml filename of the customized or personalized form.

b. The Parent Layer displays the code layer above this customization or personalization. This value is setand managed by the application and displays for your information. For example, if a user personalizeda customization, the name of the customization displays in this field.

c. The Company field displays the name of the company using the customization/personalization.

d. The Product ID indicates the application that was used to create the customization/personalization –for this example EP (Epicor) displays.

e. The Last Updated By field displays the user who most recently worked on this customized or personalizedprogram.

8. Select the Work In Progress check box. This check box indicates the modification is not available yet inRun Mode for users. You can then continue to develop the personalization or customization before releasingit.

59Epicor ERP | 10.0.700.2


9. Review the information in the rest of the fields on this sheet:

a. The Type Code field displays the type. The type can be a Personalization or a Customization.

b. The Valid For field indicates for which application version this customization/personalization runs. Forexample: 3.0.1

c. The Last Updated field displays the date on which this customization or personalization was last modified.

10. The Status field indicates the current state of the selected customized or personalized program. Availableoptions:

• Pass – This customized or personalized program works with the current version. A program must havethe Pass status before users can launch the program in Run Mode. If it does not pass, an error messagedisplays and the user cannot launch the program.

• Not Validated – This customization/personalization has not yet been evaluated by the verification tool.

• Warning – Some issues with the elements (controls or properties) on the customized/personalizedprogram are occurring. You can view these issues on the Warning and Errors sheets; these sheets aredescribed later in the Verify Customizations workshop.

11. The Where Used grid displays all places that use this customized or personalized program within theapplication.

12. Click the Restore button to revert the current customized or personalized program back to its previousversion. Use this button to undo the changes you made to upgrade the customization/personalization.

Tip The Restore button is only available if a backup version exists in the database. The applicationautomatically creates a backup version of a customization or personalization during an upgrade.However, if the customized or personalized program has not been upgraded, this button is notavailable.

13. To record changes to the current customized or personalized program, click Save.

14. If you want to remove the selected customization/personalization, click the Delete button. This customizedor personalized program is now completely removed from the application.

Export Customizations

You can use Customization/Personalization Maintenance to export a selected customized or personalized programinto a folder you select. You can also change the name of the exported file.

Typically you export a customization/personalization into a shared folder so other users can then import it intotheir application using Customization/ Personalization Maintenance. Review the next workshop section to learnhow to import a customization or personalization.

Important The export file uses a special format that can only be imported withinCustomization/Personalization Maintenance. You cannot use this format for importing within theCustomization Tools Dialog.

To export a customization:

1. Clear the Work In Progress check box you selected in the previous section.

2. Click Save.

Epicor ERP | 10.0.700.260


3. From the Actions menu, select Export Customization.

4. The Export Customization window displays.

5. The current customization displays within the Name and Description fields. Notice you can change theDescription. For this workshop, do not change this value.

6. For the New Name field enter XXX AR Invoice Personalization Export (where XXX are your initials). If youleave this field blank, the exported file uses the Name value for its filename.

7. Click the Export Filename button to find and select the path and filename you want. By default this pathis: \\<Company Name\shared\export

8. Enter the File name you will use for this exported personalization. Enter XXXARInvoicePers in this field(where XXX are your initials).

9. Click Save.

10. Now click the Export button.

The customization is now available within the selected destination folder. Other users can now import thiscustomization into their environments.

Import Customizations

You can use Customization/Personalization Maintenance to import a selected customization or personalizationinto your application. You can also change the name of the imported file.

During this exercise, you will import the personalization you previously exported into a different company. Youcan then use the customization/personalization as you need in this company. You can indicate it is a Work inProcess customization, modify the imported customization, correct issues, and so on.

To import a customization or personalization:

1. Return to the Menu screen.

2. Notice Epicor Education, Main displays as a link in the upper left corner. Click this link.The Change Current Company and/or Site window displays.

3. Select the Epicor Distribution, Main Site option.

4. Click the Refresh icon.The Menu now displays the Epicor Distribution, Main Site location.




6. From the Actions menu, select Import Customization.

7. The Import Customization window displays.

8. Click the Import Filename button to find and select the customization or personalization you want toimport.

61Epicor ERP | 10.0.700.2


9. Navigate to the EPIC06 > Shared > Export folder. Select the XXXARInvoicePers.xml file you created in theprevious exercise (where XXX are your initials).

10. Click Open.

11. Optionally, enter a New Name for the customized or personalized program. This new name might helpyou locate the program later within your application. In this field, enter XXX AR Invoice Entry PersonalizationImport.

Tip If you leave this field blank, the imported file uses the name of the file that was exported. If theImport Customization program finds a file with the same name, you are asked if you want to copyover the existing file.

12. Do not select the All Companies check box.

When selected, this check box indicates this imported customization/personalization is available to allcompanies within your application. If this check box is clear, the imported program is only available for usewithin the current Epicor Distribution company.

13. Click OK.A dialog box displays, indicating the personalization was successfully imported.

14. Click OK.

The customization/personalization is now added to the current company. It displays withinCustomization/Personalization Maintenance.

Verify Customizations

Use Customization/Personalization Maintenance to verify the selected customization contains valid code and willrun correctly.

1. From the tree view, select the XXX AR Invoice Entry Personalization Import you just imported.

2. Now from the Actions menu, select Verify Customization.The customization or personalization is run through the verification process. This process launches theprogram in a hidden mode that simulates what happens when a user launches the program during RunMode.

Tip Notice you can also verify a group of customizations and personalizations. To do this, find andselect several customizations and personalizations. Then click Actions > Verify All.

3. Most likely the Status field (on the Detail sheet) displays Pass. However if this field displays an Error value,you would next click the Compile/Script Errors tab.

4. The compile errors for this customization display on the Errors grid. You can sort the errors through thecolumns on this grid. Review these fields:

a. The Level column indicates the severity of each error. If the Error value displays in this column, it indicatesthese items must be fixed before the custom code can successfully compile.

b. The Error Code column displays the C# error code number.

c. The Line# column contains the specific line within the code which generated the compile error.

d. The Warning column displays the specific error that occurred.

Epicor ERP | 10.0.700.262


e. The Record Type column indicates the code type which caused the error.

5. You can click the Selected Issue Helper button to display the Customization Data window. Use thiswindow to correct specific problems with the customization.

6. Now click the Warnings sheet. This sheet displays elements within the customized or personalized programthat did not validate. These elements display within the Warnings grid.

a. The Control Name field defines the elements within the program that could not be verified.

b. The PropName and PropValue fields display the property name and value for the selected property.

c. The Warning field displays why the warning was generated.

d. The Record Type column indicates the code type which caused the error.

7. To remove a specific element from the program, click its Select check box. To remove multiple elements,choose multiple Select check boxes.

8. To select all the elements that generated warnings, click the Select All button.

9. Now click the Remove Selected Items button. The elements that you selected are removed from theWarnings grid.

You can now use the Run, Modify, and Show Custom Data features to help you identify these issues. Thisfunctionality is described during the next exercise.

Run or Modify Customizations

To run or modify a selected customization or personalization in Run Mode:


2. Notice Epicor Distribution, Main Site displays as a link in the upper left corner. Click this link.The Change Current Company and/or Site window displays.

3. Select the Epicor Education, Main option.

4. Click the Refresh icon.The Menu now displays the Epicor Education, Main location.




6. Click the Name button. The Customization/ Personalization Search program displays.

7. Click Search.The customizations and personalizations display in the Search Results grid.

8. Click Select All and then click OK.The customizations and personalizations populate the tree view.

63Epicor ERP | 10.0.700.2


9. Now click through the Manager personalizations and select the personalization for theApp.ObjectSecurityEntry.ObjectSecurityForm.

10. To activate the customization in Run Mode, click Actions > Run Customization.Process Security Maintenance displays in Run Mode. You can now test the customization by enteringdata, clicking buttons, and running other actions.

11. Close Process Security Maintenance.

12. You can review the customization or personalization activity recorded in Epicor Social Enterprise (ESE).This may help you decide what actions you should take on the customization or personalization. To do this,click Actions > Activity Stream.


14. You can also launch a customization or personalization in Developer Mode. Click Actions > ModifyCustomization.The Select Customization window displays.

15. Select one of the Manager personalizations and click OK.The personalized program displays.

16. Developer Mode is active, so you can display the customization tools for this program. To do this, clickthe Tools menu, select Customization.The Customization Tools Dialog displays; you can now work on the customized or personalized programas needed.

17. Close the Customization Tools Dialog and Process Security Maintenance.

Workshop - Dashboard Maintenance

Use Dashboard Maintenance to maintain current dashboards through a single management interface.

Dashboards are customized views of data created using the Dashboard application. Users select custom or existingbusiness activity queries (BAQs), and display the queried data through grids, charts, and gauges. This data canbe filtered through rules defined on the dataview, and row rules can also be defined that alert users when specificdata conditions are met. Users can also add links to web sites and reports that they then display through thedashboard.

You administrate this customization toolset through Dashboard Maintenance. You can run, modify, deploy anindividual dashboard, or deploy all your dashboards in Dashboard Maintenance. You can also generate the webform of these dashboards through this management program.

Review Dashboards

During the following, you will find and select the uTip dashboard and review its details. This custom dashboarddisplays the tips available in the Epicor ERP application. Through this dashboard, users can update existing tipsand add their own tips.

1. Navigate to Dashboard Maintenance.

Menu Path: System Management > Upgrade/Mass Regeneration > Dashboard Maintenance

Epicor ERP | 10.0.700.264



2. Click the Dashboard ID... button.

3. Clear the Deployed Dashboards check box.

4. Click Search.

The Search Results grid displays the dashboards you can review.

Tip If you wish, you can select all or a group of dashboards. You can then navigate through thisgroup of dashboards by selecting each one on the tree view.

5. Select the uTip dashboard and click OK.You return to Dashboard Maintenance. The Detail sheet contains the primary information for the currentdashboard.

6. For the Description field, enter uTip XXX Reviewed (where XXX are your initials).

7. The fields on the left side display company information about the current dashboard:

a. The Company field indicates the company in which this dashboard is available. For example: EPIC06

b. The Version Number displays the ICE version number used when this dashboard was created. Forexample: ICE 3.0.1

c. The Last Updated By and Last Deployed By fields display the user or users who most recently madechanges to this dashboard and then made this dashboard available to other users.

d. When the Delivered check box is selected, it indicates this dashboard is a system dashboard.

Tip If the current dashboard is a system dashboard, the changes you make to it are removed whenyou update the Epicor ERP application to the next service pack. If you want to save changes to asystem dashboard, use the Dashboard program to create an alternate version that won't be copiedover during an upgrade.

8. The fields on the right side of the Detail sheet display additional information, including the global informationfor the dashboard.

a. The Global Company identifier displays the company from which the current dashboard originated.

b. The DB Version Number displays the database version used when this dashboard was generated.

c. The Last Updated and Last Deployed fields display the dates on which this dashboard was mostrecently changed and deployed to the Menu.

d. If the Global Dashboard check box is selected, it indicates this dashboard is used by multiple companiesin your Epicor ERP application.

9. The Where Used grid displays the locations where this dashboard is currently located on the Menu.

10. To save your updated Description with the dashboard, click Save.

65Epicor ERP | 10.0.700.2


Manage and Generate Dashboards

During the follow exercise, you explore how to manage and deploy a dashboard.

1. To launch the current uTip dashboard in Run Mode, select Actions > Run Dashboard.The selected dashboard displays. You can now see how the selected dashboard performs.

2. Click the Refresh button to populate the dashboard with data. You can also sort the dashboard by column,as will as enter and update data.You can now explore the functions available in this dashboard. You can sort the tips by column, edit tips,and add new tips.

3. Close the uTip dashboard. When prompted, do not save your changes.

4. To launch the dashboard in developer mode, select Actions > Modify Dashboard.The uTip dashboard displays again.

5. Click on Tools > Developer.The uTip dashboard now displays in the dashboard program. You can then make changes to this dashboard;you can add grids charts, change properties, add filters, and so on.

6. Close the UTip dashboard.

7. Select the Actions > Deploy UI Application option to deploy the current dashboard to the server.

This dashboard is connected to the database, and you can add it to the Menu. You use Menu Maintenanceto add this dashboard to the Menu; users can then access the dashboard (if you give them security rightsto it).

Tip If you are upgrading the Epicor ERP application, you must redeploy the dashboards you previouslydeployed. When you search for dashboards, use the Deployed check box to determine whichdashboards were deployed and which were not used on the Menu. The Deployed check box displayson the List sheet at the end of the grid.

8. If multiple dashboards display in the tree view, you can deploy them all at once by selecting the Actions >Deploy All UI Applications option.

9. Select the Actions > Generate Web Form option.This converts the current dashboard into a program you can display within an internet browser.

10. Select the Actions > Generate All Web Forms option to convert the dashboards currently displayed onthe tree view into web forms accessible from an internet browser.

11. You can also review this user's activity recorded in Epicor Social Enterprise (ESE). To do this, click Actions> Activity Stream.


13. When you finish managing dashboards, click Save.

Epicor ERP | 10.0.700.266


Workshop - Help Annotations Maintenance

You use the Annotations feature in the application help to attach notes to individual help topics. This feature isvaluable for adding more information to a topic specific to the business processes of your organization or industry.

You can add two types of annotations. Company annotations are notes available to all users within the specificcompany. User annotations are notes each user can link to a specific help topic; these annotations only displaywhen the specific user is logged into the Epicor ERP application.

To manage the annotations, use Help Annotations Maintenance. Through this tool, you can globally updateall annotations at the same time. This will make sure your help annotations contain current information.

Tip To learn how users create, edit, and delete annotations, review the Help System > Annotations topicsin the application help.

Update an Annotation

Do the following to manage your help annotations.

1. Navigate to Help Annotations Maintenance.

Menu Path: System Setup > System Maintenance > Help Annotations

2. Click the Search button on the Standard toolbar.The Help Annotation Search window displays.

3. Click Search.The current annotations display in the Search Results grid.

4. Click Select All and then click OK.

5. Select an annotation from either the tree view or the List sheet.

6. The Detail sheet displays the current information about the annotation.

a. The Help Page Reference field indicates which help topic is linked to the annotation.

b. The Language field indicates the language used when the annotation was created.

c. The Annotation Type defines whether the annotation is a Company or User annotation.

d. The Created By fields display who first entered the help or course annotation and the date on which itwas entered.

e. The Modified fields display the identifier for the user who last updated the annotation and the date onwhich it was updated.

7. Now enter changes you need to make in the Annotation field. For this workshop, enter "Valid process forEpicor 10."

8. Click Save.The help annotation is updated with your change.

Continue to review and update other annotations as you need.

67Epicor ERP | 10.0.700.2


Workshop - Solution Management

Use the Solution Management toolset to bundle custom software items together and distribute them fromone Epicor ERP application server to another server.

To define which items you want to track while building your solution, select an appropriate Solution Type. ASolution Type is a collection Elements (items) you want to track with the type. The Epicor ERP application installswith a series of delivered solution types, but you can also define your own custom types by using Solution TypeMaintenance. Likewise, the Epicor ERP application comes with a series of predefined elements, such as BAQsor Dashboards, but you can define you own custom elements using Element Maintenance.

Tip A user creating an element type should understand the current Epicor database structure, businessobjects, and application framework.

Once you define items you want in your solution, you launch Solution Workbench. Within this program, youbuild a .cab file that contains the objects you want bundled together. This single file contains files and data forthe solution. You can then distribute this .cab file and then import it into another Epicor ERP applicationenvironment.

You add items to a solution through two methods:

• Tracking your current activity within the Epicor environment.

• Adding existing items to a solution.

Review Solution Elements

Solution elements are application items you can track in your solution. Through Element Maintenance, you canreview delivered elements, create custom elements and duplicate existing ones which you may use as a basis forcustom ones.

1. Navigate to Element Maintenance.

Menu Path: System Management > Solution Management > Solution Element Entry

2. Click Element....The Search window displays.

3. Now click the Search button.All the current elements display in the Search Results grid.

4. To highlight all the records, click Select All and click OK.

5. Review the list of all default solution elements delivered by Epicor:

BusinessObjectParentTable Name

DescriptionElement

Ice.Contracts.BO.BAQDesignerQueryHdrTracks Busines Activity Queries (BAQs)created or modified through the BAQDesigner.

BAQ

Ice.Contracts.BO.DynamicReportBAQReportTracks dynamic reports created or modifiedthrough the BAQ Report Designer.

BAQReport

Ice.Contracts.BO.BpMethodBpDirectiveTracks BPM Method Directives created ormodified through Method Directives

BpDirective

Epicor ERP | 10.0.700.268


BusinessObjectParentTable Name

DescriptionElement

Maintenance, Data DirectivesMaintenance and Updatable BAQMethod Directives.

Ice.Contracts.BO.DashBoardDashBdDefTracks Dashboards created or modifiedthrough the Dashboard program.

Dashboard

Ice.Contracts.BO.InfoPromptFormIPFormTracks forms invoked by BPM methodIPForm Ice.Contracts.BO.InfoPromptForm

IPForm

directives created in BPM Data FormDesigner.

Ice.Contracts.BO.MenuMenuTrack Menu Items created or modifiedthrough Menu Maintenance.

Menu

Ice.Contracts.BO.ReportReportTracks Reports created or modified throughthe Report Maintenance.

Report

Ice.Contracts.BO.ReportReportStyleTracks Report Style of the Report createdor modified through the ReportMaintenance.

ReportStyle

Ice.Contracts.BO.RptDataDefRptDataDefTracks report data definitions for customreports and duplicate system reports created

RptDataDef

or modified using the Report DataMaintenance.

Ice.Contracts.BO.SecuritySecurityTracks changes made to the Securitybusiness object, through processes andprograms such as Menu Maintenance.

Security

Ice.Contracts.BO.UserCodesUDCodeTypeTracks User-defined Code Types created ormodified through User Defined CodesMaintenance.

UDCodeType

Ice.Contracts.BO.GenXDataXXXDefTracks changes made to the XXXDef table.This table holds changes to metadata by the

XXXDef

client, which includes BaseExtension,Productization, Verticalization,Localization, Customization andPersonalization.

Ice.Contracts.BO.ZBODefZBODefTracks changes made to the zBODef table.ZBODef

Ice.Contracts.BO.ZDataSetZDataSetTracks changes made to the zDataSet table.ZDataSet

Ice.Contracts.BO.ZDataTableZDataTableTracks changes made to the zDataTabletable.

ZDataTable

Add a Solution Element

During this exercise, you will create a new solution element. You wish to track the help annotations entered byusers in one company, as the majority of them will apply to other companies within your organization.

Important When creating custom elements, you should have knowledge of relational database concepts,such as table relationships, records, and field types. You should also understand the functionality includedwith the current release of the application.

69Epicor ERP | 10.0.700.2


1. Within Element Maintenance, click the New button.The fields on the Element sheet activate for data entry.

2. In the Element field, enter Annotations.

3. Now for the Description, enter Help Annotations.

You first need to find the parent table in the database that contains the help annotations.

4. Click the Parent Table Name... button.The Table Search window displays.

5. In the Starting A t field, enter "an" and click Search.The tables display in the Search Results grid.

6. Select the Annotation table and click OK.

You next must select the business object that adds and updates data to the Annotation table.

7. Click the Business Object... button.The Business Object Search window displays.

8. Find and select the Ice.Contracts.BO.Annotation business object and click OK.

You now add some display columns that show users the information you are including in the solution.

9. Click the Down Arrow next to the New button; select NewElementDisplayColumn.The Display Columns fields activate.

10. Click the Column Name drop-down list and select HelpPageRef.

11. Click Save.

12. Repeat steps 9 -11 to add these displays columns:

• AnnotationType

• AnnotationText

To complete the custom element, you need to include the list child table that shares the Foreign Key viewwith the Parent Table.

13. Click the Down Arrow next to the New button; select NewElementDetail.The Child Element sheet displays.

14. Click the Child Table Name... button.The Table Search window displays.


16. Select the AnnotationList table and click OK.The child table is added to the custom element. Now if a change is made to either a parent or child table,the parent table is tracked in the Solution Workbench.

17. Click Save.

18. Exit Element Maintenance.

Epicor ERP | 10.0.700.270


Tip You can also replicate an existing element by using the Actions > Copy Delivered Element option.Through this feature, you could make some modifications to the duplicated element. You can then tracksomething not specifically tracked by the default solution elements. For more information, review theElement Maintenance topics within the application help.

If you use this example in your environment and you install help annotations that do not apply, you could launchHelp Annotation Maintenance to remove annotations you do not need.

Review Solution Types

Solution Types are containers of elements you want to track in your solution. Through the Solution TypeMaintenance, you can review delivered solution types and create custom ones.

Navigate to Solution Type Maintenance.

Menu Path: System Management > Solution Management > Solution Type Entry

1. Click the Solution Type... button and click Search.

The list of installed solution types display in the Search Results grid.

2. Click Select All and click OK.

3. The following table displays the installed solution types is the list of default solution types and how you canuse them.

DescriptionSolutionType

Tracks all delivered solution elements defined in the database.

The following is the list of delivered elements:

ALL

• BAQ

• BAQReport

• BPM Method directives

• Dashboard

• IPForm

• Menu

• Report

• ReportStyle

• RptDataDef

• Security

• UDCodeType

• XXXDef

• zBODef

• zDataSet

• zDataTable

71Epicor ERP | 10.0.700.2


DescriptionSolutionType

This type does not filter activity by elements. Instead, it tracks an activity of a user in theEpicor ICE environment, which includes performing insert, update and delete operationsagainst ICE tables.

<blank>

Important When you select this type in the Solution Workbench, the Trackedsheet displays elements based on the performed activity. You can use this informationto identify and create custom elements you would like to track in a solution later.

With this option selected, the Move Tracked To Solution and Add To Solutionoptions are disabled in the current solution. The information in the SolutionWorkbench displays for your information only.

4. Your custom Annotations element is added to the ALL solution type. From the tree view, select the ALLsolution type.

5. Click on the Solution TypeDetail sheet.Notice in the ElementID grid, the Annotations element displays in the top row of the grid. You automaticallyadded this element when you created the record in Solution Element Maintenance.

Add a Solution Type

You can also create custom solution types. During this exercise, you will create a solution type that only tracksthe help annotation changes.

1. Click the New button.

2. For the Solution Type, enter Annotations.

3. Now in the Description field, enter Help Annotations.

4. Click Save.

Next add elements to the custom solution type.

5. Click the Down Arrow next to the New button; select New Solution Type Detail.

6. Click the Element ID button.The Search window displays.


8. Select the Annotations element and click OK.The Annotations element displays in the grid.

9. Click Save.

10. Exit Solution Type Maintenance.

Epicor ERP | 10.0.700.272


Use Solution Workbench

Use the Solution Workbench to create a solution that contains objects you wish to bundle together.

Through this program, you generate a .cab file that contains the files and data for the solution. You then distributethis file to other Epicor environments. The files you can add to a solution include code projects, configurationdocuments, xml files, and so on. Certain files can be 'flagged' so that during installation the user is promptedwhere those files should be placed on the destination server when the .cab file is installed.

Navigate to Solution Workbench.

Menu Path: System Management > Solution Management > Solution Workbench

1. To create a new solution, click New.

2. In the Solution field, enter XXXHelpBAQ (where XXX are you initials).

3. Now click Solution Type... button.The Search window displays.

4. Click Search to search for and select a type you want to use.

5. The solution types display in the Search Results grid.

6. Select the Annotations solution type and click OK.

7. For the Description, enter Annotations and Orders BAQ.

This value displays during the installation process; it gives an overall explanation about what the solutioncontains.

8. Use the Internal Notes field to enter additional information on the solution. Enter "This solution containsthe current help annotations and the revamped Booked Orders BAQ."

When you build the solution, this text is automatically converted into a readme.txt file which is bundledwith the .cab file. It also displays within a field during the installation process.

9. Save the solution.

10. Close the Solution Workbench.

Track Your Activity

During these exercise, you will track the activity you want to include in the solution.

To track activity you want to add to a solution, you must log in with a user account that has Can Track Solutionprivileges. You assign these privileges in User Account Security Maintenance.

1. You first select the solution record you want to track your activity. The process of selecting a solution variesdepending on which mode you use to run Epicor ERP:

• When you run the application using the Classic Style, on the Main Menu, select Options > SolutionTracking.

• When you run the application using the Modern Shell Style, on the Home Page, click the Settingstile. From the General Settings group, select Solution Tracking.

73Epicor ERP | 10.0.700.2


2. On the Change Current Tracked Solution window, select the XXXHelpBAQ (where XXX are your initials)solution record and click OK.

While a solution is actively being tracked it is monitoring the Update, Insert and Delete events the user isdoing within the application or Service Designer. To discontinue tracking for this user, clear the value in theSolution field.

Tip You can control the solution tracking directly from the status bar. When running the applicationusing the Classic Style, navigate to Options > Preferences window and select the Solution checkbox on. Click OK to activate this option.

3. Now create some help annotations. Navigate to Count Cycle Maintenance.

Menu Path: Material Management > Inventory Management > General Operations > Count CycleMaintenance

4. To launch the application help window, press <F1> on your keyboard.The application help window displays.

5. Click on the Annotations tab and Pin it in place.

6. Click the Down Arrow next to the New button; select New Company Annotation.The Company sheet activates.

7. Enter some text for the annotation and click Save.

8. Repeat steps 3-7 to create a user annotation for Count Tag Entry. Enter some sample text.

Menu Path: Material Management > Inventory Management > General Operations > Count Tag Entry

9. When finished, close Epicor Help, Count Cycle Maintenance and Count Tag Entry.

10. Return to the Solution Workbench.


11. Select the XXXHelpBAQ (where XXX are your initials) record.

12. Click on the Tracked sheet.

The help annotations you created display.

Tip Using the Tracked list, you can do the following:

• Verify the Selected check box is selected for each item you want to include in the solution.

• To exclude an item, clear the Selected check box.

• To remove an item from the list, select the item and click Delete.

13. Click Move Tracked to Solution.

This will move the selected items you tracked into the solution.

14. To the warning message, click OK.

15. To record your changes to the solution, click Save.

Epicor ERP | 10.0.700.274


Add Items to Solution

You can also manually add element to a solution. During this exercise, you will add an existing BAQ record tothe solution.

1. Click the Add To Solution button.The Solution Element Search window displays.

2. From the Available Elements list, select BAQ and click Search.The Solution Element Search window displays.

3. Click Search again.The available BAQs display in the Search Results grid.

4. Sort the results by the QueryID column. Find and select the EPIC06-BookedOrders query and click OK.The Selected Solution Items grid now displays the annotations and the selected query.

5. Click the Add To Solution button.The Solution Element Search window closes.

6. Click on the Detail > Solution tab.The selected annotations and BAQ display on the grid.

7. Click Save.

Build a Solution

You are now ready to build your solution.

• Before you run this command, finish adding the items and files you want included within your solution.

• Your user account must have the Can Build Solution privileges enabled in User Account SecurityMaintenance.

To build a solution:

1. Click on the Actions menu and select Build Solution.The Build Solution window displays.

2. Notice you can define some Settings for the new .cab file:

• Encrypt Source Code - Select this check box to create a secure .cab file. The compiled .cab file solutionthen contains encrypted project files, preventing materials and property from being viewable during thedistribution process. Even if the project does not build correctly, the files are encrypted and a user cannotsee the files as unencrypted.

• Create Code Documentation - Select this check box to automatically generate .xml documentationfor the generated assemblies on custom project items.

• Prompt for CAB File Name and Location - Select this check box to display a directory path window.User this window to define the path where you want to place the .cable file sand enter the filename touse for the solution. by default the .cab file is created in the application client directory.

3. For this workshop, select the Prompt for CAB File Name and Location checkbox.

4. Click the Build button.

75Epicor ERP | 10.0.700.2


The generation process displays within the Build Output field.

5. Because you prompted for the file location, the Save CAB File window displays. Notice the file is saved inthe //Epicor/ERP10/ERP10.0.XXX/Client directory (where XXX is the current service pack for the Epicor ERPapplication).

6. Click Save.

7. When the build is complete, click the Close button.

8. Exit the Solution Workbench.

The .cab file is created and ready to import. This cab file now contains the code, file, and data definitions yousupplied in the definition of the solution. Notice the .cab file name is assembled by placing the filename, typevalue, and version number together.

Install a Solution

You are now ready to install the annotations .cab file in a different company.

• The solution you wish to import (.cab file) has been created.

• Your user account must have the Can Install Solutions privilege enabled in User Account SecurityMaintenance.

To import a solution:


Now you have to switch the company.

2. Navigate to the Epicor Distribution, Main Site option.

3. Verify the help annotations do not display in this company. Navigate to Count Cycle Maintenance.


4. Press <F1> on your keyboard.The application help window displays.

5. Click on the Annotations tab.Notice this topic does not have any help annotations.

6. Close the application help window and Count Cycle Maintenance.

7. Navigate to the Solution Workbench in this company.


8. Click on the Actions menu and select Install Solution.The Install Solution window displays.

9. Click on the Solution File button to navigate to the folder that contains the generated .cab file. For thisexample, navigate to the \\Epicor\ERP10\ERP10.0.100\Client folder.

10. Select the XXXHelpBAQ_CustomerSolution_3.0.1.cab file (where XXX are your initials).

Epicor ERP | 10.0.700.276


Tip Notice the ICE version number is added as a suffix to the .cab file name.

11. Click Open.

12. In the File Conflicts group box, indicate the method by which you want the Solution Workbench to handlefile conflicts. The available options include:

• Automatically overwrite duplicate files - Select this radio button option to automatically overwriteall files that have the same name within the client directory.

• Prompt for each file conflict - Select this radio button option to review each file conflict encounteredduring the import process. You can then decide whether to override the conflicting file or leave the filein its original state.

13. For this workshop, select the Automatically overwrite duplicate files radio button option.

14. Now in the Data Conflicts group box, indicate the method by which you want the Solution Workbench tohandle data conflicts. The available options include:

• Automatically overwrite duplicate data - Select this radio button option to automatically overwriteall the affected data within the client directory.

• Prompt for each data conflict - Select this radio button option to review each data conflict encounteredduring the import process. You can then decide whether to override the conflicting data or leave thisdata in its original state.

15. For this workshop, select the Automatically overwrite duplicate data radio button option.

16. When you are ready, click the Install button.

The installation progress displays within the Installation Output field.

17. When installation is complete, click the Close button.The solution is installed within this company in the Epicor ERP application.

Verify the Solution Installed

Now make sure your new items installed.

1. Return to Cycle Count Maintenance.


2. Launch the application help window and click the Annotations tab.The help annotations display.

3. Exit Cycle Count Maintenance.

4. Likewise, verify the Booked Orders BAQ is available in this company. Navigate to the Business ActivityQuery Designer.

Menu Path: System Management > Business Activity Queries > Business Activity Query


77Epicor ERP | 10.0.700.2


5. Click the Query ID... button.The Business Activity Search Form window displays.

6. In the Query ID Starts With field, enter EPIC06; clear the Shared check box.

7. Click Search.The EPIC06-BookedOrders BAQ displays in the Search Results grid.

8. Exit Business Activity Query Designer.

The items you placed in the solution are now available in this company.

Epicor ERP | 10.0.700.278


Conclusion

Congratulations! You have completed the course.

Please take a moment to let Epicor University know how to serve you better by completing an evaluation at http://www.keysurvey.com/survey/379199/e92f/. Your feedback provides the guidelines for the future direction ofEpicor University offerings.

79Epicor ERP | 10.0.700.2

ConclusionSystem Setup and Management Course

http://www.keysurvey.com/survey/379199/e92f/

http://www.keysurvey.com/survey/379199/e92f/

Additional information is available at the Education andDocumentation areas of the EPICweb Customer Portal. To access

this site, you need a Site ID and an EPICweb account. To create anaccount, go to http://support.epicor.com.

http://support.epicor.com