lunes, 22 de agosto de 2011

Habilitar las Custom Actions en un Task Flow de forma local

Hoy os traigo un pequeño fragmento de cómo habilitar de formal local las CustomActions de un Task Flow.

Existen 3 maneras de incluir CustomActions a Task Flows:
  • De forma local a la ADF Library: Es el caso que aquí os traigo y que personalmente más me gusta. Al empaquetar nuestro Task Flow en un JAR también le indicaremos qué acciones están disponibles en el menú. Esto se realiza en un archivo denominado adf-settings.xml.
  • Globalmente a una aplicación de WebCenter Portal: En este caso indicaremos acciones globales que aparecerán en todos los Task Flow del nuestra aplicación de portal. Éstas se indican en el archivo adf-config.xml.
  • Declarativamente en una página: Cuando añadimos un Task Flow en etapa de diseño en lugar de en ejecución desde Oracle Composer. Éste genera un binding a una instancia del Task Flow que es referenciada mediante la etiqueta ADF <af:region>. En este caso, desde la paleta que nos proporciona JDeveloper con los componentes de Oracle Composer podemos englobar nuestro Task Flow con un <af:showDetailHeader> y dentro arrastrar tantas <cust:customActions> como nuevos elementos de menú se quiera.
Para configurar de forma local las CustomActions a nuestro Task Flow debemos seguir los siguientes pasos:
  • Generar, en el caso de que no exista, una carpeta META-INF en nuestra carpeta raíz de código fuente src.
  • Crear un archivo con el nombre adf-settings.xml en la carpeta creada anteriormente.
  • En ella introducir las CustomActions que deseamos definir para nuestra librería. En cada una de ellas se deben definir los siguientes campos:
    • action: Acción de navegación que se va a llevar a cabo desde el Task Flow actual en el que nos encontramos.
    • location: Localización del fragmento de cabecera del Task Flow en el que se encontrará nuestra opción. Los valores pueden ser: both, menu, chrome.
    • rendered: Para el caso en el que queramos que nuestra acción sea visible dependiendo de una EL Expression de JSF.
    • icon: Para seleccionar un icono o imagen propia del menu.
    • shortDesc: Descripción corta que aparecerá al situar el ratón sobre la acción.
    • text: Nombre visual que se desea otorgar a la acción.
    • taskFlowId: Identificador del Task Flow que contendrá la acción.

Espero podido ayudar un poco con las CustomActions.

Documentación oficial acerca de CustomActions: http://download.oracle.com/docs/cd/E17904_01/webcenter.1111/e10148/jpsdg_page_editor_addconfig.htm

Ejemplo desarrollado en JDeveloper 11.1.1.4 y con la extensión de WebCenter PS3.

Un saludo a todos.

No hay comentarios:

Publicar un comentario