1. Developing Integration Projects with Oracle Data Integrator
  2. Accessibility Features in ODI

A Accessibility Features in ODI

The accessibility features in Oracle Data Integrator aim to make aspects of navigating and using the product easier for persons with disabilities and for the aging population. The accessibility features support the use of standards-based assistive technology hardware and software (such as Freedom Scientific JAWS).

This appendix provides information about how to configure and use accessibility features for ODI. It helps you to understand certain keyboard shortcuts and steps to create mappings using keyboard.

This appendix includes the following sections:

Working with Java Access Bridge

Java Access Bridge (JAB) is a technology that exposes the Java Accessibility API in a Microsoft Windows DLL, enabling Java applications and applets that implement the Java Accessibility API to be visible to assistive technologies on Microsoft Windows systems. Java Accessibility API is part of Java Accessibility Utilities, which is a set of utility classes that help assistive technologies provide access to GUI toolkits that implement the Java Accessibility API.

In order for existing assistive technologies available on Microsoft Windows systems to provide access to Java applications, they need some way to communicate with Java Accessibility Utilities. Java Access Bridge supports this communication.

An assistive technology application running on Microsoft Windows (for example a screen reader) communicates with Java Access Bridge DLLs, which in turn communicates with the Java Virtual Machine through Java Access Bridge Java libraries. These Java libraries communicate with Java Accessibility Utilities. Java Accessibility Utilities collects information about what is happening in the Java application, which it forwards to the screen reader through Java Access Bridge.

For more details on JAB, refer to Java Access Bridge Documentation.

This topic has the following sections:

Installing Java Access Bridge (Windows Only)

If you are installing ODI on a Windows computer, you can install Java Access Bridge for Section 508 Accessibility, by performing the following steps:
  1. Download Java Access Bridge from the URL: http://www.oracle.com/technetwork/java/javase/tech/index-jsp-136191.html
  2. Install Java Access Bridge.
  3. Copy the access-bridge.jar and jaccess-1_4.jar files from your installation location to the jre/lib/ext directory.
  4. Copy the WindowsAccessBridge.dll, JavaAccessBridge.dll, and JAWTAccessBridge.dll files from your installation location to the jre/bin directory.
  5. Copy the accessibility.properties file to the jre/lib directory.
You have now successfully installed Java Access Bridge.

Note:

Refer to Java Access Bridge Documentation for more information on Java Access Bridge.

Configuring Java Access Bridge

  1. Start or enable Java Access Bridge application from the location - % JDK_HOME% \bin\jabswitch –enable. Enable the JAB from the SAME JDK that you will use to start ODI Studio. Here, JDK_HOME means java.home used by ODI, to know this start ODI and navigate to Help -> About -> Properties tab, search for java.home. It points to the default location - \Program Files\java\jdk..\jre, so make sure enabling jabswitch under \Program Files\java\jdk..\jre\bin dir.
  2. To launch the JAWS (Job Access With Speech) software, double-click the desktop icon or select the JAWS entry from the Start Menu.
  3. Start ODI Studio.

Note:

Refer to JAWS online help for special keyboard commands to make the software read the text on the screen. In the JAWS application, navigate to select Help->Keyboard commands to know more about them.

Common Keyboard Commands

Some of the commonly used keyboard commands in Java Access Bridge are:

Key Combination Usage

INSERT+SPACEBAR,S

Toggle speech on/off

Note:

When using this keystroke, press and release INSERT + SPACEBAR, and then press S to mute the speech.

DOWN ARROW

To read the next line

INSERT + UP ARROW

To read the current line

INSERT + B

To read the current Window

INSERT + SHIFT + DOWN ARROW

To read the selected text

Troubleshooting

  • If JAWS reads only the dialog/window titles and if it does not read any of the text inside the dialog/window then it means you have not started Java Access Bridge or it is not working properly.

  • You need to start JAWS before starting ODI Studio. JAWS should be up and running when you are accessing ODI Studio. If not JAWS does not read all the text in ODI Studio.

  • Double check that your studio is being started by the JDK you enable.

  • If JAWS is not working properly, make sure you remove all the previous versions of java and all its related files along with registry entries from your system and then install the JDK clean (with all default values).

  • In order to have JAWS read tool tip text for a button you have to enable the option - read tool tip text from Settings -> verbosity preferences. By default, it is disabled. Search for verbosity option in the Settings menu and enable it to make JAWS read a tool tip.

  • Jaws can only read the User Interface (UI) components that you access by placing the cursor on them otherwise it cannot recognize the components and cannot read them for you.

Keyboard Navigation in ODI Studio

This section is a collection of keyboard actions that allow you to navigate through ODI Studio UI using the Keyboard (without Mouse). They are:

  • Shift + F10 – Functions like a right-click button on mouse. It opens the context menu on whatever component that has the focus/cursor on. Navigate to an item in the tree and press Shift-F10 - The context menu opens.

  • Alt + F6 – Shift between dialogs. Alt +F6 has a focus cycle. If there are only two windows open at a time, focus will keep cycling between these two (for example, smart export dialog + main window).

  • Menu Windows->Documents– displays a list of multiple objects of same type. (i.e., opens the two mappings MAP1, MAP2. This list would represent both the mappings)

  • Ctrl + Shift + Tab - Displays a dialog of all open frames and any tabs of those frames (i.e. MAP1->Overview -> Logical -> Physical)

  • Shift + Arrow Keys- moves objects around the mapping logical/physical diagram

  • Alt + PGDN / PGUP- Switches to the next / previous tab within a map (i.e. MAP1->Overview -> Logical -> Physical)

  • Ctrl + PGDN / PGUP - Switches to the next / previous sub-tab on the main tab - Overview (i.e. Overview->Definition -> Execution -> Scenarios, and so on)

  • TAB key - tabs to the required editor (this is the standard FCP support)

  • Arrow keys- traverses the nodes and links on the Editor itself.

  • Windows Context Menu key- brings up the context menu (Shift + F10 also performs the same action)

Creating Mappings using Keyboard Keys

To create a Mapping (assuming you have logged into ODI and have the Project tree open in the Design Navigator):

  1. Use arrow keys to navigate to the mapping node.
  2. Use right arrow keys to expand the tree node
  3. Use Shift + F10 to open the Mapping menu and select New Mapping
  4. Use tab keys to navigate through the New dialog and click Ctrl+ Tab to get out of the Description Text field. Disable the parameter Create Empty Dataset using spacebar.
  5. Navigate to Component Window and add a Dataset to mapping. To do this, press the Enter key and the dataset can be added to the logical diagram.
  6. In the Component Frame, use tab to get to the components.

    Note:

    From first focus of Component frame, press four tabs to bring you to the Dataset Component.
  7. With dataset added and focus on Dataset component in logical diagram, use Shift + <arrow keys> to move the component around the canvas.
  8. Close the Thumbnail frame (Shift + F10) cannot invoke menu, so you cannot close Thumbnail. Use mouse to continue. As a workaround,
    1. Invoke Window->Thumbnail. The Thumbnail will be focused.
    2. Invoke Window->Close Thumbnail. The Thumbnail will be closed.
  9. From main Windows menu, open Structure Pane (or Ctrl+ Shift+ S)
  10. From the Design Navigator, open model tree and find a data store to add to mapping, and then use Shift + F10, to do a copy of it.
  11. Use Shift+ Ctrl+ Tab to get a list of open frames and from the list select the new map (this gives the map focus in the Structure Pane).
  12. Use Shift+ Ctrl+ Tab to get to the Structure Pane, move focus to DATASET and use Shift+F10 to invoke the context menu for activating the Paste action. Or as a workaround, invoke Edit->Paste from the main menu).
  13. Moving through the structure pane will give focus to objects in the logical diagram. Then move to Logical window and use Shift+ arrow keys to move the object in the diagram (useful to resize a dataset).
  14. Copy another data store from Design Navigator. Open model tree and find a data store to add to the mapping and then use Shift+ F10 to do a copy.
  15. Use Shift+ Ctrl+ Tab to get to Structure Pane, move focus to the map name and use Shift+ F10 to invoke context menu for paste (or invoke Edit->Paste from main menu). A window of selecting parent for the new object should pop up.
  16. Use down/up arrow keys to select the option Drop Targets in this area when the cursor points on the choice box. Use Enter key to select and close the window.
  17. Move to Component Window and add a Filter to mapping dataset just as mentioned in step 5.
  18. Move to Logical window. Use Tab and then the arrow keys to focus on the components outside the dataset. Use Shift+ arrow keys to adjust the position of the components.
  19. Focus on the source data store inside the dataset on Logical window. Use Ctrl+ Shift+ I to open the Property Inspector. Use Tab to move to Connection Points section.
  20. Use right arrow key to expand Connection Points section. Add Input and Output Connector Points to connect source data store to filter.
  21. Move to Logical diagram. Move focus to Filter component. Use Shift+ Ctrl+ Tab to get to its Property Inspector.
  22. Enter filter condition to connect a particular data store attribute to filter:
    Use Tab to move to the Filter condition text field. Type the expression - DatasetName.SourceTblName.ID.
    1. Use Tab to move to the Filter condition Advanced Editor icon and then press Enter key. On the pop-up window, the connected data store displays in Attributes frame.
    2. Use Tab to move to the Attributes and expand data store node. Select the ID and press Enter key. The expression DatasetName.SourceTblName.ID is displayed in the text field on the right side.
  23. Connect Filter to target data store by repeating the above steps from 19 to 22.
  24. Use Ctrl+ S to save this mapping.
By now, you have created a generic mapping using keyboard keys.