The Query Log view is used to review queries that have been run for the purpose of debugging. Details about the query such as how long it took to run, if any bind variables were passed, or if an SQL Exception was thrown while attempting to execute the query are all available. Run time is only reported for queries that executed successfully.

−

−

Queries can be sorted by clicking on the column heading for the column to sort by. Initially, the data will be sorted in ascending order. Clicking the same column multiple times will toggle the sorting between ascending and descending. The table can be sorted on multiple columns by holding the CTRL key and selecting columns in the order which they should be sorted.

−

−

====Shortcuts====

−

−

;CTRL+A

−

:Select all items displayed

−

;CTRL+C

−

:Copies the current selected item to the clipboard:

−

::SQL Item: Copies the full SQL Text

−

::Bind Variable: Copies the bind variable value, not including the type. Binary data not supported

−

::Exception: Copies the exception and stack trace

−

;CTRL+X

−

:Fully expand selected items

−

−

===Delete Query Log===

−

−

====Purpose====

−

−

Deletes all of the recorded queries from the log then refreshes the view. The log has a max capacity and once it is met no more entries will be added, so deleting the log will be necessary to see any new queries that are being performed.

−

−

====How to do it====

−

−

Select the delete button ([[Image:Delete_edit.gif]]) from the toolbar on the top portion of the Query Log view.

−

−

===Refresh Query Log===

−

−

====Purpose====

−

−

Repopulates the view with the latest information from the query log. The log has a max capacity and once it is met no more entries will be added. This can be taken care of by deleting the log contents (see above).

−

−

====How to do it====

−

−

Select the refresh button ([[Image:Refresh.gif]]) from the toolbar on the top portion of the Query Log view.

Views and editors for the creation, manipulation, and navigation of artifacts, attributes, and relations

Remote event service for communication and synchronization of OSEE instances

Rules framework for text processing

Utilities for plug-in developers

Scheduling framework

API for the extension and use of this framework to build tightly integrated applications

Encryption Utility

Database Utilities

Jini Utilities

Scheduling Service

Datastore Adapter

Define - Requirements Management

Define provides requirements and process management with tightly integrated change management using the Action Tracking System (ATS). OSEE provides publishing capabilities that enable the creation of documents from smaller internal documents to the complex documents needed to meet military requirements for contract deliverables such as the Software Requirements Specification (SRS), System Performance Specification (SPS), Prime Item Development Specification (PIDS), and all the required traceability between them.

Key Capabilities

Enterprise support for concurrent, distributed requirements development

Integrated process and workflow

Programmatic, bidirectional traceability

End user navigation and search capabilities

Capture accurate, meaningful review metrics

Tight integration with lifecycle tools

Automated change detection capabilities

Action Tracking System

ATS is a tightly integrated change tracking system that manages changes throughout a product's lifecycle. ATS provides integrated change management to all OSEE applications through user customizable workflows.

Key Capabilities

Built on same OSEE application framework as requirements, code, test development

Common Workflow Framework that provides for the creation of any number of simple to complex workflow state machine configurations that can work together during the engineering lifecycle

Workflows are configured through graphical diagrams that ATS uses at runtime

Configuration of ATS performed through OSEE?s common application framework enabling workflows to be created and modified without separate OSEE releases

Advanced project planning capabilities and release management

Duplication errors are minimized as items are automatically linked and data is shared

Menus, Views and Editors give access to ATS while working in any other aspect in OSEE

ATS is used to track changes and support issues for the development of OSEE itself

Open Test Environment

OTE is a powerful test solution within OSEE that integrates with existing Java, C, and C++ development environments to provide a seamless flow between developing, debugging, executing, and dispositioning of tests for complex hardware and software. The user is provided a common interface to the simulated and real-time environments for both functional and unit testing.

Key Capabilities

Supports the execution of multiple simultaneous batches within a single workspace

A test environment service that provides both soft real-time and simulated capabilities, schedules the periodic execution of simulation components, and manages the I/O and testing resources.

BLAM

BLAM Lightweight Artifact Manipulation (BLAM) allows non-programmers to graphically construct workflows to automate repetitive tasks. A given workflow can be used for variety of similar tasks by using customizable controls to specify workflow parameters.

Key Capabilities

Integrated management of charge/cost accounting

Build planning and execution

Reporting services

Rules framework for requiring/alerting certain conditions

Scheduling services for automating reoccurring tasks

Program/Project Management

Program and project management tightly integrated with the Action Tracking System and other OSEE components to provide services necessary for estimation, planning, execution, and delivery of products managed within OSEE.

Application Development

Provide capabilities needed for external software application development plug-ins, like JDT, to utilize the OSEE persistence layer and integrate with other OSEE-based applications.

Design and Modeling

Provide capabilities needed for external design and modeling plug-ins to utilize the OSEE persistence layer and integrate with other OSEE-based applications.

Views and Editors

Branch Manager View

The Branch Manager View, shown by default in the Define Perspective, shows all branches and transactions on each branch managed by OSEE in a hierarchical fashion. By default, OSEE is initialized with two branches. The System Root Branch (visible to OSEE Administrators only) and the Common Branch. The System Root Branch is the base branch for all other branches in the system. The Common branch is used to store system-wide artifacts such as configuration artifacts, users, and user preferences.

Toolbar buttons

Icon

Description

Refreshes the branch hierarchy tree with the latest branch information.

Opens the table customization dialog. This allows users to add or hide columns.

Opens an action against the Branch Manager View.

Toolbar Drop-Down

To display, click on the inverted triangle located on the upper right-hand side of the Branch Manager view.

Command

Description

Open Branch Graph

Display a diagram showing the relations among branches.

Open OSEE Data Model Editor

Opens a graphical editor of all the artifact, attribute, and relation types in the system.

Branch Presentation

Switch presentation between flat or hierarchical views.

Show Archived Branches

(Admins Only) Toggles archived branch visibility.

Show Merge Branches

(Admins Only) Toggles merge branch visibility.

Show/Hide Transactions

Toggles branch transaction visibility.

Show Favorites First

Orders branches by showing favorite branches first.

Pop-up Menu

To display, perform a right-click on any branch.

Command

Description

Explore

Opens the Artifact Explorer View for the selected branch. This operation can also be performed by double-clicking on a branch.

Change Report

Opens the Change Report View for the selected branch.

Merge Manager

Opens the merge manager. This is used to resolve conflicts when committing a working branch back into its parent branch.

Branch

Creates a child branch of the selected branch.

Update Branch

Re-baselines a branch into its parent, leaving the selected branch in place. If there are conflicts, the merge manager will be opened to allow the user to resolve them.

Commit Into

Commits changes made to a branch into another branch. Unlike "Update Branch," this feature does not assume that the destination branch is the parent. This feature can only be used by administrators.

Delete Branch

Deletes the selected branch from the system by setting the branch state to deleted. The data from this branch will still be recoverable.

Purge Branch

Purges the selected branch from the system by removing all data from the data store. This action cannot be undone.

Purge Transaction

Purges the currently selected transaction from its branch. Removes all changes made on the selected transaction. (Not recoverable)

Open Associated Artifact

Opens the artifact that was associated with the creation of the selected branch.

Set Associated Artifact

Associates an artifact with the currently selected branch.

Archive

Archives the branch so that it does not appear in a list of branches unless archived branches are specifically requested.

Access Control

Opens the access control dialog.

Rename

Allows users to change the branch name.

Mark as Favorite

Sets/Unsets a branch as a favorite branch.

Copy

Places branch information into the clipboard.

Open Osee Data Model Editor

Opens a graphical editor of all the artifact, attribute, and relation types in the system.

Open Branch Graph

Shows a graphical representation of branches using the currently selected branch as the base branch.

Artifact Explorer View

The Artifact Explorer view, shown by default in the Define perspective, shows the artifact hierarchy of the selected branch. The artifact hierarchy is derived from the artifact's default hierarchy relation. By default, all branches have a default hierarchy root artifact which is the hierarchy tree's base element.

Toolbar buttons

Icon

Description

Collapses all tree nodes.

Navigates to the parent container of the artifacts that are currently displayed at the top level in the view.

Opens a new instance of the Artifact Explorer view.

Opens the Change Report View for the Artifact Explorer's selected branch. This report will show all changes made to the selected branch.

Opens the Quick Search View for the selected branch.

Opens an action against the Artifact Explorer view.

Pop-up Menu

To display, select one or more artifacts and perform a right-click.

Command

Description

Open

Opens the selected artifact using the default editor.

Open With

Opens a sub-menu listing the available editor's for this artifact.

Reveal on Another Branch

Open's a new instance of Artifact Explorer for a user selected branch. Expands tree elements to display the selected artifact to be revealed.

New Child

Creates a new artifact and places it directly under the selected artifact.

Opens the Resource History view for the selected artifact. This will display all transactions for this artifact.

Import

Opens Eclipse's import dialog.

Export

Opens Eclipse's export dialog.

Lock

Locks the artifact so the current user is the only one allowed to make changes to its attributes.

Copy

Copies the artifact.

Paste

Pastes the artifact.

Expand All

Expands all tree nodes from the selected artifact down.

Select All

Selects all open tree nodes.

Access Control

Opens the access control dialog.

Operations

Operations that can be performed on an Artifact Explorer.

Command

Description

Cross Branch Drag and Drop

Artifacts can be referenced from other branches by dragging an artifact from one branch and dropping in onto another Artifact Explorer. The outcome will be one of two actions. If the artifact already existed on the branch it will be updated with the source artifacts state data. If the artifact did not exist on the destination branch it will be introduced to that branch. Meaning it will show up in the change report as an introduced artifact.

File Document Drag and Drop

Artifacts can be created by dragging and dropping files directly onto the parent artifact. After the drop is performed, the Artifact Import Wizard should open. Select the import method and artifact type to convert file into. This should create a child artifact directly under the artifact where the file was dropped.

Artifact Editor

The Artifact editor provides specialized features for editing artifacts (this is the default editor for editing attributes and relations). The editor can be opened through Artifact Explorer, by double-clicking on any artifact or right-clicking on an artifact and selecting to Open With "Artifact Editor".

Associated with the editor is an Artifact-specific Outline view, which shows the structure of the active artifact. It is updated as the user edits the artifact.

The Artifact Editor is divided into the following sections (some sections can be expanded and collapsed by clicking on the section's title bar).

Title Area

Artifact Name - the artifact's name attribute

Message Area - reports issues that need to be addressed by the user before saving is allowed. Click on the message to open a message summary window. From the message summary window, click on any message to jump to the item associated with the message.

Toolbar Area

Icon

Description

Refreshes the artifact editor. Displaying the artifact's current data. NOTE: Changes made to the form will be lost unless data is saved before clicking on this button.

Opens an action against the Artifact Editor.

Opens the artifact or if clicking on the down-arrow, displays the open with sub-menu.

Deletes the artifact and closes the editor.

Displays the outline view.

Opens the artifact's resource history.

Displays the artifact in an Artifact Explorer view.

Open the Branch Manager View and highlights the artifact's branch.

Locks or unlocks the artifact for editing. Locking an artifact prevents other users from making changes to it.

Copies a link to the latest version of the artifact to the clipboard.

Artifact Information Area

Displays the artifact's branch, artifact type, and human readable id.

Attributes Section

Displays attribute types to be edited. Attribute types can be added or deleted by clicking on the appropriate toolbar button located on the upper-right of the attributes section title bar.
Note: The following operations follow min/max occurrence rules defined by the attribute's type.

Icon

Description

Opens an attribute type selection dialog; the selected attribute type instances will be reset to their default value.

Opens a dialog displaying attribute types that can be added to the artifact.

Opens a dialog displaying attribute types that can be deleted from the artifact. Note: Data entered for the attribute type to be deleted will be lost as soon as the dialog's OK button is selected.

Relations Section

All relations that are defined as being valid for the artifact are shown. Relations can be added by dragging any set of artifacts into the appropriate relation group. Opening relation groups will show all artifacts that are currently related. Double-clicking a related artifact will open it in its default editor (normally the Artifact Editor).

Pop-up Menu - To display, expand the Relations section, select one or more artifacts, and perform a right-click.

Command

Description

Open

Opens the selected relation using the default editor.

Edit

Opens the Artifact for editing.

Mass Edit

Opens the Artifact Mass Editor populated with the selected artifacts.

View Relation Table Report

Opens an HTML report of the relation tree.

Order Relation

(Future Capability)

Delete Relation

Deletes the selected relations.

Expand All

Expands all tree nodes containing relations to this artifact.

Select All

Selects all tree nodes.

Delete Artifact

Deletes the selected artifact and its relation to this artifact.

Details Section

Displays artifact meta-data.

Resource History View

The resource history view allows users to view the detailed changes to an aritfact.

In addition, the view also provides the user with the ability to select and compare artifacts.

Mass Artifact Editor

The Mass Artifact Editor allows the easy view of multiple artifacts along with their attributes. This editor can be viewed by right clicking the Artifact Explorer, the Search Results page, or via ATS action. Single cells can be edited via Alt-Left-Mouse-Click. After editing any number of artifacts shown, the save button persists this data.

Quick Search View

The Quick Search view allows users to perform searches for information that is contained inside artifacts in a selected branch.

To find all artifacts that contain a particular set of keywords, select Window > Show View > Other... > OSEE > Quick Search to open the view and type your search string in the Enter Search String combo box (or use the pull-down list to select a previously entered search expression).

If the By Id option is selected, only spaces and commas are treated as delimiters. Otherwise, the following special characters are also treated as delimiters:

!"#$%()*+-./:;<>?@][\^{|}~_

For example:

When By Id is not selected, hello.world will be translated to hello and world. The search will match attributes with hello and world keywords.

When By Id is selected, (A+ABG7jFm+0BKaVZIxfqOQ,AFABG7jFm+0BKaVZIxfqOQ PX1FH) will be interpreted as two GUIDs and one HRID. The search will match artifacts containing A+ABG7jFm+0BKaVZIxfqOQ and AFABG7jFm+0BKaVZIxfqOQ as its GUID or PX1FH as its HRID.

Finish entering your search options and click Search or press Enter from the combo box to execute the search. The Search view displays the results of your search. Right-click on any item in the Search view to open a context menu that allows you perform various operations on the artifacts such as copy search results to the clipboard or reveal a selected artifact in Artifact Explorer. To open one of the listed artifacts, double-click it or select Open from the context menu.

Sky Walker View

Change Report View

The change report view shows all changes made to a branch.

Toolbar buttons

Command

Description

Refreshes the data in the change report view with the latest information.

Toolbar Drop-Down

To display, click on the inverted triangle located on the upper right-hand side of the Change Report View.

Command

Description

Show Document Order

Switch presentation to show artifacts ordered by their default hierarchy relation.

Pop-up Menu

To display, perform a right-click on any branch.

Command

Description

Open

Opens the selected artifact using the default editor.

Open With

Opens a sub-menu listing the available editor's for this artifact.

Reveal in Artifact Explorer

Displays an artifacts location in the Artifact Explorer.

Resource History

Opens the Resource History view for the selected artifact. This will display all transactions for this artifact.

View Word Change Report

Displays a Word document populated with the branch differences of the selected artifacts.

View Viewer Report

Generates a report of the Change Report View content.

Copy

Copies the artifact.

Revert Artifact

Reverts an artifact.

Revert Attribute

Reverts an attribute.

Delete Transaction

Deletes a transaction.

Services

Event Service

OSEE is a client side application that runs off an Oracle database. As with many applications, OSEE caches some of the data it provides to the user. These caches need to be notified that there are updates available. These updates are triggered by an event service that "connects" all OSEE instances and notifies them that changes have been made to cached data.

When your application focus is on any OSEE View, you will notice a gear icon at the bottom of your workbench. When NOT connected to the event service, this icon will show a red slash. When this happens, you should shutdown, restart and accept all OSEE updates. If this does not solve the problem, contact an OSEE Team member for help in resolving the problem.

Attribute Tagging for Quick Search

When an artifact is saved, each attribute contained in the artifact is analyzed to produce a list of tags that are then associated with the artifact. Quick search is a form of keyword based searching which uses tags to perform contextual artifact searches.

For an attribute to be tagged by the system, it must meet the following criteria:

The attribute's type must specify an Attribute Tagger to be used by the tagging system.

The attribute must contain valid data.

The attribute revision must be saved in the database before sending to tagging system.

To produce tags, modified attributes are sent to the OSEE application server where the tagging system processes each attribute using an Attribute Tagger specified by the attribute's type. The Attribute Tagger knows how to interpret the attribute's data and how to extract words from the content. At this point, a word is defined as a sequential set of alphanumeric characters delimited by one or more spaces. As words are parsed, they are sent to the tagging system's word encoder where the following processing takes place:

The characters in the original word are converted to lower case.

The lowercase version of the word is encoded and stored in the tagging system.

Words given in inflected form (possessive, plural, etc) are converted into citation form.

Each word is encoded and stored in the tag system.

When encoding words into tags, the tag encoder uses an algorithm which transforms the word's characters into a bit-packed tag that will fit in a 64-bit integer. The tag will represent up to 12 characters (all that can fit into 64-bits). Longer words will be turned into consecutive tags.

Tag Encoding Examples

Original

Keywords

Encoding

appendices

appendix

-220858502

batteries

battery

529513131

alternate

alternate

-1420231874

backup

backup

24902827

Custom Widgets

XViewer - Advanced TreeViewer Widget

The purpose of the XViewer is to give the application developer a more advanced and dynamic TreeViewer that has the filtering and sorting the capabilities of a spreadsheet while providing the users the ability to customize their table to suit their current needs and save/restore these customizations for future use by individual or group.

The XViewer has been incorporated into the Nebula project.

Table Customizations

Provides Table Customization dialog to allow selection of visible columns, as well as the specification of their widths and names

Easily reorder columns through drag/drop or table customization

Provides mechanism to save and load table customizations so users can easily switch between customizations

Provides mechanism to mark table customizations as individual or global to provide sharing of customizations by users and teams (needs to be backed with shared file system or database)

Provides mechanism to mark table customization as default customization to display whenever this table is shown

Provides ability for multiple XViewer tables to be used within the same application, but provide their own columns and customizations