Configuración de una aparición de activador en un servidor

Como parte de la configuración de planificaciones de informes basadas en activadores, debe configurar en el servidor la aparición de activación.

La aparición externa como, por ejemplo, una renovación de la base de datos o un mensaje de correo electrónico, se enlaza a un activador del servidor que provoca la ejecución de la entrada. También debe especificar el nombre de la aparición.

Las apariciones de activador también las puede configurar un desarrollador de Software Development Kit mediante el uso de IBM® Cognos Software Development Kit. Para obtener más información, consulte IBM Cognos Software Development Kit Developer Guide.

El script de Microsoft Windows, trigger.bat, o el script de shell, trigger.sh, permite activar una o más planificaciones para que se ejecuten en el servidor. A continuación, se muestra la sintaxis del script, donde URL es el URL del servidor IBM Cognos,username es un nombre de usuario válido en el espacio de nombres especificado, password es la contraseña del nombre de usuario, namespace es el espacio de nombres del usuario y triggerlist es una lista de los nombres de activadores separados por comas:

trigger.bat URL [username password namespace] 
triggerlist

Por ejemplo, si los usuarios desean planificar un informe basado en una renovación de la base de datos y desean planificar un segundo informe basado en la recepción de un mensaje de correo electrónico, la línea de comandos de activadores personalizada podría ser parecida a ésta:

trigger.bat http://localhost:9300/p2pd/servlet/dispatch username
password namespace databaserefreshtriggername,emailtriggername

Procedimiento

Si va a configurar una aparición de activador en un servidor que no sea un servidor IBM Cognos, realice las siguientes tareas:
- Asegúrese de que el servidor tenga una versión soportada de Java Runtime Environment o kit de desarrollo Java.
- Copie los siguientes archivos de ubicación_c10/webapps/p2pd/WEB-INF/lib de un servidor IBM Cognos en la ubicación del servidor en el que esté configurando la aparición de activador:
  activation.jar
  
  axis.jar
  
  axisCrnpClient.jar
  
  commons-discovery.jar
  
  commons-logging.jar
  
  jaxrpc.jar
  
  saaj.jar
  
  mail.jar
  
  xml-apis.jar
  
  xercesImpl.jar
- Copie los siguientes archivos del directorio ubicación_c10/webapps/utilities/trigger de un servidor IBM Cognos en la ubicación del servidor en el que esté configurando la aparición de activador:
  trigger.bat
  
  trigger.sh
  
  trigger.class (programa de utilidad Java que se puede ejecutar en cualquier plataforma soportada por IBM Cognos)
Asegúrese de que la línea de comandos se ejecute cuando se produzca la aparición externa, como una renovación de la base de datos o un mensaje de correo electrónico.
El mecanismo que se utiliza para invocar el comando de activador personalizado depende de la aplicación en la que esté trabajando, por ejemplo, un sistema de base de datos o una aplicación de correo electrónico. Para obtener más información, consulte la documentación de la aplicación correspondiente.
Avise a los usuarios de que ya pueden planificar entradas de acuerdo con la aparición del activador.
Si un usuario ha planificado una entrada de acuerdo con las apariciones, cuando pulse el botón Planificación de una vista de informe, la información sobre las apariciones sustituirá a la información sobre la frecuencia en la página Planificación.

Resultados

Una vez que se haya ejecutado el script, el método de activación devolverá un valor entero, que representará el número de planificaciones que se han ejecutado. Los siguientes enteros representan errores:

-1 indica un error de uso, como una sintaxis o un parámetro no válidos.
-2 indica un problema de comunicación con el servidor IBM Cognos.