Business View Design Guide
Business View Design Guide
EnterpriseOne
Tools
9.2
JD Edwards EnterpriseOne Tools
Business View Design Guide
9.2
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected
by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate,
broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering,
disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report
them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then
the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs (including any operating system, integrated software, any programs embedded, installed or
activated on delivered hardware, and modifications of such programs) and Oracle computer documentation or other Oracle data delivered to or
accessed by U.S. Government end users are "commercial computer software" or "commercial computer software documentation" pursuant to the
applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, reproduction, duplication, release, display,
disclosure, modification, preparation of derivative works, and/or adaptation of i) Oracle programs (including any operating system, integrated
software, any programs embedded, installed or activated on delivered hardware, and modifications of such programs), ii) Oracle computer
documentation and/or iii) other Oracle data, is subject to the rights and limitations specified in the license contained in the applicable contract. The
terms governing the U.S. Government's use of Oracle cloud services are defined by the applicable contract for such services. No other rights are
granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for
use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware
in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe
use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Inside are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks
or registered trademarks of SPARC International, Inc. AMD, Epyc, and the AMD logo are trademarks or registered trademarks of Advanced Micro
Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle
Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and
services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible
for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable
agreement between you and Oracle.
JD Edwards EnterpriseOne Tools
Business View Design Guide
Contents
Preface .................................................................................................................................. i
Index ........................................................................................................................................................... 23
JD Edwards EnterpriseOne Tools
Business View Design Guide
JD Edwards EnterpriseOne Tools Preface
Business View Design Guide
Preface
Welcome to the JD Edwards EnterpriseOne documentation.
Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://
www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc .
Related Information
For additional information about JD Edwards EnterpriseOne applications, features, content, and training, visit the JD
Edwards EnterpriseOne pages on the JD Edwards Resource Library located at:
http://learnjde.com
Conventions
The following text conventions are used in this document:
Convention Meaning
Bold Boldface type indicates graphical user interface elements associated with an action or terms defined in
text or the glossary.
Italics Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular
values.
Monospace Monospace type indicates commands within a paragraph, URLs, code examples, text that appears on a
screen, or text that you enter.
> Oracle by Example Indicates a link to an Oracle by Example (OBE). OBEs provide hands-on, step- by-step instructions,
including screen captures that guide you through a process using your own environment. Access to
OBEs requires a valid Oracle account.
i
JD Edwards EnterpriseOne Tools Preface
Business View Design Guide
ii
JD Edwards EnterpriseOne Tools Chapter 1
Business View Design Guide Understanding Business Views
Business views are required for creating applications and generating reports. Business views:
• Link a JD Edwards EnterpriseOne application to one or more tables.
• Contain all or a subset of data items from one or more tables.
• Can use table joins to join multiple tables on common fields.
• Are building blocks for text search indexes that enable full-text searching of data.
To make a business view available for full-text searching, select the Text Search option on the properties
form. Do not select this option if you do not plan to use the business view for full-text searching; doing so can
negatively affect performance.
Table Joins
Use the table join feature to join multiple tables in a business view. Joining tables enables you to combine fields from
different tables for each record of the primary table. Perform the join using fields that are common to the tables. Define
the joined fields to satisfy a join condition, such as when the records, or rows, have the same value in the key fields.
The primary table is the table where you initiate the join (usually the table on the left in JD Edwards EnterpriseOne
Table Design Aid) and the secondary table is the table where you conclude the join (usually the table on the right in JD
Edwards EnterpriseOne Table Design Aid). Several types of joins exist, including those described in the following table:
Simple join, also known as inner join Includes only rows that match both the primary and secondary tables.
Right outer join Includes rows that are common to both the primary and secondary tables, and unmatched rows from
the secondary table.
1
JD Edwards EnterpriseOne Tools Chapter 1
Business View Design Guide Understanding Business Views
Left outer join Includes rows that are common to both the primary and secondary tables, and unmatched rows from
the primary table.
SQL 92 left outer join Includes rows that are common to both the primary and secondary tables, unmatched rows from the
primary table, and any rows with null values from the secondary table—regardless of any Where clause
against the fields from the secondary table.
2
JD Edwards EnterpriseOne Tools Chapter 1
Business View Design Guide Understanding Business Views
Table Unions
A table union joins entire tables. There are two options for table unions:
• Union
• Union All
With the Union option, the system first checks for rows from the primary table, and then for rows with corresponding
columns from the secondary table. If the rows from the two tables contain identical data, then only one of the records
is retrieved in the union. Unions include rows from the primary table and corresponding columns from the secondary
table.
With Union All, the system first checks for rows from the primary table, and then for rows with corresponding columns
from the secondary table. Duplicate records are retrieved if the rows from the two tables contain identical data. Because
Union All does not scan for distinct records, the retrieval time is faster than when using the Union option.
Select Distinct
If a business view includes the primary key fields of the primary table, every row of the business view query is unique.
The primary key field has a different value in each row, or record, of the primary table. If the business view does not
contain all primary key fields of the primary table, then duplicate rows can occur during the business view query. You
can eliminate the duplicate rows in the output by using the Select Distinct feature when designing the business view.
For example, this table shows the records from the primary table that are used for the Distinct Union All output:
3
JD Edwards EnterpriseOne Tools Chapter 1
Business View Design Guide Understanding Business Views
This table shows the records from the secondary table that are used for the Distinct Union All output:
This example shows the result set from the Distinct Union All joining of the two tables:
Employment Date
1/5/2009
2/8/2009
1/5/2009
9/23/2009
3/7/2009
4
JD Edwards EnterpriseOne Tools Chapter 1
Business View Design Guide Understanding Business Views
always included in the business view. Business views then carry information from the table to an application. To carry
forward additional information other than the primary key fields, select additional fields to include in the business view.
5
JD Edwards EnterpriseOne Tools Chapter 1
Business View Design Guide Understanding Business Views
6
JD Edwards EnterpriseOne Tools Chapter 2
Business View Design Guide Designing Business Views
Business views usually contain a few more fields than are used on the form, in the grid, or in the batch application.
The unused fields are related to the fields that are required. If requirements change, these fields can be added to the
application without redesigning the business view.
You can modify business views to reflect changes in business requirements. You can easily add fields to existing
business views. Deleting fields from business views, however, is more complicated. If you need to delete fields from a
business view, ensure that those fields are not currently used in an interactive or batch application.
You can use different business views for each form type that is included in an interactive application. Typically, search
& select forms include the minimum number of fields that are required to keep them at a nominal size. Search & select
forms should include:
Input-capable forms are usually large and include all of the fields from the table. They should include all of the fields
that are necessary to add or update a record, including audit information.
VzzzzzzA,where:
For example, V0101A is the first business view that is created over the F0101 table, V0101B is the second business view
that is created over the same table, and V0101C is the third business view that is created.
7
JD Edwards EnterpriseOne Tools Chapter 2
Business View Design Guide Designing Business Views
Vssss9999,where:
Provide a business view description with a maximum of 60 characters. It should reflect the application description
followed by the form type, for example, Item Master Browse and Item Master Revisions.
Primary key fields should remain in the business view and should not be reorganized. If you try to remove a primary key
field, you receive an error message.
Note: At least one business view for each table should include all columns from the table. Only one business view is
allowed for each form type, except for a header detail form. You can use two business views on header detail forms,
one for the header portion of the form and one for the detail portion.
For example, create a joined table business view by joining the F4101 (Item Master) table and the F4102 (Item Branch)
table. The F4101 table is the primary table, so the business view should be named:
8
JD Edwards EnterpriseOne Tools Chapter 2
Business View Design Guide Designing Business Views
Form Description
Table Joins Displays the tables that you select, along with the columns that are included in the tables. A key icon
appears next to the primary key fields. The primary key fields are fields that are included in the primary
index of the table. The primary table is where an application begins a search.
Available Tables Enables you to locate tables and move them to the Table Joins form.
Selected Columns Displays the data items that you select from the table to include in the business view.
Object Properties Displays the properties of a data item that is selected in the Selected Columns form.
Consider these results when deleting business views and components of business views:
Deletion Results
Deleting a data item from a business view. If the data item is used in an application, you receive an error message when you attempt to run the
application. If this occurs, you must open the application and delete the data item from the application.
Deleting an entire table from a business You cannot run any of the applications that use the business view. If this occurs, you must open the
view. application and delete all items that reside in the deleted table or attach a different business view to the
application and reconnect all of the controls.
Deleting an entire business view. Any forms that use the business view will fail. If this occurs, you must select a new business view for
the forms and reconnect all of the controls.
Note: To ensure maximum performance in applications, use these guidelines for the number of tables that are joined
in a business view:
• Join five tables if all joins are simple joins.
• Join three tables if any of the joins is an outer join or in the event of a table union.
9
JD Edwards EnterpriseOne Tools Chapter 2
Business View Design Guide Designing Business Views
Note:
• Creating Table Joins.
Select the data items that are required by the interactive or batch application to include in the business view. When you
create an application, you do not have to use every item in the business view. Balance between keeping the business
view small for maximum performance and including enough fields to allow for future business requirements.
If the required data item appears in multiple tables, you typically want to select the data item from the primary table.
Selecting the same data item from multiple tables causes the data item to appear multiple times in the business view.
Each data item that is added to the business view includes its own table reference to identify its origin.
Note: If you include multiple tables in a joined business view, the primary key fields are automatically selected from
the tables. You cannot remove the primary key fields from the business view.
If you include multiple tables in the business view, you must join the tables using a table join. You typically want to join
tables on common key fields. You might also need to join on additional fields. You should join on as many fields as
necessary to ensure that the data is fetched properly for each record. The joins must be performed on fields of the same
field type.
Note: To ensure maximum system performance, do not include more than 256 columns in business views.
Note:
• Creating Table Joins.
Select Distinct
When a business view includes the primary key fields of the primary table, every row of the business view query is
unique. If for some reason the business view does not contain all primary key fields of the primary table, then duplicate
rows can occur during the business view query.
For example, JD Edwards EnterpriseOne Journal Entry is unique by line number and document number. However, each
document can contain multiple lines. If you need to display only one record per document, you can use Select Distinct to
fetch only the first occurrence of the document number, not all of the detail lines within the document.
Business views that include a primary table that contains any of the following columns, which are used for currency
support and security, might cause the Select Distinct feature to display duplicate values:
10
JD Edwards EnterpriseOne Tools Chapter 2
Business View Design Guide Designing Business Views
Column Description
CO Company
LT Ledger Type
AID Account ID
MMCU Branch
1. In JD Edwards EnterpriseOne Business View Design Aid, select the primary table.
2. From the Table menu, select Change Index to change the primary table index.
The system displays a warning indicating that the selected column list will be changed.
3. Click Yes to continue.
The Available Indices form appears. The first edit field on the form displays the current index of the table that is
used by the business view. The default is the primary index.
11
JD Edwards EnterpriseOne Tools Chapter 2
Business View Design Guide Designing Business Views
4. For this example, select Key by Formtyp, Evtype, Obj from Available Indices, and click OK.
The Table Joins form and the Selected Columns form reflect the keys of the new index.
5. Save the changes and quit JD Edwards EnterpriseOne Business View Design Aid.
If you run an application that uses the V98EVDTL business view with Select Distinct disabled and the changed
business view index (Key by Formtyp, Evtyp, Obj), the generated SQL statement is:
Using this example, you might now have 281 rows of data from table F98EVDTL.
6. Reopen the V98EVDTL business view.
7. From the File menu, select Select Distinct.
8. Select Change Index to select the Key by Formtyp, Evtyp, Obj index from Available Indices, and then click OK.
9. Save the business view, and quit JD Edwards EnterpriseOne Business View Design Aid.
You might need to quit the software and sign in again. The software stores the business view in cache memory.
Even though you change a business view, the previous business view runs until it is cleared from cache.
Generate and rerun the same application using the V98EVDTL business view with Select Distinct activated. The
generated SQL statement is now:
Using this example, you might now have only 53 rows of data from table F98EVDTL.
Table Joins
Create table joins in business views to access data from multiple tables in a single application.
You typically use table joins for forms that are not input-capable, such as find browse forms, and reports. You do not
usually use joins for forms that update and add to the database. When you are updating the database, the relationship
between the records must be precise. If you must use a table join for an input-capable form, only use a join where the
relationship between the two tables is simple.
If a business view uses multiple tables, link the tables by establishing joins between columns in those tables. The links
define how rows from one table correspond to rows in another table.
When you join a column in one table to a column in another table, both columns must be of the same data type. You can
use the Object Properties form to view attributes for a column to determine whether you can use it in a join. The Object
Properties form displays the attributes of the data item that you have highlighted on the Selected Columns form.
Review each table and determine how the data in one table is related to the data in the other tables. You might need to
add columns or build new indices in a table, or even create new tables. If you build new indices, consider your business
needs carefully before you do so.
Note: To ensure maximum performance in applications, use these guidelines for the number of tables joined in a
business view:
• Fifteen tables if all joins are simple joins.
• Fifteen tables if any of the joins is an outer join or in the event of a table union.
12
JD Edwards EnterpriseOne Tools Chapter 2
Business View Design Guide Designing Business Views
To join columns in a table join business view, use the mouse cursor to draw a line from a column in the primary table to
the associated column in a secondary table. When you click the line that you drew, you can define the join by selecting
a join type and an operator from the Join menu. These menu options are not available until you have clicked the line
joining the columns.
The default join type is simple, and the default operator is equal. Available operators are:
• Equal (=)
• Not Equal (<>)
• Less than (<)
• Greater than (>)
• Less than or equal (< =)
• Greater than or equal (> =)
Table Unions
Use table unions to pull rows from tables that have the same structure. Table unions pull rows that exist in both tables.
The Union option is available only if the rows in one table are also included in the other table.
Union All retrieves all the rows, even the duplicate rows, from the primary and secondary tables.
Add EnterpriseOne W98220C Click the Objects node of Add a new object to a
Object to the Project a project, and click Add on project.
13
JD Edwards EnterpriseOne Tools Chapter 2
Business View Design Guide Designing Business Views
14
JD Edwards EnterpriseOne Tools Chapter 2
Business View Design Guide Designing Business Views
Select this option to indicate that the business view is used by the runtime engine during a text search. When designing
the business view, you must also add at least one GT (general text) data structure to the business view so that the
runtime engine can use it in text searches.
1. On the Design Tools tab, click Start the Business View Design Aid.
2. On the Available Tables form, use the query by example (QBE) line to search for an appropriate table.
3. Select one or more tables, and drag them to the Table Joins form.
This form is called Table Joins regardless of whether you are joining multiple tables or working on a single table.
4. If more than one table is selected, double-click the title bar of the appropriate table to designate it as the
primary table.
If the business view contains multiple tables, the system automatically designates the first table that is added to
the Table Joins form as the primary table. A crown icon appears in the upper-left corner of the primary table. If
a business view contains only one table, that table is the primary table by default.
Note: To delete a table from a business view, select the table and select Delete from the Table menu. You can
also right-click the table and select Delete from the pop-up menu.
1. On the Table Joins form, double-click the data items to include in the business view.
Selected data items appear with a check mark on the Table Joins form. As you select each data item, the system
displays it on the Selected Columns form.
2. To remove data items from a business view, double-click the data item either on the Table Joins form or on the
Selected Columns form.
This option changes the index of the primary table to a non-unique index.
15
JD Edwards EnterpriseOne Tools Chapter 2
Business View Design Guide Designing Business Views
1. On the Tables Joins form, click and draw a line that connects a column in the primary table to an associated
column in a secondary table.
Although the column names do not have to be the same, the attributes for Data Type and Decimals must
be identical before you can create a table join between two columns. To determine whether data items are
candidates for a join, click a data item on the Table Joins form and view the data item attributes that are
displayed on the Object Properties form.
2. Click the line that joins the two columns.
You can also right-click the join and select Delete from the pop-up menu.
1. From the Table menu, select either Union Mode or Union All Mode.
You can also click the Union or Union All button on the toolbar.
The Union and Union All features are available only if all columns in one table also reside in the other table.
2. Select the tables for which you want to create a table union.
You can also click the Union All button on the toolbar.
2. From the Table menu, select Distinct Mode.
You can also click the Distinct button on the toolbar. The Distinct Union All Mode feature is available only if all
columns in one table also reside in the other table.
3. Select the tables for the business view.
16
JD Edwards EnterpriseOne Tools Chapter 2
Business View Design Guide Designing Business Views
Create EnterpriseOne W98220WAB Click the Objects node of Add a new object to a
Object a project and click Add project.
in Object Management
Workbench - Web form.
Add Object W9861AWC Select Business View and Add business views.
click OK in the Create
EnterpriseOne Object form.
17
JD Edwards EnterpriseOne Tools Chapter 2
Business View Design Guide Designing Business Views
1. In the Object grid, click the business view object name, or select the object node, from the More Row Actions
drop-down menu, select Design to enter the Business View Design form.
2. The Business View Design form is in the Join Mode by default, but you can change to Union Mode or Union
All Mode by selecting them from the Table/Column Selection.
3. In the Available Tables pane, use the query by example (QBE) line to search for an appropriate table.
18
JD Edwards EnterpriseOne Tools Chapter 2
Business View Design Guide Designing Business Views
You can select one or more tables, the table you select will appear in the Selected Table pane.
Note: If more than one table is selected in Join Mode, you can’t change to Union Mode or Union All Mode,
but if you select more than one table in Union Mode or Union All Mode, you can change between them, but
you cannot select the Join Mode.
5. If more than one table is selected, click the primary option for the appropriate table to designate it as the
primary table.
If the business view contains multiple tables, the system automatically designates the first table that is added
to the Selected Table pane as the primary table. A green dot appears in the Primary column of the table. If a
business view contains only one table, that table is the primary table by default.
6. To delete a table from a business view, select the table and click Delete in the Selected Table pane.
1. In the Selected Columns pane, select the data items to include in the business view. You can click Select All to
select all the data items in the pane.
Selected data items appear with a check mark in the Selected Columns pane.
Note: Primary keys for the table are always selected by default for Join Business View, you can’t remove
them.
2. To remove data items from a business view, deselect the data item in the Selected Columns pane.
1. If you are in Join Mode and select more than one table, the Table Joins pane and Column Joins pane appears.
2. Click the Add row button in the Table Joins pane, a table join is added.
19
JD Edwards EnterpriseOne Tools Chapter 2
Business View Design Guide Designing Business Views
3. Select a table from the Left Table drop-down menu and select a table from the Right Table drop-down menu.
The Left Table drop/down and Right Table drop/down contains the list of tables selected from Selected
Tables pane. You can add up to 15 tables for a table join.
The selected data items for both the tables appear on the Left Table and Right Table tabs of the Column Joins
form respectively.
Note: If a join already exists for the two selected tables, the system shows an error.
4. Select an appropriate join type from the Join Type drop-down menu.
Simple is the default join type.
5. To delete a table join, click Delete in the Table Joins pane.
6. Click Add in the Column Join form, a column join is added.
7. Select a column from the Left Table tab, the column is added as the Left Column of the join.
Although the column names do not have to be the same, the attributes for Data Type and Decimals must be
identical before you can create a table join between two columns.
8. Select a column from the Right Table tab, the column is added as the Right Column of the join.
Select an appropriate operator from the Join Operator drop-down menu. Equal is the default join operator.
9. To delete a column join, click Delete in the Column Joins form. If you add more data items from the Selected
Columns pane to the Left Table and Right Table tab, click Refresh to save the changes.
20
JD Edwards EnterpriseOne Tools Chapter 2
Business View Design Guide Designing Business Views
21
JD Edwards EnterpriseOne Tools Chapter 2
Business View Design Guide Designing Business Views
22
JD Edwards EnterpriseOne Tools | Index | 23
Index
A
Add EnterpriseOne Object to the Project form 13
Add Object form 14, 14
B
Business View Design Aid form 14, 15, 15
business view joins, types 1
business views
deleting components 9
understanding table joins 1
C
currency columns, using Select Distinct with 10
I
inner joins, understanding in business views 1
J
joins, types in business views 1
L
left outer joins
understanding in business views 2
O
Object Management Workbench form 13
R
right outer joins
understanding in business views 1
S
Select Distinct
using with currency columns 10
simple joins
understanding in business views 1
SQL 92 left outer joins, understanding in business views 2
T
table joins
types for business views 1
JD Edwards EnterpriseOne Tools | Index | 24