InsightUnlimited Designer Express User Guide for JDEis.community.s3.amazonaws.com/Training/InsightDesigner/Insight... · InsightUnlimited Version: 2014.1 and above Document Version:

InsightUnlimited Version: 2014.1 and above

Document Version: 6.3 | Last Updated: July 29, 2014

InsightUnlimited

Designer Express™ User

Guide for JDE

June 2014

Designer Express User Guide

Page 2 of 52

©2011-2014 InsightSoftware.com International. All Rights Reserved.

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 – 401.2........................... 10

Where to Begin ............................................................................................................................................................ 10

Considerations ............................................................................................................................................................. 10

Best Practices ............................................................................................................................................................... 11

Template/ Report Specifications .............................................................................................................................. 11

InsightUnlimited DX Administration: Designer Express Licensing – 402.1.................... 12

Overview ........................................................................................................................................................................ 12

License Key Types ........................................................................................................................................................ 12

Assign Licenses ............................................................................................................................................................ 13

Administration: InsightUnlimited Profile – 402.2 ............................................................. 14

Overview ........................................................................................................................................................................ 14

Update InsightUnlimited Profile(s) ........................................................................................................................... 14

The Object Library Master ......................................................................................................................................... 15

Primary Keys and Indexing ........................................................................................................................................ 16

Map to Tables Outside of JDE ................................................................................................................................... 16

Designer Dictionary ..................................................................................................................................................... 16

SQL Capability ............................................................................................................................................................... 17

View SQL ........................................................................................................................................................................ 18

Create New Template: Tables – 403.1 ................................................................................ 20

Overview ........................................................................................................................................................................ 20

Add Tables ..................................................................................................................................................................... 20

Additional Options ....................................................................................................................................................... 22

Inline/Outline View Mode .......................................................................................................................................... 23

Create New Template: Column Options – 403.2 ............................................................... 24

Overview ........................................................................................................................................................................ 24

Set Column Options .................................................................................................................................................... 24


Page 3 of 52


Field Type ....................................................................................................................................................................... 25

Lookups ......................................................................................................................................................................... 26

Source ............................................................................................................................................................................ 27

Currency and Decimal Shifting ................................................................................................................................. 28

Create New Template: Understand Table Joins – 403.3 ................................................... 31

Overview ........................................................................................................................................................................ 31

Inner Joins ...................................................................................................................................................................... 31

Outer Joins .................................................................................................................................................................... 33

Add Master Tables ....................................................................................................................................................... 33

Joining to the Same Table .......................................................................................................................................... 34

Unions ............................................................................................................................................................................ 35

Padding Overrides ....................................................................................................................................................... 36

Effective Date Processing .......................................................................................................................................... 37

Optional Table .............................................................................................................................................................. 38

Create New Template: Define Joins – 403.4 ....................................................................... 39

Overview ........................................................................................................................................................................ 39

Define Joins ................................................................................................................................................................... 39

Create New Template: Define/Review Column Options – 403.5 ..................................... 40

Overview ........................................................................................................................................................................ 40

View/Define Amounts ................................................................................................................................................. 40

Create New Template: Add Filters and Columns – 403.6 ................................................. 41

Overview ........................................................................................................................................................................ 41

Add Filters ...................................................................................................................................................................... 41

Add Value Columns ..................................................................................................................................................... 43

Add Label Columns ..................................................................................................................................................... 44

Create a New Template: Finalize – 403.7 ........................................................................... 45

Overview ........................................................................................................................................................................ 45

Add Finishing Touches................................................................................................................................................ 45

Test Driven Development .......................................................................................................................................... 47

Save As Template ......................................................................................................................................................... 47

Associate Template with Modules ........................................................................................................................... 48

Grant Permissions ....................................................................................................................................................... 48


Page 4 of 52


Create New Template: Repeating Rows – 403.8 ................................................................ 49

Overview ........................................................................................................................................................................ 49

Default View .................................................................................................................................................................. 49

Modify Duplicate Row Format .................................................................................................................................. 50

Display Duplicate Rows .............................................................................................................................................. 50

All Row Combinations ................................................................................................................................................. 51

Further Information ............................................................................................................. 52

Contacts ......................................................................................................................................................................... 52

Customer Support ....................................................................................................................................................... 52

Notices and Disclaimer............................................................................................................................................... 52


Page 5 of 52


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 end-

user 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

Introduction


Page 6 of 52


o User-defined Captions

o Show SQL

o Export to Microsoft Excel®/PDF

o QBE, or Query by Example (other than for value columns if subtotaling is enabled)

o Fixed value selectors

o RIO, or Reusable Inquiry Objects (DX objects can be shared between DX reports or

templates)

o Linking/Drilling to/from reports within DX or to/from standard reports and templates


Page 7 of 52


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.

Template Types


Page 8 of 52


The following graphic depicts a comparison of standard template functionality compared to the

functionality available in Designer Express:

Subtotals & Grand Total

Export to Excel or PDF

Titles and Subtitles

Consolidation

Formatting

Pivoting

Hierarchies

Calculations

Sorting and Ranking

Charts & Graphs

JDE Custom Tables

Show Values from More Than One Table

on One Line

Specify Join Types

Show Values from Multiple

Tables Cross-Table

Calculations

Access All JDE Data Tables

Specify Fields in Table Joins

Budgeting

Group Filters

Automatic Hierarchy

Import

History Tables Percent Split

Count & Average

Aggregations

Aging Categorie

s

Current

Period

As Of Date

BU Snapsh

ots

Standard

Templates

Designer Express

Templates

Busines

s Logic


Page 9 of 52


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 10 of 52


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

InsightUnlimited Designer Express: Designer

Considerations – 401.2


Page 11 of 52


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 12 of 52


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.

InsightUnlimited DX Administration: Designer

Express Licensing – 402.1


Page 13 of 52


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 14 of 52


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.

Administration: InsightUnlimited Profile – 402.2


Page 15 of 52


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...

8. 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 16 of 52


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 17 of 52


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 18 of 52


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 19 of 52


7. Position as preferred in the right column.

8. Click OK.

9. Example of viewing SQL.


Page 20 of 52


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).

Create New Template: Tables – 403.1


Page 21 of 52


9. Select tables and move them to the right side by using the arrows in the center or double-

clicking 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 22 of 52


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 23 of 52


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 24 of 52


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:

Create New Template: Column Options – 403.2


Page 25 of 52


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 26 of 52


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 27 of 52


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 28 of 52


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 29 of 52


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 30 of 52


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 31 of 52


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).

Create New Template: Understand Table Joins –

403.3


Page 32 of 52


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 33 of 52


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 34 of 52


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 35 of 52


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 36 of 52


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 37 of 52


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 38 of 52


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 39 of 52


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 GLKCO

RPDOC GLDOC

RPDCT GLDCT

RPICU GLICU

RPICUT 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.

Create New Template: Define Joins – 403.4


Page 40 of 52


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.

Create New Template: Define/Review Column

Options – 403.5


Page 41 of 52


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.

Create New Template: Add Filters and Columns –

403.6


Page 42 of 52


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 43 of 52


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 drop-

down 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 44 of 52


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 45 of 52


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.

Create a New Template: Finalize – 403.7


Page 46 of 52


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 47 of 52


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 48 of 52


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 108.2 in the Quick Reference Guide for

Reporting Users, or Community Portal, for more information.


Page 49 of 52


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.

Create New Template: Repeating Rows – 403.8


Page 50 of 52


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 51 of 52


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 52 of 52


Contacts

For more information regarding our products, please contact us at:

Email [email protected]

Web www.insightsoftware.com

Customer Support

For product support, please create a case with our Customer Support Department.

Support Portal http://supportportal.insightsoftware.com/

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.

Further Information

mailto:[email protected]

http://www.insightsoftware.com/

http://supportportal.insightsoftware.com/