InsightUnlimited Designer Express User Guide for JDE. June 2014

Transcription

1 InsightUnlimited Designer Express User Guide for JDE June 2014 InsightUnlimited Version: and above Document Version: 6.3 Last Updated: July 29, 2014

2 Introduction... 5 Template Types... 7 Standard Templates... 7 DX Templates... 7 InsightUnlimited User Types... 9 Designer Express User Types... 9 InsightUnlimited Designer Express: Designer Considerations Where to Begin Considerations Best Practices Template/ Report Specifications InsightUnlimited DX Administration: Designer Express Licensing Overview License Key Types Assign Licenses Administration: InsightUnlimited Profile Overview Update InsightUnlimited Profile(s) The Object Library Master Primary Keys and Indexing Map to Tables Outside of JDE Designer Dictionary SQL Capability View SQL Create New Template: Tables Overview Add Tables Additional Options Inline/Outline View Mode Create New Template: Column Options Overview Set Column Options Page 2 of 52

3 Field Type Lookups Source Currency and Decimal Shifting Create New Template: Understand Table Joins Overview Inner Joins Outer Joins Add Master Tables Joining to the Same Table Unions Padding Overrides Effective Date Processing Optional Table Create New Template: Define Joins Overview Define Joins Create New Template: Define/Review Column Options Overview View/Define Amounts Create New Template: Add Filters and Columns Overview Add Filters Add Value Columns Add Label Columns Create a New Template: Finalize Overview Add Finishing Touches Test Driven Development Save As Template Associate Template with Modules Grant Permissions Page 3 of 52

4 Create New Template: Repeating Rows Overview Default View Modify Duplicate Row Format Display Duplicate Rows All Row Combinations Further Information Contacts Customer Support Notices and Disclaimer Page 4 of 52

5 Introduction InsightSoftware.com is an enterprise information company, providing software for Reporting, Planning and Business Performance Management. Our solutions cover: Enterprise Reporting/Inquiry, Analytics (Understand the Business) Financial Consolidation, Management Reporting, Dashboards, KPIs (Manage the Business) Forecasting, Planning, Budgeting, Strategy Management (Predict the Business) InsightUnlimited Reporting has a wide selection of pre-built templates for each module which include JD Edwards-specific business logic. These templates allow access to many of the JD Edwards tables. Joins are all pre-configured so an end user can add a new column to a report without having to know about the underlying tables or join logic. Although this provides the easiest possible enduser experience, the tables and columns available are limited to those pre-defined within InsightUnlimited Reporting. Designer Express allows you to take reporting to the next level with tools for creating user-definable, custom templates over any file in JDE including custom tables. User defined codes and built-in descriptions simplify designing and give business users thousands of template options with minimal effort. The inherent database intelligence within Designer Express means complex results are correctly displayed even with many-to-many combinations. Designer Express gives your organization immense flexibility by offering features including: Ability to create new templates based on multiple fact tables or database views. No double-counting when totaling. Several join types can be used: inner, left outer, and right outer. Ability to create a union between tables that have identical fields. Optionally select either inline or outline view. Data can be combined in different ways: one:one, one: many, many:many. Option to define how to show repeating rows. A join based on a numeric column to a string column is automatically resolved. Ability to join to the same table multiple times (only if the table joining to has no amounts defined, for example Address Book F0101). Based on the tables that are chosen, certain Master tables, such as F0006, F0101 and F4101, can be suggested and then joined to if desired. There is full language support, except for amount columns. Currency-based decimal shifting. Once a template is saved, business users can create reports and inquiries with standard capabilities including: o Descriptions o Hierarchies created manually (not imported) o Default Calculations Page 5 of 52

6 o o o o o o o User-defined Captions Show SQL Export to Microsoft Excel /PDF QBE, or Query by Example (other than for value columns if subtotaling is enabled) Fixed value selectors RIO, or Reusable Inquiry Objects (DX objects can be shared between DX reports or templates) Linking/Drilling to/from reports within DX or to/from standard reports and templates Page 6 of 52

7 Template Types The two types of Designer Express templates available in InsightUnlimited are standard templates and DX templates. Standard Templates Shipped with the product. Contain a fixed set of tables. Cannot add new tables. Cannot access custom tables. Often include business logic: o Predefined period grouping (ITD, YTD, etc.). o Alternate Joins. o Reconciliation style templates that union tables and show orphan. o Joins that require adjustments to a field for joining (PO Number in AP to PO number in Purchasing). DX Templates Not shipped with the product. Created at your site. Can access any JDE tables. Can access custom tables and tables outside JDE. Do not include built in logic to handle module specific situations. Page 7 of 52

8 The following graphic depicts a comparison of standard template functionality compared to the functionality available in Designer Express: Standard Templates Designer Express Templates Busines Count s Logic & Average Aggregations Automatic Hierarchy Import Current Period Budget ing Group Filters Aging Categorie As Of s Date Percent Split BU Snapsh ots Pivoting Hierarchies Calculations Sorting and Ranking Subtotals & Grand Total Export to Excel or PDF Titles and Subtitles Charts & Graphs Consolidation History Tables Formatting Show Values from Multiple Tables Cross-Table Calculations Access All JDE Data Tables JDE Custom Tables Specify Join Types Specify Fields in Table Joins Show Values from More Than One Table on One Line Page 8 of 52

9 InsightUnlimited User Types Reporting Users: Can create ad hoc inquiries and reports using all features related to the report build process; can publish reports to Console Users. Console Users: Have access to published reports through a controlled interface; can drill down through the data and can make selections as published by an InsightUnlimited Reporting User. Minimal training requirements. Designers: Have ability to create custom templates and have in-depth knowledge of JDE table structures, table joins and data plus advanced knowledge of InsightUnlimited. Designer Express users are licensed to users to access templates created by the designer. Administrator: Responsible for managing user accounts, database connections, and inquiry permissions. Unlike other types of users, an Administrator may not need to run inquiries, and so does not need a corresponding account with JD Edwards. Designer Express User Types The following chart indicates knowledge requirements as related to DX. Page 9 of 52

10 InsightUnlimited Designer Express: Designer Considerations Where to Begin One of the InsightSoftware.com s trainers/product specialists was involved in research conducted by MIT s Sloan School of Management and IBM concerning how companies use the data they have. In the survey they came up with five recommendations for operationalizing data and analytics: Think big: o Focus on the biggest and highest value opportunities. Start in the middle: o Begin with the question, not the data. o Don t worry about getting all data perfect to start. Make analytics come alive: o Drive Action. o Deliver Value. o Make the data more real. Add, don t Subtract: o Keep existing capabilities while adding new ones. Build the Parts, Plan the Whole: o Create an information agenda and plan for the future. Considerations Things to consider when developing new templates/reports: Eliminate information overload. Reports should make sense of the massive amounts of data available in your ERP system is a single report too complex? Verify the reporting requirement cannot be met with the standard Insight Unlimited templates. Ask the right questions: o What is the business requirement? o What decisions do I need to be able to make to run my department/business better? Have the right information for addressing those questions. Extract the most relevant aspects of information. Know who will be viewing the report. What format will be used for viewing? o.pdf o Excel o Console o Microsoft Word Executive Grade Reporting Page 10 of 52

11 Best Practices Before you begin building new templates/reports, have a documented plan in place for: Development Testing: o Have a sample report so you can validate your data as you build your report. o Use InsightUnlimited standard templates and reports to validate data and field names as you build your report. Rollout Data quality and compliance with standards should be built in at the source. Each new template should adhere to existing best practices employed for developing reports/ inquiries using InsightUnlimited Reporting. Address such things as: Naming conventions Folder structure Template / report descriptions Conventions for default formats (numbers, headers, subtotals, totals, etc.) Include/exclude title Include saved report name in the title (yes/no) Default output settings (.pdf, Excel) Console user considerations Testing / sign-off criteria Publication and permissions Template/ Report Specifications Use a design specifications form to facilitate getting the right information before you start development. Specifications will include information such as: Template name Associated module if applicable Description/ purpose Requestor Key stakeholders/ users of the resulting data Priority/ date needed Tables Table joins Filters/ filter layout Column layout Sorting and grouping defaults Default formatting Links/ Drilldown Sample of expected results to use for development and testing Page 11 of 52

12 InsightUnlimited DX Administration: Designer Express Licensing Overview The license key must include a license for the Designer Express feature. Once the key is applied, configure Designer Express users with a license via License Assignments. License Key Types There are two types of license keys related to Designer Express. Designer Express (DX): For users who can access and create inquires based on the templates created by users with a DXD license. Will see the DX tab where templates created via Designer Express are listed. Optionally the DXD templates can be located in the associated module tab. Designer Express Designer (DXD): For the advanced users who create new templates using Designer Express. Will see the DX tab where templates created via Designer Express are listed as well as New Template, used to create a template from scratch. Note: A user with a DXD license must also have a license and license assignment for Configurator to be able to create new templates. Page 12 of 52

13 Assign Licenses Assign licenses to users by completing the following steps: 1. Select the Everyone Folder. 2. Click the Assign Licenses button or right-click and select License Assignment. 3. In the License Assignment window, assign licenses to users by ticking the respective box next to the User s Name. 4. Click OK to accept changes and close the window. Page 13 of 52

14 Administration: InsightUnlimited Profile Overview Existing profiles in Insight Unlimited Administrator must be updated to incorporate additional information for Designer Express. Update InsightUnlimited Profile(s) Update the InsightUnlimited Profile(s) completing the following steps: 1. Right-click the profile. 2. Click Edit. 3. Click Next. 4. Click Next. 5. Click Next. 6. Tick Designer Express (DX) to make it available in this profile. 7. Click Next. Note: Once Designer Express is activated, you can use the right-click option within the Profile wizard and select Edit Designer Express Settings. This gives you access to the Table Locations screen to add additional tables that you might not have included initially. Page 14 of 52

15 The Object Library Master The Object Library master table (F9801 in World, F9860 in E1) contains a list of all the system objects in JDE. Designer Express uses this table as a master list of available tables in your JDE system. In order to use Designer Express, you must make this table accessible. Note: View of Object Library Master Table. Continue from Step 7 in previous section Specify Designer Express specific information. Object Librarian Master Table connection. Object Library define the library where the F9860 resides (allows you to map to tables not configured in the profile). 9. Click Choose Tables. 10. Define the tables which will be used in new templates if not already mapped e.g. F55 tables. 11. Define the table locations in the profile. Page 15 of 52

16 Note: DX is added to the module list for each table. Primary Keys and Indexing It is highly recommended that any table configured to be used in Designer Express have the proper indexes created according to JDE requirements. If indexing is not performed, performance issues may result. It is the responsibility of the Designer Express Designer to ensure that proper indexing has been established for each table configured for Designer Express. This enables InsightUnlimited to ensure that no number is counted more than once in totals and subtotals. Tables included in any Designer Express template: Must have a defined primary key. Cannot contain a BLOB. Map to Tables Outside of JDE Follow the same steps for mapping to tables outside JDE. Make note of the following: The table outside of JDE to use with DX must have all columns defined in the JDE Data Dictionary. The table must have primary keys. If it doesn t, then primary (unique) keys can be defined in the CustomerPK.xml file in the install path. The table needs to have the same user credentials for access as the JDE Data Tables. If the table lives on a different server, then a database view can be created to point to the table. The database view should live in the JDE Data Database. Designer Dictionary When columns are defined as value columns in Designer Express, that information is stored separate from the individual inquiry. This means that once a value column is defined, all DX inquiries will know that the particular column is a value. Page 16 of 52

17 This information is stored in the Designer Objects branch of the Object Repository. Note: InsightSoftware.com has a standard set of pre-defined values for 200 or so of the most common JDE tables. SQL Capability Assign SQL capability by completing the following steps: 1. Expand the item Users and Groups. 2. Right-click the specific level (Everyone, Group, or Specific User). 3. Click the Advanced button. 4. Expand Feature Control. 5. Click Advanced Tuning. 6. Highlight the appropriate level on the right (Everyone, Group, or Specific User). 7. Select the radio button for Enable YES. 8. Click Value = Show the Advanced User Feature. 9. Click Close. 10. Click OK. Note: Add the SQL icon to the Quick Access Toolbar when you begin working on creating new templates/reports. Page 17 of 52

18 View SQL To view the SQL when developing templates/ reports, the icon must be added to the Quick Access Toolbar. Add the icon to the Quick Access Toolbar by completing the following steps: 1. Click the small drop-down arrow next to the quick access bar. 2. Click Customize Quick Access Toolbar. 3. Click the drop-down from the Choose commands from to display the list of ribbon tabs. 4. Click Commands Not On Ribbon. 5. Click View SQL. 6. Click Add. Page 18 of 52

19 7. Position as preferred in the right column. 8. Click OK. 9. Example of viewing SQL. Page 19 of 52

20 Create New Template: Tables Overview This section will step through creating a new template to be used to resolve integrity issues between GL and AP. This template will then enable reporting users to create meaningful reports that drive the resolution of integrity issues. To accomplish this, the template will need to provide access to details and amounts from: Accounts Payable Ledger (F0411) GL Account Ledger (F0911) Add Tables Create a new template and add tables by completing the following steps: Ribbon: Home> Documents 1. Click the New icon. 2. Click the DX (Designer Express) tab. 3. Click New Template to access the Template Designer. 4. Click OK. 5. Click OK. 6. Available tables are displayed on the left side of the dialog. This includes: Tables used by any InsightUnlimited module Tables selected via InsightUnlimited Administrator 7. If you don t see a table: The table may not have been selected for DX in InsightUnlimited Administrator (Refer to QRA 402.2). It might not have a primary key defined. 8. Scroll to view the primary keys for the tables displayed in the right panel. Note: The primary keys are displayed only when adding tables (there is an enhancement request to be able to view after the table has been added to the report). Page 20 of 52

21 9. Select tables and move them to the right side by using the arrows in the center or doubleclicking individual tables. Note: Use the QBE (query by example) line to assist in locating the appropriate tables. The QBE line is NOT case sensitive. You can use any key to display the results (click anyplace, tab, enter key, or click the magnifying/find icon. Use the Description Column with/out wildcards to search for text. Click any column header to sort by that column. 10. You will have the option later to add Master Tables such as the Address Book, Business Unit Master or Company Master. 11. Repeat until all tables are listed on the right; tables can be selected from JDE standard and custom (F55) tables plus data views. 12. Click OK. 13. The on-screen display now looks like this (optionally double-click table headers to minimize). Page 21 of 52

22 Additional Options Optionally select the appropriate icon in the upper left corner of the Template Designer at any time. Icon Description Add tables. Remove tables. Note: When a table is removed, also remove any dependencies such as calculations or hierarchies. Manage Suggested Master Table Joins. Browse table. Example: Note: If there is sensitive data such as payroll, optionally turn off the browser feature via InsightUnlimited Administrator under Feature Control > Show Browse Table. Report Options: View Mode Type. Select Inline or Outline View Mode. Page 22 of 52

23 Column Options Define field (column) type and lookups as appropriate. Inline/Outline View Mode Optionally select view mode (default is inline view). Inline View: parent and child rows are displayed on the same line For example, an invoice parent record with two child payment records would display on two total rows, with the first payment row on the same row as the parent invoice. Example: Outline View: each record from each table gets its own row in a parent/child view; the first child row is displayed on the row below its parent. (With Outline View, performance is better since the system is not using a double counting resolver.) For example, an invoice parent record with two child payment records would display on three total rows, with the first payment row under the invoice parent row. Note that in Outline View, rows are omitted for tables which have no amount columns on the report unless the Zero Balance function is enabled. Example: Page 23 of 52

24 Create New Template: Column Options Overview Fields (columns) need to be defined as either amounts (amount or quantity that could be used for subtotals and totals) or as label columns. Most columns are defined for tables currently used in any of the InsightUnlimited standard templates. Column Options allow you to define and/or override default definitions for: Field types Lookups Source Set Column Options For tables not already used by InsightUnlimited or to override defaults, make your selections via the Column Definition dialog.. Example: Page 24 of 52

25 Field Type Select the field category by completing the following steps: 1. Click the Column Options icon. 2. Use the QBE (Query by Example) line to assist in limiting your selection. 3. Click the Category drop-down to select Numeric (Label) or Numeric); dates and non-numeric fields are already defined. Note: Quantities and amounts must be designated as numeric to be available via the Values filter. Note: Define as amounts any columns that you would want the report to total. 4. A pound sign (#) appears in the far left column for any field that is an amount/ quantity. Review and select the appropriate type: Numeric (Label): These are columns that are numeric but the numeric value represents a code number rather than a real amount, e.g. Document Number. Unit Costs are normally treated as Numeric labels, since although they represent real amounts, it does not make sense to subtotal them. Amount (Domestic): These are amount columns in the base company currency. You will be prompted for which company field to use. Decimal shifting will be based on the company base currency. Amount (Foreign): These are foreign currency amounts. DX will prompt for the currency code to use. Decimal shifting will be based on the foreign currency specified. Amount (Non-Currency): These are non-currency amounts such as units or quantities. Page 25 of 52

26 Lookups Lookups have three purposes: When a value is entered into a filter, the data is immediately validated against the lookup. If the entry is not valid, the filter field turns red indicating erroneous information and must be corrected to continue. When using the visual assist (accessed via the flashlight to the right of a filter), the list shows all possible values with the description. Allows the option to have the columnar data displayed with the code, code and description, or just the description as available from the lookup table. Add table lookups by completing the following steps: 1. Click Column Options. 2. Use the QBE (Query by Example) line to assist in limiting your selection. 3. Click the Lookup drop-down to select: None Fixed list (infrequently used and you enter the values manually) Table lookup 4. From the Code and Description Lookup dialog, select the table where the lookup lives (does not have to be a table used in your template/report). 5. Select the Code Column. 6. Select the Description Column. Page 26 of 52

27 Source When you make changes to any of the column options (field definitions), select the source as: Set as Report Override: option applies to this template/report only (this is the default when you make a change to a column). Set as Customer Default: always use this option for this column for this table for all custom templates/reports. Note: Customer Default as source does not impact any of the InsightUnlimited standard templates. Note: Customer Default as source updates all custom templates/reports created via DX using this column from this table to reflect the column options. Options are also available to delete a previously set source. Page 27 of 52

28 Currency and Decimal Shifting When a field is defined as an Amount (Domestic) select the company on which the currency is based. Example: Set the F0411 RPAG field as Amount (Domestic) and choose from the drop-down list: RPCO Company RPKCO Document Company RPOKCO Document Company (Original Order) RPPKCO Document Company (Purchase Order) The currency of that company (as set in the F0010 table) is used as this field s Domestic Currency, and the number of decimals for that currency is used. The default currency decimal setting of 2 is used as noted in the chart that follows if other option is selected. Define a field as an Amount (Foreign) and select the field on which to base the currency code. Example: Set the GLAA field from the F0911 as Amount (Foreign) and choose from the following options: GLBCRC Currency Code Base GLCRCD Currency Code From The selected option may or may not be used depending on the Ledger Type Override Setting in the Foreign Currency. Access the Foreign Currency Columns Dialog. Page 28 of 52

29 If the Ledger Type Override setting is checked, lookup tables may be used to find the currency instead of the selected columns in the right panel of this dialog. The Ledger Type Override setting is grayed out when there is no ledger type column in that table. Note if checked and follow the diagrams/rules to determine decimal shifting. Decimal shifting for F0911 GLAA field: Page 29 of 52

30 Lookup currency columns in order specified - the columns selected in the right panel of the Foreign Currency Columns Dialog. Lookup company currency - the F0010 table provides a relationship between company (CCCO column) and currency (CCCRCD). Lookup ledger type - the F0025 table provides a relationship between ledger type (LHLT column) and currency (LHCRCX). All Measures other than GLAA Field in F0911: Lookup currency columns in order specified - the columns selected in the right panel of the Foreign Currency Columns Dialog. Lookup company currency - the F0010 table provides a relationship between company (CCCO column) and currency (CCCRCD). Lookup ledger type - the F0025 table provides a relationship between ledger type (LHLT column) and currency (LHCRCX). Page 30 of 52

31 Create New Template: Understand Table Joins Overview Changing the join type changes the rows that are returned in the inquiry. When we join tables, we refer to the two tables as the left and right table. This has nothing to do with the relative position of the tables in the Template Designer dialog, but refers to the relative position in the underlying SQL statement that creates the join. When you use the Template Designer and drag fields from one table to another to create the join: The table you drag from becomes the left table. The table you drag to becomes the right table. Inner Joins An inner join is the quickest form of join for the database to execute. When joining two tables with an Inner Join: rows returned are those where there is a valid row in both tables. rows that exist in one table only with no corresponding row or rows in the other table are excluded. Example: an inner join between the Sales Order Header table (F4201) and the Sales Order Detail table (F4211): 1. Select tables. 2. Determine the fields to join. Use the search function to help locate the fields. 3. Click the field SHDOC in F4201 (this becomes the LEFT table). Page 31 of 52

32 4. Drag to field SDDOC in F4211 (this becomes the RIGHT table). 5. Note the small chain link to the right of each field name indicates this is a field used in the join. 6. Edit and/or Delete options are available on the right side of the Tables and Joins screen or click the equal sign to initiate the edit process. 7. Highlight a join and select the option at the bottom of the screen to perform either an Edit or Delete function. 8. Repeat to add additional fields to join. 9. Double-click on a join or the = to access the Join Properties dialog. Add/delete joins. Specify the join type. Include literal values. Edit padding. Apply effective date processing. 10. Optionally tick the box in the lower left-hand corner to auto-show the above screen when creating a join. 11. Click OK to continue or Cancel to exit without making changes. Page 32 of 52

33 Outer Joins A right outer Join (or just right join) will return all rows in the right table. Where there are corresponding rows in the left table, the data from these will be returned. If there are no corresponding rows, the columns from the left hand table will contain NULL values. If your inquiry filters on columns from the right hand table, then any rows with NULL values will be excluded, effectively excluding the non-matching rows in the left table. A left outer join (or just left join) functions exactly the same way reversing the left and right tables. Add Master Tables DX will scan the tables in the Template Designer and look for possible joins to common master data tables. Add Master Tables by completing the following steps: 1. Click Master Table Joins. 2. Review the list of suggested tables Master Tables with Master Table field. 3. Click the drop-down arrows to select the To Table. 4. Click the drop-down arrows to select the To Field. Page 33 of 52

34 Joining to the Same Table You can join to the same table multiple times. For example, you can join Sales Order Detail to the Address Book (F0101) and base the join on Sold To, Ship To and Parent. Example: To create multiple joins from the Sales Order Detail table (F4211) and the Address Book (F0101). 1. Select tables. 2. Create the joins. 3. An underscore and the next sequential number are appended to the table name when the same table is selected multiple times, e.g. F0101, F0101_1, F0101_2. Rename (label) the duplicate table(s): Optionally, change the table label (table name) to make it more meaningful by completing the following steps: 1. Click Table Options. 2. Select Label. 3. Enter the new label. 4. Click OK. Page 34 of 52

35 5. The new label is now displayed for the table. Unions You can create a union between tables that have identical fields. This would include tables such as the F4211 (Sales Order Detail) and the F42119 (Sales Order History) or the F0911 (Account Ledger) and the F0911P (Transaction Detail Purge) Options. Create a Union by completing the following steps: 1. Add a table. 2. Click Table Options. 3. Click Unions. Page 35 of 52

36 4. Select from the displayed list in the left panel to create the union (if any are available). 5. Click OK. 6. Union icon in the upper left corner identifies that this table is unioned with another table. Padding Overrides Use padding overrides when joining two fields with different padding (e.g. GL Subledger to Work Order). Access this feature from Edit Joins. Page 36 of 52

37 Effective Date Processing Using effective date with joins. Effective date logic is applied to the date that an event took place (the event date) and is used to look up some state for that event at a particular effective date. Note that a join has to have been defined before an effective date condition is applied. Access this feature from Edit Joins. Effective date condition not using a join View all the effective records in a table based on today s date based on the computer running at this time. This logic strips away the time component away from the date when used to compare to today s date. For example, the Address Book by Date Table, F0116 stores all addresses that have existed for a customer. Use today s date to compare to the Beginning Effective Date in each record to only return those records that are currently valid. Click the gear icon to access the drop-down menu for selection. Select date conditions from the dialog. Page 37 of 52

38 Optional Table Designate a table as optional by completing the following steps: 1. Click the gear icon. 2. Select Optional. This may apply if, for example, a table would not be used for a specific version of you ERP system. The template/report would still load. Page 38 of 52

39 Create New Template: Define Joins Overview In this section, you will continue with creating your integrity template for Accounts Payable and General Ledger Transaction Detail. Define Joins 1. Drag from the right table to the left table to create these inner joins. From AP Ledger (F0411) To Account Ledger (F0911) RPKCO RPDOC RPDCT RPICU RPICUT GLKCO GLDOC GLDCT GLICU GLICUT RPDGJ GLDGJ 2. Your screen will now look like this: 3. Note detail of the joins in the column on the right side of the screen. 4. Click OK. Page 39 of 52

40 Create New Template: Define/Review Column Options Overview In the example, the tables are already defines since they are included in standard templates. In the event a table is not defined, or to change the current definition, use Colum Options (QRA 403.2). View/Define Amounts View default column (field) options by completing the following steps: 1. Click the Column Definitions icon in the top left portion of the Template Designer screen. 2. Review settings and change as appropriate. Page 40 of 52

41 Create New Template: Add Filters and Columns Overview When the Template Designer is closed, DX creates a new blank inquiry. At this point, the inquiry has no columns defined, and no filters. Add new filters and arrange them in the filter window using the same Filter Layout tool available to Configurator users. Use filters to: Exclude irrelevant information. Reduce the volume of information returned. Reduce the time taken to return information. Add Filters Add filters by completing the following steps: 1. Expand the table or start tying the name in the search box at the top of the Add New Filters dialog. 2. Tick the checkbox for each field to make it available as a filter; for this example, select the following: GLKCO GLDOC GLDCT GLICU GLICUT GLDGJ 3. Click OK. 4. New filters are added to the list of Available Filters on the left side of the screen. Page 41 of 52

42 5. Expand the tree structure on the list to access the filters. Note: Click More Filters at the bottom of the screen to add additional filters to the list 6. Add the above filters plus VALUES (it will be available on the left side by default). 7. Add/Remove rows (left plus and eraser) or cells (right plus and minus) for up to 7 rows and 4 cells per row. 8. Add controls first drop the control, then the filter). Drop-Down Filter - to present the items in a drop-down list. Hierarchy Filter reserved for selecting hierarchies used in the report. Information Filter the filter is displayed on screen, but cannot be changed. Page 42 of 52

43 9. Select cell options. Remove - remove the current cell Rename - rename the label Show Description Only - available for drop-down filters Show Code & Description - available for drop-down filters Show All(*) Member - available for drop-down filters to select all items listed in the dropdown filter Read Only - view the values in the filter but the field is grayed out and not input capable No VA can type in a value but there is no Visual Assist to select a value Lock VA - locks the Visual Assist so that it only shows the values that have been defined in the filter 10. Click OK. 11. Your screen will now look like this: Add Value Columns Sometimes value fields from different tables can have the same field name (including the same field prefix), so a column name is not enough to differentiate between different values. To overcome this, Designer Express Inquiries replace the standard JDE two letter prefix with the JDE table name. For example, the accounts payable gross amount value is held in JDE as F0411.RPAG. In our values filter, this value is referred to as AG_F0411. Add value columns by completing the following steps: 1. Click in the Value filter. 2. Click the Visual Assist. 3. Click find in the Visual Assist to display the list of available values. 4. Select from the left and move to the right - in this example, select: AA_F0911 AG_F0411 Page 43 of 52

44 Note: the list of available values includes any values for tables that have been defined in any standard InsightUnlimited template or any DX template. Note: Calculations, time series and aging categories also create value columns. Add Label Columns Add/remove label columns by completing the following steps: Ribbon: Design> Layout 1. Click Columns Sorting & Grouping. 2. Click the Consolidation tab. 3. Columns added as filters are included in the list of available columns. 4. Move from Available Columns to Displayed Columns (from left to right panel) to include in the template (in this example, select all available columns). 5. Optionally click More Columns to add more columns to the list of Available Columns. 6. The columns dialog will look similar to this: 7. Click OK. Page 44 of 52

45 Create a New Template: Finalize Overview Use InsightUnlimited functionality to finalize your template including: Sorting and Grouping Calculations Title Formatting Permissions Output Options Template Description display from New dialog Add Finishing Touches Complete the following to add finishing touches: 1. Hide Document Company. 2. Columns will look like this: 3. Add a header for each company and display in the batch type column, format to have a dark blue background with white text. 4. Include a grand total. 5. Document Company: show code and description and hide the column. 6. Include a grand total. Page 45 of 52

46 7. The Sorting & Grouping dialog will look like this: 8. Change the heading for the amounts: AP Amount GL Amount 9. Display the saved report name in the title. 10. Create a calculation for the variance between the amount in the F0911 (GL) and the F0411 (AP). 11. Limit the data for initial testing. One company Date range of two months Batch type = vouchers Use the QBE line (Query by Example) to return the data only when the difference between the AP amount and GL amount is not equal to zero. 12. Results will look similar to this: Page 46 of 52

47 Test Driven Development Test Driven Development is a methodology commonly used in software development whereby a software specification is converted into a set of test cases with known inputs and expected outputs before any actual coding begins. Create supporting inquiries. o Base each on an individual table from the main inquiry. o Provides a clear view of the data that you may want to use in your inquiry. o Alerts you to any problems due to unpopulated columns or unexpected data in the tables. o May be used as target inquiries for linking/drilldown. Create test cases. o Pick sample input data. o Work through the joins to see what data you would expect to see. o Replicate any calculations. Save As Template Save your report as either a template or a report. If saved as a template, click New to use it to create a new report; if saved as a report, click Open to access. Page 47 of 52

48 Associate Template with Modules By default new templates are saved within the DX and can be associated with other modules by completing the following steps: 1. Access the New Inquiry dialog. 2. Highlight the template. 3. Click the Modules button. 4. Choose Module(s) to associate. 5. Template now appears in each module selected. Grant Permissions Permissions work exactly the same for DX templates/reports as they do for any other template/report within InsightUnlimited. Refer to QRA in the Quick Reference Guide for Reporting Users, or Community Portal, for more information. Page 48 of 52

49 Create New Template: Repeating Rows Overview In Designer Express reports, rows (or parts of rows), can be repeated (duplicated). Specifically, this happens when the report contains multiple fact tables joined on a one-to-many or many-to-many relationship. InsightUnlimited detects the multiple rows, and by default formats them differently to differentiate them from the other rows. There is also a design option used to designate whether to use all row combinations or not. Default View By default, the Duplicate Rows (Numbers) format style is grey text on a white background, and the data is suppressed. Page 49 of 52

50 Modify Duplicate Row Format The default for duplicate rows numbers (typically this is the only one you would change) is a grey font on a white background, with the data suppressed. You can optionally change this format style for Duplicate Rows (Numbers) by completing the following steps: Ribbon: Formatting> Format Type 1. Click on Default. 2. Highlight Duplicate Row or Duplicate Row (Numbers). 3. Click Edit. 4. Change font and/or background/uncheck Suppress Data. 5. Click OK. 6. Click OK. Display Duplicate Rows In the example that follows, the format for duplicate rows was changed to make viewing easier. The Suppress Data option is unchecked. Page 50 of 52

51 All Row Combinations Enable or disable the All Row Combinations option by completing the following steps: Ribbon: Design > Options Un/check All Row Combinations. Result: Page 51 of 52

52 Further Information Contacts For more information regarding our products, please contact us at: Web Customer Support For product support, please create a case with our Customer Support Department. Support Portal Notices and Disclaimer InsightUnlimited Reporting, InsightUnlimited Reconciler, InsightUnlimited Scheduler, InsightUnlimited Budgeting, InsightUnlimited Budgeting Lite, InsightUnlimited Designer, InsightUnlimited Console, InsightUnlimited Administrator and InsightUnlimited Personal Edition, are brand names of the InsightSoftware.com Group. InsightSoftware.com is a registered trademark of InsightSoftware.com Limited. Other product and company names mentioned herein may be the trademarks of their respective owners. The InsightSoftware.com Group is the owner or licensee of all intellectual property rights in this document, which are protected by copyright laws around the world. All such rights are reserved. The information contained in this document represents the current view of InsightSoftware.com on the issues discussed as of the date of publication. This document is for informational purposes only. InsightSoftware.com makes no representation, guarantee or warranty, expressed or implied, that the content of this document is accurate, complete or up to date. Page 52 of 52