Para incluir los enlaces de mandato activos en la documentación, primero debe declarar la utilización del código JavaScript de soporte. El JavaScript de la ayuda activa está situado en el plug-in org.eclipse.help. Para hacer referencia a él, puede utilizar la técnica de referencias cruzadas de plug-ins del sistema de ayuda. Esta referencia de script debe colocarse en la sección HEAD del HTML:
<script language="JavaScript" src="PLUGINS_ROOT/org.eclipse.help/livehelp.js> </script>
Ahora, en el cuerpo de la documentación puede invocar la función executeCommand. A continuación se ofrece un ejemplo:
<a href='javascript:executeCommand("org.eclipse.ui.help.aboutAction")'> Abrir el diálogo Acerca de </a>
El parámetro de la función executeCommand es un ParameterizedCommand serializado. Consulte el método ParameterizedCommand.serialize() para obtener todos los detalles de este formato.
El ejemplo anterior muestra el mínimo necesario para incorporar un mandato a un enlace HTML. La documentación de Eclipse complementa esto con dos partes adicionales de información. Primero se especifica un atributo class para permitir el ajuste del aspecto del enlace mediante CSS. En segundo lugar se incluye un código de imagen antes del texto del enlace. La imagen sirve para distinguir los enlaces de mandato de los enlaces ordinarios a otras páginas HTML. Al complementarlo con estas dos características extraordinarias, el ejemplo inicial tendrá el aspecto siguiente:
<a class="command-link" href='javascript:executeCommand("org.eclipse.ui.help.aboutAction")'> <img src="PLUGINS_ROOT/org.eclipse.help/command_link.png"> Abrir el diálogo Acerca de </a>
En los ejemplos anteriores, el mandato del diálogo Acerca de no necesita parámetros, por lo que la serialización es prácticamente el ID del mandato org.eclipse.ui.help.aboutAction. A continuación se proporciona otro ejemplo que muestra un mandato con un parámetro. Tenga en cuenta que el ID del mandato va seguido del ID del parámetro y del valor entre paréntesis:
<a href='javascript:executeCommand( "org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.ui.preferencePages.Views)")'> Mostrar una página de preferencias</a>
Otro ejemplo muestra que hay varios parámetros posibles. Están separados por comas y el orden de los parámetros no es importante.
<a href='javascript:executeCommand( "org.eclipse.ui.dialogs.openMessageDialog(imageType=3,buttonLabel2=Maybe,title=Opinion Poll,message=Do you like command links?,buttonLabel0=Yes,defaultIndex=0,buttonLabel1=No)")'> Abrir un diálogo de mensaje</a>