Epicor ERP Advanced Dashboards Course 10.0.700
Disclaimer This document is for informational purposes only and is subject to change without notice. This document and its contents, including the viewpoints, dates and functional content expressed herein are believed to be accurate as of its date of publication. However, Epicor Software Corporation makes no guarantee, representations or warranties with regard to the enclosed information and specifically disclaims any applicable implied warranties, such as fitness for a particular purpose, merchantability, satisfactory quality or reasonable skill and care. As each user of Epicor software is likely to be unique in their requirements in the use of such software and their business processes, users of this document are always advised to discuss the content of this document with their Epicor account manager. All information contained herein is subject to change without notice and changes to this document since printing and other important information about the software product are made or published in release notes, and you are urged to obtain the current release notes for the software product. We welcome user comments and reserve the right to revise this publication and/or make 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 of any consulting services by Epicor personnel shall be pursuant to Epicor's standard services terms and conditions. Usage of the solution(s) described in this document with other Epicor software or third party products may require the purchase of licenses for such other products. Where any software is expressed to be compliant with local laws or requirements in this document, such compliance is not a warranty and is based solely on Epicor's current understanding of such laws and requirements. All laws and requirements are subject to varying interpretations as well as to change and accordingly Epicor cannot guarantee that the software will be compliant and up to date with such changes. All statements of platform and product compatibility in this document shall be considered individually in relation to the products referred to in the relevant statement, i.e., where any Epicor software is stated to be compatible with one product and also stated to be compatible with another product, it should not be interpreted that such Epicor software is compatible with both of the products running at the same time on the same platform or environment. Additionally platform or product compatibility may require the application of Epicor or third-party updates, patches and/or service packs and Epicor has no responsibility for compatibility issues which may be caused by updates, patches and/or service packs released by third parties after the date of publication of this document. Epicor® is a registered trademark and/or trademark of Epicor Software Corporation in the United States, certain other countries and/or the EU. All other trademarks 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 of Epicor Software Corporation.
ED814905 90521-10-9217-58310700 10.0.700 Revision: June 08, 2014 5:13 p.m. Total pages: 81 course.ditaval
Advanced Dashboards Course
Contents
Contents Advanced Dashboards Course...............................................................................................6 Before You Begin....................................................................................................................7 Audience.........................................................................................................................................................7 Prerequisites....................................................................................................................................................7 Environment Setup..........................................................................................................................................8 Workshop Constraints..............................................................................................................................8
Overview of Advanced Dashboard Techniques.................................................................10 Authorization........................................................................................................................11 Advanced Dashboard Techniques.......................................................................................12 Create New Dashboard..................................................................................................................................13 Dashboard Program Properties................................................................................................................13 Workshop - Create New Dashboard........................................................................................................15 Add PartBin Query...........................................................................................................................15 Change Grid Caption......................................................................................................................16 Publish Fields...................................................................................................................................16 Add Jobhead Query.........................................................................................................................17 Change Grid Caption......................................................................................................................17 Publish Job Number.........................................................................................................................17 Apply Filter to Jobs Grid...................................................................................................................18 Image Columns..............................................................................................................................................19 Workshop - Add Image Column to the Parts Grid...................................................................................19 Add Image Column to Parts Grid.....................................................................................................19 Apply View Rule to Image Column..................................................................................................20 Advanced Searches........................................................................................................................................21 Workshop - Customize a Tracker View....................................................................................................22 Add Tracker View............................................................................................................................22 Test the Advanced Search................................................................................................................22 Workshop - Add Advanced Search with Range.......................................................................................24 Add Groupbox................................................................................................................................24 Add Field 1......................................................................................................................................24 Add Field 2......................................................................................................................................25 Add Label........................................................................................................................................25 Run Search......................................................................................................................................26 Workshop - Modify Dashboard Properties...............................................................................................27 Assign the Like Columns in Dashboard Properties............................................................................27 Verify Results in Part Maintenance...................................................................................................27 Verify Results in Job Entry................................................................................................................27 Dashboard Browse.........................................................................................................................................29 Workshop - Add Dashboard Browse.......................................................................................................29 Add Sheets and Grids....................................................................................................................................31
Epicor ERP | 10.0.700
3
Contents
Advanced Dashboards Course
Workshop - Add Sheets and Grids..........................................................................................................31 Add Tracker View............................................................................................................................31 Add Blank Sheets............................................................................................................................31 Add Grids to Sheets.........................................................................................................................32 Hide Blank Sheet.............................................................................................................................33 Foreign Key Views..........................................................................................................................................34 Workshop - Create Foreign Key and Sub Table Views..............................................................................35 Create Foreign Key View.................................................................................................................35 Add Sub Table for Job Assembly......................................................................................................35 Add Sub Table for Job Material........................................................................................................36 Add Sub Table for Job Operation.....................................................................................................37 Link New Views to Blank Grids........................................................................................................37 Verify Results of New Views.............................................................................................................38 Gauge View...................................................................................................................................................39 Workshop - Add a Gauge View to the Dashboard...................................................................................39 URL View.......................................................................................................................................................41 Workshop - Add a URL to the Dashboard...............................................................................................41 Build and Deploy Dashboard..........................................................................................................................42 Workshop - Build and Deploy the Dashboard..........................................................................................42
Updatable Dashboards.........................................................................................................44 Workshop - Create Updatable Dashboard......................................................................................................45 Add Customer Query to Dashboard........................................................................................................45 Modify Customer Grid Properties............................................................................................................45 Add Updatable Query to Dashboard.......................................................................................................46 Modify Contact Grid Properties...............................................................................................................46 Add Tracker View for Contact Query......................................................................................................48 Test Updatable Dashboard......................................................................................................................49 Verify the Created Record.......................................................................................................................49 Add Order Status Query..........................................................................................................................50 Add Chart View for Order Status Query..................................................................................................50 Workshop - Uptake from Excel.......................................................................................................................51 Create a Spreadsheet..............................................................................................................................51 Uptake from Excel..................................................................................................................................52 Verify the Created Record.......................................................................................................................53 Workshop - Use Publish View.........................................................................................................................54 Publish View from Dashboard.................................................................................................................54 Copy Standard Dashboard......................................................................................................................54 Load Published View...............................................................................................................................55
Mobile Device Dashboards..................................................................................................57 Workshop - Create Mobile Dashboard...........................................................................................................57 Generate Mobile Dashboard...................................................................................................................57 Launch Epicor Mobile Access..................................................................................................................58 Use Mobile Dashboard............................................................................................................................61
Epicor SharePoint Publisher.................................................................................................63
4
Epicor ERP | 10.0.700
Advanced Dashboards Course
Contents
ESP Authentication........................................................................................................................................65 Workshop - Create a Dashboard in Microsoft SharePoint...............................................................................66 Create New Document Library................................................................................................................66 Create a New Web Part Page..................................................................................................................68 Explore Web Part Settings.......................................................................................................................69 Load the Available Views........................................................................................................................72 Arrange Views Within the SharePoint Page.............................................................................................75 View the ESP Dashboard.........................................................................................................................75 Adjust the ESP Dashboard.......................................................................................................................75 Test the ESP Dashboard..........................................................................................................................78
Conclusion.............................................................................................................................80
Epicor ERP | 10.0.700
5
Advanced Dashboards Course
Advanced Dashboards Course
Advanced Dashboards Course The advanced dashboard techniques discussed in this course provide flexibility with the way the data displays and functionality that allows you to access the data you need. A dashboard is your personalized information and command center. It is a visualization tool that displays the current information and processes that help you perform your tasks more efficiently. The data you choose to display is refreshed periodically, so you are able to act on changes as they occur. Set up the dashboard to match your needs. Spend some time thinking about the information that is helpful to you, then set up these queries through one of the available views, and link the processes that relate to this information. The dashboard becomes an efficient tool, as you are able to both view information and then act on it from one location. It is expected that users taking this course have previous familiarity with the dashboard. This course does not review basic elements and functionality of the dashboard but focuses on advanced techniques not discussed in the Introduction to the Dashboard course. Upon successful completion of this course, you will be able to: • Create a new dashboard using existing queries. • Modify dashboard properties to make it available as an advanced search. • Add images to a new column in the current grid. • Create an advanced search page on the dashboard and enable fields for searching. • Add an advanced search with a range for searching for multiple records. • Add a Dashboard Browse to the dashboard. • Add multiple sheets with grids to the dashboard. • Understand and create foreign key views and sub table views that display information from related tables on the dashboard. • Build and deploy dashboards to the Main menu and Favorites bar. • Create an updatable dashboard. • Use the excel uptake and the publish view functionality. • Create a mobile dashboard. • Use Microsoft® SharePoint® to display dashboards.
6
Epicor ERP | 10.0.700
Advanced Dashboards Course
Before You Begin
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 Administrator • IT/Technical Staff • Project Team Leader • Department Manager
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 at
[email protected]. It is also important you understand the prerequisite knowledge contained in other valuable courses. • Navigation Course - This course introduces navigational aspects of the Epicor application's user interface. Designed for a hands-on environment, general navigation principles and techniques available in two user interface modes - Classic Menu and Modern Shell Menu. Workshops focus on each of these modes and guide you through each navigational principle introduced. • Introduction to the Dashboard Course - This course provides an introduction to the dashboard - a personalized information and a command center. • Introduction to Customization Course - This course explores the customization tools embedded within the Epicor application. Unlike personalization, users can customize a form and then make it available to multiple users in a company. • Business Activity Query Course - This course introduces Business Activity Query (BAQ) Designer data extraction tool. It provides techniques for creating static Business Activity Queries (BAQs) as well as updatable BAQs. You can use both queries as the foundation for reports and dashboards, or to review specific details of your business. • SQL Server Reporting Services for Epicor ERP Course - This course introduces Microsoft SQL Server Reporting Services (SSRS) reports and their implementation in Epicor ERP. • Required Industry Knowledge - Fundamental knowledge of relational database concepts such as table relationships, records, and field types. An understanding of the functionality of the current release of the Epicor application.
Epicor ERP | 10.0.700
7
Before You Begin
Advanced Dashboards Course
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. 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 service pack and patch as the Epicor application. Epicor's education team updates the Epicor demonstration database for each service pack and 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 completing the course workshops. • 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. Epicor's education team has written the course workshops to minimize situations like this from occurring, but Epicor cannot prevent users from manipulating the data in your installation of the Epicor demonstration database.
2.
Log in to the training environment using the credentials manager/manager. If you are logged into your training environment 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.
Workshop Constraints All workshops in this course can be performed in a shared database. To following table lists the prerequisites required to complete the below workshops:
8
Workshop
Prerequisite
Workshop - Add a URL to the Dashboard
Access to the Internet must be established in your testing environment.
Epicor ERP | 10.0.700
Advanced Dashboards Course
Before You Begin
Workshop
Prerequisite
Workshop - Uptake from Excel
Microsoft® Excel® must be available in your testing environment.
Workshop - Create Mobile Dashboard
Epicor Mobile Access™ must be installed in your testing environment.
Workshop - Create a Dashboard in Microsoft Verify that you have Microsoft® SharePoint® 2007, 2010, or 2013 SharePoint installed on your server. Epicor SharePoint Publisher must be installed in your testing environment. Workshop - Create a Dashboard in Microsoft Epicor Web Access must be installed to use the context menu SharePoint functionality within this workshop. Tip See the Epicor 10 Supplemental Installations guide for more information on how to install the above Epicor ERP utilities. If necessary, contact your system administrator for assistance.
Epicor ERP | 10.0.700
9
Overview of Advanced Dashboard Techniques
Advanced Dashboards Course
Overview of Advanced Dashboard Techniques Dashboards are very flexible and powerful tools that provide easy access to critical information in a real-time environment. Dashboards can often replace the need for workbenches, shop vision reports, ad hoc reports, and simple business intelligence reports. Dashboards display current database information you need to more efficiently perform your tasks. Dashboards are developed to meet the needs of individual designers. The main features of dashboards include: • Design environment • Totally customizable • Use Business Activity Query (BAQ), updatable BAQ or external BAQ as data source • Provide various views of the BAQ data, such as grids, charts, trackers • Components synchronize with system entry programs using publish and subscribe functionality • Conditional formatting • Copy and paste enabled • Export and import dashboard definitions • Technical and personal notes • Direct access to Epicor ERP programs • URL/XSLT View • Gauge View functionality to monitor and display data changes • Main menu and Favorites bar deployment • Updatable Dashboard based on updatable BAQs • Targeted for either Mobile device, or for full size use as Smart Client or Epicor Web Access (EWA) forms • Available to use in Microsoft SharePoint environment that displays dashboards as web parts This course demonstrates how to display information through a variety of dashboard views using advanced techniques. Workshops are available to provide a hands-on experience throughout this course. Note Some of the features reviewed in this course utilize the standard customization toolset. You do not need to have user customization security privileges for any of the features in this course; however, you must have the Dashboard Developer privilege enabled in User Account Maintenance to complete the workshops in this course.
10
Epicor ERP | 10.0.700
Advanced Dashboards Course
Authorization
Authorization Use User Account Maintenance to enter basic information, security access, and Epicor application privileges for all users. Anyone who accesses the application must be set up in this program. Menu Path: System Setup > Security Maintenance > User Account Security Maintenance Important This program is not available in the Epicor Web Access. Important User Account Maintenance is typically only accessible to system administrators. If you do not have access to this program, contact your system administrator or IT personnel at your company for assistance. All users can access a dashboard once it is placed on the menu, but creating a new dashboard, or updating an existing one, requires a security privilege. To allow a user to work in the Designer Mode for dashboards, navigate to the Options sheet and select the Dashboard Developer check box. Note When you enable this functionality, it becomes available in the Tools menu in the Dashboard program. This allows a user to toggle the mode on and off as needed.
Epicor ERP | 10.0.700
11
Advanced Dashboard Techniques
Advanced Dashboards Course
Advanced Dashboard Techniques The course focuses on advanced techniques and functionality that exist in the dashboard. The section teaches you how to work with existing queries and display the information using the dashboard.
12
Epicor ERP | 10.0.700
Advanced Dashboards Course
Advanced Dashboard Techniques
Create New Dashboard The first step in the process is to add a Business Activity Query (BAQ) to the dashboard. Use Business Activity Query Designer to create a query that displays information from a table (or multiple tables) in the database. You can add multiple queries to the same dashboard to display related information. Before you create a dashboard, it is important to consider what information will be helpful to employees at your organization. Initial questions may include: • What is the appropriate format for this information? • Do you need to display a dashboard using the smart client, web client, as a web dashboard using Microsoft SharePoint, or would you like to target the dashboard for a mobile device? • Should it be more graphical in nature? • Should users be able to search for the data that displays in the dashboard? • Should users be able to update the data that displays in the dashboard? • Is there an existing query you can use on the dashboard, or should you create a new one? Once you obtain this information, begin the process of creating a customized dashboard. Tip Throughout the course your will work with existing queries. For more information on creating queries from scratch, see the Business Activity Queries course.
Dashboard Program Properties This topic discusses the main elements found on the Dashboard program. It helps you understand the key features prior to designing a new dashboard. The program is comprised of three design sheets where you define the overall definition for the current dashboard or specific items within the dashboard: • General sheet • Titlebar • Advanced Search The General sheet and its subsheets display automatically each time you launch the Dashboard program. General sheet The following are the fields found on the General sheet: • Dashboard ID - This is the identifier for the dashboard definition. • Description - This is the description that displays on the main title bar for the Dashboard. • Enable Refresh All - When selected, the Refresh All button is added to the Standard toolbar in the dashboard. The Refresh All button allows you to refresh all query data in the dashboard. Important For customers with large databases, the Refresh All button can cause performance issues with the dashboard. • Include Tree View on Dashboard Assembly - When selected, it allows you to display a tree view in the dashboard for user navigation between data records in the primary query. Once you run the Deploy Dashboard deployment process, the tree view displays.
Epicor ERP | 10.0.700
13
Advanced Dashboard Techniques
Advanced Dashboards Course
• Target Mobile Device - When you target the dashboard at a mobile device, you can select a mobile profile which specifies the device dimensions (height and width) and modify the design surface accordingly within the constraints of the device. When you generate an Epicor Web Access definition for the dashboard, it is generated in lightweight mobile form if the dashboard is targeted at a mobile device. Titlebar sheet The Titlebar sheet displays a summary of the queries publishing information on the dashboard, as well as all the fields published to the title bar. This window allows you to modify any fields published to the dashboard title bar in one place, instead of having to access each query individually. You can use the Title Caption field to enter the text that displays on the title bar. Advanced Search To have a dashboard added as an advanced search, you must enable the Advanced Search check box. The Advanced Search functionality is designed around the concept of Like fields. Similar to the Like fields used in a BAQ Search, the Advanced Search also uses Like fields; however, the data displays as a Dashboard and opens in a separate window on your workstation. You can then use the dashboard to search for specific data, select a record, and retrieve the record back to the original program you were searching from. Note You can use Advanced Searches wherever you can launch a Search window. To launch an Advanced Search, use the Search button or a context menu search option.
14
Epicor ERP | 10.0.700
Advanced Dashboards Course
Advanced Dashboard Techniques
Workshop - Create New Dashboard In this workshop, create a new dashboard. You first add business activity queries and select data you want to display within the dashboard. You then synchronize the information displayed by the queries using the publish and subscribe functionality. Navigate to the Dashboard. Menu Path: Executive Analysis > Business Activity Management > General Operations > Dashboard Important This program is not available in the Epicor Web Access.
Add PartBin Query When the Dashboard program launches, verify that Developer mode is enabled. 1. If necessary, from the Tools menu, select Developer. This ensures that you are working in the Developer mode. Note You can toggle developer mode off and on by selecting the Developer command from the Tools menu. Users who do not have Dashboard Developer rights do not have this option available to them. These users can only open existing dashboards, and cannot update or create new dashboards.
2. From the New menu, select New Dashboard. 3. In the Definition ID and Description fields, enter XXX-PartBinWorkBench (where XXX are your initials). 4. Select the Enable Refresh All check box. Note For customers with large databases, the Refresh All button can cause performance issues with the dashboard. This button, by design, does not honor filters and returns all rows to the dashboard.
5. Select the Include Tree on Dashboard Assembly check box. 6. From the New menu, select New Query. The Dashboard Query Properties window displays. 7. Click the Query ID button. The Query Search window displays. 8. In the Starting At field, enter EPIC06 and click Search. 9. In the Search Results grid, select EPIC06-PartBin and click OK. EPIC06-PartBin is a custom query created for the company Epicor Education. 10. In the Dashboard Query Properties window, click OK. 11. On the Standard toolbar, click Save. The tree view on the left displays two icons - the query and the grid.
Epicor ERP | 10.0.700
15
Advanced Dashboard Techniques
Advanced Dashboards Course
Change Grid Caption 1. In the dashboard tree view, right-click the grid icon, and select Properties. The Dashboard Grid Properties window displays. 2. In the Grid Caption field, delete the content and enter Parts. 3. In the Dashboard Grid Properties window, click OK. 4. On the Standard toolbar, click Save. 5. On the Standard toolbar, click Refresh. 6. View the XXX-PartBinWorkBench (where XXX are your initials) dashboard and the Parts grid that displays data returned by the query.
Publish Fields Publish the Part Number field for use as a filter to the additional query views added later in the workshop. Publish the Part Description field to the title bar of the Dashboard. 1. In the dashboard tree view, right-click the query icon, and select Properties. The Dashboard Query Properties window displays. 2. On the General sheet, select the Auto Refresh on Load check box. This refreshes the data automatically when you launch the dashboard. Note Use caution when enabling this check box, as queries that retrieve many records take more time to load to the dashboard when it is initially opened.
3. In the Refresh Interval field, accept the default value -1. A minus one (-1) indicates there is no automatic refresh. In this scenario, data will be refreshed once you launch the dashboard, but for further dashboard updates, you must use the Refresh or Refresh All buttons on the Standard toolbar. Example If you would like to use a two minutes refresh interval, enter 120.
4. Navigate to the Publish sheet. 5. In the Publish Columns section, select the Part_PartNum and Part_PartDescription check boxes. 6. Select the Publish to Title check box. 7. In the field above Title caption, select Part_PartDescription. 8. In the Title caption field, enter Part:, and click OK. 9. On the Standard toolbar, click Refresh and verify the results on the title bar of the dashboard. 10. On the Standard toolbar, click Save. The Part Description field is now published to the title bar.
16
Epicor ERP | 10.0.700
Advanced Dashboards Course
Advanced Dashboard Techniques
Add Jobhead Query Add a second query to the dashboard and change its caption. 1. From the New menu, select New Query. 2. Click the Query ID button. The Query Search window displays. 3. In the Starting At field, enter z and click Search. Note Queries that begin with the letter Z are standard queries written by Epicor that are included with the software. System queries are also identified by the Delivered check box.
4. In the Search Results grid, select zjobhead01 and click OK. The Dashboard Query Properties window displays. 5. Select the Auto Refresh on Load check box. 6. In the Caption field, delete the content and enter Job Info. 7. In the Dashboard Query Properties window, click OK. 8. Click Save. 9. On the Standard toolbar, click Refresh and view the data.
Change Grid Caption 1. In the dashboard tree view, right-click the zjobhead01: Summary grid icon and select Properties. The Dashboard Grid Properties window displays. 2. In the Grid Caption field, enter Jobs. 3. In the Dashboard Grid Properties window, click OK.
Publish Job Number 1. In the dashboard tree view, right-click the query icon for Job Info, and select Properties. The Dashboard Query Properties window displays. 2. Navigate to the Publish sheet. 3. In the Publish Columns section, select JobHead_JobNum. 4. Select the Publish to Title check box. 5. In the field above Title caption, select JobHead_JobNum. 6. In the Title caption field, enter Job:.
Epicor ERP | 10.0.700
17
Advanced Dashboard Techniques
Advanced Dashboards Course
7. In the Dashboard Query Properties window, click OK. 8. On the Standard toolbar, click Refresh and verify the results on the title bar of the dashboard. Notice the part and job now display in the title bar of the dashboard. 9. On the Standard toolbar, click Save.
Apply Filter to Jobs Grid A filter that subscribes to a published piece of data can be applied to either the query or the individual views such as a grid. When a query subscribes to the published data, all views for that query then subscribe to that same piece of data. However, if you add multiple views such as a grid and a chart, you may only want to filter the data in the grid, not necessarily on the chart. In this situation, add the filter to the grid view, not the query. 1. In the dashboard tree view, right-click the grid icon for zjobhead01: Summary and select Properties. The Dashboard Grid Properties window displays. 2. Navigate to the Filter sheet. 3. Select the following information: Field
Data
ColumnName
JobHead_PartNum
Condition
= (equal sign)
Value
EPIC06-PartBin- Part and Bin Information: Part_PartNum
Note EPIC06-PartBin- Part and Bin Information: Part_PartNum is the Part Number field published from the EPIC06-PartBin query above.
4. In the Dashboard Grid Properties window, click OK. 5. On the Standard toolbar, click Save. 6. On the Standard toolbar, click Refresh to execute the query and refresh the data. 7. Verify the results by selecting parts from the Parts list and reviewing the jobs that display for that part. Scroll down and use parts DCD-100-SP and DCD-200-ML as an example of parts that have jobs in the database. 8. Remain in the dashboard.
18
Epicor ERP | 10.0.700
Advanced Dashboards Course
Advanced Dashboard Techniques
Image Columns You can ad Image Column to a dashboard grid to and define rules for its displaying. There are many standard images that you can select to display. Each column can be set up so that it does not have a default image. This allows you to populate it with images when specific rule conditions are met. To define the rules that determine when the image displays, use the View Rules sheet. Example To display an image next to a part when it has a negative on hand quantity: 1.
Create an image column and select the appropriate image (graphic) that you want to display.
2.
Establish the criteria on the View Rules sheet that defines when the on hand quantity is less than zero, the column displays the selected image.
You can immediately use this functionality to display any image included within the application. You can also display your own images through Resource Editor. The Resource Editor is a tool that allows you to add, edit, and delete the images used within the customized program or dashboard. It allows you to create a custom resource file that automatically loads when you launch the application. You can then reference these images within the application. While you are in Developer Mode for either a customized program or a dashboard, you can selected these images. When you add a new grid to a dashboard, the Image Column sheet allows you to display your custom images on the custom grid. This separate utility is available for download from EPICweb at Epicor Downloads. Use this utility to find, select, and add your own images to the Epicor application.
Workshop - Add Image Column to the Parts Grid Create a new image column and add it to the dashboard. Apply a rule on the new image column that displays the image when there is a negative on hand quantity for a part. If necessary, navigate to the Dashboard. Menu Path: Executive Analysis > Business Activity Management > General Operations > Dashboard Important This program is not available in the Epicor Web Access.
Add Image Column to Parts Grid 1. Verify the XXX-PartBinWorkBench (where XXX are your initials) dashboard created earlier is open. 2. In the dashboard tree view, right-click the EPIC06-PartBin: Summary grid icon and select Properties. The Dashboard Grid Properties window displays. 3. Navigate to the Image Columns sheet. 4. In the Column Name field, enter NegOH. 5. In the Caption field, enter Neg On Hand. The caption displays as the title of the column on the dashboard.
Epicor ERP | 10.0.700
19
Advanced Dashboard Techniques
Advanced Dashboards Course
6. In the Image Name field, verify (None) displays. The image selected in this field is used as the default image for all rows in the grid. The purpose of this workshop is to display the image only when a part has a negative on hand quantity. 7. In the Visible Index field, enter 1. The number entered in this field determines where the column will display in the grid. The number one indicates that this is the first column to display in the grid. Remain in the Dashboard Grid Properties window.
Apply View Rule to Image Column 1. Navigate to the View Rules sheet. 2. Click the New View Rule button. 3. Enter a new rule using the following information: Field
Data
Select Field
PartBin_OnhandQty
Rule Condition
LessThan
Rule Value
0
4. Click the > blue arrow button to save the rule and move it to the available rules list. 5. Click the New Rule Action button. 6. Enter the following information for the rule action: Field
Data
Select Field
NegOH
Image Name
Exclamation
7. Click the > blue arrow button to save the rule action and move it to the available actions list. 8. In the Dasboard Grid Properties window, click OK. 9. On the Standard toobar, click Refresh. 10. Review the results in the Parts grid of the dashboard. Notice the new Neg On Hand column that displays in the first column of the grid. The Warning icon only displays next to parts that have a negative on hand quantity. 11. Remain in the dashboard.
20
Epicor ERP | 10.0.700
Advanced Dashboards Course
Advanced Dashboard Techniques
Advanced Searches An Advanced Search allows you to enter criteria to search for specific data within the Dashboard. Also known as a Tracker View, the Advanced Search uses the Epicor application customization tools to create the view and enable the fields for data entry. Not only can you enable certain fields for data entry, you can also set up multiple fields to allow a range to be entered and data can be filtered. Example Searching for open sales orders within a specific date range.
Add a Tracker View When you add a tracker view to a dashboard, it includes the functionality to search the query results for data to display based on specified criteria. Many of the standard dashboards include this functionality. A tracker view allows you to find the exact information you are looking for without having to search through all the records in the dashboard. To add a tracker view, right-click the query icon in the tree view of the dashboard and from the context menu, select New Tracker View. Customize Tracker View To make the tracker view act as an Advanced Search, you must use application customization tools. To access the Customization Tools Dialog window, right-click the tracker icon in the tree view, and from the context menu, select Customize Tracker View. Tip For additional information on customization, review Introduction to Customization course, Advanced Customization course, and Application Help. Advanced Search with Range An Advanced Search with a range allows you to enter a range to retrieve data from the database based on the range entered. Date ranges are particularly helpful if you need to search for data for a given period of time. When you enable the Show Summaries feature, you are able to see subtotals of data based on ranges. To add the Range functionality, use the customization tools to add additional fields to the tracker view, and link the fields to a specific query column.
Epicor ERP | 10.0.700
21
Advanced Dashboard Techniques
Advanced Dashboards Course
Workshop - Customize a Tracker View Add a tracker view that serves as an Advanced Search filter to the dashboard.
Add Tracker View 1. Verify the XXX-PartBinWorkbench (where XXX are your initials) dashboard created earlier is open. 2. In the dashboard tree view, right-click the EPIC06-PartBin query icon, and select New Tracker View. The Dashboard Tracker View Properties window displays. 3. In the Caption field, delete the content and enter Advanced Search. The text entered here displays in the header of the Tracker View and also in the tree view of the dashboard. 4. Click the Clear All button. 5. In the display columns list, select the Visible and Prompt check boxes for the following columns. • Part_PartNum • Part_PartDescription • Part_TypeCode • PartBin_WarehouseCode Note By selecting the Prompt check box, the field changes from read only to enabled for user input.
6. For the Part_PartNum column, in the Condition field, select StartsWith and accept all other defaults. The Condition field determines how the data entered in each field is used for searching. Tip By selecting the Embed Grid View check box, the query's grid displays within the Tracker View. Do not select this option for this example.
7. In the Dashboard Tracker View Properties window, click OK. The Advanced Search sheet now displays within the dashboard. 8. Drag the Advanced Search pane up and dock it to the EPIC06-PartBin: Summary sheet. Within the Part and Bin Information pane, there are two sheets at the top of the screen - the EPIC06-PartBin: Summary sheet and the Advanced Search sheet. 9. On the Standard toolbar, click Save.
Test the Advanced Search 1. Select the Advanced Search sheet. 2. On the Standard toolbar, click Clear. 3. In the Type field, enter M. M stands for manufactured parts.
22
Epicor ERP | 10.0.700
Advanced Dashboards Course
Advanced Dashboard Techniques
4. Navigate to the EPIC06-PartBin: Summary sheet and click Refresh to view the results. Notice only manufactured parts display. 5. Navigate to the Advanced Search sheet. 6. On the Standard toolbar, click Clear. 7. In the Part field, enter the letter C. Recall the condition for this field is set to StartsWith. 8. Navigate to the EPIC06-PartBin: Summary sheet and click Refresh to view the results. Notice only parts that start with the letter C display.
Epicor ERP | 10.0.700
23
Advanced Dashboard Techniques
Advanced Dashboards Course
Workshop - Add Advanced Search with Range Add a search range for part numbers to the Advanced Search sheet on the dashboard. Modify the newly created Advanced Search sheet, add a groupbox, as well as two new Part fields for entry of the range.
Add Groupbox 1. In the dashboard tree view, right-click the Advanced Search tracker view, and select Customize Tracker View. The Customization Tools Dialog window displays. 2. Arrange the dashboard and the Customization Tools Dialog windows to see both. 3. In the Customization Tools Dialog window from the Tools menu, select Toolbox. The Toolbox window displays. 4. In the Toolbox window, click EpiGroupBox. 5. Under the Warehouse field, click in the Advanced Search sheet to add the new groupbox. 6. Resize the box so it fits two text boxes inside for the part range entry fields. 7. Navigate to Customization Tools Dialog > Properties sheet. 8. On the canvas, click the epicGroupBox1 to select it. 9. In the Misc group, in the Text field, delete the content and enter Part Range Search. 10. In the Customization Tools Dialog window, click Save.
Add Field 1 This field is used as the start range parameter for the advanced search. 1. In the Toolbox window, click EpiTextBox. If necessary, re-launch the Toolbox from the Tools menu in the Customization Tools Dialog window. 2. On the Advanced Search sheet, click inside the previously added groupbox to add the new field. 3. Resize the box so the data fits in the field. 4. Navigate to the Customization Tools Dialog > Properties sheet. 5. In the Data group, in the Text field, delete the content and leave the field blank. 6. In the Misc group, in the IsTrackerQueryControl field, select True. Note Setting the IsTrackerQueryControl to True means that the field acts as a control for the search window.
7. In the Misc group, in the QueryColumn field, select Part_PartNum.
24
Epicor ERP | 10.0.700
Advanced Dashboards Course
Advanced Dashboard Techniques
8. In the Dashboard group, in the DashboardCondition field, select GreaterThanOrEqualTo. 9. In the Dashboard group, in the DashboardPrompt field, select True. 10. In the Customization Tools Dialog window, click Save.
Add Field 2 This field is used as the ending range parameter for the advanced search. 1. In the Toolbox window, click EpiTextBox. If necessary, re-launch the Toolbox from the Tools menu in the Customization Tools Dialog window. 2. Click inside the groupbox under the previously added textbox. Leave enough space between both textboxes for adding a label between them in the next task. 3. Resize the box so the data fits in the field. 4. Navigate to the Customization Tools Dialog > Properties sheet. 5. In the Data group, in the Text field, delete the content and leave the field blank. 6. In the Misc group, in the IsTrackerQueryControl field, select True. 7. In the Misc group, in the QueryColumn field, select Part_PartNum. 8. In the Dashboard group, in the DashboardCondition field, select LessThanOrEqualTo. 9. In the Dashboard group, in the DashboardPrompt field, select True. 10. In the Customization Tools Dialog window, click Save.
Add Label Add a label to the search groupbox. 1. In the Toolbox window, click EpiLabel. If necessary, re-launch the Toolbox from the Tools menu in the Customization Tools Dialog window. 2. Click inside the groupbox between the two EpiTextBox fields to add the new label. 3. Navigate to the Customization Tools Dialog > Properties sheet. 4. In the Misc group, in the Text field, delete the content and enter To. 5. Click Save and exit the Customization Tools Dialog window. 6. If necessary, in the Save Confirmation window, click Yes. 7. In the dashboard, on the Standard toolbar, click Save.
Epicor ERP | 10.0.700
25
Advanced Dashboard Techniques
Advanced Dashboards Course
Run Search 1. Navigate to the Advanced Search sheet. 2. On the Standard toolbar, click Clear. 3. In the first part range search field, enter CS-000. 4. In the second part range search field, enter CS-100. 5. Navigate to the EPIC06-Part Bin: Summary sheet. 6. On the Standard toolbar, click Refresh. 7. Review the results. 8. Remain in the dashboard.
26
Epicor ERP | 10.0.700
Advanced Dashboards Course
Advanced Dashboard Techniques
Workshop - Modify Dashboard Properties Modify the dashboard properties by adding this dashboard to the available advanced searches in the Epicor application. Identify the Part Number and Job Number as Like columns. As a result, this dashboard is added to the available advanced searches anywhere a Part search or Job search window is initiated.
Assign the Like Columns in Dashboard Properties 1. Verify the XXX-PartBinWorkbench (where XXX are your initials) dashboard created earlier is open. 2. Navigate to the General > Adv Search sheet. 3. Select the Advanced Search check box. 4. In the Available "Like" columns list, select Part.PartNum, and click the > right blue arrow button. This moves the selected item to the Advanced Search "Like" columns. 5. In the Available "Like" columns list, select JobHead.JobNum, and click the > right blue arrow button. This moves the selected item to the Advanced Search "Like" columns. 6. On the Standard toolbar, click Save. 7. Minimize the dashboard.
Verify Results in Part Maintenance Navigate to Part Maintenance. Menu Path: Production Management > Job Management > Setup > Part 1. Click the Part button to initiate a part search. 2. Navigate to the Advanced sheet and verify the XXX-PartBinWorkbench (where XXX are your initials) dashboard displays in the grid. You could now use the dashboard as an advanced search for Part Maintenance. 3. In the Part Search window, click Cancel. 4. Exit Part Maintenance.
Verify Results in Job Entry Navigate to Job Entry. Menu Path: Production Management > Job Management > General Operations > Job Entry 1. Click the Job button to initiate a job search. 2. Navigate to the Advanced sheet and verify the XXX-PartBinWorkbench (where XXX are your initials) dashboard displays in the grid. You could now use the dashboard as an advanced search for Job Entry.
Epicor ERP | 10.0.700
27
Advanced Dashboard Techniques
Advanced Dashboards Course
3. In the Job Search window, click Cancel. 4. Exit Job Entry.
28
Epicor ERP | 10.0.700
Advanced Dashboards Course
Advanced Dashboard Techniques
Dashboard Browse A Dashboard Browse provides the ability to use a standard search button on the dashboard, along with the Standard navigational toolbar. The standard search button (indicated by a binoculars icon) allows you to initiate a standard search for records. The navigational tools area allows you to scroll through selected records, or select the record from a list of search results. Use a special filter on the query to add a Dashboard Browse to the query level of a dashboard. To apply a filter, right-click the query icon in the tree view and select Properties. You must also determine which field to use for the search. For example, the Part Number field in the Part master file. A dashboard can contain more than one Dashboard Browse. Each query added to the dashboard can contain its own dashboard browse, however, one is indicated as the Primary Browse. A Primary Dashboard Browse displays next to the Standard toolbar at the top of the screen above the contents pane of the dashboard. A Dashboard Browse not marked as Primary displays in the Contents pane of the dashboard and at the same level as the query itself.
Workshop - Add Dashboard Browse In this workshop, add a primary Dashboard Browse to the dashboard. 1. Verify the XXX-PartBinWorkbench (where XXX are your initials) dashboard created earlier is open. 2. In the dashboard tree view, right-click the EPIC06-PartBin query icon, and select Properties. The Dashboard Query Properties window displays. 3. Navigate to the Filter sheet. 4. Select the following information: Field
Data
ColumnName
Part_PartNum
Condition
= (equal sign)
Value
Dashboard Browse (at the bottom)
The Dashboard Browse Properties window displays. 5. In the Display Column field, verify PartNum displays. If not, select this value. 6. In the Drop Down Columns list, hold the Ctrl key and select PartDescription and PartNum. 7. Click the > blue arrow to add the fields to the selected fields list. 8. If the PartNum field is not listed first, select the PartNum field, and click the ^ up arrow to move it to the top of the list. 9. Select the Primary Browse check box. 10. In the Dashboard Browse Properties window, click OK.
Epicor ERP | 10.0.700
29
Advanced Dashboard Techniques
Advanced Dashboards Course
11. In the Dashboard Query Properties window, click OK. 12. On the Standard toolbar, click Save. 13. View the Dashboard Browse on the toolbar. 14. Click the binoculars icon to launch the Part Search. 15. In the Starting At field, enter DCD and click Search. 16. In the Search Results grid, highlight all DCD parts and click OK. 17. Use the standard navigational tools in the Dashboard Browse to navigate through the selected records. 18. Remain in the dashboard.
30
Epicor ERP | 10.0.700
Advanced Dashboards Course
Advanced Dashboard Techniques
Add Sheets and Grids Once you create a dashboard, you can add a custom sheets with user-defined grids. This allows you to determine the information that displays in the grid format. All grids contain the same basic functionality such as cut, copy, paste, print selected, Group By, and Summarize options.
Workshop - Add Sheets and Grids Add three new sheets to the dashboard that display job assembly, job material, and job operation information. Later in the course, add grids to each sheet to display the related job information.
Add Tracker View Use a tracker view to add a blank panel (and sheet) to the dashboard. 1. Verify the XXX-PartBinWorkbench (where XXX are your initials) dashboard created earlier is open. 2. In the dashboard tree view, right-click the Job Info query, and select New Tracker View. The Dashboard Tracker View Properties window displays. 3. In the Caption field, delete the content and enter Job Details. 4. Click the Clear All button and click OK. 5. On the Standard toolbar, click Save.
Add Blank Sheets 1. In the dashboard tree view, right-click the Job Details tracker view, and select Customize Tracker View. The Customization Tools Dialog window displays. 2. Arrange the Dashboard and Customization Tools Dialog windows to see both. 3. In the Customization Tools Dialog window, navigate to the Wizards > Sheet Wizard sheet. 4. Click the New Custom Sheet button. 5. In the Dockable Sheets list, select the available option. 6. Enter the following information: Field
Data
Name
JobAsmbl
Text
Job Asmbl
Tab Text
Job Assembly
7. Click the > blue arrow to add the sheet to the Custom Sheets list.
Epicor ERP | 10.0.700
31
Advanced Dashboard Techniques
Advanced Dashboards Course
8. In the Customization Tools Dialog window, click Save. 9. Use steps 4 through 8 to add two additional custom sheets. Field
Data
Name
JobMatl
Text
Job Matl
Tab Text
Job Material
Field
Data
Name
JobOper
Text
Job Oper
Tab Text
Job Operations
10. In the dashboard, in the Job Details pane, view the new sheets.
Add Grids to Sheets 1. In the dashboard, select the Job Assembly sheet. 2. In the Customization Tools Dialog window from the Tools menu, select ToolBox. The ToolBox window displays. 3. In the ToolBox window, click EpiUltraGrid. 4. Click in the top left corner on the canvas on the Job Assembly sheet, to add the new grid to the sheet. Resize the box so the grid spans the length and height of the Job Assembly sheet. You may have to move the Customization Tools Dialog window out of the way so you can add the grid. Example
5. In the Customization Tools Dialog window, navigate to the Properties sheet. Verify the object in focus is (C)epiUltraGrid1. 6. In the Appearance group, change the Text field to Job Assembly. 7. Click Save. 8. Navigate to the Job Material sheet. 9. In the Customization Tools Dialog window, from the Tools menu, select ToolBox. 10. In the ToolBox window, click EpiUltraGrid.
32
Epicor ERP | 10.0.700
Advanced Dashboards Course
Advanced Dashboard Techniques
11. Click in the top left corner on the canvas on the Job Material sheet, to add the new grid to the sheet. Resize the box so the grid spans the length and height of the Job Material sheet. 12. In the Customization Tools Dialog window, navigate to the Properties sheet. Verify the object in focus is (C)epiUltraGrid2. 13. In the Appearance group, change the Text field to Job Material. 14. Click Save. 15. Navigate to the Job Operations sheet. 16. In the Customization Tools Dialog window, from the Tools menu, select ToolBox. 17. In the ToolBox window, click EpiUltraGrid. 18. Click in the top left corner on the canvas on the Job Operations sheet, to add the new grid to the sheet. Resize the box so the grid spans the length and height of the Job Operations sheet. 19. In the Customization Tools Dialog window, navigate to the Properties sheet. Verify the object in focus is (C)epiUltraGrid3. 20. In the Appearance group, change the Text field to Job Operations. 21. Click Save. 22. Exit the Customization Tools Dialog window. 23. In the dashboard, on the Standard toolbar, click Save.
Hide Blank Sheet 1. Select the Job Details sheet. 2. Right-click the sheet name and select Hide. The Job Details sheet disappears. 3. On the Standard toolbar, click Save. 4. Remain in the dashboard.
Epicor ERP | 10.0.700
33
Advanced Dashboard Techniques
Advanced Dashboards Course
Foreign Key Views A foreign key is a link to a separate or foreign table that contains logically similar data. Foreign keys allow these related tables to be linked together to display the desired information. Access these views using customized sheets, or display them within the dashboard. This functionality provides a powerful tool that enables the setup of numerous table combinations. You can create one view and link it to another sub-view, another sub-view linked to that sub-view, and so on. As long as a logical connection is established between the parent and child columns, you can display the data through a combination of views. The Custom Data Dialog option from the Tools menu of the Customization Tools Dialog window allows you to create and edit custom data views. This customization tool uses foreign keys to link fields in separate but related tables. Fields that link to foreign key fields in other tables must share the Like property. The Like property defines which foreign keys can link to the selected field. You can create foreign key views for any query result or data view that has a field that allows the user to search by its record (GetByID) identifier. You can then create a view based on this field's value. Example Order Entry has the PartNum field in the data view, which allows you to create a foreign element that links the part information to Order Entry.
34
Epicor ERP | 10.0.700
Advanced Dashboards Course
Advanced Dashboard Techniques
Workshop - Create Foreign Key and Sub Table Views Create a foreign key view and three sub table views to use in the dashboard. The foreign key view establishes the Job Number from the Job Header as the key field and as the adaptor. Create three sub table views that allow you to see job assembly, job material, and job operation information as each job is selected in the dashboard. After you create the views, link the blank grids on your dashboard (created in the previous workshop) to these views to display the related job information.
Create Foreign Key View Create a foreign key view for job number. 1. Verify the XXX-PartBinWorkbench (where XXX are your initials) dashboard created earlier is open. 2. In the dashboard tree view, right-click the Job Details tracker icon, and select Customize Tracker View. The Customization Tools Dialog window displays. 3. In the Customization Tools Dialog window, from the Tools menu, select Data Tools. The Custom Data Dialog window displays. 4. In the Custom Data Dialog window, click the New Custom View button. 5. Enter custom view details. Field
Data
View Name
Job
Parent View Name
TrackerQueryView
Column Name
JobHead_JobNum
6. Click the Add button. 7. To the Foreign Key View Succeeded message, click OK. 8. In the Custom Data Dialog window, click OK. 9. In the Customization Tools Dialog window, click Save.
Add Sub Table for Job Assembly 1. In the Customization Tools Dialog window, from the Tools menu, select Data Tools. The Custom Data Dialog window displays. 2. In the Custom Data Dialog window, click the New Custom View button. 3. In the View Name field, enter JobAsm. 4. Enter custom view details.
Epicor ERP | 10.0.700
35
Advanced Dashboard Techniques
Advanced Dashboards Course
Field
Data
Parent View Name
Job
View Type
Sub Table View
Sub Table Name
JobAsmbl
Parent View Columns
JobHead_JobNum
Child View Columns
JobNum
5. Under the Parent and Child View fields, click the Add button. 6. At the bottom of the window, click the Add button. In the Custom Views list, STV:JobAsm displays. 7. In the Custom Data Dialog window, click OK. 8. In the Customization Tools Dialog window, click Save.
Add Sub Table for Job Material 1. In the Customization Tools Dialog window, from the Tools menu, select Data Tools. The Custom Data Dialog window displays. 2. In the Custom Data Dialog window, click the New Custom View button. 3. In the View Name field, enter JobMatl. 4. Enter the following custom view details: Field
Data
Parent View Name
JobAsm
View Type
Sub Table View
Sub Table Name
JobMtl
Parent View Columns
AssemblySeq
Child View Columns
AssemblySeq
5. Under the Parent and Child View fields, click the Add button. 6. At the bottom of the window, click the Add button. In the Custom Views list, STV:JobMatl displays. 7. In the Custom Data Dialog window, click OK. 8. In the Customization Tools Dialog window, click Save.
36
Epicor ERP | 10.0.700
Advanced Dashboards Course
Advanced Dashboard Techniques
Add Sub Table for Job Operation 1. In the Customization Tools Dialog window, from the Tools menu, select Data Tools. The Custom Data Dialog window displays. 2. In the Custom Data Dialog window, click the New Custom View button. 3. In the View Name field, enter JobOper. 4. Enter the following custom view details. Field
Data
Parent View Name
JobAsm
View Type
Sub Table View
Sub Table Name
JobOper
Parent View Columns
AssemblySeq
Child View Columns
AssemblySeq
5. Under the Parent and Child View fields, click the Add button. 6. At the bottom of the window, click the Add button. In the Custom View list, STV:JobOper displays. 7. In the Custom Data Dialog window, click OK. 8. In the Customization Tools Dialog window, click Save.
Link New Views to Blank Grids 1. Move the Customization Tools Dialog window so you can see the Job Assembly grid on the dashboard. 2. Navigate to the Job Assembly sheet and click inside the grid. 3. In the Customization Tools Dialog window, navigate to the Properties sheet. 4. Locate the EpiBinding field. 5. In the EpiBinding field, select JobAsm and click Save. 6. Move the Customization Tools Dialog window so you can see the Job Material grid on the dashboard. 7. Navigate to the Job Material sheet and click inside the grid. 8. In the Customization Tools Dialog window, navigate to the Properties sheet. 9. In the EpiBinding field, select JobMatl and click Save. 10. Move the Customization Tools Dialog window so you can see the Job Operations grid on the dashboard.
Epicor ERP | 10.0.700
37
Advanced Dashboard Techniques
Advanced Dashboards Course
11. Navigate to the Job Operations sheet and click inside the grid. 12. In the Customization Tools Dialog window, navigate to the Properties sheet. 13. In the EpiBinding field, select JobOper and click Save. 14. Exit the Customization Tools Dialog window. 15. In the dashboard, click Save.
Verify Results of New Views 1. Navigate to the Advanced Search sheet. 2. On the Standard toolbar, click the Clear icon. 3. Navigate to the EPIC06-PartBin: Summary sheet. 4. On the Standard toolbar, click the Refresh icon. 5. In the Parts sheet, select the part number DCD-200-ML. 6. Navigate to the Job Details sheet and review the Job Assembly, Job Material, and Job Operations sheets for several jobs listed in the dashboard. Note You may need to click the Refresh icon for each sheet to populate the data.
7. Remain in the dashboard.
38
Epicor ERP | 10.0.700
Advanced Dashboards Course
Advanced Dashboard Techniques
Gauge View Use the Gauge View functionality to create a gauge graphic that updates when selected data changes within the query it monitors. This tool allows you to visualize data you monitor so you can act on changes as they occur. There are several gauge types available, allowing you to select the type that meets your needs.
Workshop - Add a Gauge View to the Dashboard In this workshop, use the Job Info query as the data source for a gauge view that monitors the production activity of individual jobs. Use the basic digital gauge type to display the information. 1. Verify the XXX-PartBinWorkbench (where XXX are your initials) dashboard created earlier is open. 2. In the dashboard tree view, right-click the Job Info query icon, and select New Gauge View. The Dashboard Gauge Properties window displays. 3. Click the Gauge Type button. The Open window displays. 4. Select BasicDigital02.xml and click Open. 5. In the MarkerBinding field, select JobHead.ProdQty. Note This gauge type only displays the data column which defines the marker on the gauge. Different gauge types may allow you to select the StartValueBinding and EndValueBinding fields. The StartValueBinding field defines the column from the current query used as the beginning gauge value. When the gauge evaluates where to place its marker, the StartValueBinding value is evaluated against the EndValueBinding value. The EndValueBinding field defines the column from the current query used as the final value on the gauge. Tip If you want to reuse this gauge view elsewhere, select the Publish View check box. In this example, do not select this check box.
6. In the Dashboard Gauge Properties window, click OK. The gauge view displays at the bottom of the screen. 7. In the dashboard, click the zjobhead01 : Gauge sheet and move it up towards the Job Details sheet. 8. When the grey tab displays at the bottom of the box, release the sheet. The Job Details sheet and the zjobhead01 : Gauge sheet now display at the same level. 9. Navigate to the Advanced Search sheet. 10. On the standard toolbar, click the Clear button. 11. Navigate to the EPIC06-PartBin: Summary sheet. 12. In the Parts grid, select the record for DCD-200-ML.
Epicor ERP | 10.0.700
39
Advanced Dashboard Techniques
Advanced Dashboards Course
13. In the zjobhead01 : Summary grid, select different jobs and view the production quantity value that displays on the gauge view. Example The following image displays the created Gauge View.
Tip On dashboard web forms, you can use gauge views in exactly the same way as on smart client dashboards. For updatable dashboards, radial gauges - that have needles or markers you can grab and drag around - can be used to update data to the Epicor database.
40
Epicor ERP | 10.0.700
Advanced Dashboards Course
Advanced Dashboard Techniques
URL View The URL/XSLT View allows you to display a website using a URL address or an XSLT Style sheet that displays data on your dashboard. When you enter a file name that ends in .xslt in the Web Address field, additional fields become available for you to further define the Style Sheet details. There are many different uses for a URL/XSLT link: • Simple URL link to a defined website. • URL link to website that is published from a query. • Link to standard web part such as Microsoft Outlook® Inbox, or Calendar. • Display dashboard data through an XSLT stylesheet. URL View To add a URL to the dashboard you simply enter the caption and website address in the Dashboard URL/XSLT Properties window. You can optionally link to a website that is published from a query on the dashboard using the Publisher field.
Workshop - Add a URL to the Dashboard Create a URL view and link the URL to Epicor's website. 1. Verify the XXX-PartBinWorkbench (where XXX are your initials) dashboard created earlier is open. 2. From the New menu, select New URL/XSLT View. The Dashboard URL/XSLT Properties window displays. 3. In the Caption field, enter Epicor Website. 4. In the URL/XSLT Address field, verify Epicor's website www.epicor.com displays. 5. In the Dashboard URL/XSLT Properties window, click OK. View the site Epicor Website sheet at the bottom of the dashboard. 6. Click the Epicor Website sheet and move it up towards the Part and Bin Information sheet. 7. When the grey tab displays at the top of the box, release the sheet. The Part and Bin Information and Epicor Website sheets now display at the same level. 8. On the Standard toolbar, click Save. 9. Remain in the dashboard.
Epicor ERP | 10.0.700
41
Advanced Dashboard Techniques
Advanced Dashboards Course
Build and Deploy Dashboard After you design a dashboard, you must build and deploy it so other users can access it. Use the Tools > Deploy Dashboard option to compile the dashboard definition into a User Interface (UI) finished assembly and then deploy it to the server. When the dashboard definition is compiled, deploy it to the Main menu and the Favorites bar so all users can access it. Important The following workshop demonstrates how you can quickly enable the new dashboard to all users when you launch the application using the Classic Style. If you run the application using the Modern Shell Style, exit the application and log in using the Classic Style to successfully complete the workshop. Tip To learn how to make your custom dashboard available to users using the Menu Maintenance program, review the Introduction to the Dashboards course.
Workshop - Build and Deploy the Dashboard Build and deploy the dashboard as the UI application and make it available to all users. 1. From the Tools menu, select Deploy Dashboard. The Deploy Dashboard window displays. 2. Click the Test Application button. The dashboard displays in a new window that users can see once you deploy it. 3. Exit the preview dashboard window. 4. In the Deploy Dashboard window, select the Deploy Smart Client Application, Add Menu Tab and Add Favorite Item check boxes. 5. Click the Deploy button. Note Building the dashboard assembly process may take few moments.
6. Once the process is complete and the status pane displays Finished, click OK. 7. In the dashboard, on the Standard toolbar, click Save. 8. Exit the dashboard. 9. When logged in into application using the Classic style, on the Main menu, navigate to the Favorites sheet. Tip If the Favorites menu is not displayed on the Main Menu, click View > Favorites to enable this option.
42
Epicor ERP | 10.0.700
Advanced Dashboards Course
Advanced Dashboard Techniques
10. Click the Dashboard Assemblies group and in the list, verify the XXX-PartBinWorkBench (where XXX are your initials) dashboard displays. View the dashboard is also embedded on the Main menu as a new sheet. 11. From the Options menu, select Developer Mode. Important You must be in the Developer Mode to perform any changes to the Main menu.
12. Click the Menu Groups sheet and navigate to Production Management > Job Management > General Operations 13. Verify the Menu Items sheet displays the content of the General Operations folder. 14. Navigate to the Favorites sheet. 15. Right-click the XXX-PartBinWorkBench (where XXX are your initials) dashboard, and drag and drop it to the contents pane on the right. The Copy Menu Item window displays. 16. To the message, click OK. The dashboard is now available to all users. 17. From the Options menu, select Developer Mode. This disables the Developer Mode.
Epicor ERP | 10.0.700
43
Updatable Dashboards
Advanced Dashboards Course
Updatable Dashboards The Updatable Dashboard is an extension to the standard dashboard capabilities. Use the updatable dashboard functionality to place updatable Business Activity Queries (BAQs) on either a client dashboard or a mobile device dashboard. When you configure the dashboard with updatable Business Activity Queries (BAQs), the dashboard behaves like a standard Epicor form allowing you to review and update data right from the form you create. Examples of updatable dashboards may include: • A form consisting of one updatable BAQ which displays Detail and List sheets. Users would use this updatable dashboard to enter and edit simple records. • A complex dashboard which contains multiple views, graphs, URL pages and so on. Some of the sheets or panels on this complex dashboard are updatable. • A mobile application which is sized appropriately for a specific mobile device. One or more sheets can be updated, and these sheets are either tabbed or sequentially paged to organize the flow of data entry. • A simple or complex application which has sheets and panels that support multiple dirty rows. You can then make a number of changes to a record, like selecting a series of check boxes across different rows, before you save all of these records to the database. Throughout the following workshops, you will work with existing updatable BAQs. For more information on the process of creating updatable BAQs, review Business Activity Queries course. Note To create updatable BAQs, you must have both the BAQ Advanced User and the BPM Advanced User priviliges set up in the User Account Maintenance > Options sheet. For more information, contact your system administrator.
44
Epicor ERP | 10.0.700
Advanced Dashboards Course
Updatable Dashboards
Workshop - Create Updatable Dashboard Create a new dashboard using updatable BAQs that displays customers and customer contacts. Using the dashboard you can retrieve a customer record and create new customer contacts or update existing ones. Navigate to the Dashboard. Menu Path: Executive Analysis > Business Activity Management > General Operations > Dashboard Important This program is not available in the Epicor Web Access.
Add Customer Query to Dashboard Create a new dashboard and add the standard system query that displays customer information. 1. From the New menu, select New Dashboard. 2. In the Definition ID field, enter XXX-CustContUpdate (where XXX are your initials). 3. In the Description field, enter Customer Contact Update. 4. From the New menu, select New Query. The Dashboard Query Properties window displays. 5. In the Query ID field, search for and select zCustomer01. 6. Navigate to the Publish sheet. 7. In the Publish Columns section, select the Customer_Company, Customer_Name and Customer_CustNum check boxes. 8. In the Titlebar Subscriber section, select the Publish to Title check box. 9. In the field above Title caption, select Customer_Name. 10. In the Title caption field, enter Customer: and click OK. 11. Navigate to the Dashboard sheet. 12. On the Standard toolbar, click Refresh and view the grid that displays customer information.
Modify Customer Grid Properties 1. In the tree view, right-click the zCustomer01 grid icon and select Properties. The Dashboard Grid Properties window displays. 2. In the Caption field, delete the content and enter Customer List. 3. In the Dashboard Grid Properties window, click OK. The new caption displays in the tree view and grid header.
Epicor ERP | 10.0.700
45
Updatable Dashboards
Advanced Dashboards Course
Add Updatable Query to Dashboard 1. From the New menu, select New Query. The Dashboard Query Properties window displays. 2. In the Query ID field, search for and select the EPIC06-UpdCustContacts query. 3. Navigate to the Filter sheet. 4. Enter the following information: Field
Data
Column Name
CustCnt_Company
Condition
= (equal sign)
Value
zCustomer01- CustomerTrackerQuery: Customer_Company
This condition states the company information must be equal for both queries. 5. Press Enter to add the second condition: Field
Data
Column Name
CustCnt_CustNum
Condition
= (equal sign)
Value
zCustomer01- Customer Tracker Query: Customer_CustNum
This condition matches customer numbers for both queries. When you select a customer from the Customer List grid, the related contacts for that customer display in the grid below. 6. In the Dashboard Query Properties window, click OK. 7. On the Standard toolbar, click Save.
Modify Contact Grid Properties 1. In the tree view, right-click the EPIC06-UpdCustContacts grid icon and select Properties. The Dashboard Grid Properties window. 2. In the Caption field, delete the content and enter Customer Contacts. 3. Select the Updatable check box. When you select this check box, on the General sheet, the Prompt check boxes display for each field, allowing you to select the fields you want to make updatable in the dashboard. 4. Verify all columns have the Visible check box enabled. 5. Click Update All.
46
Epicor ERP | 10.0.700
Advanced Dashboards Course
Updatable Dashboards
Notice the Prompt check box displays for all columns that allow data updates as defined in the EPIC06-UpdCustContacts BAQ. Important In the following workshop, you will use the Uptake from Excel functionality to update the Epicor application using the data displayed in the Customer Contacts grid. The Excel Uptake requires that the number of visible column has to match the number of updatable columns.
6. Clear the Visible check box for the following read-only columns: Field RoleCd_RoleDescription ShipTo_Name ShipTo_ZIP ShipTo_Company RoleCd_Company Customer_CustID CustCnt_RoleCode
7. Navigate to the Updatability sheet. The Multi Dirty Row and Allow Add New check boxes are settings that you establish in the Business Activity Query Designer, when you create an updatable BAQ. These fields control whether you can add or update multiple rows of data at one time. For more information on these fields, review Business Activity Queries course. Tip You can define custom Actions, which will become available in the dashboard's Actions menu. Use the Business Activity Query Designer to define actions and use them with Business Process Management Method Directives to run a specific method. For more information on Updatable BPM Directives, review Business Process Management course.
8. Navigate to the Add New Subscribers sheet. 9. Click New to add new line. 10. Enter the following information: Field
Data
Add New Subscriber Column
CustCnt_State
Publish From Query
Customer Tracker Query
Publish Column
Customer_State
This example shows how to add a new subscriber, that will default the Contact State from the Customer State (zCustomer01 query), when you add a new contact record. 11. In the Dashboard Grid Properties window, click OK.
Epicor ERP | 10.0.700
47
Updatable Dashboards
Advanced Dashboards Course
Add Tracker View for Contact Query You can use tracker views as an advanced search mechanism, and to create new or update updating existing records. 1. In the tree view, right-click the EPIC06-UpdCustContacts query icon an select New Tracker View. The Dashboard Tracker View Properties window displays. 2. In the Caption field, delete the content and enter Advanced Search. 3. Select the Updatable check box. 4. Click the Clear All button. 5. Select the Visible and Prompt check boxes for the following columns: Field CustCnt_LastName CustCnt_FirstName CustCnt_Name CustCnt_ContactTitle CustCnt_EmailAddress CustCnt_PhoneNum CustCnt_FaxNum CustCnt_State CustCnt_Company CustCnt_ConNum CustCnt_CustNum
6. In the Dashboard Tracker View Properties window, click OK. 7. In the dashboard, drag the Advanced Search sheet up and reposition it to the left of the Customer Contacts grid. 8. On the Standard toolbar, click Save.
48
Epicor ERP | 10.0.700
Advanced Dashboards Course
Updatable Dashboards
Test Updatable Dashboard 1. From the Tools menu, select Deploy Dashboard. 2. In the Deploy Dashboard window, click the Test Application button. The dashboard displays for testing. 3. On the Standard toolbar, click Refresh. 4. In the Customer Tracker Query pane, select the record for Dalton. The Customer Contacts grid populates with all contacts for this customer. 5. In the Customer Contacts grid, select any record and view the information that displays in the Advanced Search tracker. 6. In the E-Mail Address field, enter your email address. 7. On the Standard toolbar, click Save. The next step is to add a new contact record. 8. In the Customer Tracker Query pane, select the record for Clarke. 9. Navigate to the Customer Contacts sheet. 10. On the Standard toolbar, click New. In the Customer Contacts grid, the new blank row displays. 11. View the State/Prov field displays the state code. This is a result of the Add New Subscriber functionality that populates the column with the customer state information. 12. In the Name field, enter your full name. 13. On the Standard toolbar, click Save. You are created as the new contact with the next following contact number for the customer Clarke. Remain in the testing dashboard.
Verify the Created Record 1. In the Customer Tracker Query pane, in the Cust. ID column, right-click the record for Clarke and select Open With > Customer Display. Customer Display for the customer Clarke displays. 2. Navigate to the Contacts > List sheet and verify the grid displays your name. 3. Exit Customer Display. 4. Exit the testing dashboard. 5. In the Deploy Dashboard window, click Cancel.
Epicor ERP | 10.0.700
49
Updatable Dashboards
Advanced Dashboards Course
6. In the Customer Contact Update dashboard, on the Standard toolbar, click Save. Remain in the dashboard.
Add Order Status Query Add the zSalesOrderStatus query to the dashboard. The query provides data source to a simple chart that displays summary of all open order values for each customer. You add this chart view as a web part to the SharePoint site in later workshop. 1. From the New menu, select New Query. The Dashboard Query Properties window displays. 2. In the Query ID field, search for and select zSalesOrderStatus. 3. In the Dashboard Query Properties window, click OK. 4. In the dashboard, drag the Sales Order Status sheet up and reposition it to the right of the Customer Tracker Query grid. 5. Notice the Customer Tracker Query and Sales Order Status are on the same level. 6. On the standard toolbar, click the Refresh button to populate the data.
Add Chart View for Order Status Query 1. In the tree view, right-click the zSalesOrderStatus query icon an select New Chart View. The Dashboard Chart View Properties window displays. 2. In the Chart By (X axis) field, select CustID. 3. In the Chart On (Y axis) field, select Open Value. 4. In the Dashboard Chart View Properties window, click OK. 5. In the dashboard, drag the Chart View for zSalesOrderStatus sheet and reposition it to the right of the zSalesOrderStatus: Summary sheet. 6. In the Chart View for zSalesOrderStatus sheet, click the Settings tab. 7. In the Chart Type field, select PyramidChart3D. 8. In the Settings tab, click the Refresh button and view the chart. 9. Click Save.
50
Epicor ERP | 10.0.700
Advanced Dashboards Course
Updatable Dashboards
Workshop - Uptake from Excel The Uptake from Excel functionality allows you to add new records or update existing ones using a Microsoft® Excel® spreadsheet. The Uptake from Excel functionality uses an Open XML, which is an XML-based file format developed by Microsoft. It is the default document format for saving applications in Microsoft® Office® starting with Office 2007. To perform any data transactions using Uptake from Excel, the Excel spreadsheet needs to be saved as Microsoft Office Open XML Format Spreadsheet (*.xlsx). Important If you use previous versions of Microsoft Office, install the Microsoft Office Open XML compatibility pack. http://office.microsoft.com/en-us/products/HA101686761033.aspx Uptake from Excel supports multithreaded updates. Use this function to specify how many threads to use at a time to make updates. You can specify up to 10 submission threads. Example You can take 100 rows to update with a batch size of 20 using 5 threads. This would mean that the client would use 5 threads to send 20 records at a time to the server. You can also select to update the entire collections of rows at once. In the following example, create a spreadsheet that will add new ship-to contact record in the Customer Contact Update dashboard.
Create a Spreadsheet The first step in using the Excel Uptake is to create the spreadsheet. 1. In the Customer Contacts Update dashboard, navigate to the Customer List grid. 2. In the grid, select the record for the customer Dalton. 3. Navigate to the Customer Contacts grid. The grid displays the current contact(s) for the customer Dalton. 4. Select the record for Jim Shipler. 5. Right-click the record and select Copy Selection Include Labels. Note View other copy options, including Copy To Excel. You can use this option to launch Microsoft Excel and copy all data from the grid into a spreadsheet. If you apply any Group By settings in the grid, these will be retained in the spreadsheet. This functionality is available on all grids except in Dashboard runtime.
6. Launch Microsoft Excel. 7. In the Sheet1, select the A1 column. 8. Right-click and select Paste. The contact information displays in the spreadsheet. 9. Right below the second row, enter the following information:
Epicor ERP | 10.0.700
51
Updatable Dashboards
Advanced Dashboards Course
Field
Data
Name
your full name
E-Mail Address
your email address
Contact Num
enter the next following contact number (2)
Customer
9
Ship To
Plant2
10. In Microsoft Excel, click Save. The Save As window displays. 11. In the Save as type field, select Excel Workbook (*.xlsx) 12. In the File name field, enter XXX-contact (where XXX are your initials) and Save the file on your Desktop. 13. Exit Microsoft Excel.
Uptake from Excel 1. In the dashboard, from the Tools menu, select Deploy Dashboard. 2. In the Deploy Dashboard window, click the Test Application button. The dashboard displays for testing. 3. On the Standard toolbar, click Refresh. 4. In the Customer Tracker Query pane, select the record for Dalton. The Customer Contacts grid populates with all contacts for this customer. 5. Click in the Customer Contacts grid to activate the Uptake from Excel option. 6. From the Actions menu, select Uptake from Excel. The Excel Uptake Properties window displays. 7. Click the Browse button. 8. In the Open window, select Desktop. 9. Select the XXX-contact (where XXX are your initials) file you created and click Open. 10. In the Excel Uptake Properties window, select the Skip Header Row check box and click OK. The Customer Contacts grid populates with the information from the spreadsheet. Note In the grid, you may see identical rows. This is because you copied the information from the grid and then pasted it back. As long as these rows contain the same contact and customer numbers, once you click Save, they will not create separate records in the database.
11. On the Standard toolbar, click Save.
52
Epicor ERP | 10.0.700
Advanced Dashboards Course
Updatable Dashboards
12. The Multi Threaded Save window displays. Tip You may use this feature to specify how many threads to use at a time to make updates.
13. Click the Start button. 14. Once data is processed, click Close.
Verify the Created Record 1. In the Customer Tracker Query pane, in the Cust. ID column, right-click the record for Dalton and select Open With > Customer Display. Customer Display for the customer Dalton displays. 2. Navigate to the Ship To > List sheet. 3. In the List sheet, highlight the record for Plant2. 4. Navigate to the Ship To > Contacts > List sheet. 5. Verify the record you created displays in the grid. 6. Exit Customer Display. 7. Exit the testing dashboard. 8. In the Deploy Dashboard window, click Cancel. 9. In the Customer Contact Update dashboard, on the Standard toolbar, click Save. Remain in the dashboard.
Epicor ERP | 10.0.700
53
Updatable Dashboards
Advanced Dashboards Course
Workshop - Use Publish View Use the publish views functionality to publish views from one dashboard and make them available on another dashboard. The published view displays in the Available Views panel on any dashboard. This feature gives you a convenient way to display any view for reuse on another dashboard.
Publish View from Dashboard 1. In the tree view, right-click the Customer List grid icon and select Publish View. The Published View Properties window displays. Tip Another way to publish a view is to navigate to the Dashboard Grid Properties window and select the Publish View check box.
2. View the Dashboard Caption field that displays the source of the view. 3. In the Published Caption field, enter List of Customers. 4. In the Group field, enter XXX-Group (where XXX are your initials). Tip Use this field to assign views to specific groups, based on their functionality.
5. In the Description field, enter List of customers published from XXX-CustContUpdate (where XXX are your initials). 6. In the Published View Properties window, click OK. 7. From the View menu, select Published Views. At the bottom of the tree view, the Available Views panel displays the list of all published views within the Epicor application. 8. In the Available Views panel, verify List of Customers displays. When you hover over the published view, the description displays. 9. On the Standard toolbar, click Save. 10. On the Standard toolbar, click Close All to clear the dashboard. 11. To the warning message, click OK. 12. Remain in the dashboard.
Copy Standard Dashboard To use the published view functionality and add it to another dashboard, create a copy of a standard application dashboard. Note You cannot modify standard application dashboards.
54
Epicor ERP | 10.0.700
Advanced Dashboards Course
Updatable Dashboards
1. In the Definition ID field, search for and select QuoteStatus. 2. To the System Dashboard Warning message, click OK. The Opportunity/Quote Status Dashboard displays. 3. From the File menu, select Copy Dashboard. The Copy Dashboard window displays. 4. In the Definition ID field, enter XXX-QuoteStatus (where XXX are your initials) 5. In the Copy Dashboard window, click OK. 6. On the Standard toolbar, click Save. You can now make changes to the dashboard. 7. On the Standard toolbar, click Refresh to run the query and populate the dashboard data. Notice the Available Views panel displays the previously published Customer List view.
Load Published View 1. In the Available Views panel, select List of Customers and click the Load Published View icon. The Customer List displays in the tree view of the current dashboard. Tip Another way to load the published view is drag and drop the view from the Available Views panel to the tree view of the dashboard. The next step is to synchronize the information displayed by both queries using the publish and subscribe functionality. 2. In the tree view, right-click the zQuoteStatus query icon and select Properties. The Dashboard Query Properties window displays. 3. Navigate to the Publish sheet. 4. In the Publish Columns section, select QuoteHed.CustNum. 5. In the Dashboard Query Properties window, click OK. 6. In the tree view, right-click the zCustomer01 query icon and select Properties. The Dashboard Query Properties window displays. 7. In the Dashboard Query Properties window, navigate to the Publish sheet. 8. If necessary, in the Publish Columns section, for the Customer.CustNum column, clear the check box. 9. Navigate to the Filter sheet and select the following information: Field
Data
ColumnName
Customer.CustNum
Condition
= (equal sign)
Epicor ERP | 10.0.700
55
Updatable Dashboards
Advanced Dashboards Course
Field
Data
Value
zQuoteStatus- Opportunity Status: QuoteHed.CustNum
10. In the Dashboard Query Properties window, click OK. The information from both queries is now synchronized. 11. Navigate to the Open sheet and select quote lines for different customers. The Customer List grid below displays the information for the selected customer. 12. On the Standard toolbar, click Save. 13. On the Standard toolbar, click Close All to clear the dashboard. 14. To the warning message, click OK and remain in the dashboard.
56
Epicor ERP | 10.0.700
Advanced Dashboards Course
Mobile Device Dashboards
Mobile Device Dashboards The Epicor Everywhere Framework™ supports mobile dashboards which are rendered as web applications that may run on a number of mobile devices including BlackBerry® and iPhone™. Since the mobile dashboards that support Epicor Mobile Access are built using the dashboard technology and Updatable BAQ technology, it is simple to create web applications that implement business functionality on mobile devices. For a complete list of supported devices, review Application Help or contact your Epicor Customer Account Manager.
Workshop - Create Mobile Dashboard Learn how to create and deploy a mobile dashboard. In this workshop, use the previously created Customer Contact Update dashboard and create its mobile version.
Generate Mobile Dashboard 1. In the Definition ID field, search for and select the XXX-CustContUpdate (where XXX are your initials) dashboard. The dashboard displays. 2. From the Tools menu, select Generate Mobile Dashboard. The Generate Mobile Dashboard window displays. Tip This example shows how to create a mobile dashboard from the existing smart client dashboard. To create a new mobile dashboard from scratch, create a new dashboard definition and on the General sheet, select the Target Mobile Device check box.
3. In the New Definition ID field, enter XXX-MobileDashboard (where XXX are your initials). 4. Select the Show in Designer check box and click OK. The Generate Mobile Dashboard message displays. 5. To the message, click OK. 6. Verify the Mobile sheet displays. View the environment similar to a mobile device. 7. Click the Refresh button to populate the data. 8. Use the navigation buttons at the bottom to display the Customer List grid, the Customer Contacts grid, the Advanced Search tracker and the SalesOrderStatus grid. 9. Navigate to the General > Mobile Navigation > Flow sheet.
Epicor ERP | 10.0.700
57
Mobile Device Dashboards
Advanced Dashboards Course
This sheet displays the flow of forms that will display on a mobile device. Tip If you display more forms on your dashboard, you can use this sheet to set up a desired flow to better navigate in your dashboard.
10. Navigate to the General > Mobile Navigation > Jumps sheet. This sheet allows you to set up available jumps between all forms in your dashboard. Tip If you display more forms on your dashboard, you can set up more complex jump scenarios.
11. From the Tools menu, select Deploy Dashboard. The Deploy Dashboard window displays. 12. Select Generate Mobile Application and Available for Mobile Menu check boxes. By selecting these options you create a mobile device application from the current dashboard and make it available on the Mobile Menu. 13. Click Deploy. 14. Once finished, click OK. 15. On the Standard toolbar, click Save. Your mobile dashboard is now available for use. 16. Exit the dashboard.
Launch Epicor Mobile Access Important • To complete this task, Epicor Mobile Access must be installed and operational in your environment. To learn how to install EMA, review the Epicor 10 Supplemental Installations guide. For more information, contact your system administrator. • A user accessing the Epicor Mobile Access environment must have Allow Mobile Access privileges defined in User Account Maintenance. The images in this section display the Epicor Mobile Access application launched on the iPhone4® simulator. 1. Open the Epicor Mobile Access application on your mobile device. 2. Enter a valid Username and Password. Example manager/manager
58
Epicor ERP | 10.0.700
Advanced Dashboards Course
Mobile Device Dashboards
3. Click Login. 4. View the mobile Main Menu. • Use the Mobile Menu to launch mobile dashboards deployed for the selected company. • Use the System menu to configure display settings, select a company, site, theme and clear cache.
Epicor ERP | 10.0.700
59
Mobile Device Dashboards
Advanced Dashboards Course
Tip To learn how to use the System menu, where you can set up display parameters and appearance of mobile dashboards, review the Epicor Mobile Access topics within the Application Help.
60
Epicor ERP | 10.0.700
Advanced Dashboards Course
Mobile Device Dashboards
Use Mobile Dashboard 1. Select the Mobile Menu option. 2. From the list of mobile dashboards, select the XXX-Customer Contact Update dashboard you created.
The dashboard form displays. 3. On the Customer List grid, select the record for customer Addison.
4. Use the navigation buttons to select the Advanced Search form.
Epicor ERP | 10.0.700
61
Mobile Device Dashboards
Advanced Dashboards Course
The tracker displays the first contact for the customer Addison. Tip You can also use the combo box to jump to the form directly.
5. Click the Edit button. Since the mobile dashboard uses the updatable query as the datasource, you can use it to upload your customer contacts.
6. In the Phone field, enter the phone number of your choice. 7. Click the Save button. The contact is now updated. Tip You can optionally use the New button to create a brand new contact for the customer.
8. Click Log Off and exit the mobile access environment.
62
Epicor ERP | 10.0.700
Advanced Dashboards Course
Epicor SharePoint Publisher
Epicor SharePoint Publisher Epicor SharePoint Publisher (ESP) supports the creation of SharePoint web parts that directly link to Epicor ERP BAQs. Use this functionality to create SharePoint pages, that function as Epicor dashboards, supporting publish and subscribe between views. ESP supports updatability and links to Performance Canvas for embedded EEPM functionality. Important To use ESP, Microsoft® SharePoint® 2007, 2010, or 2013 must be installed and operational in your environment. To create a link between the Epicor application and Microsoft SharePoint, Epicor SharePoint Publisher must be installed on the server. For more information, see the Epicor 10 Supplemental Installations guide or contact your system administrator. The main ESP features include: • WinClient identical data render. • Data updatability supported. • Connection information and properties set up in Edit mode. • OrderBy and GroupBy functionality in grids. • Multi-Column data sorting • "Open with" functionality (Epicor Web Access must be installed and deployed in your environment ). • Links between Grid-Tracker-Chart-Gauge. • Grid View data export using context menu. • DSP (Epicor Performance Canvas) integration. • Customizable web part settings. • Support of URL/XSLT views (the path to an XSLT file must be a hyperlink to public accessible resource). • Customized Tracker views. • Single Sign-On for Windows machines in domain. • Asynchronous Grid/Chart/Gauge update. • A single click dashboard deployment (autoconnect feature). • BPM Informational Messages displaying. • All values in grids and trackers honor a format mask, defined for each particular field in BAQ Designer. • ESP supports all modern browsers (Microsoft® Internet Explorer®, Safari®, Mozilla Firefox®, Google Chrome™ ). • Web Dasher utility allowing you to manipulate SharePoint pages and web parts. The following options are available, when adding a Web Part: • Epicor Publisher Chart View • Epicor Publisher Gauge View • Epicor Publisher Grid View • Epicor Publisher Tracker View • Epicor Publisher URL/XSLT View
Epicor ERP | 10.0.700
63
Epicor SharePoint Publisher
Advanced Dashboards Course
• Epicor Publisher Top Navigator
64
Epicor ERP | 10.0.700
Advanced Dashboards Course
Epicor SharePoint Publisher
ESP Authentication The following graphic displays how Epicor SharePoint Publisher Authentication works.
Web user accesses SharePoint Dashboard web parts on SharePoint server in a De Militarized Zone (DMZ). SharePoint Dashboard web parts access Epicor server, which is the Active Directory in local network. Epicor server always checks credentials against Epicor database, no credentials check against Active Directory is performed. If Epicor server is located in the local network and Epicor client (or SharePoint server with SharePoint Dashboard) is out of it, then no any additional authentication has to be done except Epicor username/password. There are two scenarios of accessing Epicor SharePoint dashboard solution: 1.
Force user to enter Epicor credentials in SharePoint In this scenario, no Active Directory users are required. You may use Epicor UD tables to store user-defined parameters. First, create a new user in Epicor ERP and set up user-defined parameters via UBAQ/Dashboard. When user comes from Internet to a SharePoint server, he must supply Epicor credentials on SharePoint page. After that, SharePoint dashboard accesses Epicor BAQs on Epicor server via TCP protocol.
2.
Use Epicor Single-Sign-On (SSO) feature In this scenario, first add a new user to Active Directory. Then create new user in Epicor and specify SSO parameters for this user (map Epicor user to AD user in Epicor). After that, set up user-defined parameters via UBAQ/Dashboard. When user comes from Internet to a SharePoint server, he must identify himself against Active Directory. SharePoint dashboard accesses Epicor BAQs on Epicor server via TCP protocol; Epicor server resolves AD user in Epicor user (via SSO).
Epicor SharePoint Publisher uses a web service license. Epicor recommends buying sufficient web services licenses to avoid any performance penalties that occur when number of licenses is exceeded.
Epicor ERP | 10.0.700
65
Epicor SharePoint Publisher
Advanced Dashboards Course
Workshop - Create a Dashboard in Microsoft SharePoint In this workshop, create a dashboard using Microsoft SharePoint site. The dashboard you create displays the grids, the tracker view and the chart view from the XXX-CustContUpdate dashboard you created earlier. Web Parts are an integrated set of controls for creating web sites that enable end users to modify the content, appearance, and behaviour of web pages directly from a browser. All dashboard web parts access the Epicor application server directly; no web services or other intermediate layers are used. The following graphic shows the dashboard created in Microsoft SharePoint, when it is complete. Refer to this screen as you go through the workshop.
Create New Document Library Important The process of creating a document library and web part page varies across Microsoft SharePoint products. The following steps apply to the Microsoft SharePoint 2013 environment. To learn how to create a library and page using Microsoft SharePoint 2010, refer to the Epicor SharePoint Publisher topics within the Application Help. Navigate to the Microsoft SharePoint web site. Example http:///default.aspx
1. On the Home Page, click the Add lists, libraries, and other apps tile.
66
Epicor ERP | 10.0.700
Advanced Dashboards Course
Epicor SharePoint Publisher
2. Select the Document Library option.
3. On the Adding New Library window, click the Advanced Options link. 4. In the Name field, enter My Web Parts as the name for your library. 5. In the Description field, enter Web Parts Library as the description for your library. 6. For the Create a version each time you edit a file in this document library? option, select No. 7. In the Document Template field, select Web Part page. 8. Click Create.
Epicor ERP | 10.0.700
67
Epicor SharePoint Publisher
Advanced Dashboards Course
The library becomes available for selection on the left side of the SharePoint page.
Create a New Web Part Page 1. Click the My Web Parts library. 2. Click Files and select the New Document option.
68
Epicor ERP | 10.0.700
Advanced Dashboards Course
Epicor SharePoint Publisher
3. In the Name field, enter XXX-Customer Dashboard (where XXX are your initials). 4. In the Choose a Layout Template box, accept the default option Header, Footer, 3 Columns. If this option is not selected by default, select it. 5. Click the Create button. The Web Part Page displays in Edit Mode.
Explore Web Part Settings In this task, explore the available SharePoint Web Part settings and options. 1. In the Header section, click the Add a Web Part button. 2. From the Categories list, select Miscellaneous. The list of all available ESP Web Parts displays.
Epicor ERP | 10.0.700
69
Epicor SharePoint Publisher
Advanced Dashboards Course
3. From the Web Parts list, select the Epicor Publisher Grid View check box and click Add. Epicor Dashboard Grid View displays at the top of the page and it needs to be set up. 4. Click the No dashboard selected, please setup webpart information. The Epicor DashBoard Grid View properties window displays at the right of the page. Use this window to set up all necessary controls for the web part. Note All Web Parts share a common set of properties that control their appearance, layout, and advanced characteristics.
5. Click the + sign next to the Appearance group to expand it. Use the Appearance settings to change title name, height, width, and to control the way the web part displays on the page. 6. In the Title field, delete the content and enter Customer List. 7. Collapse the Appearance group and expand the Layout group. 8. View the following settings: • Hidden - Specifies whether the Web Part is visible when a user opens the Web Part Page. • Direction - Specifies the direction of the text in the Web Part content. • Zone - Specifies the zone on the Web Part Page where the Web Part is located. • Zone Index - Specifies the position of the Web Part in a zone when the zone contains more than one Web Part. 9. Collapse the Layout group and expand the Advanced group.
70
Epicor ERP | 10.0.700
Advanced Dashboards Course
Epicor SharePoint Publisher
10. View the following settings: • Allow Minimize - Specifies whether the Web Part can be minimized. • Allow Close - Specifies whether the Web Part can be removed from the Web Part Page. • Allow Hide - Specifies whether the Web Part can be hidden. • Allow Zone Change - Specifies whether the Web Part can be moved to a different zone. • Allow Connections - Specifies whether the Web Part can participate in connections with other Web Parts. • Allow Editing in Personal View - Specifies whether the Web Part properties can be modified in a personal view. • Export Mode - Specifies the level of data that is permitted to be exported for this Web Part. • Title URL - Specifies the URL of a file containing additional information about the Web Part. • Description - Specifies the ScreenTip that displays when you rest the mouse pointer on the Web Part title or Web Part icon. • Help URL - Specifies the location of a file containing Help information about the Web Part. • Help Mode - Specifies how a browser will display Help content for a Web Part. • Catalog Icon Image URL - Specifies the location of a file containing an image to be used as the Web Part icon in the Web Part List. • Title Icon Image URL - Specifies the location of a file containing an image to be used in the Web Part title bar. • Import Error Message - Specifies a message that displays if there is a problem importing the Web Part. • Target Audiencies - This feature helps target groups and individuals with specific pages, Web Parts, and content. With the help of audience targeting feature, content can be targeted in a site for viewing by one or more specific audiences. 11. Collapse the Advanced group and expand the Grid settings group. 12. View the following settings: • Allow user to add additional group by fields - When selected, a user can add additional group by fields in a grid by using the drag and drop functionality. • Grid edit mode - The main goal of this setting is to optimize performance of your SharePoint dashboards, as editable grids run slower than simple read-only grids. View the list of options: • Manual - When selected, the grid initially displays in the View mode. When you double click on the grid, the grid enters the Edit mode, allowing you to perform updates. After you make an update, the grid switches back to the View mode. Tip In the dashboard runtime, you can also switch between modes by using the Switch VIEW/EDIT mode option in the drop-down menu found in the grid's top-right corner. • AlwaysOn - When selected, the grid is always rendered in the Edit mode and cannot be switched to the View mode. • AlwaysOff - When selected, the grid is always rendered in the View mode and cannot be switched to the Edit mode. • Fill grid with data on initial render - This option controls if grid populates with data automatically, when you display a dashboard. Typically, you would disable this option for a dashboard (grid) that contains a lot of data when not filtered. Therefore, this control should not be used without a filter. • Grid Skin - This control modifies the appearance of the grid.
Epicor ERP | 10.0.700
71
Epicor SharePoint Publisher
Advanced Dashboards Course
• Use paged render of grid - This option controls the paging functionality. When used, a value you enter specifies how many records per page you want to store on the server. This value defines how many records are saved together in one page (result set). Tip In many situations, the paging feature improves performance. This functionality stores result sets, or pages, in a temporary directory on the server. You define how many records are included in each page. After the cached pages are stored in this directory, the data request process can then move through each page instead of processing all of this information at once.
13. Collapse the Grid settings group. 14. Remain in the Edit Mode.
Load the Available Views In this task, establish the connection to the customer contact update dashboard you created previously. Use the single click dashboard deployment functionality to load all available views at once. Tip The below steps discuss how to create a connection between Microsoft SharePoint and Epicor ERP application. Depending on your environment settings, you may need to work with your system administrator to complete this task. 1. In the ICE 3 Server field, verify or enter your application server URL. Tip Get the correct URL that points to the application server from the .sysconfig file that runs this instance of the Epicor application. You can find this value in configuration setting. In your Epicor application folder, the .sysconfig files are located in the client\config folder. Example
72
Epicor ERP | 10.0.700
Advanced Dashboards Course
Epicor SharePoint Publisher
2. Optionally, select the Enable Single Sign-On check box. Single sign-on (SSO) is a property of access control of multiple, related, but independent software systems. With this property a user logs in once and gains access to all systems without being prompted to log in again at each of them. 3. Optionally, select the Require Credentials check box to ask user for credentials once a new session is opened. 4. Click the More settings link to view the Epicor Web Access address. This field enables browser-based access to the Epicor application directly from Microsoft SharePoint. Epicor Web Access (EWA) functionality allows you to right-click a field and use the "Open With" functionality to access related web forms. If EWA is installed in your environment, enter your Epicor Web Access site URL in this field. 5. In the Epicor Login / Password fields, verify or enter an appropriate credentials used to access the Epicor application. When the Single Sign-On is enabled, Epicor Login / Password fields are hidden. 6. Click Apply. 7. In the Current company field, verify or select a company. In this example, select Epicor Education.
Epicor ERP | 10.0.700
73
Epicor SharePoint Publisher
Advanced Dashboards Course
8. In the Dashboards to display section, click the Switch Dropdown / Textbox button. 9. From the Dashboards to display list, select XXX-CustContUpdate (where XXX are your initials) dashboard you created. Important Notice the available dashboard views display below the selected dashboard. Here, you have an option to select (load) one or more views to display within the web part you modify. In this example, load all available views at once and then, arrange them on the SharePoint page using the drag and drop functionality. This example shows how to deploy a SharePoint quickly, without having to modify each web part individually. Example
10. Verify all check boxes next to available views are selected. 11. Click Apply to remain in the Edit Mode. Notice that all available views display within the Header section. You may need to scroll down to view the entire SharePoint page. In the following task, use the drag and drop functionality to move the views into the appropriate sections within the page.
74
Epicor ERP | 10.0.700
Advanced Dashboards Course
Epicor SharePoint Publisher
Arrange Views Within the SharePoint Page 1. While in the Edit Mode, scroll down to see the three middle sections and the footer section of the page. 2. Click the zSalesOrderStatus: Summary web part box and move it down towards the Footer section. 3. When the red line displays in the Footer section, below the Add a Web Part control, release the mouse. The view is now a part of the footer section of the SharePoint page. Tip You may use the graphic found within the Workshop - Create a SharePoint Dashboard topic for a reference.
4. Use steps 2 - 3 to move the Customer Contacts grid to the Left Column section of the page. 5. Use steps 2 - 3 to move the Advanced Search grid to the Middle Column section of the page. 6. Use steps 2 - 3 to move the Chart View for zSalesOrderStatus grid to the Right Column section of the page. 7. Once complete, the layout of the page is as follows: Section
View Name
Header
Customer List
Left Column
Customer Contacts
Middle Column
Advanced Search
Right Column
Chart View for zSalesOrderStatus
Footer
zSalesOrderStatus: Summary
8. In the top - left corner, click Stop Editing to switch to a standard view.
View the ESP Dashboard 1. View the XXX-dashboard (where XXX are your initials) dashboard in Microsoft SharePoint. 2. Notice the following changes must be performed to make the dashboard more user friendly and to correctly display data: • The Customer List grid occupies a big portion of the screen and it needs to be shrinked. • The zSalesOrderStatus: Summary grid needs to be shrinked and data can be grouped by customer.
Adjust the ESP Dashboard To change any web part settings, navigate back to the Edit Mode. 1. Click Site Actions and select Edit Page. The dashboard displays in Edit Mode.
Epicor ERP | 10.0.700
75
Epicor SharePoint Publisher
Advanced Dashboards Course
Example
2. In the Header box, click Web Part Menu and select Edit Web Part. Example
3. Click the + sign next to the Paging settings group to expand it. 4. Select the Use paged render of grid check box. Tip In many situations, the paging feature improves performance. This functionality stores result sets, or pages, in a temporary directory on the server. You define how many records are included in each page. After the cached pages are stored in this directory, the data request process can then move through each page instead of processing all of this information at once.
5. In the Records per page field, enter 5. This value defines how many records are saved together in one page (result set). 6. Click Apply and click OK.
76
Epicor ERP | 10.0.700
Advanced Dashboards Course
Epicor SharePoint Publisher
Now modify the zSalesOrderStatus: Summary grid at the bottom. 7. In the Footer box, click Web Part Menu and select Edit Web Part. 8. Click the + sign next to the Paging settings group to expand it. 9. Select the Use paged render of grid check box. 10. In the Records per page field, enter 5. 11. Click More settings. 12. In the Group results by field, select Cust. ID. 13. Click Apply and click OK. 14. In the Customer List box, click Web Part Menu and view Connections > Send Baq DashBoard Data To > Customer Contacts. This connection means the Customer List provides the information to the Customer Contacts grid below, using the publish and subscribe functionality.
Important All relationships between views are properly placed and defined without any extra user efforts. All these relationships have already been defined in the customer update dashboard created in the win client.
15. In the Customer Contacts box, click Web Part Menu and view Connections > Get Baq DashBoard Data From > Customer List. This is the opposite part of the previous connection where the Customer Contact grid receives data from the Customer List grid. The publish and subscribe functionality synchronizes data in the Customer Contacts grid to only display contacts for the customer selected on the Customer List grid. Tip You can check other views to see what BAQ data they send and receive.
16. In the top left corner, click Stop Editing. Tip If the dashboard is too wide to fit on screen, navigate back to the Edit Mode and use the Appearance group to modify width of web parts. You can also control the width of columns in a grid. To resize a column, hover the mouse pointer between column captions and notice the mouse pointer
Epicor ERP | 10.0.700
77
Epicor SharePoint Publisher
Advanced Dashboards Course
changes. Now you can press and hold the left mouse button to change the column's width. You can use this feature in both grouped and plain grids.
Test the ESP Dashboard Important To use the context menu functionality within this task, Epicor Web Access must be installed and deployed in your environment. 1. View the information that displays on the SharePoint dashboard. 2. In the Customer List grid, select Addison. 3. In the Customer Contacts grid, turn on the edit mode by using the Switch VIEW/EDIT mode option in the drop-down menu found in the grid's top-right corner. Tip You can also access the edit mode by double-clicking on the grid. The Cancel, Add Contact and Update buttons display under the Customer Contacts grid. Tip Recall the switching between view/edit modes in updatable grids is controlled by the Grid edit mode option found in the grid web part settings. For more information, review the Explore Web Part Setting topic in this workshop.
4. Click the Add Contact button. Note Adding new records using this view is possible because the underlying uBAQ that provides the data source has the Allow New Records control selected on the Update > General Properties sheet. The blank row displays at the bottom of the grid. 5. Notice the State/Prov populates. Recall this is a result of the Add New Subscriber functionality that populates the column with the customer state information. 6. In the blank row, double-click on each field listed below and enter the following information: Field
Data
Last Name
Enter your last name.
First Name
Enter your first name.
Name
Enter your full name.
E-Mail Address
Enter your email address.
Contact Num
3
Customer
2
7. Click Save. The grid switches back to the read mode.
78
Epicor ERP | 10.0.700
Advanced Dashboards Course
Epicor SharePoint Publisher
8. In the Customer Contact grid, select the record you created and view details in the Epicor DashBoard Tracker View. 9. In the Customer List grid, in the Cust. ID column, right-click Addison and select Open With Customer Entry. 10. In the Login window, enter your User ID and the Password, for example, manager/manager. The Epicor Web Access form for Customer Entry displays. 11. Navigate to the Contacts > List sheet and view the record you created. 12. Exit Customer Entry web form. 13. Exit Microsoft SharePoint.
Epicor ERP | 10.0.700
79
Conclusion
Advanced Dashboards Course
Conclusion Congratulations! You have completed the Advanced Dashboard course.
80
Epicor ERP | 10.0.700
Additional information is available at the Education and Documentation areas of the EPICweb Customer Portal. To access this site, you need a Site ID and an EPICweb account. To create an account, go to http://support.epicor.com.
