Adición de un botón a la barra de herramientas

Para personalizar la barra de herramientas Query Studio, puede añadir botones de la barra de herramientas.

Procedimiento

Detenga el servicio de IBM® Cognos.
Abra el archivo ubicación_c10/templates/ps/qs/ui.xml en un editor XML o de texto.
Bajo el elemento toolbarContent, añada un identificador para el nuevo botón.
En el siguiente ejemplo se muestra cómo hacer esto para un botón llamado Test.
```
<button id="Test" />
```
Guarde y cierre el archivo ui.xml.
Abra el archivo ubicación_c10/templates/ps/qs/features.xml en un editor XML.
Bajo el elemento root, añada un elemento new feature correspondiente al botón de la barra de herramientas definido en el archivo ui.xml.
Por ejemplo, para el botón Test, añada lo siguiente:
```
<feature name="Test" >
		<toolbar buttonType="button">
		<tooltip>"Test"</tooltip>
			<icon>
				<active useWebRoot="true">qs/images/toolbar/test_button.gif</active>
			</icon>
		<action>
			<parameters>
				<parameter type="string">Test</parameter>
			</parameters>
		</action>
	</toolbar>
</feature>
```
El archivo test.gif al que el elemento icono hace referencia debe existir en el directorio ubicación_c10/webcontent/qs/images/toolbar.

Nota: Si va a añadir un elemento de menú para la misma funcionalidad, añada el botón bajo el mismo elemento feature que el elemento de menú, según se muestra en el siguiente ejemplo:
```
<feature name="Test" >
    <menuItem type="menuItem">
		<...
	 </menuItem>
	 <toolbar buttonType="button">
		 <...
	  </toolbar>
</feature>
```
Guarde y cierre el archivo features.xml.
En el directorio ubicación_c10\webcontent\qs\classes, cree un nuevo archivo JavaScript denominado CIDCaracterística.js.
Por ejemplo, para el botón Test, el nombre de archivo sería CTest.js.

Nota: Si va a añadir un elemento de menú para la misma funcionalidad, este archivo lo utilizarán tanto el elemento de menú como el botón.

En el archivo JavaScript, defina una clase llamada CIDCaracterística, por ejemplo CTest, y las funciones de soporte, según se muestra en el siguiente ejemplo:

function CTest() 
{
    //Initialize
}
CTest.prototype = new AFeatureObject();
CTest.prototype.setup = function (aFeatureParams)
{
    //setup feature parameter
};
CTest.prototype.processErrorState = function()
{
    //Handle error and return error state
};
CTest.prototype.proceedWithoutDialog = function()
{
	return this.execute();
};
CTest.prototype.execute = function (aParameters)
{
    //Execute Feature
};

Guarde el archivo JavaScript.
Inicie el servicio de IBM Cognos.

Resultados

El nuevo botón aparecerá en la barra de herramientas de Cognos Query.

Para suprimir un botón de la barra de herramientas, suprima de ui.xml y features.xml las secciones de código asociadas al botón.