Reporter Tutorial: Intermediate Refer to the following sections for guidance on using these features of the Reporter: Lesson 1 Data Relationships in Reports Lesson 2 Create Tutorial Training Report Lesson 3 Modify Report Criteria Options Lesson 4 Conditional Formatting Lesson 5 Smart Report WorkCenter Popup Lesson 6 Smart Criteria Lesson 7 Email Reports Lesson 8 Schedule Reports Lesson 9 Export Reports For complete reference information on the Maintenance Connection Reporter, refer to the Online Reporter Guide available from the Help Menu. The following additional Reporter Tutorials are available from MC User Connect: Reporter Tutorial Basic: Overview, Copy Report, Report Groups, Report Preview Window, Report Criteria, Field Selection, Sorting/Grouping, and Charting. Reporter Tutorial Advanced: Custom Expressions, Modifying Fixed Criteria, Editable Smart Reports, Custom Group Headers, and Summary Reports. Reporter Tutorial Pivot Reports: Instructions for creating Pivot Reports, an easy to use method for presenting aggregated or summary data. 1 P age
Lesson 1 Data Relationships in Reports It is helpful to understand the data relationships that make up reports, and how these relationships affect your report presentation and the options that are available to you. Each module (or Report Group) includes a set of basic reports defined with a simple, one-to-one relationship between available data files. For example, the many Work Order Lists found in the Work Order Report Groups are simple reports with data available from the work order table and each work order s associated asset. The relationship between the primary table (work order) and secondary table (asset) is one-to-one in the below example as there is only one primary asset record associated with each work order (the asset defined on the Work Order Details tab). As such, it is very easy to report on asset and work order information together on the same row/record of the report: The more complex reports in each Report Group have one-to-many relationships between available data files. As an example, Work Order Labor reports are available that list the actual labor hours (and/or costs) associated with each work order. In this situation, there can be many actual labor records tied to the same work order. For example, let s look at a work order to clean up graffiti found at a park that required two individuals to finish the job (one to clean up and one to repaint a couple weeks later). In this situation, if we place the work order and work order labor information on the same level in the report, the work order information is duplicated, as it is the same work order referenced for each actual labor record: If we want the information to be presented more hierarchically to avoid this duplication, one-to-many reports like this often include sorting/grouping defined on the primary record. That is, we can define the work order (WO#) as the first level of sort and group at this level. This avoids duplication of information that is common to all records in the group, and creates a nice summary calculation of data displayed: 2 P age
There are several examples of data maintained in Maintenance Connection that involve these more complex data relationships. One excellent example is the one-to-many relationship when reporting against multiple assets linked to a work order through the Tasks tab. Additionally, there can be many training/certification records for a given labor resource (staff member), or many asset downtime records for a given asset. When reporting against this type of data, be sure to plan for the appropriate level of grouping and/or total calculations to ensure that your information will be presented as desired. 3 P age
Lesson 2 Create Tutorial Training Report Let s create a report to use for this tutorial: 1. Select the Work Order (Closed) Reports folder on the left: 2. The Report List on the right will display all reports currently in the selected Work Order (Closed) Reports group/folder. Locate the Closed Work Order List and select it (you can search for %list to quickly locate it). Once it has been selected, click Copy Report (alternatively, you can right click on the Report Name and select Copy Report): 3. The report will open in the Report Copy window, showing standard options for Report Setup. At the top of the window, enter a name for your report, such as Your Name Closed Work Order List TEST. It is helpful to put the word TEST in reports used for training, so that they are easily identified later. 4. Specify a Repair Center in the Managed By prompt if the report should only be viewable by a particular Repair Center. To make the report viewable by all, select All Repair Centers. The logged in user s Repair Center will be shown by default. 5. Click on the Groups tab, and then the Custom Groups sub-tab. Ensure that this report is designated for inclusion in your desired Report Group. This makes it easier to locate the report in the future. 4 P age
6. Click Apply when you are finished and you will return to the Report Lookup. The new report is likely to display by default, depending on what it was named and the Managed By Repair Center to which it was associated. If your new report does not display by default, modify the filters at the top or page through the Report List to locate it. Now you are ready to modify your new report as needed. 5 P age
Lesson 3 Modify Report Criteria Options The field prompts that display in the Report Criteria window will vary depending on the report in use. The options available can be tailored to exclude prompts that will not be used and/or add prompts that are not shown. In the new report we just created, we will add a prompt to filter report data based on the date the work order was completed (WO.Complete). For closed work order reports, the Completed or Closed date is often preferred, rather than filtering by Target date. 1. From the Report List, select the report that you created in Lesson 2, and then select Run Report. 2. The Report Criteria window will open for this report. 3. To add the date the work order was completed (WO.Complete) to the options displayed, double click on the words Report Criteria at the top of the dialog: 4. The Manage Report Criteria Fields dialog will display. Note: You must be a member of an access group with permission to modify this dialog in order to use this feature. Contact your System Administrator if this window does not display for you. 5. To add the WO.Complete field, we must find it in the list. The Work Order (WO) Table will be selected by default, so you only need to scroll alphabetically until the WO.Complete field is displayed. 6 P age
6. Select WO.Complete from the list on the left and then click the right arrow adjacent to the list to move the field onto the Display fields list in the middle of the dialog. Note: The field will move to the bottom of the Display fields list, so it may not be visible initially. 7. Scroll to the bottom of the Display fields list and click on your newly added field to select it. The field should now be showing and selected in both the Display Fields and SQL Where columns: 8. To move this field so that it appears at the TOP of the Report Criteria dialog, click the top up arrow several times, until the field is at the top of the list: 7 P age
9. Now let s remove the Target Date field to ensure there is no confusion between these prompts. Select the Target Date field from the Display fields list and click the left arrow to the left of this list: 10. When you have finished making these two changes, click the Apply button at the top of the dialog: 11. The Report Criteria window will display. Do not be concerned that your changes are not yet showing. You must first Apply or Cancel out of this window in order to have your changes take effect. Click Cancel to return to the Report List. 12. Select your report and click Run Report again. When the Report Criteria window displays, Complete should be listed at the top and Target Date should no longer display. 13. For date fields like Complete there is one more step that needs to be taken to allow selection of the predefined date filters. Select the operator dropdown next to Complete (it should indicate is within by default). Change the selection to is and then switch it back to is within. The appropriate date filter options should now be available. 8 P age
14. Select an option from the available dropdown that will return a record set for this tutorial: 15. Add any additional filtering you desire in order to appropriately limit the returned data at your organization (e.g., Repair Center, Location, etc.). 16. Click the Save Criteria option in the lower left of the Report Criteria dialog and then click Apply to run the report: 17. The report should open in the Report Preview window. 18. For this particular lesson, we are not concerned about the contents displayed in the Report Preview window, so we will return to Report Setup to proceed to our next lesson. Note: If you need to add an ID field (such as Zone ID) to Report Criteria options, contact Maintenance Connection Support for assistance in defining the correct relationship to ensure the field option dropdown is presented correctly. Tip: The Manage Report Criteria Fields dialog requires that you know actual table column names (rather than the user-friendly label from the data dictionary). If you do not know the actual name of a field, locate it on the WorkCenter Page and click the field label (right click for an indicator/checkbox). The help popup will display, showing information on the field. The name shown in the second row is the actual column name, which is used to define custom report criteria. In the below example, WO.UDFBit3 would be listed in the Manage Report Criteria Fields window, even though it displays in the interface as Guest Impact. 9 P age
Lesson 4 Conditional Formatting You can use conditional formatting to apply special formatting when the value in a given field meets a certain criteria. Let s modify our report to place a red border around work orders that exceed a particular dollar amount: 1. If you are continuing from Lesson 3, return to Report Setup. Alternatively, access Report Setup for any Closed Work Order Report that can be modified for training purposes. 2. In order to perform a calculation based on Total Cost, we need to ensure that this field is included on our report. Let s modify our field list to include the field that stores this information. This field is called [WO] Cost Total Actual. Locate the field in the Available fields list and move it to the Display fields list: 3. Let s also add the Work Order Complete Date to the report, and remove extraneous fields that are not needed. Add and remove fields until your Display fields list looks similar to the following: 4. Click on the Style/Format tab and then click on the Format 1 sub-tab. Up to 3 different conditional formatting criteria can be defined (Format 1, Format 2, and Format 3): 10 P age
5. In the Criteria Type dropdown control, select Numeric, indicating that the criteria will be based on a numeric value: 6. An Operator field will appear to specify the operator for your expression. Since we wish to highlight all work orders with a cost greater than a particular amount, we will use the operator greater than. 7. A Value field prompt will display. Enter an appropriate number for your organization. For example, you could enter 75.00 in the field prompt. 8. In the Apply Criteria To prompt, you must indicate the column in your report on which the calculation should be based. Looking at the Display fields list the Total Cost field is the fourth field/column displayed, so we will select Column 4: 9. In the Limit Criteria to prompt, we will leave the value Report Data. If we only wished to have this conditional formatting apply to group totals, this prompt could be used to specify this. 10. The style for this conditional display can be defined using available predefined dropdown values, or by using the Style Editor. Let s use the available dropdown options first. From the Format Type field, let s select Red Border/Background to ensure the value stands out. We will set this to show in the Cell, rather than the Row. Notice how the Reporter automatically populates the HTML Style Tag based on your selection this does not need to be altered. 11. Your page should now appear similar to the following: 11 P age
12. Click Apply when you are finished to view your results: The Total Cost column is highlighted (and bordered) in red for all work orders with a total cost over $75.00. Also notice that the Format Criteria defined is specified above the report output so that report viewers will understand what the formatting means. Using the Style Editor In addition to the predefined dropdown options, a Style Editor is also available to assist in defining conditional formatting styles in reports. To use the Style Editor, return to Report Setup: 12 P age
1. Click on the Style/Format tab and then click on the Format 1 sub-tab. 2. Note that to the right of the Format Style field there is an Edit Style Icon. 3. Click the Edit Style icon and the Style Editor will open, defaulted to define the Content and Text style. 4. Use the available options in the Content and Text section to set the font family, size, style, color and alignment. By default, the font family will be set to Arial, font size to 10 point, font color to black, and alignment to left. These settings will be applied if not otherwise set/modified. Text Size can be modified by entering a number into the available prompt, or by sliding the available control. Font color can be modified by clicking on a desired color. Indicators are available to set the font style to bold or italic. Alignment can be set as desired. Padding can be used to increase the space around the text. 5. As modifications are made, changes to font color, size and style will be shown in the area in the upper right, and the associated HTML for the style will be shown in the lower right: 13 P age
Tip: The content field can be modified if you wish to enter additional text to better see how the changes will appear. 6. To modify another style parameter, click on the appropriate tab. The options displayed will change to reflect those available for the given selection. For example, selecting Border and Outline will present the following options: 7. The same process can be used to set a Background color (click the Background tab). 8. When you are finished setting a style, click the Apply button in the upper right. The Style Editor will close, and you will be returned to the Report Setup window. 9. To view the style you have set in the Report Preview window, click Apply. 14 P age
Lesson 5 - Smart Report Popups Reports can include smart actions, which allow you to click on a row/column displayed in a report and open the respective record or a defined report. You can even use smart features to allow editing of report fields from within a report, or updates to status (e.g., Issue work orders). In this tutorial, we will demonstrate how to connect a record in a report to its associated work order. 1. If you are continuing from Lesson 4, return to Report Setup. Alternatively, access Report Setup for any Work Order Report that can be modified for training purposes. 2. Click on the Smart Elements tab and turn Smart Mode On from the default Smart Settings sub-tab: 3. Select the Smart Actions sub-tab. From this sub-tab, we can specify the type of smart action to enable. 4. Select Row (Single Smart Action per Row) from the Smart Action Type dropdown control: 5. Additional fields will display to define the desired action. From the Smart Action dropdown control, ensure Popup WorkCenter is displayed. 6. In our example, we will allow the user viewing the report to open the work order listed. To enable this, scroll to the bottom of the Smart Action Field Value dropdown control and select [WO]WO: 15 P age
7. In the Smart Action Tool Tip field, enter Click here to open this work order. Your page should appear as follows: 8. Click Apply when you are finished to view the defined smart action in the report. 9. Hold (hover) your mouse over a report row. Notice that the row becomes highlighted and the tool tip you specified is shown: 10. Click on a desired row. The Work Order Work Center should pop up, displaying the work order identified in the report: 11. Click the Close button in the upper right corner to return to the Report Preview window. 12. Select the Setup icon to return to the Report Setup window, so that we can set this popup to be columnspecific. 16 P age
13. Return to the Smart Elements tab and select the Smart Actions sub-tab. 14. Change the Smart Action Type to Column (Multiple Smart Actions per Row). The remaining prompts on this page will disappear. 15. Now, a smart action can be defined for each given column. Select the [WO] Work Order # field/column in the Display fields list and click the Edit button below the list. 16. In the Report Field Options dialog that is displayed, set the Smart Action control (in the middle of the dialog) to Popup Work Center. 17. Additional fields will display to specify the type of popup. Set the fields as shown below: 18. Click Apply to close the Report Field Options dialog. Click Apply again to save your changes and return to the Report Preview window. 17 P age
19. Notice how the Work Order # field is now the only field that highlights and is connected to the Work Order popup. This allows you to choose different actions for other columns in the report. For example, the Asset Name field could popup the Asset record or a defined report. 18 P age
Lesson 6 - Smart Criteria Smart Criteria is a very powerful feature that allows you to dynamically filter data presented in the Report Preview window until desired results are displayed. Smart Criteria works as a supplement to any criteria defined using the Report Criteria dialog, meaning it is added to any criteria already defined. Let s use Smart Criteria to further filter our displayed report. The Smart Criteria option is typically hidden in the Report Preview window. Let s return to Report Setup to make it display by default for this report: 1. If you are continuing from Lesson 5, return to Report Setup. Alternatively, access Report Setup for any Work Order Report that can be modified for training purposes. 2. Click on the Smart Elements tab and select the Smart Criteria sub-tab. 3. Change the Default State to Shown. This will ensure that the Smart Criteria Pane displays automatically each time this report is opened. The Smart Criteria Pane will also remain open as you toggle between Report Preview and Report Setup. 4. In the Default Smart Criteria prompt, enter the first field you would like to perform the dynamic filtering against. Common choices are Shop, Type, Problem, Priority or Complete (date). For our example, let s choose [WO] Priority. 5. Click the Apply button to return to the Report Preview window. 19 P age
6. The Report Preview window will display, split into two panes, showing the new Smart Criteria pane on the left. Our default field (Priority) is selected automatically: 7. Click on the value for Normal (your options may be different). As this option is selected, the criteria is added to the Report Criteria and the page is refreshed with your newly filtered results. 8. To select more than one value from the available list, click the Multiple Selections Indicator and select another value. The page will refresh, and the Report Criteria will indicate that this selection is included: 20 P age
9. You can continue to ADD criteria based on other field values as needed. For example, let s add additional filtering for the assigned Shop. In the Smart Criteria field list, scroll until you find the [WO] Shop field and click on it. 10. Your organization s Shops will now appear in the list. The indicator for Multiple Selections remains on, allowing for multiple shops to be selected. Pick one or two shops from your list and note how they are added to the Report Criteria and honored in the refreshed results: 11. If you decide you do not wish to filter by the indicated criteria, you can use the Clear or Clear All options in the upper right of the Smart Criteria pane. If you wish to remove all criteria defined in the Smart Criteria Pane, you could use the Clear All option. For our example, click Clear to remove the latest criteria added. The criteria for Shop will be removed. 12. For demonstration purposes, select a date field from the field list (Complete or Target Date). Notice how the available options switch to logical date groupings. This is an expedient method to view work orders from different time periods: 21 P age
The defined Smart Criteria remains in effect while you toggle back and forth to Report Setup (if needed). However, once you exit (close) the report, this dynamic filtering is not saved. It is only used during the current viewing/run of the report. Tip: It should be noted that most MC Reports are set to have Smart Criteria available, but hidden, in the Report Preview window. That is, although the Smart Criteria Pane does not show by default, a Show/Expand Control appears in the far left of the Report Preview window. Clicking on this control will bring up the Smart Criteria Pane for your use. To set Smart Criteria to show by default in order to keep it displayed as you toggle between the Report Preview and Report Setup windows, use the option described in Step 3. 22 P age
Lesson 7 - Email Report Report content displayed in the Report Preview window can be easily emailed to selected recipients. To email a displayed report: 1. If you are continuing from a previous lesson, return to Report Setup. Alternatively, access Report Setup: 2. Click the Email button in the Report Preview toolbar: 3. The Email Report dialog will display: 4. The name of the logged in user will display in the From Name prompt. It should be noted, however, that the system determines the Email From/Name values based on the System Preference defined (Tools->System Preferences ->System Folder). If values are specified for this preference, this is what will display to the recipient. If no values are displayed, the logged in user will show. If your system is set to show the logged in user, you can modify the From Name as desired. 5. Recipients are specified in the To Address prompt. You can manually enter any email address directly into this prompt, with multiple addresses separated by a comma. However, if you are sending to an individual maintained in your MC System, you can quickly retrieve their correct address. To do so, click the To: button which will open the Select Recipients dialog. 6. Use the available prompt to indicate that you wish to locate an Employee, Contractor or Requester: 23 P age
7. Once the value is selected (e.g., Labor [Employees]), a list of records corresponding to that selection is displayed. Records that appear disabled (greyed out) do not have email addresses stored in their record. 8. Select the desired recipient and click the To-> or CC-> button to indicate that you want them included in the respective address line of the email. 9. Select any additional recipients. Click Apply when done. 10. The Email Report dialog will display, listing the email addresses of the intended recipients. If multiple recipients were specified, the addresses will be separated with a comma. 11. The email Subject will list the report name. You can modify this as desired. In addition, you can specify a message to appear in the body of the email, above the displayed report contents. 24 P age
12. Click Apply when you are finished. You will receive a message indicating that the report was sent to the intended recipients. The email received by recipients will embed the report into the email body. In addition, the report will be shown as an attachment, allowing the recipient to open it in a browser window: 25 P age
Lesson 8 - Schedule Reports Reports in Maintenance Connection can also be scheduled for automatic distribution (via email) to specified individuals. Note: To use the report scheduling feature the Agent Service must be enabled at your organization. If scheduled reports do not work for you, contact Maintenance Connection Support or your System Administrator to ensure that the Agent Service was purchased and enabled at your organization. 1. If you are continuing from a previous lesson, return to Report Setup. Alternatively, access Report Setup for any Work Order Report that can be modified for training purposes: 2. From the Report Setup window, select the Schedule tab. If the tab is not displayed, you are likely a member of an Access Group without permission to access this feature. You must contact your System Administrator for assistance. 3. On the default Email sub-tab, turn the Email Schedule On. Additional prompts will display allowing you to specify the recipients and time to send. 4. In the Frequency prompt, specify how often you wish the report to be sent. For example, to have it sent once a week, you would enter Every 1 Week(s). In the Begin On prompt, specify the date and time the report should begin sending. If you wanted the report to go out each Monday, you could pick the next available Monday from the dropdown, and specify the desired time of day: 26 P age
Note: If you are a hosted online customer, your server is based in the Pacific Time Zone and the time should be specified accordingly. 5. In the Attachment Type prompt, specify the type of attachment that should be included with the email. For most reports, the HTML option is preferable. The XML and CSV options are most often used when reports are to be opened in Excel or another software program. 6. The Do not send if report returns no records indicator is an especially helpful feature. For most scheduled reports, you only want the report sent out if data requires attention (e.g., overdue work orders, unapproved purchase orders, employees with expiring certifications, etc.). Set this indicator on if you want to limit report distribution to happen only when records match your defined report criteria: 7. In the Email Recipient(s) area, you can manually enter the email address of any individual to receive the report, with multiple addresses separated by a comma. Or, as used in Lesson 7, you can click the Add button to access the Select Recipients dialog: Use the available prompt to indicate that you wish to locate an Employee, Contractor, or Requester: Once the value is selected (e.g., Labor [Employees]), a list of records corresponding to that selection is displayed. Records that appear disabled (greyed out) do not have email addresses stored in their record. Select the desired recipient and click the To-> or CC-> button to indicate that you want them included in the respective address line of the email. 27 P age
Select any additional recipients. Click Apply when done. 8. You will be returned to the Email tab with the recipients specified: 9. On the upper right of the page, you can specify the name and email address that should be listed as the sender on the email accompanying the scheduled report. It is always preferable to enter a recognizable name to reduce the risk of the recipient s email system interpreting the email as spam. 10. On the lower right, you can designate if particular days of the week should be excluded from distribution. For example, on a report scheduled for daily distribution, you may want to exclude Saturdays and Sundays. This setting is not necessary for the weekly schedule in our example. 11. To save the changes made, click the Apply button. Your report will be emailed when the next scheduled date and time occur. Note: It is important that email addresses are accurately entered as the report will not distribute if any of the email addresses are invalid. 28 P age
Lesson 9 - Export Reports Maintenance Connection reports can be exported to a variety of formats. Custom formatted output, such as the Work Order Statement, can only be exported to a PDF or HTML file. Reports formatted in a more typical column and row fashion, however, can also be exported to a.csv or.xml format. Once exported and saved to your desktop (or a server), the report output can be opened using any application that supports the specified type. Let s export this report to both a.csv format and open it in Excel, and then open it in a PDF. Note: Some customers may have difficulty exporting to a PDF, due to local setup issues or unique report configuration. If you encounter problems, we recommended that you use the HTML option instead. 1. If you are continuing from a previous lesson, return to Report Setup. Alternatively, access Report Setup for any report that you would like to export: 2. Click on the Export button on the Report Preview Toolbar: 3. The Export dialog will display, showing the available export options: 4. Click on the Comma-Delimited (.csv) option. 5. Your operating system will prompt you to indicate if you wish to Open or Save the file. Click Save: Choose a location to save your file and enter a name for the file. Click Save when you have entered your information. 29 P age
Depending on your operating system, you should receive a confirmation message, giving you the opportunity to open the newly-created download file. Click Open when prompted. 6. Excel will open and present the content of the report: 7. The columns can be reformatted and resized using standard Excel features: 8. Once presented in Excel, you can use any of Excel s powerful features to further manipulate or perform calculations on available data. Tip: You may note that only the basic column, row and header information is exported when the.csv format is used (no report title, groupings, charts, etc.). This allows for optimum manipulation of the data from within Excel. If you prefer to have additional data included in your export, you can export to an HTML format, save the file, and then proceed to open the saved file directly from Excel. Additional information, such as groupings and page headers, will be included. 30 P age
9. Close the Excel window to return to the MC Export dialog. 10. With the Export dialog displayed, click on PDF. 11. Your report should open in a browser window as a PDF, displaying all report formatting. Once presented as a PDF, you can use available options to save a copy of the file for future use. 31 P age