Designer Express User Guide Summer 2011is.documentation.s3.amazonaws.com/Archive/User...

www.InsightSoftware.com

Version: 2.0 Last Updated: August 29, 2011

for JD Edwards World and EnterpriseOne

InsightSoftware.com Insight Designer Express User Guide

of 30

Contents

1. Introduction .......................................................................... 3

Welcome ............................................................................................................................... 3 Using this Guide ................................................................................................................... 3 Indexing ................................................................................................................................ 3 Who Should be a DX Designer? ......................................................................................... 3 What Knowledge is Required for the Different Levels of Insight Designer Express Users? ................................................................................................................................... 3

2. Designer Express Features ................................................. 4

Features ................................................................................................................................ 4

3. Administration Tool Setup .................................................. 5

Licensing .............................................................................................................................. 5 Insight Profile ....................................................................................................................... 7

4. Creating a New Template or Report ................................. 10

Add Tables .......................................................................................................................... 10 Define Joins ........................................................................................................................ 11 Define Suggested Master Table Joins ............................................................................. 14 Define Amounts .................................................................................................................. 16 Review and Edit Selections .............................................................................................. 22

5. Repeating Rows ................................................................. 23

Formatting .......................................................................................................................... 23 Design Option ..................................................................................................................... 25

6. Export/Import DX Reports ................................................. 26

Exporting DX Reports ........................................................................................................ 26 Importing DX Reports ........................................................................................................ 29 Exporting/Importing, and Opening DX Reports Using a Different JDE Version Profile ............................................................................................................................................. 29

7. Further Information ........................................................... 30

Contacts .............................................................................................................................. 30 Technical Support .............................................................................................................. 30 Notices and Disclaimer ..................................................................................................... 30


of 30

Welcome

Insight Designer

Express™ Edition, also referred to as DX (pronounced Dex),

is available as of the Winter 2011 for JDE release. DX enables Insight Designer users to create new templates, through a simple user interface, over standard and custom JD Edwards tables. In these templates, multiple joins can be created to multiple tables. Once a new template is created, Insight users can create reports from the template using standard functionality.

Using this Guide In order to get the most out of this guide, we have used the following symbol to highlight important concepts:

NB IMPORTANT INFORMATION

Indexing It is highly recommended that any table configured to be used in Designer Express should have the proper indexes created. 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.

Who Should be a DX Designer? It is essential that users who are developing reports using Designer Express are advanced users with an in-depth knowledge of JD Edwards tables, fields and table joins. This guide is written for these advanced users.

What Knowledge is Required for the Different Levels of Insight Designer Express Users?

Insight Designer Express™

User

Use of Designer Express

JDE Knowledge Required

Insight® Knowledge Required

Designer Create custom templates

In-depth knowledge of JDE table structures, table joins, and JDE data required

Yes - advanced knowledge

Power User Create reports from custom templates

Helpful but not required Yes - anywhere from basic to advanced knowledge

Console User Run reports No No


of 30

Features Designer Express offers many features, including the following:

Users can create new templates based on multiple fact tables

There is no ‘double-counting’ with totalling done

Several join types can be used: inner, left outer, and right outer

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 is supported

Once a template is saved, power users can create reports with standard capabilities including:

o Descriptions o Hierarchies created manually (not imported) o Default Calculations o User-defined Captions o Show SQL o Export to Excel/PDF o QBE, or Query by Example (other than for value columns if

subtotalling is enabled) o Fixed value selectors o RIO, or Reusable Inquiry Objects (DX objects can be shared

between DX reports or templates)


of 30

Licensing The license key being used must include a license for the Designer Express feature. Then the power user who will be using this feature must be configured with a license via License Assignments:

There are two types of license keys related to Designer Express: Designer Express (DX) Designer Express Designer (DXD)


of 30

Designer Express vs. Designer Express Designer

Designer Express (DX) – this license is for those users who can access and create inquires based off of the templates created by users with a DXD license. Users with this license will see the DX module tab and all templates created by DX will be listed here:

Designer Express Designer (DXD) – this license is for the advanced users who create new templates using Designer Express. Users with this license will see the DX module tab. All templates created by DX are listed here as well as New Template, used to create a template from scratch.

NB USERS WITH A DESIGNER EXPRESS DESIGNER (DXD) LICENSE ALSO MUST HAVE A

LICENSE AND LICENSE ASSIGNMENT FOR CONFIGURATOR IN ORDER TO BE ABLE TO

CREATE NEW TEMPLATES.

Console and Designer Express

In order for Console users to view and run reports created in Designer Express, they must have both a Console users and a Designer Express (DX) license.


of 30

Insight Profile Existing Insight Profiles in the Administration Tool must be updated to incorporate additional information for Designer Express. The first addition is in the Module Selection step as shown below, where Designer Express must be selected if this feature is to be available in this profile.

When Designer Express has been enabled in the profile, the next step in the profile wizard is to define the specific information needed for this feature. The Object Librarian Master Table (F9860) / [F9801 for JDE World] – where all objects are stored

Connection – set how to connect to the F9860 table, whether it is the same Insight Connection as that being used to connect to your JDE Data, or whether it is a different Connection

Object Library – define the library where the F9860 resides (allows you to map to tables not configured in the profile) Choose Tables – define the tables which will be used in new templates if they are not already mapped


of 30

Once the tables are chosen, define the table locations in the profile. (Note that DX is added to the module list for each table.)


of 30

Another way to access the Designer Express Setup within the Profile wizard is to right click on the appropriate profile and select Edit Designer Express Settings.

NB THE DESIGNER EXPRESS FEATURE MUST BE TURNED ON WHEN GOING THROUGH THE

FULL PROFILE WIZARD. ONLY THE DESIGNER EXPRESS AND TABLE LOCATIONS

SCREENS ARE SHOWN WHEN CHOOSING THE EDIT DESIGNER EXPRESS SETTINGS.


of 30

Add Tables To create a new template or report using Designer Express Designer, log into Insight. Click New, select the Designer Express (DX) Module Tab, and then choose New Template. Immediately, the Add Tables to View Dialog appears where you add the tables needed for your report. You can use the QBE line to narrow down your table selection and then move selected tables to the right panel under Selected Tables. At this time, you do not need to add any master tables (such as Address Book, Business Unit Master or Company Master) in which to join. You will have an option later to add suggested Master Tables if needed. Click OK after you have selected the tables you would like to join for your report.


of 30

Define Joins The next step is defining your joins between the tables you selected. You can define your join by using the QBE to search for the fields you want to join. You can search on either Name or Description. Once you see the fields you want to join in each table, you simply connect the fields by dragging your mouse from one table to the other as demonstrated below:

Once the first join has been defined, you will see the join definition listed in the panel on the right. You can edit the join by either clicking on the ‘=’ sign between the tables or highlighting the join from the right side panel and selecting the Edit Join Button located at the bottom of the panel. This launches the Join Properties Dialog.


of 30

Within this dialog, you can define more fields to join as well as define the join type to be used between the two tables. Your options of join types are below. You can hover over each join type to get a description of what each join type accomplishes:

Inner – Include only records where both tables meet the criteria

Left Outer – Include all rows from Table A, and just those rows from Table B which meet the criteria

Right Outer – Include all rows from Table B, and just those rows from Table A which meet the criteria

You can also choose to define Literal Values if you choose. When this box is checked, you can define a specific field value in the join, such as the option to only join when the Business Unit = 30 in the Customer Ledger (F03B11), RPMCU field, as in the example below:


of 30

Joining to the Same Table

One significant benefit of using Designer Express is that you can join to the same table multiple times. This feature is perfect for joining to the same master table multiple times. For example, if you are joining the Sales Order Detail (F4211) to the Address Book Master (F0101), you may want to base the join on Sold To, Ship To and Parent:


of 30

Define Suggested Master Table Joins The next step is to define any Master Table joins you would like to include in your report or template. To define these, select the Manage Suggested Master Table Joins button in the ribbon:

To start defining your joins to each table, select the appropriate To Table from the column using the dropdown provided:

When you define a Company Constants table join, you are prompted to select which company field you wish to use in the join.


of 30

In the below example, we have selected Table F03B11 and can choose to join to either RPCO or PRKCO:

When you define a join to F4101 Item Master you are again prompted with a choice of fields to join with:

ITM – Item Number Short

LITM – 2nd

Item Number

AITM – 3rd

Item Number


of 30

Define Amounts Fields need to be defined as either an Amount or Quantity for subtotal and totalling purposes. As of the Summer 2011 Version, with the addition of Insight Default Metadata, the quantity and amount columns for all tables that we currently map to are pre-defined and will automatically default into the template. (If you have set any overrides, these will take precedence.)

NB DURING AN UPGRADE TO SUMMER 2011, IF A JDE LABEL FIELD HAS BEEN PREVIOUSLY

DEFINED IN DX AS AN AMOUNT, THE FIELD DEFINITION WILL BE OVERWRITTEN TO BE

AN AMOUNT. IF NEEDED THIS FIELD DEFINITION CAN BE CHANGED BACK USING DXD.

To verify how these fields are defined, select the Amount Columns Tab located in the top left portion of your screen:

Each table you have defined a join to will display with its available numeric fields to define. You can sort the list by using the QBE for any displayed column in order to narrow down your selection. The below information is particularly useful when using custom definitions for amount fields.

NB ONCE YOU A FIELD IS MANUALLY DEFINED AS EITHER AN AMOUNT OR AMOUNT NON-CURRENCY (QUANTITY) FOR A SPECIFIC TABLE, IT DOES NOT NEED TO BE DEFINED

AGAIN WHEN WHEN CREATING A NEW TEMPLATE OR REPORT USING THE SAME TABLE.

Currency-based Decimal Shifting

Once you define a field as an amount, you have further options to define using the dropdown menu to the right of the amount type. These options determine how the decimal shifting is performed.

Domestic Currency Shifting

If you define a field as an Amount (Domestic), you are prompted to select the company on which the currency is based.

For example, if you set the RPAG field from the F0411 as Amount (Domestic), you can choose from the following options:


of 30

RPCO – Company

RPKCO – Document Company

RPOKCO – Document Company (Original Order)

RPPKCO – Document Company (Purchase Order) The following diagram shows that if a company column is defined in this dropdown menu, the currency of that company (as set in the F0010 Table) will be used as this field’s Domestic Currency, and the number of decimals for that currency is used. If no other option is selected, the default currency decimal setting of 2 will be used.

Company column defined?Yes

NoLookup company currency

F0010

Fail Default shift of 2 places


of 30

Foreign Currency Shifting

If you define a field as an Amount (Foreign), you then select the field on which to base the currency code:

For example, if you set the GLAA field from the F0911 as Amount (Foreign), you can choose from the following options:

GLBCRC – Currency Code Base

GLCRCD – Currency Code From It is important to know that the selected option may or may not be used depending on the Ledger Type Override Setting in the Foreign Currency Columns Dialog, as well as various lookup tables in JD Edwards. The Foreign Currency Columns Dialog is accessed by clicking on the … next to the Currency dropdown menu:

See the Ledger Type Override setting in the lower left corner of the dialog. If this is checked, lookup tables may be used to find the currency instead of the selected columns in the right panel of this dialog.

NB THE LEDGER TYPE OVERRIDE SETTING IS GRAYED OUT WHEN THERE IS NO LEDGER

TYPE COLUMN IN THAT TABLE.


of 30

There are several rules with the currency-based decimal shifting, and these rules are different for the GLAA field in the F0911 than they are for all other amount fields. The diagrams below show how the default number of decimals is determined.

F0911- GLAA Field

First, you must see if the Ledger Type Override is checked. From there, follow the Yes/No paths as to when the lookup tables and the selected currency columns in the Foreign Currency Columns Dialog are used.

Ledger override ticked?YesNo

Lookup currency columns in order

specified

Fail

Default shift of 2 places

Row has LT value ‘AA’?

Yes

Lookup company currency

F0010

No

Row has LT value ‘CA’?


specified

Yes

Lookup ledger type currency

F0025

No

Fail


F0010

Fail

Fail


F0010

Fail

Fail

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)


of 30

All Measures other than GLAA Field in F0911

For all measures other than the GLAA field in the F0911, different rules are followed. First, you must see if the Ledger Type Override is checked. From there, follow the Yes/No paths:

Ledger override ticked?Yes No


specified

Fail

Default shift of 2 places

Lookup ledger type currency

F0025Fail


F0010

Fail

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)


of 30

Amount (Non-currency)

You may need to define a field as Amount Non-currency) for your quantity fields. In the same example, there are many quantity fields in the F42119 to define as Amount (Non-currency) as seen below:


of 30

Review and Edit Selections Once you have completed defining all your amount and quantity fields, you can select the Table and Joins Tab to review your joins and table selections. If you have defined multiple tables, you may need to scroll to view all tables selected from either the main workspace or the right join panel to review all your joins defined:

Once you are satisfied with your selections, click OK to exit Designer Express Designer (DXD) to begin defining your filters and columns using Configurator.

NB ONCE YOU LEAVE THE DESIGNER EXPRESS DESIGNER, YOU CAN ALWAYS GO BACK TO

REFINE OR REVIEW YOUR SELECTION. TO GAIN ACCESS, CLICK ON THE

CONFIGURATOR TAB AND SELECT TEMPLATE DESIGNER.


of 30

In Designer Express reports, rows (or parts of rows), can be repeated. Specifically, this happens when the report contains multiple fact tables joined on a one-to-many or many-to-many relationship. Insight 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.

Formatting The below example is a report that is joining the F0911 and F0411. The amounts that display in a light gray color are those that are repeating. This makes it much more clear on which rows are being used in the Grand Total amounts.

In Formatting Defaults, there are two items related to duplicate rows:

Duplicate Row – Formatting for the label columns in duplicate rows

Duplicate Row (Numbers) – Formatting for the values in duplicate rows


of 30

When you edit the Duplicate Row (Numbers) item, you see that the font color is gray:

If you changed this to Suppress Data, the result would like like this:


of 30

Design Option In the Design Menu, in the Options Group, there is an option to display All Row Combinations.

Selecting this option means that all rows will be displayed, even if they are being repeated:

See that the totals remain the same despite all row combinations being displayed.


of 30

DX reports can be exported and imported in the Administration Tool. This is done by exporting/importing the Designer Dictionary as well as the report itself.

NB THE DESIGNER DICTIONARY STORES ALL THE INFORMATION RELATED TO THE VALUES

IN THE REPORT.

Exporting DX Reports First, locate the report you want to export in the Admin Tool and enable the Table Names column. Do this by right clicking in the column header area in the right hand panel and selecting Table Names.


of 30

The Table Names column lists which tables the report is using. In this example, the report relies on the F0911, F0411, F0901, and F0101 tables:

Go up to the Designer Objects area in the left hand panel and drill down to find the tables. Note that they are listed under a folder named with the JDE version that was used when creating the report. In this case, it was JDE 8.10.

In this example, we have entries for the F0411 and F0911, which are the two tables that have amount fields. (The F0901 and F0101 were also used to create the report, but they are not listed under Designer Objects since they do not have amounts.) To export this report, you would need to export the content of the F0411 and F0911 folders here along with the original report. The easiest way to do this is to drag the entire Designer Dictionary to the Export folder. Start the export by right clicking on Import/Export and choosing Begin Export:


of 30

Drag the Designer Dictionary to the Import/Export folder.


of 30

Then drag the report into the Import/Export folder as well, just as you would normally export a report.

Finally, save the file by right clicking on Import/Export and choosing Save to File.

Importing DX Reports To import a file, right click on Import/Export and choose Open File. After choosing the file, the contents will be displayed in the staging area on the right hand panel. You need to drag and drop both the Designer Dictionary as well as the report itself into your repository in the left hand panel.

Exporting/Importing, and Opening DX Reports Using a Different JDE Version Profile

If you export/import or open a DX inquiry using a different JDE version profile other than the profile you used to create the inquiry (i.e. it was created in JDE 8.10 and you want to use it in a JDE 9.0 profile), the defined amounts (Amounts column) related with that inquiry will not pass over. The recommended way to add these Amounts into the inquiry is to open the inquiry in the new JDE version profile and add them again, defining the amounts and the decimal shifting. Then save the report and use this report version when using the related JDE version profile.


of 30

Contacts

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

E-Mail

[email protected]

Web www.InsightSoftware.com

Technical Support For Technical Support, please access the Customer Support Center:

Web Link

www.InsightSoftware.com/support

Notices and Disclaimer Insight, Console, Reconciler and GL Inquiry are trademarks of InsightSoftware.com Limited. InsightSoftware.com is a registered trademark of InsightSoftware.com Limited. Oracle, JD Edwards, JD Edwards EnterpriseOne, JD Edwards World and Oracle E-Business are registered trademarks of Oracle Corporation. Other product and company names mentioned herein may be the trademarks of their respective owners. The information contained in this document represents the current view of InsightSoftware.com on the issues discussed as of the date of publication. InsightSoftware.com cannot guarantee the accuracy of any information presented after the date of publication. This document is for informational purposes only. InsightSoftware.com makes no warranties, expressed or implied, in this document. © 2000-2009 InsightSoftware.com Limited. All rights reserved.

mailto:[email protected]

http://www.insightsoftware.com/

http://www.insightsoftware.com/support

Designer Express User Guide Summer 2011is.documentation.s3.amazonaws.com/Archive/User...

Documents

Transcript of Designer Express User Guide Summer 2011is.documentation.s3.amazonaws.com/Archive/User...