El primero de los dos archivos JAR necesarios, al que denominaremos
PSFTCI.jar, debe crearse y compilarse manualmente.
El conector de PeopleSoft sondea el servidor PeopleSoft Enterprise a intervalos
especificados en busca de sucesos. Cuando el conector detecta un suceso, convierte los
datos de sucesos en un objeto de negocio y lo envía a la aplicación cliente. Para
utilizar este escenario, debe crear un proyecto de sucesos personalizado en el servidor
PeopleSoft Enterprise.
Almacén de sucesos
El almacén de sucesos es una tabla que contiene sucesos que
representan cambios de datos hasta que el conector de sondeo los procesa. El conector
utiliza el almacén de sucesos para realizar un seguimiento de las entidades de sucesos. Para utilizar el proceso de entrada, debe utilizar el diseñador de aplicaciones de
PeopleTools para crear un proyecto personalizado para la notificación de sucesos. El proyecto personalizado crea el almacén de sucesos que el conector necesita para el
proceso entrante. Cada vez que se crea, se actualiza o se suprime un objeto de negocio,
la función PeopleCode utilizada en el proyecto y luego añadida a la interfaz de
componente inserta un nuevo registro en el almacén de sucesos, con el nombre de objeto,
las claves y el valor de estado adecuados.
Durante el proceso entrante, el conector
sondea los sucesos en el almacén de sucesos a intervalos de sondeos configurados. En cada
llamada de sondeo, el conector procesa un número configurado de sucesos. El orden del
proceso de sucesos se basa en el orden ascendente de prioridad y el orden ascendente de
la indicación de la fecha y hora del suceso. En cada ciclo de sondeo se toman los sucesos con el estado Ready for poll (0)
(Preparado para sondeo).
El conector utiliza el nombre de objeto y la clave de objeto para recuperar el objeto de
negocio correspondiente. A medida que los sucesos se recuperan del almacén de sucesos y
se procesan, el estado del suceso cambia para reflejar su estado, como se muestra en la
tabla siguiente.
Tabla 1. Valores de estado de sucesoNombre abreviado de estado |
Descripción |
Valor de tabla de sucesos |
Error al procesar suceso |
Se ha producido un error durante el proceso de sucesos. |
-1 |
Preparado para sondeo |
El suceso está preparado para que lo elijan. |
0 |
Correcto |
El suceso se ha entregado al gestor de sucesos. |
1 |
Suprimido |
El suceso se ha procesado correctamente y se ha eliminado del
almacén de sucesos. |
4 |
I. Para crear la tabla de sucesos
Para configurar y compilar los archivos JAR de PeopleSoft, asegúrese de que
se realicen los pasos siguientes:
- Cree la tabla de sucesos
- Añada el desencadenante al componente WBI_CUSTOMER_COMP
- Cree la API de Java™ para la interfaz de
componente
- Copie el proyecto WBI_CUST_PROJ ubicado en <Directorio de instalación de Cast
Iron>\etc\peoplesoft\scripts a un directorio temporal (C:\Projects) en la máquina en la que ejecuta PeopleTools.
- Inicie sesión en el diseñador de aplicaciones de PeopleSoft y seleccione
Tools (Herramientas) > Copy Project
(Copiar proyecto) > From File (De archivo).
- Vaya al directorio C:\Proyectos. En el área para seleccionar un
proyecto, en la lista que se muestra, efectúe una doble pulsación en
WBI_CUST_PROJ.
- En el diálogo para copiar desde archivo, pulse Copiar. Espere a que se complete la
operación.
- Seleccione WBI_CUST_PROJ en el panel izquierdo y seleccione
Build (Compilar) > Project (Proyecto) en
el menú principal.
- En el panel de compilación, seleccione estas casillas de verificación:
- Crear tablas
- Crear vistas
- Crear desencadenante
- Ejecutar y compilar script
- Pulse Build (Compilar) para empezar a compilar el proyecto.
- Pulse Close (Cerrar) para salir del diálogo de progreso de la
compilación.
- En la vista de registro de la compilación del diseñador de aplicaciones, compruebe
los mensajes del registro para confirmar que los tres registros se han procesado
correctamente.
- Seleccione File (Archivo) > Save All
(Guardar todo) para guardar los cambios.
- Para configurar la seguridad del usuario para las interfaces de componente, inicie
sesión en PeopleSoft Web Client con el URL:
http://localhost/psp/ps/?cmd=login.
- Vaya a PeopleTools > Security
(Seguridad) > Permissions & Roles (Permisos y roles) >
Permission Lists (Listas de permisos).
- Especifique PTPT1200 en el recuadro de edición de begins
with (empezar por) y pulse Search (Buscar).
- Vaya al separador de interfaces de componente, pulse + para añadir la interfaz de
componente WBI_CUSTOMER_COMP_INTERFACE.
- Pulse editar en WBI_CUSTOMER_COMP_INTERFACE.
- Seleccione Full Access (Acceso total) para todos los métodos y pulse OK
(Aceptar).
- Vuelva a la pestaña Interfaces de componente y pulse + para añadir la interfaz de componente IBM_EVENT_CI.
- Pulse editar en IBM_EVENT_CI.
- Seleccione Full Access (Acceso total) para todos los métodos y
pulse OK (Aceptar).
- Regrese al separador de interfaces de componente y pulse el botón
Save (Guardar) para guardar los cambios.
II. Para añadir desencadenantes
- En el diseñador de aplicaciones de PeopleSoft, abra el proyecto
WBI_CUST_PROJ.
- En el panel izquierdo, pulse con el botón derecho en
WBI_CUSTOMER_COMP y seleccione View PeopleCode
(Ver PeopleCode).
- En la ventana de edición de PeopleCode, seleccione
SavePostChange en el panel derecho.
- Escriba el código PeopleCode siguiente en la ventana de edición.
Declare Function IBMPublishEvent PeopleCode IBM_FETCH_ID.IBM_NEXT_EVENT_ID FieldFormula;
Component string &BONAME1; serie de compoeente &KEYLIST1;
&BONAME1 = "WbiCustomerCompInterface";
&KEYLIST1 = "WBI_CUSTOMER.WBI_CUSTOMER_ID"; /* Comprobar si el componente ha cambiado antes de llamar a la función*/ If ComponentChanged() And %UserId <> "C" Then /* Publicar este suceso en IBM WebSphere IBM_EVENT_TBL para sondeo */
IBMPublishEvent(&BONAME1; &KEYLIST1); End-If;
- Seleccione File (Archivo) > Save All
(Guardar todo) para guardar los cambios.
- Para garantizar que el desencadenante creado en los pasos anteriores funciona bien,
debe realizar una tarea de inicialización. Conéctese a la base de datos que PeopleTools
utiliza y ejecuta la sentencia SQL siguiente:
$ insert into PS_IBM_FETCH_ID values(1000);
$ commit;
III. Para crear la API de Java
para la interfaz de componente
La API de interfaz de componente proporciona
acceso a todos los objetos y métodos de PeopleCode. Puede generar manualmente estas API
utilizando el diseñador de aplicaciones y después compilándolas en un archivo
PSFTCI.jar.
- En el diseñador de aplicaciones PeopleSoft abra la interfaz de componente
IBM_EVENT_CI.
- Seleccione Build (Compilar) > PeopleSoft
API en el menú principal.
- En el diálogo para compilar enlaces de API de PeopleSoft, compruebe que en las clases
Java sólo esté seleccionada la casilla de
verificación para compilar. Establezca el directorio de destino para almacenar los
archivos Java que se generen.
En la lista para
seleccionar una API para compilar, seleccione los elementos siguientes:
- CompIntfc.CompIntfcPropertyInfo
- CompIntfc.CompIntfcPropertyInfoCollection
- Todos los que empiezan por CompIntfc.IBM_EVENT_CI
- Todos los que empiezan por CompIntfc.WBI_CUSTOMER_COMP_INTERFACE
- Pulse Aceptar. Compruebe el directorio de destino para
ver si los archivos Java se han generado
correctamente.
- Copie los archivos Java generados en el
directorio C:\Temp y después copie el archivo psjoa.jar
desde el directorio <PeopleTools_HOME>\web\psjoa a
C:\Temp.
- Escriba el directorio como C:\Temp y ejecute los mandatos siguientes
para compilar los archivos Java.
$ javac -classpath .\psjoa.jar PeopleSoft\Generated\CompIntfc\*.java
$ jar -cvf PSFTCI.jar PeopleSoft\Generated\CompIntfc\*.class
El conector PeopleSoft utilizará estos dos archivos JAR, psjoa.jar y
PSFTCI.jar, para acceder a la aplicación PeopleSoft Enterprise.