WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

Propiedades del adaptador de entrada para PeopleSoft

Las propiedades de adaptador de entrada contienen la información de configuración para el proceso de sucesos de entrada de un componente de exportación. Estas propiedades también controlan el funcionamiento general del adaptador, como por ejemplo especificando el espacio de nombres para objetos de negocio. Utilice el asistente de conexión del adaptador para establecer estas propiedades.

La tabla siguiente lista las propiedades para proceso de entrada que establece utilizando el asistente de conexión de adaptador. Se proporciona una descripción más detallada de cada propiedad en las secciones que siguen a la tabla.
Tabla 1. Propiedades de adaptador de entrada
Nombre de propiedad Finalidad
ID de adaptador a utilizar para registro cronológico y rastreo (AdapterID) El nombre de la instancia del adaptador en los archivos de registro y rastreo.
Instancia de adaptador para suceso filtrado (AdapterInstanceEventFilter) Identificador que determina si esta instancia de adaptador procesa sucesos específicos en el almacén de sucesos.

Entrega de sucesos asegurada una sola vez (AssuredOnceDelivery)

Especifica si el adaptador proporciona entrega asegurada de sucesos una sola vez.

Interfaz de componente para probar conexiones fallidas (PingCompIntfc) La interfaz de componente que el adaptador utiliza para validar una conexión con el servidor PeopleSoft Enterprise
Nombre de interfaz de componente para notificación de sucesos (EventCIName) La interfaz de componente que el adaptador utiliza para la notificación de sucesos

Tipo de entrega (DeliveryType)

Determina el orden en que el adaptador entrega los sucesos al componente de exportación.

Delimitador para claves del almacén de sucesos (EventKeyDelimiter) El nombre y valor para una clave de objeto en la tabla de sucesos
No procesar sucesos que tengan una indicación de fecha y hora en el futuro (FilterFutreEvents)

Especifica si el adaptador filtra o no los sucesos futuros comparando la indicación de fecha y hora de cada suceso con la hora del sistema

Tipos de sucesos a procesar (EventTypeFilter)

Una lista delimitada de tipos de suceso que indica al adaptador qué sucesos debe entregar

Formato de fecha Java™ para la indicación de fecha y hora del suceso (DateFormat) El formato que se utiliza para crear la indicación de fecha y hora del suceso

Número máximo de conexiones (MaximumConnections)

El número máximo de conexiones que el adaptador puede utilizar para la entrega de sucesos de entrada.

Número mínimo de conexiones (MinimumConnections)

El número mínimo de conexiones que el adaptador puede utilizar para la entrega de sucesos de entrada.

Tiempo entre sondeo de sucesos (PollPeriod)

La cantidad de tiempo que el adaptador espera entre periodos de sondeo.

Número máximo de sucesos recopilados durante cada sondeo (PollQuantity)

El número de sucesos que el adaptador suministra al componente de exportación durante cada periodo de sondeo.

Detener el adaptador cuando se encuentra un error durante el sondeo (StopPollingOnError)

Especifica si el adaptador detiene el sondeo de sucesos cuando encuentra un error durante el sondeo.

Tiempo entre reintentos en caso de anomalía de conexión del sistema (RetryInterval)

La cantidad de tiempo que el adaptador espera entre intentos de establecer una nueva conexión después de un error durante operaciones de entrada.

ID de adaptador a utilizar para registro cronológico y rastreo (AdapterID)

Necesaria
Valor predeterminado 001
Tipo de propiedad String (serie)
Uso Esta propiedad identifica la instancia de adaptador en los archivos de registro y de rastreo, y también ayuda a identificar la instancia de adaptador al supervisar adaptadores. El ID de adaptador se utiliza con un identificador específico del adaptador, PSOFTRA, para formar el nombre del componente utilizado por la herramienta Analizador de anotaciones y rastreos. Por ejemplo, si la propiedad del ID de adaptador se establece en 001, el ID de componente es PSOFTRA001.

Si ejecuta varias instancias del mismo adaptador, asegúrese de que los ocho primeros caracteres de la propiedad de ID de adaptador son exclusivos para cada instancia de modo que pueda correlacionar el registro y el rastreo de la información con una instancia de adaptador concreto. Al hacer que los siete primeros caracteres de una propiedad de ID de adaptador sean exclusivos, el ID de componente para varias instancias de dicho adaptador también es exclusivo, lo que le permite correlacionar la información de registro y rastreo a una instancia específica de un adaptador.

Por ejemplo, cuando establece la propiedad de ID de adaptador de dos instancias de WebSphere Adapter para PeopleSoft Enterprise en 001 y 002. Los ID de componente de esas instancias, PSOFTRA001 y PSOFTRA002, son lo suficientemente cortos para seguir siendo exclusivos, lo que le permite distinguirlos como instancias de adaptador por separado. No obstante, las instancias con propiedades de ID de adaptador más largas no se pueden distinguir entre sí. Si establece las propiedades de ID de adaptador de dos instancias en Instance01 y Instance02, no podrá examinar la información de registro y rastreo de información para cada instancia de adaptador porque el ID de componente para ambas instancias se trunca en PSOFTRAInstance.

Para el proceso de entrada, esta propiedad se recupera de las propiedades de adaptador de recursos. Para el proceso de salida, se recupera de las propiedades de fábrica de conexiones gestionadas.

Globalizada
Con soporte Bidi No

Instancia de adaptador para el filtrado de sucesos (AdapterInstanceEventFilter) (AdapterInstanceEventFilter)

Esta propiedad controla si la instancia de adaptador procesa sucesos específicos en el almacén de sucesos.

Tabla 2. Detalles de Instancia de adaptador para el filtrado de sucesos (AdapterInstanceEventFilter)
Necesaria No
Valor predeterminado nulo
Tipo de propiedad Serie de caracteres
Uso Esta propiedad le ayuda a migrar desde WebSphere Business Integration Adapter para PeopleSoft hasta WebSphere Adapter para PeopleSoft Enterprise. WebSphere Business Integration Adapter para PeopleSoft le permite realizar el equilibrio de carga permitiendo instancias de adaptador de gran volumen en varios tipos de sucesos para procesar sucesos del mismo tipo. Cuando no se precisa el equilibrio de carga, una única instancia de adaptador procesa todos los sucesos de un determinado tipo. Esta propiedad es para habilitar la migración sin problemas para clientes de WBIA a JCA para los clientes que están sacando provecho actualmente del filtrado connectorID.

WebSphere Adapter para PeopleSoft Enterprise no suele requerir equilibrio de carga de esta manera, pero le da soporte para que pueda migrar sin modificar los desencadenantes de base de datos u otros mecanismos que graban sucesos en el almacén de sucesos.

La propiedad AdapterInstanceEventFilter corresponde a la propiedad ConnectorID de WebSphere Business Integration Adapter para PeopleSoft.

Para utilizar esta característica, los desencadenantes de base de datos u otros mecanismos que crean sucesos en el almacén de sucesos deben asignar el valor adecuado en la columna ID de conector.

Para utilizar esta característica, PeopleCode que crea sucesos en el almacén de sucesos debe asignar el valor adecuado para la columna de ID de conector.

El ejemplo en la tabla siguiente muestra la interacción entre la propiedad AdapterInstanceEventFilter y el valor en la columna ID de conector en el almacén de sucesos.

Si las propiedades EventTypeFilter y AdapterInstanceEventFilter están ambas establecidas, el adaptador sólo procesa sucesos que cumplen ambos criterios. Es decir, sólo procesa los eventos cuyo tipo se especifica en la propiedad EventTypeFilter y cuya columna ID de conector coincide con la propiedad AdapterInstanceEventFilter.

Ejemplo Consulte el ejemplo en la tabla siguiente.
Globalizada
Con soporte Bidi
Tabla 3. Interacción de la propiedad AdapterInstanceEventFilter con la columna ID de conector en el almacén de sucesos
Propiedad AdapterInstanceEventFilter Columna ID de conector de un suceso Resultado
nulo nulo El adaptador procesa el suceso.
nulo Instance1 El adaptador procesa el suceso, porque la columna de ID de conector no está seleccionada.
Instance1 Instance1 El adaptador procesa el suceso.
Instance1 Instance2 El adaptador no procesa el suceso, porque los ID de instancia no coinciden.
Instance1 nulo El adaptador no procesa el suceso, porque los ID de instancia no coinciden.

Entrega de sucesos asegurada una sola vez (AssuredOnceDelivery)

Especifica si se va a proporcionar o no entrega asegurada una sola vez para sucesos de entrada.

Tabla 4. Detalles de entrega de sucesos asegurada una sola vez
Necesaria
Valores posibles

True
False

Valor predeterminado True
Tipo de propiedad Booleano
Uso Cuando esta propiedad se establece en True, el adaptador proporciona entrega de sucesos asegurada una sola vez, de modo que cada suceso se entrega una sola vez. Un valor de False no proporciona la entrega de sucesos asegurada una sola vez, pero proporciona mejor rendimiento.

Cuando esta propiedad se establece en True, el adaptador intenta almacenar información de transacción (XID) en el almacén de sucesos. Si se establece en False, el adaptador no intenta almacenar la información.

Esta propiedad sólo se utiliza si el componente de exportación es transaccional. Si no lo es, no se puede utilizar ninguna transacción, independientemente del valor de la propiedad.

Globalizada No
Con soporte Bidi No

Interfaz de componente para comprobar una conexión fallida (PingCompInterface)

Esta propiedad especifica el nombre de la interfaz de componente de PeopleSoft Enterprise que el adaptador utiliza para validar una conexión con el servidor PeopleSoft Enterprise.

Tabla 5. Detalles de interfaz de componente para comprobar una conexión fallida
Fila Explicación
Necesaria
Valor predeterminado El nombre de la primera interfaz de componente de la lista
Tipo de propiedad String (serie)
Uso El nombre de la interfaz de componente que el adaptador utiliza para probar la conectividad con el servidor PeopleSoft Enterprise. Especifique un nombre de interfaz de componente que ya exista en las aplicaciones PeopleSoft Enterprise
Globalizada No
Con soporte Bidi No

Nombre de interfaz de componente para notificación de sucesos (EventCIName)

Esta propiedad especifica el nombre de la interfaz de componente de PeopleSoft Enterprise que el adaptador utiliza para el proceso de entrada.

Tabla 6. Detalles de nombre de interfaz de componente para notificación de sucesos
Fila Explicación
Necesaria
Valor predeterminado IBM_EVENT_CI
Tipo de propiedad String (serie)
Uso El nombre de la interfaz de componente que el adaptador utiliza para el proceso de entrada. Para utilizar el proceso de entrada, cree una interfaz de componente expresamente para la notificación de sucesos en PeopleSoft Enterprise.
Globalizada No
Con soporte Bidi No

Tipo de entrega (DeliveryType)

Esta propiedad especifica el orden en que el adaptador entrega los sucesos al componente de exportación.

Tabla 7. Detalles de tipo de entrega
Necesaria No
Valores posibles

ORDERED
UNORDERED

Valor predeterminado ORDERED
Tipo de propiedad Serie de caracteres
Uso Se aceptan los valores siguientes:
  • ORDERED: El adaptador entrega los sucesos al componente de exportación de uno en uno.
  • UNORDERED: El adaptador suministra todos los sucesos al componente de exportación al mismo tiempo.

Si establece esta propiedad en UNORDERED, las propiedades Número mínimo de conexiones y Número máximo de conexiones deben ser mayores que 1.

Globalizada No
Con soporte Bidi No

Delimitador para claves del almacén de sucesos (EventKeyDelimiter)

Esta propiedad especifica el delimitador para la pareja de nombre-valor de clave de objeto en la tabla de sucesos.

Tabla 8. Detalles de delimitador para claves del almacén de sucesos
Fila Explicación
Necesaria No
Valor predeterminado =:
Tipo de propiedad String (serie)
Uso Utilice esta propiedad para especificar un nombre de objeto y un valor para utilizarlos como clave de objeto en el almacén de sucesos.
Ejemplo CustomerID=2001
Globalizada No
Con soporte Bidi No

No procesar sucesos cuya indicación de la hora sea futura (FilterFutureEvents)

Esta propiedad especifica si el adaptador filtra o no los sucesos futuros comparando la indicación de fecha y hora de cada suceso con la hora del sistema.

Tabla 9. No procesar sucesos cuyos detalles tienen una indicación de la hora futura
Necesaria
Valores posibles

True
False

Valor predeterminado False
Tipo de propiedad Booleano
Uso

Si se establece en True, el adaptador compara la hora de cada suceso con la hora del sistema. Si la hora del suceso es posterior a la hora del sistema, el suceso no se entrega.

Si se establece en False, el adaptador entrega todos los sucesos.

Globalizada No
Con soporte Bidi No

Tipos de sucesos a procesar (EventTypeFilter)

Esta propiedad contiene una lista delimitada de tipos de suceso que indica al adaptador qué sucesos debe entregar.

Tabla 10. Tipos de sucesos para procesar detalles
Necesaria No
Valores posibles Una lista delimitada por comas (,) de tipos de objetos de negocio y operaciones
Valor predeterminado nulo
Tipo de propiedad Serie de caracteres
Uso Los sucesos se filtran por tipo de objeto de negocio y operaciones. Si se establece la propiedad, el adaptador sólo entrega aquellos sucesos que están en la lista. Un valor de null o * indica que no se aplicará ningún filtro y que todos los sucesos se entregarán al componente de exportación.

Cuando el conjunto de operaciones predeterminadas (Crear/Actualizar/Suprimir) no es el preferido, el adaptador proporciona una función de sondeo basada en operaciones.

Por ejemplo, si selecciona una operación Crear|Actualizar, el adaptador sondea sólo aquellos sucesos con la operación Crear o Actualizar para todos los objetos de negocio. La serie predeterminada generada para eventTypeFilter es *: Crear|Actualizar.

Sintaxis: BOName:Operation1|Operation2, BOName:Operation1|Operation2|Operation3
  • "," se utiliza para separar los objetos de negocio. Los objetos que no estén en esta lista se ignoran.
  • ":" se utiliza para separar el nombre de objeto de negocio y el nombre de la operación.
  • "|" se utiliza para separar las operaciones soportadas, como por ejemplo Crear, Suprimir y Actualizar.
Ejemplo
  • Para recibir sucesos relacionados con los objetos de negocio Customer y Order independientemente de las operaciones, especifique este valor: Customer,Order o especifique este valor para todas las operaciones soportadas: Customer:Crear|Actualizar|Suprimir,Order:Crear|Actualizar|Suprimir.
  • Para recibir todos los sucesos del objeto de negocio Customer y los sucesos Crear y Suprimir del objeto de negocio Order, especifique este valor: Customer,Order:Crear|Suprimir
  • Para recibir los sucesos Crear y Suprimir de todos los objetos de negocio, especifique este valor: *:Crear|Suprimir.
Nota: En esta propiedad, puede utilizar únicamente aquellas operaciones que se han elegido al seleccionar objetos de negocio y servicios.

Si las propiedades EventTypeFilter y AdapterInstanceEventFilter están ambas establecidas, el adaptador sólo procesa sucesos que cumplen ambos criterios. Es decir, sólo procesa los eventos cuyo tipo se especifica en la propiedad EventTypeFilter y cuya columna ID de conector coincide con la propiedad AdapterInstanceEventFilter.

Globalizada No
Con soporte Bidi No

Formato de fecha Java para la indicación de fecha y hora del suceso (DateFormat)

Esta propiedad especifica el formato que se utiliza para la indicación de fecha y hora del suceso.

Tabla 11. Detalles de formato de fecha Java para la indicación de fecha y hora del suceso
Fila Explicación
Necesaria
Valor predeterminado MM/dd/aa
Tipo de propiedad String (serie)
Uso Esta propiedad se utiliza para dar formato a los valores de fecha del servidor PeopleSoft Enterprise.
Globalizada No
Con soporte Bidi No

Número máximo de conexiones (MaximumConnections)

Esta propiedad especifica el número máximo de conexiones que el adaptador puede utilizar para la entrega de sucesos de entrada.

Tabla 12. Detalles de número máximo de conexiones
Necesaria No
Valor predeterminado 1
Tipo de propiedad Entero
Uso Sólo son válidos los valores positivos. El adaptador considera cualquier entrada positiva menor que 1 o equivale 1. Escribir un valor negativo o 0 para esta propiedad podría dar como resultado errores en tiempo de ejecución.
Globalizada No
Con soporte Bidi No

Número mínimo de conexiones (MinimumConnections)

Esta propiedad especifica el número mínimo de conexiones que el adaptador puede utilizar para la entrega de sucesos de entrada.

Tabla 13. Detalles de número mínimo de conexiones
Necesaria No
Valor predeterminado 1
Tipo de propiedad Entero
Uso Sólo son válidos los valores positivos. El adaptador trata cualquier valor inferior a 1 como 1. Si se escribe un valor negativo o 0 para esta propiedad, pueden obtener errores en tiempo de ejecución.
Globalizada No
Con soporte Bidi No

Intervalo entre períodos de sondeos (PollPeriod)

Esta propiedad especifica la cantidad de tiempo que el adaptador espera entre periodos de sondeo.

Tabla 14. Detalles de intervalo entre períodos de sondeos
Necesaria
Valores posibles Enteros mayores que o igual a 0.
Valor predeterminado 2000
Unidad de medida Milisegundos
Tipo de propiedad Entero
Uso El periodo de sondeo se establece en una frecuencia fija, lo que significa que si la ejecución del ciclo de sondeo se retarda por alguna razón (por ejemplo si un ciclo de sondeo previo tarda más de lo esperado en completarse), el siguiente ciclo de sondeo se producirá inmediatamente para compensar el tiempo perdido debido al retardo.
Globalizada No
Con soporte Bidi No

Número máximo de sucesos en el período de sondeo (PollQuantity)

Esta propiedad especifica el número de sucesos que el adaptador suministra al componente de exportación durante cada periodo de sondeo.

Tabla 15. Detalles del número máximo de sucesos en el período de sondeo
Necesaria
Valor predeterminado 10
Tipo de propiedad Entero
Uso El valor debe ser mayor que 0. Si se aumenta este valor, se procesarán más sucesos por período de sondeo y es posible que el adaptador se ejecute con menos eficacia. Si se disminuye este valor, se procesarán menos sucesos por período de sondeo y es posible que el rendimiento del adaptador mejore ligeramente.
Globalizada No
Con soporte Bidi No

Número de veces que se reintenta la conexión del sistema (RetryLimit)

Esta propiedad especifica el número de veces que el adaptador intenta restablecer una conexión de entrada.

Tabla 16. Detalles del número de veces que se reintenta la conexión del sistema
Necesaria No
Valores posibles Enteros positivos
Valor predeterminado 0
Tipo de propiedad Entero
Uso Sólo son válidos los valores positivos.

Cuando el adaptador encuentra un error relacionado con la conexión de entrada, esta propiedad especifica el número de veces que el adaptador intenta reiniciar la conexión. Un valor de 0 indica un número infinito de reintentos.

Globalizada
Con soporte Bidi No

Detener el adaptador cuando se encuentra un error durante el sondeo (StopPollingOnError)

Esta propiedad especifica si el adaptador detiene el sondeo de sucesos cuando encuentra un error durante el sondeo.

Tabla 17. Detalles de detener el adaptador cuando se encuentra un error durante el sondeo
Necesaria No
Valores posibles

True
False

Valor predeterminado False
Tipo de propiedad Booleano
Uso

Si esta propiedad se establece en True, el adaptador detiene el sondeo cuando encuentra un error.

Si esta propiedad se establece en False, el adaptador anota una excepción cuando encuentra un error durante el sondeo y continúa el sondeo.

Globalizada No
Con soporte Bidi No

Tiempo entre reintentos en caso de anomalía de conexión del sistema (RetryInterval)

Cuando el adaptador encuentra un error relacionado con la conexión de entrada, esta propiedad especifica la cantidad de tiempo que el adaptador espera antes de intentar establecer una nueva conexión.

Tabla 18. Detalles de intervalo de reintento
Necesaria
Valor predeterminado

60000 (1 minuto)

Unidad de medida Milisegundos
Tipo de propiedad Entero
Uso Sólo son válidos los valores positivos. Cuando el adaptador encuentra un error relacionado con la conexión de entrada, esta propiedad especifica la cantidad de tiempo que el adaptador espera antes de intentar establecer una nueva conexión.
Globalizada No
Con soporte Bidi No
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:01:55


Tema de referenciaTema de referencia | Versión 8.0.0.5 | rbp_peo_inbound_props_WMB