Incluir Ayuda/Help en las aplicaciones ADF

Application Development

01/08/2011 - Jesús García

El pasado 22-06-2011 se liberó la versión 11.1.2 de Oracle Help, alineada con la misma versión de JDeveloper que había aparecido 2 semanas antes.

The Oracle Help technologies provide the means for developing and displaying HTML-based help systems for Java and web applications. Authors can create a single help system that can be displayed – without modification – both in a Java environment, using Oracle Help for Java (OHJ); and in a web environment, using Oracle Help for the Web.

Oracle Help for Java(OHJ)

OHJ está formado por un conjunto de componentes Java, un API de Java, y una especificación de los formatos de archivo para el desarrollo y visualización de contenido HTML de ayuda en entornos Java.

Oracle Help for the Web – Rich Client (OHW-RC)

OHW-RC proporciona contenido de ayuda HTML en entorno Web. Se utiliza Oracle Application Development Framework (ADF) para crear una interfaz de usuario que cumple con Oracle’s Browser Look and Feel Plus (BLAF+).

Authoring

Oracle Help no incluye un entorno de creación completo pero sí que incluye dos utilidades para facilitar el trabajo:

Helpset Authoring Wizard: This wizard converts certain noncompatible help content and control files into files that can be used by Oracle Help. For example, you can use the wizard to create an Oracle Help system from files generated by RoboHelp 2000 for Microsoft HTML Help.
Text Search Indexer: This utility generates the search index file used in Oracle Help when a user searches on a word or phrase in the Search tab.

Aunque es sencillo crear contenidos directamente, lo ideal es aprovecharse de que Oracle Help es compatible con varias herramientas de autor: Adobe RoboHelp, WebWorks Quadralay y AuthorIT.

¿Cómo integrar Oracle Help con las aplicaciones ADF?

En este How to document y en este viewlet encontrarás explicaciones detalladas sobre cómo realizar la integración de Oracle Help con aplicaciones desarrolladas con el framework Oracle Application Framework (ADF).

Parar realizar el tutorial y probar la aplicación de ejemplo, puedes descargar aquí el código necesario.