auto print course - système de gestion intégrée d'entreprise (sgi) epicor · 2017-09-15 ·...

Epicor ERPAuto Print Course10.1.500

Disclaimer

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

EDE8921905

90521-10-9215-5831001

10.1.500

Revision: July 25, 2016 4:46 p.m.

Total pages: 34

course.ditaval

Contents

Auto Print Course...................................................................................................................5Before You Begin....................................................................................................................6

Audience.........................................................................................................................................................6

Prerequisites....................................................................................................................................................6

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

About Auto Print....................................................................................................................9Workshop - Auto Preview an SSRS Report.........................................................................10

Locate the Check Box....................................................................................................................................10

Locate the OrderHed Table............................................................................................................................10

Add Standard Directive..................................................................................................................................11

Add an Action...............................................................................................................................................12

Define Report Parameters..............................................................................................................................12

Enable Data Directives....................................................................................................................................13

Test the BPM.................................................................................................................................................13

Workshop - Auto Print an SSRS Report...............................................................................15SSRS Report - Create a Data Directive............................................................................................................15

Define the Condition.....................................................................................................................................15

Select the Report...........................................................................................................................................16

Set Up Report Options...................................................................................................................................17

Set Up Report Parameters..............................................................................................................................18

Activate the Directive.....................................................................................................................................18

Test the Auto Print Action..............................................................................................................................19

Workshop - Email an SSRS Report.......................................................................................21Create a Data Directive..................................................................................................................................21



Set Up Email Options.....................................................................................................................................23




Workshop - Auto Print Bartender Labels............................................................................27Review the Report Style.................................................................................................................................27

Create a Data Directive..................................................................................................................................28



Set Up Report Options...................................................................................................................................29



Create a Sales Order......................................................................................................................................31


3Epicor ERP | 10.1.500

ContentsAuto Print Course

Conclusion.............................................................................................................................33

Epicor ERP | 10.1.5004

Auto Print CourseContents

Auto Print Course

This course illustrates how you use a Business Process Management (BPM) data directive to automatically printand distribute reports.

Use the Auto Print action to preview, print, e-mail, or fax a report when a data directive executes. You canautomatically print SSRS reports, Crystal reports, Bartender labels, and Outbound EDI documents.

The course workshops demonstrate how to automatically display a print preview of a SQL Server® Reporting

Services (SSRS) report, print an SSRS report, send an SSRS report to selected recipients as an e-mail attachment,and generate Seagull Scientific BarTender

® labels.

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

• Understand the purpose of the auto print functionality.

• Work with Business Process Management (BPM) data directives.

• Define conditions that activate the Auto Print action.

• Link the Auto Print Ready check box to a data directive. This check box is available for use on AR Invoice Entry,Sales Order Entry, and other programs.

• Learn how to find and select a report for automatic printing.

• Configure the Auto Print action to preview, print, e-mail, and/or fax a selected report.

• Configure report styles and data directives to automatically print BarTender labels.


Auto Print CourseAuto Print Course

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

• Department Manager

• Project Team Leader

Prerequisites

To complete the workshops in this course, the necessary modules must be licensed and operating in your trainingenvironment. For more information on the modules available, contact your Epicor Customer Account Manager.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 userinterface modes - Classic Menu and Modern Shell Menu. Workshops focus on each of these modes andguide you through each navigational principle introduced.

• Database Concepts Course - This course reviews the table and field name identification process using FieldHelp, Customization Tools, and the Data Dictionary Viewer functionality. It also describes table linkingprocedures and requirements as well as join type definitions and specifications.

• System Flow Course - This course introduces a basic quote to cash scenario that includes the process fromthe initial customer quote to final cash receipts and payment of supplier invoices. This course emphasizes theseries of processes that make up the quote to cash process by using a simple scenario to highlight varioustransactions. Your organization may have more complex processing routines than those described in thiscourse.

Recommended Industry Knowledge:

• Knowledge of your current Epicor ERP application.

• Understanding of relational database concepts such as tables, table relationships, records, and field types.

• General knowledge of Seagull Scientific's BarTender application and the Commander program.


Auto Print CourseBefore You Begin

Environment Setup

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

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

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

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

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

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

• The Epicor demonstration database is at the same version as the Epicor application. Thedemonstration database is installed from the Epicor Administration Console using the "Add DemoDatabase" command under Database Server. See Epicor ERP installation guides for details. If you are anEpicor Cloud ERP customer (and have licensed embedded education), the demonstration database isinstalled for you.

• Your system administrator restored (refreshed) the Epicor demonstration database prior tostarting this course. The Epicor demonstration database comes standard with parts, customers, salesorders, and so on, already defined. If the Epicor demonstration database is shared with multiple users(that is, the database is located on a server and users access the same data, much like your live, productionenvironment) and is not periodically refreshed, unexpected results can occur. For example, if a courseworkshop requires you to ship a sales order that came standard in the Epicor demonstration database,but a different user already completed this workshop and the Epicor demonstration database was notrestored (refreshed), then you will not be able to ship the sales order. If you are an Epicor Cloud ERPcustomer see section below.

2. Verify, or ask your system administrator to verify, that a printer is shared on the network and can be accessedfor the course workshops.

3. Log in to the training environment using the credentials manager/manager. If you are logged into yourtraining environment as a different user, from the application Home Page click Settings to open the SettingsPage, and then choose Change User under General Options.

4. From the Menu, select the company Epicor Education (EPIC06).

5. From the Menu, select the Main Site.

6. Verify, or ask your system administrator to verify, that the shared network printer (from Step 2) has beenadded to Printer Maintenance and is configured correctly:

a. Launch Printer Maintenance. Navigate to System Management > Reporting > PrinterMaintenance.

b. On the Detail sheet, click Printer ID to open the Printer Search dialog box.

c. Search for the printer using its network name or just click Search to retrieve all printers.


Before You BeginAuto Print Course

d. Select the printer, and click OK.

Tip If you need to add printers to the Epicor ERP application, review the printer informationfrom the desktop. Click Start > Devices and Printers. Right-click a printer icon; from the contextmenu, select Printer Properties. Use the values from this window to set up the new printer recordin Printer Maintenance. Note that because the printer is already set up on your system, you onlyneed to enter the printer name in the Network Path field.

e. On the Detail sheet, verify that SSRS Printer is selected and verify that the Description field containsa value. A description is required for the printer to be included on selection lists in the application.

f. Click Save to apply any changes and then close Printer Maintenance.

7. To complete the Workshop - Email an SSRS Report, on the Company Maintenance > Email andReporting sheet, your network's Server Mail Transport Protocol (SMTP) Server must be configured. Thisinformation varies from company to company. If needed, contact your IT Specialist to obtain this informationbefore you begin this course.

8. To be able to test Auto Print for BarTender Labels, the BarTender and Commander applications must beinstalled and configured to pick up and process the .bt output file generated by the Auto Print action. Verify,or ask your system administrator to verify these applications are installed on your server.

Epicor Cloud ERP Specific Information

Note If you are an Epicor Cloud ERP customer, then note the following about your Epicor-hosted educationcompany. All logins referenced in the course (such as manager, or epicor) should be changed to be the<site ID>-. For example, if your site ID is 98315, then wherever you are instructed to use the login manager,instead use 98315-manager. The password is the same as the login name.

Note To refresh your Epicor training data, send a request that includes your site ID [email protected]. Refreshing your training data may take up to 72 hours after the request isreceived.


Auto Print CourseBefore You Begin

About Auto Print

You use the auto print feature to immediately print, preview, and/or send reports. When users enter or updatedata in selected columns, the report renders using the actions and parameters you define.

To leverage this feature, you set up a Business Process Management (BPM) standard data directive with an AutoPrint action in its workflow. Introduced in Epicor 10, the BPM Auto Print action replaces the Business ActivityManager Auto-Print event used in previous Epicor ERP releases.

Through Business Process Management, you create workflows that automate, execute, and monitor businessprocesses and data entry. A Standard data directive is a set of conditions and actions associated with a specificdatabase table, so these directives track data changes. In Data Directives Maintenance, the BPM WorkflowDesigner has a library of configurable actions you leverage to create data directives that launch auto printingbased on triggers ranging from a single statement to multiple statements designed with custom C# code.

For example, you can create a BPM data directive based on the JobHead table that auto prints the Job Travelerreport by monitoring the Required By field on a job record. When users update the Required By date and savethe job, the data directive activates, causing the Auto Print action to run. This action specifies what printer touse and which data parameters need to be passed to the report. The Job Traveler then prints on the selectedprinter in your production center, alerting your production team about the job change.

You can also use automatic printing to distribute the report to key individuals. For example, you could create adata directive that automatically emails Sales Order Acknowledgments to specific customer contacts. Likewise,you could set up a directive that e-mails new purchase orders to managers for review.

The Auto Print action is a flexible feature. It can just run a single auto print task like a print preview. Howeverwhen you indicate you want to print the report on a client or server printer, you can also set up the action tosimultaneously send the report as an e-mail attachment and/or a fax. Likewise if you select the Email/Fax printaction, you can send out the report through both an e-mail attachment and a fax.

Tip You can further customize how the report auto prints by designing routing rules. Routing rules activatewhen the Auto Print action runs, and they help you streamline reporting for specific business needs. Theycan be simple rules that define an alternate report style users run when they need to print a report usinga unique format, or complex rules that divide, or break, the report run into multiple dataset partitionswhich they can link to separate rendering workflows.

For more information, review the Routing Rules section in the application help, the Reporting Tools chapterin the Implementation User Guide, and/or the SQL Server Reporting for Epicor ERP course.


About Auto PrintAuto Print Course

Workshop - Auto Preview an SSRS Report

Some programs have an Auto Print Ready check box. By default, this check box does not do anything. Howeveryou can set up a data directive to monitor this check box.

In this workshop, you will create a data directive which monitors the OrderHed table. When users select theAuto-Print Ready check box on a sales order and click Save, the sales order displays in a print preview window.

Locate the Check Box

You first need to locate the Auto Print check box.

1. Navigate to Sales Order Entry.

Menu Path: Sales Management > Order Management > General Operations > Order Entry

2. Navigate to the Summary sheet.

3. Locate the Auto-Print Ready check box.

4. Now click the Header tab to display the Header > Detail sheet.

5. Locate the Auto-Print Ready check box.

You next create the data directive that monitors this check box.

Locate the OrderHed Table

1. Navigate to Data Directives Maintenance.

Menu Path: System Management > Business Process Management > Data Directives Maintenance

Important This program is not available in Epicor Web Access.

2. Click the Table button.

3. The Table Search window displays.

4. Verify Search by Table option is selected.

5. In the Table Name Starting At field, enter Order.

6. Click Search.

7. Select OrderHed and click OK.

Epicor ERP | 10.1.50010

Auto Print CourseWorkshop - Auto Preview an SSRS Report

Data directives are based on a table. Selecting a table adds it to the Data Directives tree view, making it availablefor you to create data directives. When a table has existing data directives configured for it, those directivesdisplay on the tree view under the table node.

Add Standard Directive

The Auto Print feature is only available on Standard data directives.

1. Click New and select New Standard Directive.

2. In the Directive Name field, enter XXX-Auto Print (where XXX are your initials).

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

4. Click Design to launch the BPM Workflow Designer.

5. Click the Condition icon and drag it to the workflow pane of the Designer, below the Start element.

6. Add a connection between the Start and Condition elements.

7. In the workflow, click the Condition element.

8. In the Condition pane at the bottom, click the Add Line icon.

For this exercise, you will insert one condition statement. However a Condition action can have multiplestatements that execute in the order you arrange them on this tab.

9. In the Condition statement, click the drop-down list and select The specified field has been changedfrom any to another.

10. Click the specified link; the Select Table Field(s) window displays.

11. In the Table field, verify ttOrderHed displays.

12. From the list of available fields, select the AutoPrintReady check box and click OK.

13. Click the any link.

14. Clear the Any Value check box.

15. In the Value field, select false and click OK.

16. Click the another link.

17. Clear the Any Value check box.

18. In the Value field, select true and click OK.

The directive now displays the following:

• The ttOrderHed.AutoPrintReady field has been changed from False to True

When a user selects the Auto-Print Ready check box on Sales Order's Summary or Header sheets, this Conditionelement will evaluate to True. Any actions linked to the True workflow activate.

11Epicor ERP | 10.1.500

Workshop - Auto Preview an SSRS ReportAuto Print Course

Add an Action

1. In the workflow elements toolbar, click the Auto Print icon and drag it below the Condition element.

2. Connect the Condition's True exit point to the Auto Print element.

3. Select the Auto Print workflow element.

4. In the Actions pane, verify Automatically print specified report with selected options with ruledisplays.

5. Click the first specified link. The AutoPrint Report Search window displays; verify the Basic tab is active.

6. In the Report Type, verify SQL Server Reporting (SSRS) displays.

7. In the Report Table Level field, verify 'OrderHed' is the Primary table displays.This limits the Search Results grid to only display reports where OrderHed is the primary table.

8. Click Search.

9. From the list, select OrderAck (Sales Order Acknowledgment) and click OK.

10. Click the second specified link. The Set up Auto Print window displays.

11. In the Run Schedule field, select Immediate.

This means the action executes right after the condition resolves to True.

12. For the Print Action, select Auto Preview.

13. You want to display the Sales Order Acknowledgments in a .pdf viewer. For the Output Format, verify thePDF option displays.

Define Report Parameters

Now to complete the auto print action, you specify the report parameters. On this sheet, you define the actionsassociated with the listed parameters so values are passed to the report in the context of the Auto Print action.

1. Select the Report Parameters sheet.

Tip You find out which parameters a report uses by activating the trace log.

2. For the OrderList parameter, click the arrow on the right-hand side and select The specified expression.

3. Click the specified link to launch the Specify C# expression window.

4. In the Available variables pane, expand the Temp-tables > ttOrderHed node.

5. Double-click the OrderNum field.

Epicor ERP | 10.1.50012


6. Now from the Functions pane, expand the String node.

7. Double-click the x.ToString() function.

8. Verify the ttOrderHedRow.OrderNum.ToString() expression displays.

9. Click OK.

10. Scroll down and view the SSRSEnableRouting parameter. By default, this parameter is se to True. Sincethere are no routing rules defined for the Job Traveler report in Report Style Maintenance, choose not toapply routing rules:

a. Click the True constant.

b. In the Specify a Value window, select false.

c. Click OK.

d. Select the Report Options sheet. Verify the Apply Routing label displays in red.

11. In the Set up Auto Print window, click Apply and then OK.

The action statement now displays as the following:

• Automatically print OrderAck report with selected options with rule

The Auto Print action is now set up to generate and display a print preview of the Sales Order Acknowledgment.

Enable Data Directives

1. Click the Validate button and verify BPM reports no errors.

2. Click Save and Exit to return to the Data Directives window.

3. Select the Enabled check box to activate the directive.

4. Click Save.

5. Minimize Data Directives Maintenance.

Test the BPM

1. Return to Sales Order Entry.


2. Click New.

3. In the Customer field, enter Dalton and press Tab.

4. Click New > New Line.

13Epicor ERP | 10.1.500

Workshop - Auto Preview an SSRS ReportAuto Print Course

5. On the Lines Detail sheet at the bottom, enter the following details:

ValueField

DSS-1010Part

10Order Quantity

6. Select the Auto-Print Ready check box.

7. Click Save.

The Sales Order Acknowledgment report appears in a preview window. It displays the current sales order.

Epicor ERP | 10.1.50014


Workshop - Auto Print an SSRS Report

This workshop takes you through creating and testing a Business Process Management (BPM) data directive thatauto prints an SSRS report in response to a record change. During this workshop, you cause the Job Traveler toprint when users update a job record.

SSRS Report - Create a Data Directive

You begin by creating a data directive that monitors the Job Header (JobHead) table.

1. Navigate to Data Directives Maintenance.



2. On the Detail sheet, click in the Table field. Enter jobhead and press Tab.

3. In the tree view, select the JobHead node.

4. From the New menu, select Choose New Standard Directive.A new directive node is added under JobHead.

5. Navigate to the Standard > Detail sheet.

6. For Directive Name, enter XXX Auto Print Job Traveler, where XXX are your initials.

7. Accept the default values that populate the other fields.

8. Click Save.

Define the Condition

You now launch the BPM Workflow Designer to create the data directive.

1. Click the Design button.The BPM Workflow Designer window displays.

2. Select the Condition action element and drag it to the workflow design area.

3. Click on the Start element to display its connections; drag one of them to a connection arrow on theCondition action element.

4. Select the Condition element.

5. On the Condition tab at the bottom of the workflow design area, click the New button.

15Epicor ERP | 10.1.500

Workshop - Auto Print an SSRS ReportAuto Print Course

6. Click the arrow on the right side of the Condition column and choose the There is at least one updatedrow in the specified table statement.

7. Use the default updated option.

8. Click specified link.The Select Table dialog box displays.

9. Now click OK to select ttJobHead (the data directive table).

Note For this condition statement, you can only select a table. You cannot select a field even thoughthe fields display on this dialog box.

You have configured the Condition element. Now whenever a user changes a value on the JobHead table, thecondition evaluates to true.

Select the Report

You next add the Auto Print action element to the data directive.

1. Select the Auto Print action element and drag it to the workflow design area.

2. Place your cursor over the Condition action to display its connections; drag its True connection to aconnection on the Auto Print action.

When the condition statement resolves to True, it activates the Auto Print action.

3. Select the Auto Print action element.

The Action tab at the bottom of the workflow design area displays an action statement. You need to adjustsome items on this statement to set up how the report will print.

4. Click specified report link.The Auto Print Report Search dialog box displays. In the Report Type field, the default option is SQLServer Reporting. Use this report type for this workshop.

5. For Report ID, enter jobtrav.

6. Click Search.

7. In the Search Results list, select the JobTrav report that has Standard - SSRS displayed in the StyleDescription column.

8. Click OK.In the action statement, note that specified changes to JobTrav.

Epicor ERP | 10.1.50016

Auto Print CourseWorkshop - Auto Print an SSRS Report

Set Up Report Options

You can now define some print options for the Job Traveler report.

1. Click specified options link.The Set Up Auto Print dialog box displays with the Report Options tab in focus. The available choices onthis tab are based on report type (SSRS in this workshop).

2. For Run Schedule, choose Immediate.

This indicates the report generates immediately when the data directive activates.

Tip If you select the Queued option, the report task is placed as a task on the server queue. Whenthe other tasks before the report task complete, this report task runs. Select this option when youcan wait for the report to generate; this option improves performance by reducing the chance toomany tasks run on the server at the same time.

3. For the Print Action, select Auto Print. This sends the report directly to the printer.

4. From the Output Format drop-down list, select the PDF option.

5. For the optional User Description, enter Job Traveler Auto Print.

This text displays in the System Monitor to help you locate a specific run of this report.

6. For the Printer option, select the Server radio button and choose the network printer defined in PrinterManagement to support these course workshops.

For SSRS reports, the list only shows SSRS printers.

Other printer options:

• When the application is configured to support it, selecting Use Default Printer causes the applicationto automatically select the printer. The application first checks the workstation for a default printer. Ifthe workstation does not have a printer defined, the application next checks the current company. Theprinter defined on the current company then runs. You select default printers in WorkstationMaintenance and Company Maintenance.

• You can choose Client and select a client-based printer. Select or accept the available printer and clickOK to use the client printer with the Auto Print action. Be aware a message will display advising you theclient printer option is not recommended for SSRS reports.

7. For Print Quantity, accept the Constant radio button and the value of 1.

This indicates only one copy of the report is sent to the server printer.

Tip Select the Dynamic radio button when you want users to decide how many copies to print. Youselect the table and field that contains a numeric value. During runtime, users enter a value in thistable/field that indicates the number of copies to run at the printer.

17Epicor ERP | 10.1.500


Set Up Report Parameters

You next must define parameters for the report; these parameters define the data that populates the generatedreport. For this workshop, you will configure a report parameter to pull in the job number (ttJobHead.JobNum)for the job record that changed.

1. Select the Report Parameters tab.

2. In the Parameter Name column, select the Jobs parameter.The parameters list is assembled from the fields for the selected report.

3. From the Actions column (be sure the Jobs parameter is still selected), click the Down Arrow and selectThe specified table and field value option.

4. Click the specified link.The Select Table Fields(s) dialog box displays. The ttJobHead table (the data directive table) is alreadyselected. You cannot change this value.

5. In the fields list, choose JobNum.

6. Click OK.You return to the Report Parameters tab. The Action column now displays:

• The ttJobHead.JobNum table and field value

7. Scroll down and locate the SSRSEnableRouting parameter.

8. Click the True constant and set it to False. The Action column now displays:

• The false constant

9. Click Apply and then OK.This closes the Set Up Auto Print dialog box. Your return to the workflow designer.

Activate the Directive

Now complete the Auto Print action element and activate the data directive.

1. From the action statement, click the with rule link.The Execution Rule window displays. Use the rule options on this window to determine how multipleunsaved, or dirty, rows update in the selected table.

2. Depending on the table selected for the data directive, different rule options are active. Select the For eachmatching radio button option.

3. Now click the table drop-down list to select the temporary table (tt) that uses the execution rule. Verify thetable drop-down list displays the ttJobHead (temporary table).

Epicor ERP | 10.1.50018


Tip Temporary tables contain the updated rows in memory before they save to the actual database.When you define a row rule, you determine how the Epicor ERP application updates multiple unsavedrows to the database.

4. Click OK.You return to the BPM Workflow Designer.

5. Click the Validate button to check for errors.

6. Click Save and Exit to save your workflow.You return to Data Directives Maintenance.

7. On the Standard > Detail sheet, select the Enabled check box.

8. Click Save.


The data directive is ready to test.

Tip The enabled data directive will trigger an Auto Print action every time a job record changes. This willcontinue until the data directive is manually disabled by clearing the Enabled checkbox on the data directive.If this condition statement causes the Job Traveler to print too often, you could change this example sothe data directive monitors a specific field instead.

Test the Auto Print Action

Make a change to a job record to verify that the Auto Print action triggers and prints the Job Traveler report forthe changed job record.

1. Navigate to Job Entry.

Menu Path: Production Management > Job Management > General Operations > Job Entry

2. On the Job sheet, click the Job... button.The Job Search dialog box displays.

3. Click Search to retrieve a list of available jobs.

4. From the Search Results grid, select job 2056 and click OK.

Tip You can choose another job as well. The auto print is set to launch from a change to any job.

The selected job displays in Job Entry.

5. Make a simple change to the job. For this example, change the Priority from NORMAL to Very High.

6. Click Save.

7. Now either launch the System Monitor from your Windows Tray or from the Epicor ERP application.

Menu Path: System Setup > System Maintenance > System Monitor

19Epicor ERP | 10.1.500



8. Select the Reports tab.A new line displays for the Job Traveler report, so your change launched the Auto Print task.

9. Retrieve the report from the printer selected in your Auto Print action report options.

Epicor ERP | 10.1.50020


Workshop - Email an SSRS Report

You can set up an Auto Print action to generate a report as an e-mail attachment. When users activate the datadirective, the report renders using a selected output format, such as a .pdf, and then is automatically sent toselected recipients.

For this workshop, you once again create another data directive that monitors an Auto Print Ready check box,in this case the Auto Print Ready check box within AR Invoice Entry. When users select this check box and savethe invoice, the AR invoice generates as a .pdf file and then is sent to a recipient as an e-mail attachment.

Create a Data Directive

1. Return to Data Directives Maintenance.



2. On the Detail sheet, click in the Table field. Enter InvcHead and press Tab.

In the tree view, the InvcHead node now displays.

3. Select the InvcHead node.

4. Click the Down Arrow next to the New button. Select New Standard Directive.A new Standard directive node is added under the InvcHead node.

5. Navigate to the Standard > Detail sheet.

6. For Directive Name, enter XXX Email AR Invoice (where XXX are your initials).

7. Click Save.



1. Click the Design button.The BPM Workflow Designer window displays.

2. Select the Condition element and drag it to the workflow design area.

3. Click on the Start element to display its connections; drag one of them to a connection arrow on theCondition element.

4. Select the Condition element.

21Epicor ERP | 10.1.500

Workshop - Email an SSRS ReportAuto Print Course


6. From the condition statement drop-down list, select The specified field has been changed from any toanother option.

7. Click specified link.The Select Table dialog box displays.

8. In the Fields text box, enter au.This filters the field options that display in this dialog box.

9. Select the AutoPrintReady check box.

10. Click OK.You return to the BPM Workflow Designer. The condition statement now reads:

• The ttInvHead.AutoPrintReady field has been changed from any to another

11. Click the any link.The Specify a Value dialog box displays.

12. Clear the Any value check box.The Value drop-down list activates.

13. You want this condition to monitor when users select the Auto Print Ready check box. Verify the falseoption displays in this dialog box.

14. Click OK.You return to the BPM Workflow Designer.

15. Click the another link.The Specify a Value dialog box displays.

16. Clear the Any value check box.The Value drop-down list activates.

17. From this drop-down list, select the true option.

18. Click OK.You return to the BPM Workflow Designer. The condition statement now reads:

• The ttInvHead.AutoPrintReady field has been changed from False to True

You have configured the Condition element.

Select the Report

You next add an Auto Print action element to the data directive and select the report that renders through thisBPM action.

1. In the BPM Workflow Designer, select the Auto Print action element and drag it to the workflow designarea.

Epicor ERP | 10.1.50022

Auto Print CourseWorkshop - Email an SSRS Report

2. Place your cursor over the Condition action to display its connections; drag its True connection to aconnection on the Auto Print action.

This indicates that when the condition statement resolves to True, it activates the Auto Print action. Whena user selects the Auto Print Ready check box, the condition activates this Auto Print action.


Notice the Actions tab displays this statement:

• Automatically print specified report with selected options with rule

4. Click the specified report link.The Auto Print Report Search dialog box displays.

5. Use the fields on the Basic tab to find and select the specific report to automatically print. In the ReportType field, verify the SQL Server Reporting option is selected.

6. In the Report Table Level field, select the 'InvcHead is used by the Report' option.

7. Click Search.The Search Results grid displays the report styles that match your search. A series of ARForm report stylesdisplays on this drop-down list.

8. Select an ARForm that uses the Standard - SSRS report style.

Tip You create report styles in Report Style Maintenance. You create styles to generate customversions of reports you design in Microsoft

® SQL Server Report Builder

®. Styles can also have routing

rules that define how the report output renders. For more information, review the Report StyleMaintenance and Routing Rules sections in the application help and the Reporting Tools chapter inthe Implementation User Guide.

9. Click OK.

You return to the BPM Workflow Designer. The action statement now reads:

• Automatically print ARForm report with selected options with rule

Set Up Email Options

You now set up an Auto Print action to generate the AR invoice as an e-mail attachment.

1. Click the specified link.The Set up Auto Print window displays.

2. From the Print Action drop-down list, select Email/Fax.

3. Determine the Run Schedule for this report. Select the Immediate option.

This causes the report to be placed at the top of the system agent queue and renders before other taskswaiting in the queue. Because you want to immediately send the email after a user selects the Auto PrintReady check box, you select this option.

23Epicor ERP | 10.1.500


4. Optionally enter a User Description to help identify the instance of this report. For this example, enterAuto Email for AR Invoice.This text displays in the System Monitor to help you locate an archived report.

5. Now click the Email/Fax Setup... button.The E-Mail/Fax window displays; verify the E-Mail sheet is active.

6. In the Subject field, enter AR Invoice Review.

7. The Attachment Type defines the format of the electronic file. The report generates using this file typeand then the Auto Print action attaches this report file to the email. Notice you can select XML, PDF, Word,and other file format types. For this workshop, select the PDF option.

8. Enter who will receive this e-mail in the E-Mail To field. You can enter one or multiple e-mail addresses inthis field. For this example, enter your email address.

9. Use the E-Mail Body field to enter any additional text you want to include with the report. This text displaysin the message pane on the email window. For this example, enter "A new AR invoice is ready for yourreview. This AR invoice is attached."

10. Click OK.You return to the Set up Auto Print window.


You next define the parameters you need to populate the report.

To render the selected AR invoice, you need to populate the ttInvcHead.InvoiceNum column with the currentinvoice number. This invoice data then can populate the AR Invoice Form, and the report renders its data in the.pdf format, creating the e-mail attachment.

1. Click on the Report Parameters tab.

2. Select the InvoiceNum parameter.

3. Now from the Action column, click the drop-down list. Select The specified table and field value option.

4. Click the specified link.The Select Table Field(s) window displays.

5. In the Fields text box, enter "In".The fields that begin with the "In" characters display on the grid.

6. Select the InvoiceNum check box.

7. Click OK.The Action column now displays "The ttInvcHead.InvoiceNum table and field value" statement.

8. Locate the SSRSEnableRouting parameter at the bottom and set it to False. Verify the parameter reads:

• The False constant

9. Click Apply.

Epicor ERP | 10.1.50024


10. Click OK.


Now finish the Auto Print action element and activate the data directive.



3. On the Standard > Detail sheet, select the Enabled check box.

4. Click Save.



To test this Auto Print directive, you first create a miscellaneous invoice in AR Invoice Entry. After you select theAuto Print Ready check box and click Save, the report generates and is sent as an email attachment.

1. Launch AR Invoice Entry.

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

2. From the Group > Detail sheet, click the Group... button to find and select an invoice group. Select agroup from the current fiscal year.

3. Click File > New > New Miscellaneous Invoice.The Header > Detail sheet displays.

4. Click the Sales Order... button.The Sales Order Search window displays.

5. From the Order Type drop-down list, select Open.

6. Click Search.The Search Results grid populates with open sales orders.

7. Select a recent sales order and click OK.Information from the selected sales order displays on the Header > Detail sheet.

8. Now click the Down Arrow next to the New button; select New Line.

9. Click the SO Line/Rel button.The Order Release Search window displays.

10. Select one of the selected sales order's detail lines. Click OK.Information from the selected detail line displays on the Line > Detail sheet.

25Epicor ERP | 10.1.500


11. Now return to the Header > Detail sheet.

12. Select the Auto-Print Ready check box.

13. Click Save.

The AR Invoice renders as a .pdf file and attaches to an e-mail. This e-mail displays in your inbox. To check onthe progress, launch the System Monitor. When the report process is complete, it displays on the History Taskssheet.

Epicor ERP | 10.1.50026


Workshop - Auto Print Bartender Labels

Setting up Auto Print for a Bartender Labels report is similar to setting up Auto Print for SSRS reports. You firstreview a report style for the Bartender label report and then create an Auto Print data directive.

You can currently set up these Bartender labels in the Epicor ERP application:

• GenInv

• GenJob

• GenQA

• GenSO

• GenShip

• GenRcpt

For this workshop, you create a data directive that causes a change in Customer Shipment Entry to automaticallygenerate shipping labels. Once the shipping label (.bt) file is sent to the server, the BarTender

® Commander

®

application intercepts the .bt file and sends it to the printer.

Review the Report Style

You first review a report style that outputs the bartender labels to a folder on the server.

1. Navigate to Report Style Maintenance.

Menu Path: System Management > Reporting > Report Style


2. In the Report ID field, enter GenShip and press Tab.

3. Navigate to the Styles > Detail sheet.

4. Verify the following report properties:

ValueField

Bartender LabelsReport Type

GenShipData Definition

reports/CartonSinglePart.btwReport Location

5. Make sure the Output Location field is blank.

Bartender labels automatically generate in the C:\EpicorData\Bartender\<CompanyID> folder, so youdo not need to specify an Output Location.

6. Exit Report Style Maintenance.

27Epicor ERP | 10.1.500

Workshop - Auto Print Bartender LabelsAuto Print Course

Create a Data Directive

Create a BPM standard data directive that includes a Condition that activates the Bartender Auto Print action.

1. Return to Data Directives Maintenance



2. On the Detail sheet, click in the Table field and enter ShipHead. Press Tab.The table displays on the tree view.

3. From the New menu, select New Standard Directive.

On the tree view, a new directive node is added under the ShipHead node.

4. On the Standard > Detail sheet, for Directive Name, enter XXX Ship Auto Print (where XXX are yourinitials).



1. Click the Design button.The BPM Workflow Designer launches.

2. Select the Condition element and drag it to the workflow design area.

3. Select the Start element to display its connection arrows; drag any one of these arrows to a connection onthe Condition element.

4. Now to configure a condition statement, select the Condition element.


6. From the Condition drop-down list, select The specified field has been changed from any to anotherstatement.

7. Click the specified link.The Select Table Fields(s) dialog box displays. The ttShipHead table (the data directive table) is alreadyselected and you cannot change this value.

8. In the fields list, select the ShipStatus check box.

9. Click OK.

The Condition statement now displays:

• The ttShipHead.ShipStatus field has been changed from any to another

Epicor ERP | 10.1.50028

Auto Print CourseWorkshop - Auto Print Bartender Labels

Now whenever the Status value on a customer shipment changes, this condition resolves to true.

Select the Report

1. Select the Auto Print action and drag it to the workflow design area.

2. Place your cursor over the Condition action to display its connections and drag its True connection to theAuto Print action.


Notice the Actions tab displays this statement:

• Automatically print specified report with selected options with rule

4. Select the report that will auto print. Click the specified report link.The Auto Print Report Search dialog box displays. Verify you are on the Basic tab.

5. For Report ID, type genship.

6. For Report Type, select Bartender Labels.

7. For Report Table Level, select 'ShipHead' is used by the Report.

8. Click Search.

9. In the Search Results list, select the GenShip report.

10. Click OK.In the Action statement, note that specified changes to GenShip.

Set Up Report Options

You can now define print options for the bartender labels.

1. Click specified options link.The Set Up Auto Print dialog box appears. Verify the Report Options tab is selected.

2. For Run Schedule, select the Immediate option.

3. For the Print Action, select the Auto Print option.

While you can set up automatic printing for bartender labels, the actual report is not sent to the printer.Instead the printer name is placed in the Bartender header file. The BarTender Commander application thenintercepts the .bt file and sends it to the printer defined in the header file.

4. For User Description, enter Print Ship Label.

5. For the Printer option, select Server and choose the network printer that supports these course workshops.

29Epicor ERP | 10.1.500


Tip When the application is configured to support it, choosing the Use Default Printer radio buttonoption causes the system to automatically select the printer. The system first attempts to use thedefault label printer at the workstation. However if the default printer is not set as a label printer, itwill then use the default label printer defined in Company Maintenance.

6. For Print Quantity, select Constant and enter 1.This causes the Auto Print action to only print one copy of the shipping labels.


You next define the parameters you need to populate the Bartender labels.

1. Select the Report Parameters tab.

2. In the Parameter Name column, select the PackNum parameter.The parameters list is assembled from the fields for the selected report.

3. In the PackNum row in the Action column, click the Down Arrow and select The specified table andfield value option.

4. Click specified link.

The Select Table Fields(s) dialog box displays. The ttShipHead table (the data directive table) is alreadyselected and you cannot change this value.

5. In the fields list, select the PackNum check box.

6. Click OK.You report to the Report Parameters tab. The Action column now displays:

• The ttShipHead.PackNum table and field value.

7. Click Apply and OK.This closes the Set Up Auto Print dialog box. You return to the workflow design area.




3. Click the Enabled check box.

4. Click Save.


The data directive is ready to test.

Epicor ERP | 10.1.50030


Important The enabled data directive will trigger an Auto Print action every time a shipment is completedand marked as closed. This will continue until the data directive is manually disabled by clearing the Enabledcheckbox on the data directive's Standard > Detail sheet.

Create a Sales Order

Create a sales order for the packing slip.

1. Navigate to Sales Order Entry.


2. From the New menu, select New Order.

3. In the Customer field, enter Addison and press Tab.

4. Navigate to the Lines > Detail sheet.

5. From the New menu, select New Line.

6. In the Part/Rev field, enter DCD-400-KB and press Tab.

7. In the Order Quantity field, enter 10.

8. In the Need By field, enter the date one week from today's date.

9. Click Save.

10. Navigate to the Summary sheet and record the sales order number _________.

11. Exit Sales Order Entry.


Complete an order shipment to trigger the Auto Print action in your BPM data directive.

1. Navigate to Customer Shipment Entry.

Menu Path: Material Management > Shipping / Receiving > General Operations > Customer ShipmentEntry

2. From the New menu, select New Pack.

3. Navigate to the Lines > Customer Shipment Entry > Detail sheet.

4. From the New menu, select New Line.

5. In the Order Number field, enter the sales order number created in the previous exercise and press Tab.

6. Click Line/Rel, click Search, select the record, and click OK.

31Epicor ERP | 10.1.500


7. Navigate to the Summary sheet.

8. From the Actions menu, select Close.

9. Click Save.

10. Exit Customer Shipment Entry.

Closing and saving the order triggers the Auto Print action, which writes the .bt file to theC:\EpicorData\Bartender\<CompanyID> folder on your server. The .bt file is read by the BartenderCommander application and sent to the printer identified in that file.

11. You can verify the report printed through the System Monitor:

a. Access the System Monitor from either your Windows Tray or from the Epicor ERP application.

Menu Path: System Setup > System Maintenance > System Monitor

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

b. Review the Generic Shipping line on the Reports sheet.

Tip When no .bt file generates, use the System Monitor to troubleshoot the problem. Click theHistory Tasks tab, locate the corresponding task line, and verify whether the Status field indicatesERROR. With the task line selected, click Detail and review the error message.

Epicor ERP | 10.1.50032


Conclusion

Congratulations! You have completed the Auto Print course.

33Epicor ERP | 10.1.500

ConclusionAuto Print Course

Additional information is available at the Education andDocumentation areas of the EPICweb Customer Portal. To access

this site, you need a Site ID and an EPICweb account. To create anaccount, go to http://support.epicor.com.

http://support.epicor.com

auto print course - système de gestion intégrée d'entreprise (sgi) epicor · 2017-09-15 ·...

Documents