Utilización de la API de Java para supervisar datos

Puede definir un origen de datos para utilizar la API de Java™ para interactuar con una aplicación de larga ejecución en la plataforma Java. El agente inicia la aplicación al inicio e interactúa con ella de forma periódica. Cuando crea el agente, Agent Builder crea el código fuente de la aplicación. Debe personalizar el código para recopilar los datos correctos. En función del código, el origen de datos puede producir varios conjuntos de datos que pueden contener una sola fila, varias filas o datos de sucesos.

1. En la página Origen de datos inicial del agente o la página Ubicación de origen de datos, pulse Programas personalizados en el área Categorías de datos de supervisión.
2. En el área Orígenes de datos, pulse API de Java.
3. Pulse Siguiente.
4. En la página Información de API de Java, entre un nombre de grupo de atributos.
5. Especifique un texto de ayuda para el grupo de atributos.
6. Seleccione si el grupo de atributos Produce una sola fila de datos, Puede producir más de una fila de datos o Produce sucesos. Esta opción afecta la aplicación Java de muestra que se crea al final del asistente. Para obtener más información, consulte el apartado Envío de datos.
7. Opcional: Pulse Avanzado para modificar las propiedades avanzadas del grupo de atributos. Avanzado está disponible cuando se selecciona que el grupo de tributos Puede producir más de una fila de datos o Produce sucesos.
8. Pulse Siguiente.
9. En la página Información de atributo, especifique el primer atributo para el grupo de atributos. Para obtener más información sobre la creación de atributos, consulte Creación de atributos.
10. Seleccione Añadir atributos adicionales y pulse Siguiente para añadir otros atributos al agente. Las referencias a los atributos se incorporan en la aplicación Java de muestra que se crea al final del asistente.
11. Pulse Siguiente.
12. En la página Información de origen de datos de la API de Java global, entre un nombre de clase y un nombre de archivo JAR.

    El nombre de clase es un nombre de clase cualificado cuyo método principal se llama cuando se inicia Java. La aplicación Java de muestra se crea con el método Java principal en esta clase.

    El archivo JAR es el archivado que contiene las clases Java que componen la aplicación Java. El archivo JAR está empaquetado con el agente y se instala con él.

13. Opcional: Defina los códigos de error que la aplicación Java puede enviar, en la página Información de origen de datos de API de Java global, sección Códigos de error. La aplicación Java envía estos códigos de error cuando no puede recopilar datos.
    Restricción: Un código de error tiene un límite de 256 caracteres. Sólo están permitidos las letras ASCII, los dígitos y los subrayados. No se permiten espacios.
    1. Pulse Añadir en la sección Códigos de error.
    2. En la ventana Definición de código de error de la API de Java, entre un valor de visualización.
    3. Especifique un valor interno. El valor interno debe ser un entero desde 1.000 a 2.147.483.647.
    4. Defina un texto de mensaje para cada error. Puede utilizar el texto de mensaje que se ha especificado previamente seleccionándolo en la lista. Pulse Aceptar para volver a la página Información de origen de datos de la API de Java global.
       El mensaje se registra en el archivo de registro del agente.
    5. Si no hay disponible ningún texto de mensaje adecuado, pulse Examinar para configurar el texto del mensaje.
       Se visualiza la ventana Los mensajes (lista). La ventana de mensajes muestra una lista de los mensajes que están definidos en el agente. Hasta que defina mensajes, la lista permanece en blanco. Puede utilizar Editar para alterar un mensaje definido y Eliminar para suprimir uno o más mensajes que ha definido.
    6. En la ventana Mensajes (lista), pulse Añadir para ver una ventana Definición de mensaje. En la ventana Definición de mensaje, puede escribir el texto que describe el significado del nuevo mensaje y seleccionar el tipo de mensaje.
       Nota: El identificador de mensaje se generará de forma automática.
    7. Pulse Aceptar.
    8. Aparecerá la ventana Mensajes (lista) con el nuevo mensaje. Para verificar el mensaje y volver a la página Información de origen de datos de la API de Java global, pulse Aceptar.
14. Opcional: En la sección Archivos complementarios de la página Información de origen de datos de la API de Java global, puede añadir archivos que se empaquetan con el agente y se copian en el sistema del agente en la instalación del agente. El archivo JAR de la API de cliente del proveedor de Java no se lista aquí; se copia automáticamente en el sistema del agente. La columna Tipo de archivo describe cómo espera utilizarse cada archivo. En la tabla siguiente, se describen tres posibles usos (Tabla 1). Pulse Editar para editar el archivo importado. Para obtener más información, consulte (Edición de una definición de archivo de mandatos).

    Tabla 1. Tipos de archivos para archivos complementarios

    Tipo de archivo	Descripción
    Ejecutable	Seleccione esta opción si desea incluir un archivo ejecutable con el agente. El agente no utiliza este archivo, pero se encuentra en la vía de acceso para que lo utilice la aplicación Java.
    Biblioteca	Seleccione esta opción si desea incluir una biblioteca con el agente. El agente no utiliza este archivo, pero se encuentra en la vía de acceso de la biblioteca para que la aplicación Java lo utilice.
    Recurso Java	Seleccione esta opción para incluir recursos Java con el agente. El agente no utiliza este archivo, pero se encuentra en la vía de acceso de clase para que la aplicación Java lo utilice.

    Nota: Cuando se añade un archivo complementario de recursos de Java al Agent Builder, el archivo se añade automáticamente a la vía de acceso de clases del proyecto. El compilador de Java utiliza el archivo complementario para resolver cualquier referencia que tenga el código, a clases en el recurso.

    Para obtener información sobre dónde se instalan los archivos complementarios con el agente, consulte Nuevos archivos en el sistema.
15. Opcional: Cree un filtro para limitar los datos devueltos por este grupo de atributos, si los datos son muestreados. Cree un filtro pulsando Avanzado.
    Nota: Los datos se muestrean si no ha seleccionado Produce sucesos en la página Información de API de Java.

    Para obtener más información sobre el filtrado de datos desde un grupo de atributos, consulte Filtrado de grupo de atributos.
16. Opcional: Añada propiedades de configuración al subnodo.
    Si añade este origen de datos a un subnodo, la página Alteraciones temporales de configuración de subnodo se visualiza para que pueda añadir propiedades de configuración al subnodo. Se necesita por lo menos una propiedad de configuración bajo el subnodo para crear la aplicación Java de muestra. Se necesita por lo menos una propiedad de configuración porque el ejemplo utiliza una propiedad de configuración para distinguir una instancia de subnodo de otra.
17. Realice una de las acciones siguientes:
    1. Si utiliza el Asistente de agente, pulse Siguiente. Complete el asistente según sea necesario.
    2. De lo contrario, pulse Finalizar para guardar el origen de datos y abrir Agent Editor. A continuación, en el menú principal, seleccione Archivo > Guardar.
    En este punto, Agent Builder crea el código fuente para la aplicación de supervisión. El código está ubicado en el subdirectorio src del directorio del proyecto. Edite este código para crear la aplicación de supervisión.