Opcional: Adición de ayuda al nodo

  1. Añadir ayuda en línea al nodo. Puede crear un archivo help.html en el proyecto para que contenga la ayuda en línea que describe lo que el nodo hace y cómo utilizarlo. Si tiene varios archivos, es posible que desee crear un subdirectorio doc diferente en el proyecto de plug-in y almacenar allí los archivos de la ayuda en línea. Puede hacer que la ayuda en línea del nodo aparezca con la información proporcionada por el producto. En la información del producto WebSphere Message Broker, bajo Referencias > Flujos de mensajes, hay un nodo final denominado "Nodos definidos por el usuario". Para que la ayuda en línea para el nodo aparezca en este punto, tiene que:
    1. Modificar el archivo plugin.xml de modo que incluya el punto de extensión siguiente con la documentación del producto WebSphere Message Broker.
      <extension point="org.eclipse.help.toc">
      <toc file="toc.xml"/>
      </extension>
    2. Cree un archivo toc.xml en el proyecto de nodo de plug-in y modifique el atributo link_to de modo que enlace con el ancla "UDNodes" que ya se ha definido en la tabla de contenido de la documentación WebSphere Message Broker como se indica a continuación:
      <toc label="My Plugin Node" topic="my_node.htm"
      link_to="../com.ibm.etools.mft.doc/toc.xml#UDNodes">
      <topic label="Mytopic 1" href="topic1.htm>
      </toc>
      A continuación, debe poder ver el tema de ayuda bajo Referencias > Flujos de mensajes > Nodos definidos por el usuario, en la tabla de contenido.

      Los nodos de ejemplo que se proporcionan con el producto muestran esta característica.

      Para obtener una descripción adicional de los puntos de extensión y cómo se utilizan, consulte PDE Guide.

  2. Añadir ayuda según contexto (F1) al nodo. Esta es la ayuda que se muestra al pulsar un nodo en Perspectiva de Desarrollo de aplicaciones de intermediario y pulsar a continuación F1.

    Cuando se crea un nodo, se crea el archivo HelpContexts.xml. Esto asigna un id de contexto basado en el nombre del nodo. Puede modificar el archivo HelpContexts.xml para el nodo cambiando el texto en el campo de descripción. El nombre del archivo HelpContexts.xml debe ser exclusivo dentro del proyecto pero puede contener varias entradas de contexto, por ejemplo, si tiene varios nodos dentro de un solo proyecto, cada nodo puede tener en el archivo su ayuda según contexto.

    La ayuda sensible al contexto tiene una longitud limitada. Un modo práctico de proporcionar más ayuda al usuario es enlazar desde la ayuda de F1 con un archivo HTML que contenga más información, por ejemplo, con la ayuda en línea del nodo, como se ha descrito anteriormente. El enlace debe codificarse del modo siguiente:
    <topic href"../directorio plugin/archivo html" label="Link title">
  3. Añadir al nodo ayuda emergente (ayuda sobre sugerencias). Cuando se crea un nodo, se crea un archivo palette.properties. Puede modificar este archivo para que contenga ayuda emergente, que se utiliza para mostrar el nombre del nodo cuando la paleta no es lo suficientemente grande como para visualizarlo todo.

Si no desea añadir ninguna característica opcional, puede comprobar el nodo en este punto. Para hacerlo, necesita iniciar otra instancia de entorno de trabajoInicio del cambio, consulte la sección Habilitación de las posibilidades de ejecución de PDEFin del cambio, y seleccionar Ejecutar > Ejecutar como > Entorno de trabajo de ejecución. Consulte PDE Guide para obtener más información acerca de cómo realizar la comprobación utilizando el Entorno de trabajo de ejecución.

Conceptos relacionados
Nodos de entrada definidos por el usuario
Nodos de proceso de mensajes definidos por el usuario
Nodos de salida definidos por el usuario
Tareas relacionadas
Desarrollo de extensiones definidas por el usuario
Implementación de los ejemplos proporcionados
Comprobación de un nodo definido por el usuario
Distribución de una extensión definida por el usuario
Referencia relacionada
Extensiones definidas por el usuario
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Su opinión
Copyright IBM Corporation 1999, 2006 Última actualización: 22/08/2006
as04497_