Reports Tab - CyberGrants
Transcription
Reports Tab - CyberGrants
Reports User Guide CyberGrants, Inc. – Two Dundee Park, Suite 101 – Andover, MA 01810 Reports User Guide Introduction This document provides detailed instructions on the use of the Reports tool functionality in the CyberGrants System. It is intended for use by the end user to gain an understanding on the use of the Reporting tool functions and features released on 10/28/10. It provides a step by step approach on how to access the new features and how to easily customize reports to suit the end users philanthropic and corporate reporting needs. This document may be used as a training tool for new users of the CyberGrants System. Revisions Author E. Zuchowski Description Initial Revision Date 11/10/10 The information in this document is confidential and not for disclosure outside of CyberGrants, Inc., Cyber Grants clients and prospective CyberGrants clients. CyberGrants, Inc Two Dundee Park • Suite 101 Andover, MA 01810 978-824-0300 Table of Contents REPORTS MENU & NAVIGATION .................................................................................................1 HOW TO ACCESS REPORTS .................................................................................................................. 1 REPORT LIBRARY .........................................................................................................................3 HOW TO LOCATE REPORTS .................................................................................................................. 3 MY REPORT ACTIVITY..................................................................................................................5 HOW TO SEARCH FOR REPORT ACTIVITY ................................................................................................ 5 MY FAVORITE REPORTS ..............................................................................................................7 HOW TO MANAGE FAVORITE REPORTS .................................................................................................. 7 MY SCHEDULED REPORTS ...........................................................................................................8 HOW TO CREATE A SCHEDULE FOR A REPORT .......................................................................................... 8 TAG REPORTS............................................................................................................................ 10 HOW TO TAG REPORTS ..................................................................................................................... 10 AD HOC REPORTS ...................................................................................................................... 12 HOW TO CREATE AN AD HOC REPORT ................................................................................................. 12 AD HOC REPORT ADMINISTRATION .......................................................................................... 29 HOW TO MANAGE AD HOCS ............................................................................................................. 29 HOW TO CONFIGURE AD HOC REPORT PREFERENCES ............................................................................. 30 HOW TO CLONE AD HOC REPORTS ..................................................................................................... 32 HOW TO DELETE AD HOC REPORTS..................................................................................................... 33 TABLE OF FIGURES .................................................................................................................... 34 REPORTS MENU & NAVIGATION Reports Menu & Navigation How to Access Reports Overview Reports can be generated easily by selecting a report from the Report Library, assigning some qualifying filters, and choosing a report layout. Reports can also be customized by using the robust and flexible Ad Hoc functionality. This process involves a few additional steps, which are clearly defined in this guide. There are three types of Reports available, they include: Standard Reports - The suite of pre-defined reports which are included in the CyberGrants system. All Grantmakers with access to Reports can run the Standard Reports. Users can limit the data that is displayed when running standard reports with the use of filters. Ad Hoc Reports – On demand reports which can be created on pre-defined groups of data called Report Topics. The user can select the fields to include in the report, limit the results with various filters, and design the layout of the report. Ad Hoc Reports can be run, saved, edited, and shared with other designated users. Custom Reports – Created by the CyberGrants development team to meet the unique requirements of a Grantmaker. Select the Reports tab from the Main Menu to access the Reports main page. Figure 1 - Main Menu - Reports Tab Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 1 REPORTS MENU & NAVIGATION Reports Page Content The Reports Main Portal Page is comprised of functional areas called Portlets, which may include one or more of the following (depending on a clients setup): Report Library – Displays the listing of all Standard, Custom and Ad Hoc Reports My Report Activity – Displays recent report activity for the user My Favorite Reports – Create and manage a list of regularly run reports My Scheduled Reports – Create and manage a schedule for running reports My Tags – Displays user-defined tags and a link to tag-associated reports My Ad Hoc Reports – Create and manage Ad Hoc Reports The layout of your Reports Main portal page and the Portlet titles may look different than the example below. The management of the portlets and their relative position on the page has been determined by your Administrator. Only Admin level users can modify the layout and the portlet labels. Figure 2 - Reports Main Portal Page Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 2 REPORTS LIBRARY Report Library How to Locate Reports Overview The Report Library contains a list of all Standard, Ad Hoc and Custom Reports. A user will only see those Ad Hoc Reports which they created or were shared with them by another user. Report Library The Report Library is sectioned into groups by report type, they include: Budget Reports – Budget Cash Flow and Grant Payment Reports Payment Reports – Grant Payment Type and Payment Details Reports Request Reports – Grant Request and approval related reports Ad Hoc Reports - Reports created by the user and Ad Hoc Reports shared by others with that user. Administration Reports – Application Processing Statistic Reports Uncategorized Reports – Reports that were not assigned a Report Category Note: The Report Library group may be renamed by your Admin, so the actual names you see may vary from the figure below. Figure 3 - Report Library Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 3 REPORTS LIBRARY Report Groups Each Report Group contains a list of reports to choose from. The list of reports is expandable by clicking on the [+] symbol next to the Report Group Name. A list of reports within the group will display and allow you to a select a report. A group can be compressed by clicking on the [-] to temporarily hide the individual list of reports. Individual Reports The individual reports are listed alphabetically under each Report Group. Users may: Run a Report - Run a report by clicking on the Report Name. Preview a Report – To preview a report, select the magnifying glass icon next to the report name you wish to preview. Favorite - Add a report to your ‘Favorite’ reports list by clicking on the heart. Figure 4 - Individual Reports in Library Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 4 REPORT ACTIVITY My Report Activity How to Search For Report Activity Overview Users can search for their recent report activity within the past 30 days. This feature allows the user to review, run, and schedule reports. A user may search on recent activity that occurred within the same day, for the prior 7 days or for the past month. Users may apply a filter to the report activity by the report status. My Report Activity Example: A user may wish to review ALL reports they have run Today. Figure 5 - My Report Activity Report Run Period Select a time period from the Reports Run: drop-down list. The available report activity time periods include: Today – Display reports run today. Last 7 Days – Display reports run in the past 7 days. Last Month – Display reports run in the past 30 days. Report Status You can filter your report activity by selecting a Report Status. The default Status value is All. Select one of the following to limit the list of report activity: All – Display all reports for the activity period selected Completed – Display all reports that completed for the period selected Failed – Display all reports that failed to run for the period selected Queued – Display all reports that are in queue, but have not run yet, for the period selected Running – Display all reports that are currently running for the period selected Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 5 REPORT ACTIVITY Report Listing Columns Report Name – click on the report name to run the report. The user will be prompted to select report filters and report layout prior to running the report. Queue # - a unique report processing identifier to reference in the event there is a need to engage technical support or to report an issue. Status – The current disposition of the report. (completed, running, queued, or failed) o To identify a report still processing, the status will display ‘Running’; you are not able to view a report until it has completed processing. o To view the output of a report, select the link ‘Completed’ in the status column for the report. o To schedule a report to run, select ‘Schedule’ to have reports run at defined intervals and be distributed to selected users. Last Run – Date/time of the last time the report was run manually or via the report scheduler. Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 6 FAVORITE REPORTS My Favorite Reports How to Manage Favorite Reports Overview Users can create a list of Favorite Reports to quickly access their most commonly run reports. Favorite Reports are identified by having a solid red heart symbol next to its name. Clicking the red heart will add a report to favorites. Clicking it again will remove it from favorites. Favorite reports will remain in the Reports Library but will also display in the My Favorite Reports list. My Favorite Reports My Favorite Reports portlet displays Report name & Report Category for each favorite Report. Figure 6 - My Favorite Reports – listing Add/Remove Favorite Reports Screen Options: Click a Report Name to run the report. Click the solid red heart to remove the report from Favorites. To add a report to your Favorite Reports list, click on the clear heart Symbol next to a report. This will turn the clear heart to a solid red heart. To remove a report from your Favorite Reports list, click the solid red heart next to the report in either location: My Favorite Reports or the Reports Library. Figure 7 - Flag Reports as a Favorite Note: A solid red heart next to its name indicates that it is a Favorite Report. A clear red heart next to its name indicates that it is not a Favorite Report. Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 7 REPORT SCHEDULING My Scheduled Reports How to Create a Schedule for a Report Overview Reports can be generated automatically by creating a schedule for it to run. Once created and run, these reports will display in My Scheduled Reports. This includes reports scheduled by other users who have included you in the distribution list. My Scheduled Reports Figure 8 - My Scheduled Reports Report Name – displays the name of the scheduled report Status – indicates whether the scheduler is turned on for the report (active is on, inactive is off) Last Run – displays the last date the report ran Next Run – displays the next scheduled run date Select Report to Schedule Report Schedules can only be created for reports which have been run. Previously run reports can be found in the My Report Activity. Click on the (Schedule) link next to a completed report name to open the Report Scheduler. Figure 9 - Select Reports for Scheduling Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 8 REPORT SCHEDULING Schedule Reports To create a Report Schedule : 1. Enter the Start Date to initiate the report to generate. (will run at night) 2. Enter an End Date if you want the report to stop generating on a specific date. (optional) 3. The Next Run Date and Status will display after the schedule is saved. 4. Check the Active box to activate the schedule. 5. Uncheck the Active box to deactivate the schedule. 6. Select a Frequency and define the schedule description. 7. You may enter a Description about this schedule. (optional) 8. Identify who should receive and be notified via email when the report has run. * Recipients will see the report in their My Report Activity portlet once it has been generated. * Only fully licensed users will appear on the distribution list. Figure 10 - Report Scheduling Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 9 TAG REPORTS Tag Reports How to Tag Reports Overview A Tag is a label, which may be a single keyword or phrase, assigned to a Report as a means of grouping or classifying similar report types. Assigning a Tag to a Report helps to describe reports and allows them to be found easily. Tags are user-defined. Users can assign Tags to individual reports by clicking on the tag icon after any report. A window will display and allow you to enter or edit existing tags. Figure 11 - Tag Icons Tags can also be managed on the Save & Run Report page, just prior to running a report. My Tags My Tags portlet displays all of your Tags and the number of Reports linked to each tag. Figure 12 - My Tags Click on a Tag name to view a list of all of the reports associated with that Tag. Once you choose a tag, the Report Library Search Result screen will display all the reports with the selected tag and allow you to access them. Search for Reports by a Tag Figure 13 - Tagged Report Results Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 10 TAG REPORTS Add/Remove Tags Tags can be added or changed on the Save & Run Report page. To Add a Tag - Enter one or more keywords or phrases in the Tags field on the Save & Run Report page. Separate keywords and phrases with commas. For example: (budget, monthly, Monthly Reporting) The three tags in the example above will be assigned to the Budget Report when it is run. If a Tag does not already exist, a new one will be created. To Remove a Tag – delete the keyword or phrase from the Tags field below then run the report. Figure 14 – Add Tags - Save & Run Report Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 11 AD HOC REPORTS Ad Hoc Reports How to Create an Ad Hoc Report Overview Users have the ability to create and manage Ad Hoc Reports. Ad Hoc Reports can be created for quick reporting needs, frequent reporting and for sharing with other users. They are easily created, run and saved to your library. This section of the guide will walk you through the steps involved in these capabilities. Accessing Ad Hoc Reports Ad Hoc Reports can be accessed by clicking on “Create Ad Hoc Report” from the Main Reports Menu or in the My Ad Hoc Reports Portlet. Figure 15 – Main Menu - Create Ad Hoc Report Figure 16 – My Ad Hoc - Create Ad Hoc Report Timeline Monitor A Timeline Monitor is displayed at the top of the screen to indicate the stage of the Create Ad Hoc process which you are currently in. A double circle indicates the current stage. The example below indicates that the user is working on the last stage: Save & Run Report. Figure 17 - Create Ad Hoc - Timeline Monitor A user may go to a Previous stage by selecting the [Previous] button at the bottom of the screen or by selecting the stage. Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 12 AD HOC REPORTS Steps to Create Ad Hocs This section explains the 5 steps to create an Ad Hoc Report. following activities: The steps include the Steps Menu Selection Description 1 Report Topic Selection 2 Field Selection 3 Filter Selection 4 Layout & Preview Select a Report Topic to base and create an Ad Hoc Report for. Note: Only one can be selected. Identify which fields to display in the report and to which fields will be used as filters. Refine the content of the report by applying filters. Identify report criteria to narrow the data results. Select a layout format for how the report will be displayed. 5 Run & Save Report Step - 1 Select a Report Topic Save the Report and assign a Report Name and Output Format. Generate the report to view the results. Report Topics are logical groupings used to organize data elements. . Choose a Topic by clicking on the button next to the Topic name, and then select [Next] to proceed. Only one Topic may be selected at a time to create an Ad Hoc Report. A description of the Topic will be displayed on the right side of the screen. (Topics and descriptions may be customized by your administrator). Report Topics Figure 18 – Ad Hoc - Report Topic Selection Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 13 AD HOC REPORTS Step - 2 Select the Report Fields Select the fields you want to display in the report and those fields which you want to use as filters. Fields that are designated as Filters do not necessarily have to display in the report. To select fields and filters, click in the box next to the field name in the appropriate column: Display in Report and Use as Filter. You can search the list by type of data – e.g. display all the CURRENCY fields. This helps to find specific type of data quickly in the list. Field Selections Figure 19 - Ad Hoc - Field Selection Navigation Options To filter the fields by type of data, Select a type in the Display drop-down list. To return to Report Topic Selection, select the [Previous] button. To proceed to Filter Selection, select the [Next] button. To reset all your selections and start over, select the [Clear All] button. Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 14 AD HOC REPORTS Step - 3 Select the Report Filters The Filter Selection allows you to define criteria to limit the results of your report. The fields you identified as Filters in the previous stage will display on the Filter Selection screen. All of the criteria which you specify for the filters must be met in order for the data to be included in the report output (filters are optional). Filter Selection Figure 20 - Ad Hoc - Filter Selection Navigation Options Add More Filters To return to Field Selection, select the [Previous] button. To add more Filters, select the [Add Filters] button. To proceed to Layout & Format of Report, select the [Next] button. The [Add Filters] button allows you to add additional fields to filter the report on. Select any field from the Available Fields list by clicking on the green ‘+’ symbol. The field will be added to the list of filters listed above. You are then able to apply criteria to the new filter. Add Filters Figure 21 - Ad Hoc Add Additional Filters Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 15 AD HOC REPORTS Filter Operators An Operator allows you to perform true/false evaluations on the data you are requesting. The set of Operators available in the drop-down list will vary depending on the type of data for that field. The list of all Operators is displayed at the bottom of this page. The field values must match the filter criteria in order to be included in the report results. Filter Operator Selection Figure 22 - Ad Hoc Filter Operators Assign an Operator 1. Click on the drop-down list next to the Filter-field name and choose an Operator to establish the criteria to refine the report output. 2. Assign a value(s) by clicking on (click to Select Values) or by entering data when prompted in the Field Value(s) column. Assigned Field Values will display in the field values column after they have been entered. Filter Operators Definitions After - Enter a date to search on all records after a specified date Before - Enter a date to search for all records with a date prior to the specified date Between - Search for records with a value that falls between two specified dates Contains - Search for records which contain a string of values specified Does Not Contain - Wild card – enter a string not to be contained Does Not Include - Select value(s) from a list to exclude records from the search Ends With - enter last few characters Equal To – Search for records with a value equal to the specified value Greater Than – Search for records with a value greater than the specified value Greater Than or Equal To Search for records with value greater than or equal to specified value Has a Value - Search for all records that have a Value in this field, is not blank Includes – Select value(s) from a list to search for matches Is Blank - Search for all records that have no value for this field Less than – Search for records with a value less than the specified value Less than or Equal to - Search for records with a value less than or equal to the specified value Not Equal To – Search for records which do not equal the specified value On or After Enter a date to search on all records On or After a specified date On or Before Enter a date to search for all records with a date On or Prior to the specified date Starts With - Enter the first few characters Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 16 AD HOC REPORTS Helpful Hints and Tips Ad Hoc Report tips Report Filter tips Omit using a field as a column in the report if the field is used to filter on a single value. For example, if the report is intended for only approved requests, there is no need to display the column “Request Disposition”, since all the records returned will be “Approved”. The items used to filter appear at the bottom of the report’s title page. When working with classifications and grant or payment amounts, select the “Grant or Payment Amount Per …” columns instead of the standard “Grant Amount” or “Payment Amount” columns. The “Per” columns multiply the grant or payment amount by the classification percentage. For example, if a $10,000 payment is distributed for a grant and the Proposal Type listed 85% Matching Gifts and 15% Disaster Relief, the report would return an $8,500 amount ($10,000 x 85%) for Matching Gifts and a $1,500 ($10,000 x 15%) for Disaster Relief. Report filters are optional; however, if filters are not used, the report displays all the Grantmakers data. The result is that the report takes longer to generate and display. The effective use of filters is critical to obtain the desired information. Carefully review the following: Over-filtering can unexpectedly limit information in a report. Use only relevant filters. Leave a filter blank or set it to the default value, “(All)” or “(None)”, if it is not relevant to the selection of data. Values within the same filter are inclusive. A multi-select filter allows a user to pick multiple values. If a user chooses a multi-select filter like Proposal type, and selects both “Matching Gift” and “Disaster Relief” as values, the report returns requests where the value for Proposal Type is “Matching Gift” OR “Disaster Relief”. Values in different filters are exclusive of one another. If a user uses more than one filter, the data must satisfy all the criteria. For example, if filtering on State of “Massachusetts” and Request Disposition of “Approved”, the report displays information that meets both criteria: organizations located in Massachusetts AND requests that are approved. Classification tables (single-select, multi-select, percentage, and checkbox fields) are exclusive of one another. Classification reports may only incorporate one classification at a time. For example, a user cannot filter a report to include both “elderly” and “African American” data because the Age and Ethnicity data is in different fields and cannot be correlated. The availability of budget information is based on a users’ Budget Line Security Access. NOTE: Contact the CyberGrants Administrator to alter the security level or to receive access to a particular budget. The Budget Year filter selects all budget lines within a given year. Lists of all payments coming from the budgets accessible to the user are returned. When balancing the budget, use only the Budget Name and Payment Status. Other filters (date fields, amount, geography, or ownership) may exclude payments from the report. Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 17 AD HOC REPORTS Step - 4 Select the Report Format This section will explain the 5 different types of report formats available and how to configure them. The user would first select a report format, and then identify the fields to include in the report, from those selected in step 2. Some of the format options offer a grouping and sub-grouping feature. Select Report Format Figure 23 - Ad Hoc Select Report Format Format Options The 5 Report Format styles to choose from for the Ad Hoc Report creation include: Group Above - combine similar records under a common group, with subtotaling by the major groups. Group headings are displayed at the top of the report. Group Left - combine similar records under a common group, which is displayed on the left of the report. Tabular / Data Extract – Basic, columnar format, detailed display. Document – Report is presented in a MS Word document or PDF format. Matrix/Pivot Table – Summary of information rather than individual details displays. Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 18 AD HOC REPORTS Report Format: Group Above Overview Group Above Reports combine similar records under a common heading or Group, which will display at the top of the report. It provides detailed information grouped and subtotaled. A maximum of 10 columns may be included. (A total of 13 fields may be selected – 3 for Group levels and 10 for column details.) Examples of common groupings are: Organization, Grant Year, Budget Name or Proposal Type. Group Above sample format How to Create a Group Above Report Overview Add Groups Specify the fields used for creating data groupings in the report. The report will display the grouping level each time before the Group-Level value changes. The maximum number of group levels is limited to 3 for this report format. Add Group Fields Select the group fields from the Available Group Fields sections on the left of the screen. Click on either the single right arrow or the double right arrow (all) to move them to the Selected Group Fields section. Remove Group Fields To remove one or more group headers, click the field box next to the field(s) to remove, and then select the left arrow. To remove all Group Headers, select the double left arrows. Order Groups The group order determines how the groups will be displayed and the data will be summarized. Higher positioned groups should reflect a wider or broader range of grouped data. For example, you might create groups in the following order: Country, State/Region, and then Organization Type. (broader to more specific) Arrange the order of the groups, select the group then click the UP/DOWN arrows to move their position. Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 19 AD HOC REPORTS Group Above Figure 24 - Report Layout –Group Above Field Selection and Display Order To create the report, the user would select fields from the Available Display Fields section and then move them to the Selected Display Fields section. This is done by clicking the checkbox for the desired fields and then choosing the appropriate arrow to select them. If you would like: To move selected fields to the right side, click on the right arrow To remove selected fields from the right side, click on the left arrow To include all fields in the report, click on the double right arrows To remove all fields, click on the double left arrows The order in which the fields are displayed on the report can be arranged by selecting the field, and then clicking on the up or down arrows to move the field. Click the [Next] button to continue, or the [Preview] button for a quick preview of the report. Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 20 AD HOC REPORTS Report Format: Group Left Overview Group Left Reports combine similar records under a common heading or Group, which will display on the left of the page. It provides detailed information grouped and subtotaled. A maximum of 10 columns may be included. (A total of 13 fields may be selected – 3 for Group levels and 10 for column details.) Examples of common groupings are: Organization, Grant Year, Budget Name or Proposal Type. How to Create a Group Left Report Overview Add Groups Specify the fields used for creating data groupings in the report. The report will display the grouping level each time before the Group-Level value changes. The maximum number of group levels is limited to 3 for this report format. Add Group Fields Select the group fields from the Available Group Fields sections on the left of the screen. Click on either the single right arrow or the double right arrow (all) to move them to the Selected Group Fields section. Remove Group Fields To remove one or more group headers, click the field box next to the field(s) to remove, and then select the left arrow. To remove all Group Headers, select the double left arrows. Order Groups The group order determines how the groups will be displayed and the data will be summarized. Higher positioned groups should reflect a wider or broader range of grouped data. For example, you might create groups in the following order: Country, State/Region, and then Organization Type. (broader to more specific) Arrange the order of the groups, select the group then click the UP/DOWN arrows to move their position. Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 21 AD HOC REPORTS Group Left Figure 25 - Report Layout –Group Left Field Selection and Display Order To create the report, the user would select fields from the Available Display Fields section and then move them to the Selected Display Fields section. This is done by clicking the checkbox for the desired fields and then choosing the appropriate arrow to select them. If you would like: To move selected fields to the right side, click on the right arrow To remove selected fields from the right side, click on the left arrow To include all fields in the report, click on the double right arrows To remove all fields, click on the double left arrows The order in which the fields are displayed on the report can be arranged by selecting the field, and then clicking on the up or down arrows to move the field. Click the [Next] button to continue, or the [Preview] button for a quick preview of the report. Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 22 AD HOC REPORTS Report Format: Tabular / Data Extract Overview Tabular reports are the most basic report format. Data is displayed in a columnar format and is ordered by the first column of the report. A Tabular report can be generated in any of the following report print formats: Ascii, CSV, MS Excel, HTML and PDF. Detailed information listed in columns is totaled at the conclusion of the report. Data Extract reports include a tab delimiter or comma delimiter between each field, allowing users to generate data they can use with another software program. Tabular / Data Extract sample format Tabular / Data Extract Figure 26 - Report Layout - Tabular/Data Extract Field Selection and Display Order To create the report, the user would select fields from the Available Display Fields section and then move them to the Selected Display Fields section. This is done by clicking the checkbox for the desired fields and then choosing the appropriate arrow to select them. If you would like: To move selected fields to the right side, click on the right arrow To remove selected fields from the right side, click on the left arrow To include all fields in the report, click on the double right arrows To remove all fields, click on the double left arrows The order in which the fields are displayed on the report can be arranged by selecting the field, and then clicking on the up or down arrows to move the field. Click the [Next] button to continue, or the [Preview] button for a quick preview of the report. Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 23 AD HOC REPORTS Report Format: Microsoft® Word - Document Overview This report format option enables you to generate a presentation quality report directly into Microsoft® Word which can then be edited, printed, saved or emailed. Document Report Layout Figure 27 - Report Layout - Document Field Selection and Display Order To create the report, the user would select fields from the Available Display Fields section and then move them to the Selected Display Fields section. This is done by clicking the checkbox for the desired fields and then choosing the appropriate arrow to select them. If you would like: To move selected fields to the right side, click on the right arrow To remove selected fields from the right side, click on the left arrow To include all fields in the report, click on the double right arrows To remove all fields, click on the double left arrows The order in which the fields are displayed on the report can be arranged by selecting the field, and then clicking on the up or down arrows to move the field. Click the [Next] button to continue, or the [Preview] button for a quick preview of the report. Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 24 AD HOC REPORTS Report Format: Matrix/Pivot Table Matrix / Pivot Table Format Matrix reports display a summary of information rather than individual detail. These reports are especially helpful if the user is interested in the sum of payments/requests, percent of total, average and count of each item. Matrix reports only run in PDF format and default to the appropriate orientation (portrait or landscape) based on the width of the report results. Matrix/Pivot Table sample format Matrix / Pivot Table Report Layout Figure 28 - Matrix/Pivot Table Report Layout Layout Sections 1. Matrix Columns – Select ONE field you want to display as the columns in the report. The list will contain those fields which you selected to Display in the Report during the field selection step. 2. Matrix Rows – Select the fields you want to display as rows in the report. The list will contain those fields which you selected as fields to Filter on during the field selection step. A maximum of 3 rows can be selected. 3. Matrix Inner Cells – This section will contain the list of calculated fields that can be displayed in this report. Only fields selected as Display in the Report AND is either a Currency or a Number type fields are eligible. Calculated fields include: Average Min Count Max Median Sum Click the [Next] button to continue, or the [Preview] button for a quick preview of the report. Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 25 AD HOC REPORTS Select Functions Overview During the process of selecting fields for which to display in a report, you may notice an additional link: (Select Functions). This enables the user to include additional calculated values for the selected field in the report. Select Functions Currency and number type fields have a (Select Functions) link next to the field name. If you click on the link, it will display a list of arithmetic functions as shown below. This feature allows you to select additional calculations for a field to be included in the report. These will be displayed after major report groupings, similar to the data displayed in figure 31. Multiple functions can be selected at one time. Figure 30 - Select Functions – Output Figure 29 - Field – Select Functions Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 26 AD HOC REPORTS Step - 5 Run & Save Report This is the final step in creating an Ad Hoc Report. This step allows you to assign a name, save and run the Ad Hoc Report. The Report Name and attributes will be saved when you choose [Run Report]. You will be prompted to enter the filter selection and output format each subsequent time the report is run. Figure 31 - Save & Run Report Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 27 AD HOC REPORTS Report Settings Report Name Report Category Tags Add to Favorites Report Title Orientation Report Summary Select Report Format (required) The Report Name is a user-defined name assigned to the Ad Hoc Query and will be saved to the “Report Library” and “My Ad Hoc Reports” menus. Report name is required if you want to save the report. Reports can be grouped into report categories, so that they can be referenced with similar types of reports. If none is selected, it will default to ‘Uncategorized’. Add or change existing Tags to reports. To add this report to your Favorites click the checkbox. To remove it from Favorites, uncheck the box. The Report Title will display at the top of the report when it is generated. A default title will display if one if not provided. Select how you wish the report to be presented in Landscape or Portrait. The Summary will appear on the report cover page when printed. Report Formats - Select the format you want the report output displayed in. ASCII- Generates a plain text listing where each column is separated by a horizontal tab. This information is best suited for importing into other programs. CSV – Generates a plain text listing where each column is separated by a horizontal tab. This information is best suited for importing into other programs. Microsoft® Excel – Generates a report directly into Microsoft® Excel. HTML –Generates an informal web-ready report viewable via an Internet Browser. PDF –Generates a formal, presentation quality report, which cannot be altered. Requires the Adobe® Acrobat Reader or similar application to view. Microsoft® Word – Generates a presentation quality report directly into Microsoft® Word that can be edited, printed, saved or e-mailed. Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 28 AD HOC REPORT ADMINISTRATION Ad Hoc Report Administration How to Manage Ad Hocs Overview Admin Icon Options There are several tools available to assist you in managing your Ad Hoc Reports. They enable you to do various activities such as copying, cloning and editing of Ad Hoc Reports. The tools are represented by icons and are displayed below. They will appear next to the Ad Hoc Report names in My Ad Hoc Reports or in the Report Library. Admin Icon Allows you to: Preview View a brief image of the report Edit Change fields, filters or the layout of an Ad Hoc Report Configure Allows you to share, clone, delete, edit Ad Hoc Report Clone Create a copy or clone of an Ad Hoc Report Favorite Add or Remove an Ad Hoc Report as a Favorite Tag View and assign tags to an Ad Hoc Report Figure 32 - Ad Hoc - Icon options Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 29 AD HOC REPORT ADMINISTRATION How to Configure Ad Hoc Report Preferences Overview Click on the cog icon to invoke the Configuration feature. Configure allows you to: Edit Report titles, Descriptions, and Tags Share Reports Clone Reports Delete Reports Configure Report Settings Figure 33 - Configure Ad Hoc Report Settings Edit Report Settings To modify the Ad Hoc Report name, Description, or Tags enter the new values and select [Save] at the bottom of the screen. Share Reports To Share an Ad Hoc Report, select the checkbox next to the users you want to share the report with. Select the Permissions - Sharing Option for each user. (The options are defined on the next page). Report Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 30 AD HOC REPORT ADMINISTRATION Permissions Figure 34 - Sharing Ad Hoc Reports Sharing Options There are 3 Options to choose from when sharing a report with another user. They include: A. Allow user to run this report. B. Allow user to run this report and remove his/her own access to this report. C. Allow user to have his/her own copy of this report. For ALL 3 options, the shared report will display in the users ‘My Ad Hoc Reports’. For options A & B, if the original owner of the Ad Hoc deletes it from their list, it will no longer be available to the users they have shared it with. PERMISSIONS Run Report Edit fields Edit filters Delete report Clone report Share report Add Tags Add to Favorites Modify report name Modify report format Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. A SHARING OPTIONS B C 31 AD HOC REPORT ADMINISTRATION How to Clone Ad Hoc Reports Overview If you wish to create an Ad Hoc similar to an existing one, but with a few changes, then you may clone the Ad Hoc report. Instructions To Clone an Ad Hoc report: 1. Find the report you wish to clone in the Report Library, My Ad Hoc Reports, or My Favorites. 2. Click on the double page icon next to the report name. 3. The Clone Report screen will display and allow you to save the cloned report with a new name. Enter the new name and select [Clone]. The new cloned report can now be accessed in the My Ad Hoc Reports portlet and modified as needed. Clone Ad Hoc Figure 35- Clone an Ad Hoc Report Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 32 AD HOC REPORT ADMINISTRATION How to Delete Ad Hoc Reports Overview Since it is very easy to create Ad Hoc reports, you may find that you have created duplicate reports or outdated reports which are no longer needed. These reports can be deleted. Be aware though, that deleting an Ad Hoc Report is permanent. The report will no longer be available in the Ad Hoc Reports list, the Report Library, My Favorites, My Tags, or My Scheduled Reports. Users are unable to delete reports that have been shared with them via the Sharing Option: “Allow user to run this report”. This will be evident by the absence of any Delete check boxes. Instructions Ad Hoc reports can be deleted by either of the following methods: 1) Click on the icon cog the bottom of the screen. next to the Ad Hoc report and then select [Delete] at OR 2) Click in the box next to the report name(s) on My Ad Hoc Reports, and then select [Delete]. Multiple Ad Hoc reports Either method will display the Report Deletion screen below. Follow these steps to complete the Report Delete. 1. Click in the checkbox in the Select column to choose the report(s) to delete. 2. Click the [Delete] button to delete. Delete Ad Hoc Reports Figure 36 - Delete an Ad Hoc Report The [Cancel] button will take you back to the previous screen without deleting. To Delete ALL reports in the list, click on [Select All] button, then select [Delete]. Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 33 Table of Figures Figure 1 - Main Menu - Reports Tab ___________________________________________________________________ 1 Figure 2 - Reports Main Portal Page ___________________________________________________________________ 2 Figure 3 - Report Library ____________________________________________________________________________ 3 Figure 4 - Individual Reports in Library _________________________________________________________________ 4 Figure 5 - My Report Activity ________________________________________________________________________ 5 Figure 6 - My Favorite Reports – listing ________________________________________________________________ 7 Figure 7 - Flag Reports as a Favorite __________________________________________________________________ 7 Figure 8 - My Scheduled Reports _____________________________________________________________________ 8 Figure 9 - Select Reports for Scheduling ________________________________________________________________ 8 Figure 10 - Report Scheduling ________________________________________________________________________ 9 Figure 11 - Tag Icons ______________________________________________________________________________ 10 Figure 12 - My Tags _______________________________________________________________________________ 10 Figure 13 - Tagged Report Results ___________________________________________________________________ 10 Figure 14 – Add Tags - Save & Run Report _____________________________________________________________ 11 Figure 15 – Main Menu - Create Ad Hoc Report ________________________________________________________ 12 Figure 16 – My Ad Hoc - Create Ad Hoc Report _________________________________________________________ 12 Figure 17 - Create Ad Hoc - Timeline Monitor __________________________________________________________ 12 Figure 18 – Ad Hoc - Report Topic Selection ____________________________________________________________ 13 Figure 19 - Ad Hoc - Field Selection___________________________________________________________________ 14 Figure 20 - Ad Hoc - Filter Selection __________________________________________________________________ 15 Figure 21 - Ad Hoc Add Additional Filters ______________________________________________________________ 15 Figure 22 - Ad Hoc Filter Operators __________________________________________________________________ 16 Figure 23 - Ad Hoc Select Report Format ______________________________________________________________ 18 Figure 24 - Report Layout –Group Above ______________________________________________________________ 20 Figure 25 - Report Layout –Group Left ________________________________________________________________ 22 Figure 26 - Report Layout - Tabular/Data Extract _______________________________________________________ 23 Figure 27 - Report Layout - Document ________________________________________________________________ 24 Figure 28 - Matrix/Pivot Table Report Layout __________________________________________________________ 25 Figure 29 - Field – Select Functions ___________________________________________________________________ 26 Figure 30 - Select Functions – Output _________________________________________________________________ 26 Figure 31 - Save & Run Report ______________________________________________________________________ 27 Figure 32 - Ad Hoc - Icon options ____________________________________________________________________ 29 Figure 33 - Configure Ad Hoc Report Settings __________________________________________________________ 30 Figure 34 - Sharing Ad Hoc Reports __________________________________________________________________ 31 Figure 35- Clone an Ad Hoc Report ___________________________________________________________________ 32 Figure 36 - Delete an Ad Hoc Report__________________________________________________________________ 33 Reports User Guide (revision date: 11/1/10) CyberGrants, Inc. 34