EAGLE Web Workbook Web Training rev1.pdf · EAGLE is a relational database built on the MIL-STD-1388-2B specification. This military standard lays out how a relational LSAR database

MAINTENANCE MANAGEMENT INFORMATION SYSTEM

EAGLE Web Workbook

14 February 2017

A Product of Raytheon Company 2017 Raytheon Company

ALL RIGHTS RESERVED

U.S. Patents 5,457,792; 5,493,679; 5,737,532,4,847,795 Made in the U.S.A.

COPYRIGHT 2017 RAYTHEON COMPANY

UNPUBLISHED WORK - ALL RIGHTS RESERVED.

This document does not contain technology or Technical Data controlled under either the U.S.

International Traffic in Arms Regulations or the U.S. Export Administration Regulations.

This document shall not be published, or disclosed to others, or duplicated in

whole or in part without written permission of Raytheon Company.

All other company and product names used herein may be the trademarks or

registered trademarks of their respective companies.

Information in this manual may change without notice and does not represent a

commitment on the part of Raytheon Company and its subsidiaries.

Excerpts from Logistics Product Data (ANSI/GEIA-STD-0007), Copyright ©

(2007), Government Electronics and Information Technology Association. All

Rights Reserved. Reprinted by Permission.

Revision History

Printed November 2006 Seventh Edition

Printed October 2008 Eighth Edition

Printed February 2011 Ninth Edition

Printed February 2012 Tenth Edition

Printed February 2013 Eleventh Edition

Printed February 2014 Twelfth Edition

Printed February 2015 Thirteenth Edition

Printed February 2016 Fourteenth Edition

Printed February 2017 Fifteenth Edition

Printed February 2017

.

The EAGLE Software Package has become the best of its

kind thanks, in large part, to its clients. We would like to

take this opportunity to thank all of you for your

suggestions, insights and support. In addition, we want to

renew our commitment to you, our valued clients.

Table Of Contents

Chapter 1: Introduction ....................................................................................................... 6

EAGLE and EAGLE Web Introduction & Database overview ...................................... 6

What is EAGLE? ............................................................................................................ 6

What Is EAGLE Web?.................................................................................................... 9

Chapter 2: Main Menu and Navigation ............................................................................ 10

Main Menu .................................................................................................................... 10

Changing Your Password ............................................................................................. 12

Chapter 3: Finders ............................................................................................................. 13

Finder Icons .................................................................................................................. 13

Using Wildcards............................................................................................................ 15

Additional Finder Functionality .................................................................................... 15

Chapter 4: Editors ............................................................................................................. 16

Chapter 5: Insert Records ................................................................................................. 18

Insert Error Reporting ................................................................................................... 19

Chapter 6: Edit Records .................................................................................................... 21

Edit Error Reporting ..................................................................................................... 22

Chapter 7: Deleting Records ............................................................................................. 24

Chapter 8: Narrative Editors ............................................................................................. 25

Chapter 9: Comments and Responses ............................................................................... 27

Creating, Responding to, and modifying Comments .................................................... 27

Comment Finder ........................................................................................................... 28

Chapter 10: LSAR Reports ............................................................................................... 29

Chapter 11: Document System ......................................................................................... 32

Uploading a Document ................................................................................................. 32

Chapter 12: EAGLE Web Adhoc ..................................................................................... 36

Database Tables ............................................................................................................ 36

Queries .......................................................................................................................... 36

Examples ....................................................................................................................... 37

Creating Queries in EAGLE Web................................................................................. 38

Query Exercise 1 ........................................................................................................... 40

Chapter 13: Analysis Reports ........................................................................................... 46

Appendix ........................................................................................................................... 47

6

Chapter 1: Introduction

EAGLE and EAGLE Web Introduction & Database overview

In this section, you should learn about the following technologies:

1. EAGLE 2. LSAR Databases 3. MIL-STD-1388-2B 4. End Items 5. EAGLE Web

What is EAGLE?

EAGLE is a relational database built on the MIL-STD-1388-2B specification. This

military standard lays out how a relational LSAR database should be structured for

military use. EAGLE is a client application that runs on Microsoft Windows and a web

application server.

EAGLE is an acronym for Enhanced Automated Graphical Logistics Environment. It

can greatly reduce the amount of time and work needed to enter data into a MIL-STD-

1388-2B database.

Relational Database

A relational database is a set of tables, which (surprise!) relate to each other. Each table

has columns and rows. A table is somewhat like an Excel spreadsheet. Each column has

a pre-defined data type, such as text, numbers, and so forth. Under that column, you can

only put in that type (you cannot put text in a number column, for instance).

Tables are a set of rows, each of which holds data. When we get data from EAGLE, we

are usually getting rows from a table. Each row has a set of columns called keys. These

keys make that row unique in the table: no other row in the table can have the same set of

keys.

Tables may have multiple columns that are keys. For instance, we have the following

row, where keys are bold face: (A, B, C, D, E). D and E are common data. A, B, and C

are keys. We cannot have another row that has A, B, and C as keys in this table because

it already contains a row with those keys. We may have a row with (A, B, D, D, E).

Relationship between Tables

7

The relational database relates tables through key structures. We have what are called

parent tables and child tables. Child tables ‘point to’ parent tables by inheriting the key

structure of the parent table. Assume we have a parent table, A, which has the key

structure (EIACODXA, LCNSTRXA). Now we have a child table, B, with the key

structure (EIACODXA, LSACONXB, ALTLCNXB, LCNTYPXB) (all keys). Now,

table A relates to table B through the EIACODXA column. That is, any row in B will

have to have a corresponding row in A with the same EIACODXA.

This structure creates safeguards for the data. As you will see later, almost every table in

EAGLE has the EIACODXA (End Item) column in it. At the top of the EAGLE

database there is a table, XA, which holds the end item data and only has EIACODXA as

a key. This creates stronger structural integrity through the database. That row in XA

cannot be deleted without all rows in child tables of XA being deleted first. If XA is

copied, all child data must be copied also. All child table data with the same

EIACODXA is know to relate to that end item.

The set of columns in a table which relate to a parent table is called the foreign key or

each column with this characteristic is called a foreign key. The other keys are called

primary keys. Note that key structures still have to be unique. That is, for every record

in a child table, you know that there is one and only one record in their parent table.

Some tables, however, have multiple parents.

End Items

As mentioned before, table XA contains End Item data. Generally an end item is a top

level product, such as a tank, bicycle, helicopter, and so forth. It is used to identify the

project/program that is being worked on currently. When working in EAGLE or EAGLE

Web, you will work with data from one End Item at a time. This ensures that data

between projects is not confused and accidentally entered incorrectly.

Technically speaking, the End Item column in XA, EIACODXA, is a 10 character

alphanumeric column. This means it contains 10 characters, where characters are letter

and/or numbers. Upper case and lower case letters are usually seen as the same thing

inside the database, so for our purposes A = a [Note: upper and lower case characters

are different on some columns, usually comments, but it isn’t common].

EAGLE Database Structure and the LSAR

In this section, you will learn more on how the EAGLE database is structured table-wise,

what the LSAR is, and how the LSAR is structured.

1. Eagle Table Structure o X tables o H tables

2. LSAR structure 3. ALC, LCN, LCN Type

8

Table XA

Table XA is parent table of almost all other tables in EAGLE. It contains the

EIACODXA, end item acronym code, which serves to define the End Item for underlying

tables. When an LSAR structure is used, an LCN structure is required (more on this

later).

Table XB

Table XB holds the LSAR data for the database. All tables with LSAR data in them will

hang off this table or a child of this table. It contains the LCN, ALC, and the LCN Type

(more on this later). The keys for this table are EIACODXA (End Item), LSACONXB

(LCN), ALTLCNXB (ALC), LCNTYPXB (LCN Type).

Table XH

This table houses the Commercial and Government Entity Code (CAGE code). It is a

child of XA, and therefore contains EIACODXA. It also has CAGECDXH (CAGE

code) as a primary key. A CAGE code is something like a code for a vender. This table

also contains an address and name for the contract and government entity.

Table HA

Table HA combines a CAGE code with a Reference number. This Reference number is

used to identify individual parts. This table gives you an overview of what parts you

have and who makes them. It contains additional information about the part, such as the

name and NSN. Table HA’s keys are EIACODXA, CAGECDXH, and REFNUMHA

(Reference Number).

Table HG

This table is a child of both XB and HA. It combines an LCN structure from XB with a

Reference number and CAGE code form HA. Its keys are keys from both XB and HA,

combined.

LSAR

The LSAR is made up of three things: LCN (Logistics Control Number), ALC

(Alternate LCN Code) and LCN Type. At the heart of the system is the LCN. The LCN

gives a hieratical breakdown of an object. We have what are called Indenture Levels,

which outline what level of the breakdown one may be at. Say a bicycle’s LCN is BIKE.

Then, its frame may be at indenture level BIKEAA, which is a level deeper. The two AA

concatenated to the end of BIKE signal that BIKE is the overall part, and that AA is a

part that is an indenture level below.

9

In XA there is the LCNSTRXA column, which describes the LCN structure. For the item

above, it would be 42, signaling that the first overall part is 4 characters long, and then

the next indenture level down is 2. The second indenture level could contain, say, the

frame and the wheels at BIKEAA and BIKEAB. From there, we can also have an LCN

structure of 422, which lets us drill down lower. Say on the frame there is the seat,

BIKEAAAA, the handle bars, BIKEAAAB, and the forks, BIKEAAAC.

The second part of the LSAR is the ALC. This allows for alternate configurations. You

could have BIKEAA with ALC 0 and BIKEAA with ALC 1 which may be 2 different

types of bike frames. You would use reference numbers and CAGE codes to differ on

what company and part the frame is, but if the frame has different specifications, such as

one being a men’s frame, one being a woman’s frame, then you would use ALC to

specify alternate configuration for the bicycle. These configurations would drill down

from there, and all of the LCN structure would have to be stored with a different ALC.

The last piece of the LSAR is the LCN Type. There are two different types: physical and

functional. The physical type, which is denoted by P, you have already dealt with. The

Bike itself will be a physical object. The functional type, denoted by F, is different. The

functional type is used to denote tasks, such as repairing the bike, cleaning it, changing

out tires, and so forth.

What Is EAGLE Web?

EAGLE Web is a web based system which allows internet or intranet users to access all

the LSAR Data in the EAGLE database. It allows user’s full access to all the LSAR

Tables. Users can insert, update and delete any records they have rights to. In Addition

users can execute all LSAR Reports and view the results from their web browser. The

AdHoc Reporting tool in EAGLE Web allows users to create and execute real time

queries against the EAGLE Database. EAGLE Web also allows users to create

Comments and respond to Comments against every record in the EAGLE Database.

EAGLE Web contains three major views: Finders, Edits, and other functionality views.

The Finders allow users to query and view the results from every LSAR table. The Edit

Views allow users to insert and edit data in the LSAR Tables. The other functionality

views include document storage, AdHoc, user maintenance, LSAR Reports, Analysis

Reports and Table Help.

10

Chapter 2: Main Menu and Navigation

Main Menu

The EAGLE Web home page is accessed using a web browser by typing the IP address or

URL of the EAGLE Web server into the address text box. When this happens, a request

is made to a web server that has the EAGLE Web software installed on it. When a user

initially reaches the EAGLE Web home page, only a small amount of information will be

available.

Figure 1: The EAGLE Web Home Page

11

Once logged in, the user will have access to all disciplines within EAGLE Web that the

administrator has deemed appropriate and necessary. The menu is customizable by user,

so different users may have different options available to them.

Hovering over a menu option will display any sub-disciplines if they exist. A greater-than

character (>) at the right side of the menu entry shows that a sub-discipline should exist.

Figure 2: EAGLE Web Home Page after login shown with all available Main Menu Options.

12

Changing Your Password

Your user id and password are assigned to you by your system administrator. If you wish

to change your password, you can do so by navigating to:

Main Menu->User Setup->User Password.

Clicking on “User Password” will take you to the Password Maintenance screen.

Typically rules regarding password structure are up to the administrator for your EAGLE

Web system. To change your password, simply type in your new password into the

“New Password” text box and the “Verify New Password” box, and press the Change

Password button. Your new password will be validated and will be required the next

time you log into EAGLE Web.

Figure 3: Password Maintenance Form.

13

Chapter 3: Finders

Finders allow users to query for data from any LSAR Table. All Finders have a Finder

Box which contains search fields which can restrict the records which are retrieved. All

Finder Boxes contain an End Item Field which should display the current End Item being

used. All Key Fields for the LSAR table being used are available search fields. All

search fields can use standard Oracle wildcards.

Figure 4: HA Finder Screen

To retrieve results from any EAGLE Web Finder simply click on the Query button. This

will display the results of the search with all search field criteria taken into account.

Finder Icons

Figure 5: Finder Record Icons

Each record returned in an EAGLE Web Finder contains 3 or more of the icons shown in

Figure 7. Each Finder Record will contain the Comment Icon (Push Pin), Delete Icon

(Red X) and the Edit Icon (Pencil). The Additional Icons shown are displayed as needed.

14

Figure 6: Comment Icon

Figure 7: Comment Icon Color Coding

The Comment Icon allows the user to view and/or create comments against the record

displayed. The Comment Icon is color coded depending on current comment conditions.

Figure 8: Child Record Drill Down Icon

Figure 9: Expanded Child Drill Down Icon Display

The Child Record Drill Down Icon allow users to Drill Down to Child Records with the

selected Parent Record Keys. The Links bring the user to the child table Finder. Links

are highlighted in blue if records exist for the child table.

Figure 10: Delete Record Icon

The Delete Record Icon deletes the selected record after a confirmation from the user.

This will also delete any child records of the selected record.

Figure 11: Narrative Editor Icon

The Narrative Editor Icon provides access to EAGLE Web Narrative Editors. These are

available for tables in the LSAR which are narrative tables.

15

Figure 12: Edit Record Icon

The Edit Icon opens the Edit screen for the selected record.

Using Wildcards

All search fields allow the use of Oracle Wildcards. These wildcards greatly increase the

usefulness of the search fields.

The “%” wildcard matches on 0 or more characters. For example: In the HA Finder if the

Item Name search field is used with “B%” then all records with an Item Name starting

with “B” will be returned. To find all records with a B in the Item Name a user would

put “%B%” in the Item Name search field.

The “_” wildcard matches on 1 character. For example: In the HA Finder if the Item

Name search field is used with “M_” then all records with an Item Name starting with

“M” and having 2 characters will be returned. The “_” wildcard can be multiple times to

indicate a specific number of characters. For example: in the HG Finder the LCN search

fields has “___” (Three Underscores), the results will only display records with the LCN

is 3 characters long.

Additional Finder Functionality

For every EAGLE Web Finder the user has the option to view only Table Keys in

the result set. This is set by a check box in the Finder Box.

Column Sorting is available for each column on every EAGLE Web Finder. Simply click the column header for the column you wish to sort by.

Collapsible columns allow you to hide columns by clicking the + (plus) or – (minus) icon in the header of each row. This is also saved by user for use in the

future.

Selected Row highlighting highlights a row in blue when it is clicked. This allows the user to more easily follow a specific row while scrolling horizontally.

Each EAGLE Web Finder allows all results to be exported to MS Excel by clicking the Excel Icon.

16

Chapter 4: Editors

EAGLE Web Editors allow users to insert, clone and update all records in the LSAR

Tables. All LSAR data rules apply. Easy drop down list boxes are available for fields

requiring specific inputs.

Figure 13: Table HA Edit Screen

Each EAGLE Web Edit screen displays all LSAR Table Fields for edit.

Figure 14: Drop Down List Boxes

17

For every field that requires specific input to support the Specification a Drop Down List

Box is provided.

Figure 15: Hover Over Field Information

Users can hover over any field in the Edit Screen to see additional information regarding

the field from the LSAR Specification.

Figure 16: Edit Screen Table Information Link

On every Edit Screen in EAGLE Web there is a link to the Table Schema Information

system for the selected table.

18

Chapter 5: Insert Records

The EAGLE Web application allows users to insert data into any of the LSAR Tables.

To insert a record navigate to the desired tables Finder Screen and click on the Insert

Record button in the Finder Box.

Figure 17: Insert Record Button

When the user clicks on the Insert Record Button they are brought to the Edit screen in

Insert Mode.

Figure 18: Edit Screen in Insert Mode

19

The Edit Screen in Insert Mode allows users to insert all data for all fields of the record.

The Key fields are in Red and are required to save the record to the database. Once all

values are entered the user simply clicks the Save button to save the record to the

database.

Figure 19: Parent Key Finders

For Inserting Records EAGLE Web provides Parent Key finders for all Parent tables of

the selected table. Click on the Select Parent Keys From Button to Display a list of Links

to available Parent Key Finders for the selected Table.

Figure 20: Parent Key Finder

Parent Key Finders allow users to select a records parent from a list. The parent key

values are then inserted into the Edit screen for the new record.

Insert Error Reporting

When EAGLE Web finds an error in the entered data a message is displayed to the user

in a red text area. The error message states the error in the data being added to the

database. If an error occurs no data is saved to the data base.

20

Figure 21: CA Record Insert with Error Reported

The user is returned to the insert screen to modify the record to resolve the error.

21

Chapter 6: Edit Records

The EAGLE Web application allows users to edit and record in any of the LSAR Tables.

To edit a record navigate to the desired tables Finder Screen and query for the records

required.

Figure 22: Finder Screen for Table CA

Once the desired record is located in the Finder screen simply click the Edit Icon to

navigate to the Edit Screen with the selected record loaded.

22

Figure 23: Edit Screen with CA Record Loaded

While in the Edit screen make any necessary changes and click the Save button to save

changes to the database.

Edit Error Reporting

When EAGLE Web finds an error in the entered data a message is displayed to the user

in a red text area. The error message states the error in the data being edited in the

database. If an error occurs no data is saved to the data base.

23

Figure 24: Edit screen with error

The user is returned to the edit screen to modify the record to resolve the error.

24

Chapter 7: Deleting Records

The EAGLE Web application allows users to delete and record in any of the LSAR

Tables. To delete a record navigate to the desired tables Finder Screen and query for the

records required. To delete the record simply click the Delete icon associated with the

record and confirm the delete in the pop-up confirmation box. Please note that the record

and any child records will be permanently deleted from the database.

Figure 25: Deleting a CA Record

25

Chapter 8: Narrative Editors

The EAGLE Web application allows users the ability to easy read and edit narrative

records in the LSAR Database. The narrative editors combine narrative text in single

easy to use editors. The narrative editors support cut and paste. When the narrative

record is created or modified the application creates or updates any necessary individual

narrative fields in the corresponding records.

To access the narrative editor for any narrative table simply click the Narrative Editor

Icon for the selected record in the Finder Screen. The Narrative Editor Icon appears in

Finder results for all tables associated with a narrative.

Figure 26: Table CA Finder with Narrative Editor Icon

When the user clicks the Narrative Editor Icon the Narrative Editor opens for the selected

Narrative Table.

26

Figure 27: CC Narrative Editor

Once the user is in the Narrative Editor they can create or edit the narrative task. To

insert the record or save changes simply click the Save button in the narrative Editor.

27

Chapter 9: Comments and Responses

EAGLE Web allows users to attach Comments and respond to comments against any

record in the LSAR Database. To create a Comment or Response for a record, navigate

to the tables Finder Screen and query for the desired record. The Comment Icon for each

record is color coded to easily determine the state of comments for a specific record.

Figure 28: Comment Icon

Figure 29: Comment Icon Color Coding

Figure 30: Finder Results with Narrative Icons

Creating, Responding to, and modifying Comments

To Create, Respond to or edit a comment click on the Comment Icon for the selected

record. This will open the Comment Editor Pop up window.

28

Figure 31: Comment Popup Editor

The Comment Popup Editor allows users to create new comments, respond to comments

and modify comments or responses. Once the user makes any changes in the Comment

Popup Editor simply click the corresponding save button to save changes.

Comment Finder

The Comment Finder in EAGLE Web Allows users to locate Comments for any table in

the LSAR Database. To access the Comment Finder navigate from the Main Menu to

Comments. This will open the Comment Finder. The Comment Finder allows the user

to search by table, Comment Creator and date for comments in the system.

Figure 32: Comment Finder

Once a user locates a record in the Comment finder they can access the Comments and

Responses by clicking the Edit Icon for the selected record. This will open the Comment

Popup Editor.

29

Chapter 10: LSAR Reports

EAGLE Web makes all standard LSAR Reports available from the Web. To access the

LSAR reports navigate to LSAR Reports on the Main Menu. This will bring the user to

the LSAR Reports screen where they can select the report they wish to run.

Figure 33: LSAR Reports Screen

To select a report from the LSAR Reports Screen simply click the report you desire.

When a report is selected the user is brought to the reports parameter screen.

30

Figure 34: LSA-003 Report Parameter Screen

The Parameter screens for each LSAR Report allows users to create parameters for the

LSAR Report. Parameters are saved by user for ease of use in future executions of the

report. Required parameters for the report are in red. Once a user supplied all necessary

report parameters they simply click the Execute Report button. This will bring the user to

the Report Request Processed Screen.

Figure 35: Report Request Processed Screen.

When an LSAR Report is executed in EAGLE Web the report is executed on the

Database server and the results are uploaded to the EAGLE Web Document system. An

Email is generated to notify the user the report is completed. The user will then navigate

to the EAGLE Web Document system to access their report output.

31

Figure 36: EAGLE Web Document System LSAR Reports

Please see the Chapter on the EAGLE Web Document System for more information.

32

Chapter 11: Document System The EAGLE Web document system is a module that allows the user to upload binary and

text documents into the database. Virtually any format can be stored and viewed from

EAGLE Web document system. The document itself is stored in table ZD as a Binary

Large Object, or BLOB.

When the BLOB is accessed using EAGLE Web it is rendered in the client browser using

the application that is associated with the MIME type of the document that is

downloaded. For example, if an MS-Word document was stored in the database your

computer would most likely have MS-Word associated with a MIME type of “.doc”.

Therefore, when the document is downloaded, MS Word will open and launch the

document.

Throughout the EAGLE Web application there are areas where documents can be

attached. These records are all stored in table ZD, but are cross referenced using either

cross reference tables, or embedded html tags.

Uploading a Document

Step 1:

Navigate to Main Menu->Documents->Document Viewer

Step 2:

Click on the button.

(See image below)

Figure 37: Document Viewer screen in Eagle Web, after clicking on New Document

33

Step 3:

Select the button.

Browse to “F18.bmp” on your desktop, and select the “Open” button.

This will automatically fill in the Document ID with the name of the file and the Type

pull down with the type of the file. You can change the Document ID field, but a conflict

will occur if a document with the same Document ID, type, and revision already exists in

the documents table.

Step 4:

Select the button next to the Document Category pull-down.

This will prompt you for a category name. Insert “F18” and press OK.

Figure 38: New Category name prompt

Step 5:

Then Select “F18” from the Document Category pull-down.

34

Figure 39: EAGLE Web Document System

This will put the document with the Document ID of F18 under the category of F18,

which can be used for organizational purposes. You can create Sub Categories for more

organization of document placement.

Step 6:

Press the button. Notice that the F18 image appears in the document list at the left

side of the screen.

Step 7:

Click on the “F18.BMP” hyperlink to launch the document. Depending on browser

settings, the image may display inside the document window.

35

Figure 40: Document Record in EAGLE Web

Figure 41: View of F-18 bmp from EAGLE Web

36

Chapter 12: EAGLE Web Adhoc

EAGLE Web Adhoc is an EAGLE Web module that allows users to create customized

queries using standard SQL syntax, and execute those queries on the EAGLE Web

database. This exercise will provide an introduction into basic SQL syntax, and

demonstrate how SQL can be used specifically in the context of the EAGLE database.

SQL is an acronym for Structured Query Language, and is computer language designed

for the management and retrieval of data in a relational database management system. In

addition to retrieving data from the database, SQL can be used to insert, update, and

delete records from the database, as well as grant and revoke privileges on objects used in

the database. EAGLE Web does not support execution of SQL statements that modify

data, but can be used to retrieve records from the database, and save the results to a

spreadsheet. In order to use SQL, the user does require some knowledge concerning the

underlying database tables in the system being queried.

Database Tables

A key concept in a relational database is the concept of a “table”. A table is very similar

to a spreadsheet in that it has rows and columns that have values. Each row represents a

record, or part of a record, and each column represents a field in the record. Some fields,

such as key fields are mandatory, while others are conditional or optional. In addition,

tables can relationships with other tables.

Queries

The most common operation in SQL databases is the query, which is performed with the

declarative SELECT keyword. SELECT retrieves data from a specified table, or multiple

related tables, in a database. While often grouped with Data Manipulation Language

(DML) statements, the standard SELECT query is considered separate from SQL DML,

as it has no persistent effects on the data stored in a database. Note that there are some

platform-specific variations of SELECT that can persist their effects in a database, such

as the SELECT INTO syntax that exists in some databases.

SQL queries allow the user to specify a description of the desired result set, but it is left

to the devices of the database management system (DBMS) to plan, optimize, and

perform the physical operations necessary to produce that result set in as efficient a

manner as possible. An SQL query includes a list of columns to be included in the final

result immediately following the SELECT keyword. An asterisk ("*") can also be used as

a "wildcard" indicator to specify that all available columns of a table (or multiple tables)

are to be returned. SELECT is the most complex statement in SQL, with several optional

keywords and clauses, including:

37

The FROM clause which indicates the source table or tables from which the data is to be retrieved. The FROM clause can include optional JOIN clauses to join

related tables to one another based on user-specified criteria.

The WHERE clause includes a comparison predicate, which is used to restrict the number of rows returned by the query. The WHERE clause is applied before the

GROUP BY clause. The WHERE clause eliminates all rows from the result set

where the comparison predicate does not evaluate to True.

The GROUP BY clause is used to combine, or group, rows with related values into elements of a smaller set of rows. GROUP BY is often used in conjunction

with SQL aggregate functions or to eliminate duplicate rows from a result set.

The HAVING clause includes a comparison predicate used to eliminate rows after the GROUP BY clause is applied to the result set. Because it acts on the results of

the GROUP BY clause, aggregate functions can be used in the HAVING clause

predicate.

The ORDER BY clause is used to identify which columns are used to sort the resulting data, and in which order they should be sorted (options are ascending or

descending). The order of rows returned by an SQL query is never guaranteed

unless an ORDER BY clause is specified.

Examples Say for example you have a table called “BOOKS” that looks like the following:

Title Author Description Cost Price

Robinson Crusoe Daniel Defoe Adventure 7.99 14.99

Rain Of Gold Victor VillaSenor Adventure 3.99 8.99

Grapes Of Wrath John Steinbeck Drama 5.01 10.15

This table is populated with 3 rows, and has 5 columns: Title, Author, Description, Cost

and Price. The Cost is how much we paid for the book, and Price is how much we intend

to sell the book for.

If we wanted to select every column and every row from the table above, we could

execute an SQL statement such as the one below.

SELECT * FROM BOOKS

The key word “SELECT” identifies what columns you wish to be returned from the table

specified in the FROM clause. The “*” is a wildcard, and in this case is telling the

database what we wish to view all columns selected in the table.

If we only wanted to see the books in the BOOKS table, but did not wish to see any other

information we could has written the query differently.

38

SELECT TITLE FROM BOOKS

Title

Robinson Crusoe

Rain Of Gold

Grapes Of Wrath

Or we could have chosen to list only the TITLE and the PRICE

SELECT TITLE, PRICE FROM BOOKS

Title Price

Robinson Crusoe 14.99

Rain Of Gold 8.99

Grapes Of Wrath 10.15

As mentioned above, the WHERE clause is used to filter the rows that are returned in a

query. For example if we wanted to see all books written by John Stienbeck, we could

execute the query:

SELECT * FROM BOOKS WHERE AUTHOR = ‘John Steinbeck’



We could also use the WHERE clause to query for all records that cost more than $5.00.

SELECT * FROM BOOKS WHERE COST > 5


Robinson Crusoe Daniel Defoe Adventure 7.99 14.99


Notice that when using a WHERE clause all string arguments are enclosed by single

quotes, while numeric arguments are not.

Creating Queries in EAGLE Web To create database queries in EAGLE Web navigate to Main Menu->Adhoc. Your

screen should look like this:

39

Figure 42: EAGLE Web AdHoc Screen

The Adhoc screen is divided up into 3 main sections. The “Tables” section describes all

of the tables that are viewable from the Adhoc Tool.

Figure 43: EAGLE Web's AdHoc table list

Typing in the “Search” text box will filter the tables by name. Then a table is selected in

the Tables box, the columns in the table will be displayed in the “Database Columns”

box.

40

Figure 44: Columns for the selected table

Query Exercise 1 This exercise will demonstrate how to retrieve HG information from EAGLE Web using

AdHoc.

Step 1:

Navigate to Main Menu->Adhoc.

Figure 45: EAGLE Web AdHoc Screen

41

Step 2:

Type HG into the search box. Notice that “HG, Part Application Provisioning” becomes

active.

Figure 46: The “Tables” box after typing HG into the search text box

In the “Database Columns” list box, HOLDING THE CTRL KEY, use the mouse to

select the following columns:

Figure 47: The selected columns for this query

Notice that in the SQL Text area, EAGLE Web has created an SQL statement that can be

executed.

Figure 48: The SQL generated by AdHoc

42

Notice that we are selecting CAGE Code, Reference Number, End Item, LSA Control

Number, Alternate LSA Control Number, and LCN type.

SELECT HG.CAGECDXH, HG.REFNUMHA, HG.EIACODXA, HG.LSACONXB,

HG.ALTLCNXB, HG.LCNTYPXB

FROM HG

Step 3:

Press the “Where” button. Your screen should look like this:

Figure 49: AdHoc where clause generator

Step 4:

Click on “LSACONXB”

Figure 50: Column List

Step 5:

Select “like” from the operator drop down list box.

43

Figure 51: Relational Operator List

Step 6:

Click on the apostrophe ( ) button.

Step 7:

Type A02%

Step 8:

Click on the apostrophe ( ) button.

Your screen should look like this.

Figure 52: The completed “WHERE” clause

What you have essentially done is created the “WHERE” clause for your query.

Step 9:

44

Press the “OK” button.

Step 10:

At this point you are ready to execute your query. Notice that the SQL has been

generated for you. If you are an expert in SQL you could have typed the query into the

SQL text box by hand, or pasted it in from another document.

Examining the SQL created, we see that our WHERE clause is limiting the rows returned

to LCNs that begin with the string “A02”. From a conceptual view, we are asking for a

complete list of part numbers that comprise the “A02” system which in our case is the

1874AS5000-100 assembly.

SELECT HG.CAGECDXH, HG.REFNUMHA, HG.EIACODXA, HG.LSACONXB,

HG.ALTLCNXB, HG.LCNTYPXB

FROM HG

WHERE ( HG.LSACONXB LIKE 'A02%' )

Press the “Query” button to execute the query.

Your query results should look similar to what is displayed below.

Figure 53: Query Results

Notice that the all of the records returned have an LCN that begins with the string “A02”.

45

The number of records returned is defaulted to 50 records per page, and you can scroll

through each page by pressing the button.

Step 11:

Press the “Export to Excel” button. This will export the results of the query to an excel

spreadsheet.

46

Chapter 13: Analysis Reports

EAGLE Web Analysis reports execute a defined set of queries which have been created

by the EAGLE Team. These reports are access from the Analysis Reports Link on the

Main Menu.

Figure 54: Anaylsis Reports Screen

To select a report simply select it from the Report Drown List Box. Once a report is

selected more information is displayed on the screen. To execute the report click the Run

Query button. The results are given in the EAGLE Web AdHoc format in a new window.

Figure 55: Analysis Report Results

47

Appendix

Note: The EAGLE Web system administrator has the capability to customize a users

main menu options such that when the user logs in, he or she will be presented with a

subset of the EAGLE Web capabilities.

48

Technical support is provided by the EAGLE Team of Raytheon Company. Phone

support is available Monday through Friday from 8:00 a.m. to 4:30 p.m. Mountain

Standard Time. EAGLE technical support personnel can be reached at (520) 663-6673.

Training on the EAGLE product is available.

Are you ready for EAGLE? Join Team EAGLE and find out what it’s like to soar. Give

your logistics software product the EAGLE advantage. For more information on

becoming part of Team EAGLE, contact:

Raytheon Company

Team EAGLE

(520) 663-6673

Email: [email protected]