Epicor Information Worker For Epicor ERP
Epicor Information Worker For Epicor ERP
ED812905
90521-10-9241-583101001
10.2.600
Revision: March 23, 2020 8:53 p.m.
Total pages: 26
course.ditaval
Epicor Information Worker for Epicor ERP Course Contents
Contents
Epicor Information Worker for Epicor ERP Course...............................................................4
Before You Begin....................................................................................................................5
Audience.........................................................................................................................................................5
Prerequisites....................................................................................................................................................5
Environment Setup..........................................................................................................................................5
Overview.................................................................................................................................7
Architecture Overview...........................................................................................................8
IW Client Installation..............................................................................................................9
Daily Processing....................................................................................................................10
Import Menu.................................................................................................................................................10
Import and Synchronize Data..................................................................................................................11
Workshop - Import Data into Microsoft Outlook.....................................................................................12
Import Customers and Invoices........................................................................................................12
Import Sales Orders.........................................................................................................................13
Import a BAQ Data Snapshot...........................................................................................................14
Import Appointments, Tasks, and Contacts....................................................................................................14
Workshop - Import Contacts, Tasks, and Appointments..........................................................................15
Workshop - Edit Data after Import..........................................................................................................16
Explore Menu................................................................................................................................................16
Workshop - Navigate the Explore Menu..................................................................................................17
Launch Menu.................................................................................................................................................18
Workshop - Navigate the Launch Menu..................................................................................................18
Synchronization.............................................................................................................................................19
Workshop - Synchronize Data.................................................................................................................20
Import Data into Microsoft Word and Microsoft Excel....................................................................................21
Workshop - Import Data into Microsoft Word.........................................................................................21
Workshop - Import Data into Microsoft Excel..........................................................................................21
Work with Imported Data in Microsoft Word.................................................................................................22
Workshop - Work with Imported Data in Microsoft Word.......................................................................23
Conclusion.............................................................................................................................25
This course introduces Epicor Information Worker, an Epicor desktop productivity application that allows Microsoft®
Office® users to view and update Epicor data. This enables individuals to increase productivity and improve
real-time decision-making by leveraging Epicor data.
For many information workers, Microsoft Windows® and Microsoft Office are integral components of desktop
productivity tools. At the same time, access to customers, products, suppliers, financial records, and employee
information from Epicor is just as critical to business management. These two areas of information merged with
Epicor Information Worker.
This course begins with a brief discussion of the application setup. The main focus of this course is to access data
from the Epicor using Microsoft Outlook and then synchronize the data back to Epicor.
The course includes presentations, demonstrations, and a series of hands-on workshops designed to create and
deploy Epicor Information Worker.
Upon successful completion of this course, you will be able to:
• Understand the features and functionality available in Epicor Information Worker.
• Access Epicor data from within Microsoft Office.
• Perform synchronization between Microsoft Office and Epicor records.
Read this topic for information you should know in order to successfully complete this course.
Audience
Prerequisites
To complete the workshops in this course, the necessary modules must be licensed and operating in your training
environment. For more information on the modules available, contact your Epicor Customer Account Manager.
It is also important you understand the prerequisite knowledge contained in other valuable courses.
• Knowledge of Microsoft Office
• Knowledge of Epicor.
Environment Setup
The environment setup steps and potential workshop constraints must be reviewed in order to successfully
complete the workshops in this course.
Your Epicor training environment, in which the Epicor demonstration database is found, enables you to experience
Epicor functionality in action but does not affect data in your live, production environment.
If IW is already in production use, you must install the IW server components on a different server in order to do
this course without affecting the production IW installation.
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 your
Epicor training environment with the Epicor demonstration database installed. Do not complete
the course workshops in your live, production environment.
Note It is recommended that multiple Epicor demonstration databases are installed. Contact
Support or Systems Consulting for billable assistance.
• The Epicor demonstration database is at the same version as the Epicor application. The
demonstration database is installed from the Epicor Administration Console using the "Add Demo
Database" command under Database Server. See Epicor ERP installation guides for details. If you are an
Epicor Cloud ERP customer (and have licensed embedded education), the demonstration database is
installed for you.
• Your system administrator restored (refreshed) the Epicor demonstration database prior to
starting this course. The Epicor demonstration database comes standard with parts, customers, sales
orders, 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, production
environment) and is not periodically refreshed, unexpected results can occur. For example, if a course
workshop 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 not
restored (refreshed), then you will not be able to ship the sales order. If you are an Epicor Cloud ERP
customer see section below.
2. Install the Information Worker server using the procedures in the Epicor ERP Supplemental Installations
guide.
3. Assign your Windows user credentials to the manager account in your Epicor application.
a. Log into your Epicor application. For User name and Password, use epicor and epicor . These
credentials allow you the administrative rights needed for this task.
c. On the Details sheet, type manager in the User ID field and press Tab to display the settings for the
manager user account.
d. In the Domain and Domain User ID fields, type your Windows user name and domain name.
4. From a computer with Microsoft Office 2010 or above, open a web browser and go to
http://yourIWservername/informationworker replacing yourIWservername with your Information
Worker server computer name.
5. Follow the instructions on the client download page to download and install the Information Worker client.
Note To refresh your Epicor training data, enter a support ticket in EpicCare and include your site ID.
Overview
Epicor Information Worker allows Microsoft Office users to view and update Epicor data from within Microsoft
Outlook, Excel, and Word. Once Epicor data has been imported into Microsoft Office, users can keep the data
synchronized between Office and Epicor according to a schedule of their choosing. Users can work in connected
(to Epicor database) or disconnected modes.
In Microsoft Outlook®, contacts, appointments, and tasks can be synchronized with Epicor Information Worker.
From there, you can update data, add calls, and later synchronize the new information back to the Epicor
application.
In Microsoft Excel®, users can import application data into Microsoft Excel tables, edit data, and refresh data
brought into tables as necessary. When a document opens, it can be saved as a template that can be populated
by an Epicor Information Worker import. Application forms can be launched that relate to the currency selected
record as well.
In Microsoft Word® users can launch a Microsoft Word mail merge based on imported tables, import application
data by field or by list, edit data, refresh data as necessary, and launch application forms related to a currently
selected record.
The following diagram shows an overview of an Information Worker installation, which includes Information
Worker clients, the Information Worker server with its configuration manager utility, and the Epicor server that
provides application data to the Information Worker clients.
Architecture Overview
The Epicor Information Worker (IW) architecture is divided in two parts, the server and the client.
Server
Epicor Information Worker requires the following server applications:
• The IW server
• The Epicor application server
You must have the Epicor server installed and functional to correctly configure Epicor Information Worker. IW
clients who also have the Epicor client have added capabilities, but IW clients do not have to have the Epicor
client.
In Epicor, the business activity queries (BAQs) are the business entities (record types) views that supply the records
imported/synchronized by Epicor Information Worker. In Epicor, the IW BAQs are prefixed with ziw.
You can open the Epicor application from IW to add a:
• CRM Call
• Help Desk Case
• Lead, Opportunity or Quote
• RMA
• Sales Order
• Service Call
Client
The client components include:
• Microsoft Office 2010, or 2013.
• Epicor Information Worker Office add-in.
Microsoft Office
The Epicor IW client is Microsoft Office 2010 or 2013. Visual Studio Tools for Microsoft Office runtime must also
be installed. Both programs are accessible during the client installation. Individual users can have Microsoft
Outlook, Microsoft Word, and Microsoft Excel installed or just one or two of those applications depending on
their needs.
Epicor Information Worker Office Add-ins
The Epicor Information Worker Office add-in is a separate installation. Once the add-in is installed, the next time
Outlook, Word or Excel opens, the Epicor IW menus, ribbons and toolbar items display. This also includes a Help
menu item.
IW Client Installation
Daily Processing
The following section reviews the Epicor Information Worker functionality in Microsoft Outlook and provides
supporting workshop exercises.
Epicor Information Worker performs the following tasks in Microsoft Outlook:
• View and update application data in custom forms within Outlook.
• Add application data.
• View and update application data in standard Outlook forms such as Contacts.
• Add application data.
• Launch Outlook forms related to a currently selected form.
• Launch application forms related to a currently selected form.
In Outlook, IW features are accessed from the Epicor tab.
Import Menu
Import on the Epicor tab allows you to import business entities from the Epicor application to Microsoft Outlook.
Clicking an entity start a wizard that gets data from Epicor into Office.
• Sales Orders
• Service Calls
• Service Contracts
• Ship To's
• Shipments
• Sales Territory
For example, if you select Import > CRM Calls and complete the Information Worker Explorer Wizard, a folder
with data rows is created in the Epicor Outlook folder CRM Calls folder. When you double-click a row, the data
opens in a custom Outlook form. These records can have child rows. In these cases, the data opens in a tree view
that allows you to drill-down into the information. Some of the data comes from configured views and allows
you to update certain form information. Business entities that are imported are by default set for synchronization
once they are imported.
My Lists
My Lists enables you to pick any BAQ for which you have access rights on your Epicor server and download its
data. The selection list is the list of shipped and user-defined BAQs you would see when you are logged into
Epicor and using the BAQ Designer. A My Lists import is a one-time snapshot of application data from the selected
BAQ. There is no subsequent synchronization of application data between the data source and Outlook. A My
Lists BAQ import overwrites any data brought down by a previous import of the same BAQ.
Advanced Import
Advanced Import performs the same process as the standard business entity import but starts the wizard with
two extra forms that allow extra configuration options that are used less frequently.
Use Import > EntityName to choose an Epicor business entity and import either all, or a selection of, the available
records and apply the default data synchronization between your Microsoft Office application and the Epicor
application. Alternatively, use the Import > Advanced Import option to select an Epicor business entity plus
have more control over synchronization.
Standard Import
When the import process begins, the Information Worker Explorer wizard displays. In this window you can
enter criteria as needed (see Criteria Filters below) and click Next to display a list of records. You can either
individually select or clear a row, or use the Select All or Clear All menus to select or clear all the rows. The
selected rows are the records that will be imported.
The standard import results in the following synchronization behavior. The selected records are the only records
that ever synchronize for that entity unless you run the import for that entity again using Advanced Import
options. However, if you select to bring down related data in the Information Worker Explorer Wizard, any new
related entity records show up without any further effort.
Advanced Import
Advanced import allows you to import all, or a selection of, records and enables more control over synchronization.
• When you select an entity in Advanced Import, none of the import options on the first wizard page are selected
unless you previously imported it. Once an entity has been imported, the last used import option for that
entity is selected on the first wizard page when you select the entity from the Advanced Import menu.
• Whether or not the Next button that would allow you to see the import wizard step of selecting related data
is enabled or not depends on how the business entity is configured. Certain entities, for example Customers,
make more sense to allow for related record linking.
• Synchronization options are displayed when you are setting up an advanced import:
• Synchronize all available data - Importing all records using this option means that when new records
subsequently are added that match the entity, those new records will come down to Information Worker
without any further effort during synchronization.
• Synchronize related data - If this option is selected, it is because during a previous import for a different
entity, this entity was selected to bring down its records related to the main entity you were importing.
This is not an option you set directly. This option being selected is showing you that these entity records
are being brought down only as they relate to records in other entity imports that you previously set up
(those entities are listed). This is an informational setting, nothing happens when you click Finish unless
you choose a new import type.
• Do not synchronize - This option stops any synchronization of records for this entity, whether they were
setup through related imports or other import options. Any downloaded records for the entity are deleted
when you click Finish.
In this workshop, import customers, invoices, sales orders and a BAQ-based data snapshot into Microsoft Outlook.
Leaving the criteria fields (Customer, Postal Code, and Country in this example) blank configures the
import to retrieve all available records. Entering criteria helps focus your search.
3. In the Select window, select the Import check boxes of any three customers and click Next.
The window also includes options for selecting or clearing all items.
5. Click Finish.
In the Navigation Pane Mail Folders view, under the Epicor folder, a new Customers folder and a new
Invoices folder display.
9. Open the Epicor > Invoices folder and repeat the process to open the Customers window from that
location.
When new invoices are added for the customers you have chosen to import/sync, the new invoices will
automatically be brought down during IW synchronizations.
3. In the Select window, select the Import check boxes of any three Sales Orders and click Finish.
In the Navigation Pane Mail Folders view, under the Epicor folder, a new Sales Orders folder displays.
You want a quick way to view the customer contacts list for your company. You are not concerned with
synchronization or update capabilities. You are told that an existing BAQ, UpdCustContacts, is designed to
extract a contact list from the Epicor database, and the Information Worker My Lists import option can be used
to display the list in Outlook.
2. Under Filter, type Customer Contacts in the Description field to focus your search.
3. From the list, select the BAQ named EPIC06-UpdCustContacts (in the Name column) and click Next.
The Information Worker Explorer-My List window displays a list of records retrieved by the BAQ.
4. Using the check boxes in the Import column, select several records and click Finish.
In the Navigation Pane Mail view, the imported data is displayed in the folder Epicor > My Lists >
UpdCustContacts. Keep in mind that this is a static report and there is no subsequent synchronization of
application data between the Epicor application and Outlook.
b. Re-select your records or make another selection, and then click Finish.
The UpdCustContacts folder is updated to display the new import results. Keep in mind that a My Lists
BAQ import always completely overwrites any data brought down by a previous import of the same
BAQ. There is no merging of records.
Importing appointments, tasks, and contacts into Microsoft Outlook from the Epicor application is slightly different
than importing business entities. These items display along with your other items in Outlook, rather than in
designated Epicor folders.
Appointments
The Appointment entity represents an Epicor task list record that is a task type of Appointment. Epicor task list
records with a task type Appointment are placed in the Microsoft Outlook calendar. Appointments are agreed
upon meeting times for specific employees when communicating with customers or prospects.
Tasks
The Task entity represents an Epicor task list record that is not the task type of Appointment. Epicor task list
records of the task type Appointment are placed in the Microsoft Outlook calendar. Tasks are follow-up items
for specific employees when communicating with customers or prospects.
Contacts
The Contacts entity represents an Epicor contact record. These records are placed in the Outlook Contacts view.
Epicor contacts are records that define multiple contacts for the main location and ship-to locations of a customer.
Note When you add an Epicor Information Worker contact record, the country portion of the address
must match the available country list in the Epicor application. For example, it would cause an error if you
enter United States of America in Microsoft Outlook while the Epicor application expects USA.
The Import > CRM Call option, available for imported contacts, can automatically create a CRM Call record for
the Epicor application as long as the To Email Address matches an email address in the imported contacts list.
When you send an email from Microsoft Outlook, you can configure Outlook to automatically add a new CRM
Call or prompt you to add one.
Do the following:
2. Under Configure Information Worker select Email Options. Under Email Options, select Log emails
sent to imported contact to enable automatic logging. Additionally select Prompt before logging if you
want to control whether or not emails are logged as they are received.
For more information on Epicor business entities, see the Information Worker Online Help.
2. Click Next to open the Select window and retrieve the list of available contacts.
4. Click Finish.
In Navigation pane Contacts view, the Epicor application imported contacts display.
To use alternate contact folder, do the following (for administrators only):
b. In the Outlook Options grid, select the Use Alternate Contact Folder check box and for folder name
enter Epicor Contacts.
c. Deploy the updated configuration file so that the Information Worker clients pick it up the next time
they start an office application.
d. Repeat steps 1 - 4.
In Navigation pane, Contacts view, check the Epicor Contacts folder displays along with the standard
folder.
6. Click Next to open the Select window and retrieve the list of available tasks.
8. Click Finish.
In the Navigation pane, Tasks view, the Epicor application imported tasks display.
10. Click Next to open the Select window and retrieve the list of available appointments.
In this workshop, customize the task form to show your calculated data.
1. In the Task list, right-click the task form and select Add Column.
2. In the Show Columns dialog box, from the Select available columns from drop-down list, select
User-Defined fields in folder.
3. From the Available columns list, select a field and click Add.
4. Click OK.
Explore Menu
Use Explore on the Epicor tab to view details relating to a selected record and to add new records in custom
Outlook forms.
For working with Epicor data records, the Explore menu enables you to use Microsoft Outlook as the Epicor
application interface in place of the Epicor client. You can view records that have already been synchronized
between the Epicor application and Microsoft Outlook as well as add new records. New records update the Epicor
application are thereafter synchronized along with other Information Worker records.
The first step to using the Explore feature is to select an Information Worker record. After selecting a record, go
to the Explore menu and select an existing item to view or select an item to add from the New submenu. To
identify Information Worker records in Outlook:
• In the Navigation pane Mail view, the Epicor folder and its subfolders contain Information Worker records.
• In the Navigation pane Contacts, Tasks, and Calendar views, switch to an Information Worker view:
• Verify that the Home tab is selected.
• In the Current View group, select Information Worker.
You can work with Explore in offline mode. The next time you connect with the Epicor Information Worker server,
the new records will be synchronized.
Note Data must be synchronized between the Epicor application and Microsoft Outlook in order for the
information to display.
In this workshop, navigate the Explore menu and add a new item to synchronize back to the Epicor application.
1. In the Outlook Navigation pane Mail view, open the Epicor folder and select the Invoices folder.
Invoices display in the right grid.
3. From the Epicor tab, select Explore > Customer - Bill To.
The Customers window displays.
4. In the Customers window, review the customer bill-to information and click Close.
6. From the Epicor tab, select Explore > New > CRM Calls.
The CRM Calls window displays.
7. In the Description field, enter XXX - Customer check in (where XXX are your initials).
8. In the Text field, enter XXX - Followed up to see if customer needed additional products or services
(where XXX are your initials).
9. Click OK.
Under the Epicor folder, a CRM Calls folder is added, containing your new call record.
10. Open the CRM Calls folder and double-click your call record.
The CRM Calls window displays with your call details.
11. In the CRM Calls window, review the call information and click OK to close.
Launch Menu
Use Launch on the Epicor tab to open and create records directly in the Epicor client. The Launch menu
functionality requires that you have an Epicor client installation that can be accessed from Outlook.
The first step to using the Launch feature is to navigate to an Epicor Information Worker record in the Outlook
Mail view. After selecting a record, go to the Launch menu and select an existing item to view or select an item
to add from the New submenu.
Selecting an item from the Launch menu causes the Epicor client to open and display the appropriate form for
the selected Epicor Information Worker record. Selecting an item from the New submenu causes the Epicor client
to open and display a new form with related data from the selected Epicor Information Worker record.
When choosing an item on the Launch menu starts the Epicor client, you are prompted to log in with your Epicor
client user credentials. When the Epicor client is already running, choosing a Launch menu item opens the
applicable Epicor form without any requirement to log in.
The first time you perform an action that attempts to start the Epicor client , you may be prompted to browse
to the Epicor.exe file in your Epicor client installation. The file location where Information Worker will go by
default is set in File > Epicor > Epicor Properties.
In this workshop, use the Launch menu to open the Customer Tracker in the Epicor client and verify one the
fields in a customer record.
You just called Addison Inc. and spoke to your contact, Andrew Addisen. He told you he was recently promoted
to Vice President. You want to verify this information is correct in the Epicor application customer records.
1. In the Outlook Navigation pane Mail view, open the Epicor folder and select the Customers folder.
Customer records display in the right grid.
5. Under Contact Information, verify that the Name field displays Andrew Addisen and the Title field
displays Vice President.
Synchronization
Once data is imported to added to Microsoft Outlook from the Information Worker menu items, a synchronization
cycle refreshes the field (column) data mapped between Outlook and the Epicor application.
Synchronization Results
Click the Synchronize button to refresh the records brought down to the Outlook through Information Worker
as follows:
There is no merging of changed fields to produce an updated record. Entire records are replaced.
As you can see by the results in the last row of the table above, the Epicor record wins if both records are edited
between a synchronization cycle. Between synchronization cycles, you must make your changes in either Epicor
or Office to avoid inadvertently losing your changes.
Enabling Automated Synchronization
Automated synchronization can be set to occur at regular intervals.
The Synchronization Errors Form displays both synchronization errors and the full synchronization log depending
on how it is accessed. Conflicts are logged as errors, which are reviewed by clicking the Synch Error icon in the
Windows application tray. You can right-click the Epicor Information Worker icon in the status bar and select
Show Synchronization Log to access this log any time. Once the log displays, you can Show/Hide details or
Export the log, which is useful to the Information Worker administrator when troubleshooting issues.
In this workshop, synchronize data and view the CRM Call created in a previous workshop.
6. In the All grid, verify the CRM Call created in the Navigate the Explore Menu workshop displays.
Data import through the Information Worker client is the starting point for working with Epicor ERP data in
Microsoft Word and Excel
The Information Worker client online help (installed with the client) includes topics about working with your
imported Epicor ERP data in Word and Excel.
4. In the Customer grid, select any three customers and click Finish.
The Epicor Information Panel displays on the right side of the application window with the selected customers
located in the Document Contents > Customers node.
If the panel does not display, click Information Panel on the Epicor tab.
5. In the Information Panel, right-click a customer and from the list, select Set as Primary Context.
4. In the Customer grid, the following columns to display and click Finish.
• CustNum
• Cust ID
• Customer
• Address
• CityName
• Credit Limit
A new worksheet is created with the name of the imported business entity and the data is displayed in an
Excel table for the columns you selected. If there are child entities worksheets are also created for them.
Once the Epicor data is available in Microsoft Word, you can perform mail merges, use templates, and open
Epicor forms.
1. In Microsoft Word, from the Epicor Information Panel on the right side of the application window, expand
the Document Contents > Customers node.
3. From the customer field list, right-click Customer and select Insert.
As each field is inserted into the document, the customer information displays.
4. Click the mouse so that the cursor appears to the right of the Customer data and press [Enter].
5. From the customer field list, right-click Address and select Insert.
6. Click the mouse so that the cursor appears to the right of the Address data and press [Enter].
7. From the customer field list, right-click CityName and select Insert.
8. Click the mouse so that the cursor appears to the right of the CityName data and type a comma and then
a space.
9. From the customer field list, right-click State/Prov and select Insert.
10. Click the mouse so that the cursor appears to the right of the State/Prov data and type two spaces.
11. From the customer field list, right-click Postal Code and select Insert.
12. Click the mouse so that the cursor appears to the right of the Postal Code data and press [Enter] three times.
13. From the Epicor Information Panel, right-click Document Contents > Invoices and select Import Data.
15. In the Invoices grid, select any three invoices and click Finish.
The Epicor Information Panel displays on the right side of the application window with the selected invoices
located in the Document Contents > Invoices node.
16. Expand the Invoices node, and then expand the first invoice.
The invoice field list displays below the invoice.
17. From the invoice field list, right-click Invoice and select Insert.
18. Click the mouse so that the cursor appears to the right of the Invoice data and type space, a dash (-), and
a space.
19. From the invoice field list, right-click Invoice Date and select Insert.
20. From the Epicor Information Panel, select Document Contents > Customers.
21. In the Customers node, right-click the first customer in the list and select Launch > Customer Tracker.
The Customer Tracker window displays.
Conclusion