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.
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. |
Necesaria | Sí |
---|---|
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 | Sí |
Con soporte Bidi | No |
Esta propiedad controla si la instancia de adaptador procesa sucesos específicos en el almacén de sucesos.
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 | Sí |
Con soporte Bidi | Sí |
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. |
Especifica si se va a proporcionar o no entrega asegurada una sola vez para sucesos de entrada.
Necesaria | Sí |
---|---|
Valores posibles | True |
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 |
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.
Fila | Explicación |
---|---|
Necesaria | Sí |
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 |
Esta propiedad especifica el nombre de la interfaz de componente de PeopleSoft Enterprise que el adaptador utiliza para el proceso de entrada.
Fila | Explicación |
---|---|
Necesaria | Sí |
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 |
Esta propiedad especifica el orden en que el adaptador entrega los sucesos al componente de exportación.
Necesaria | No |
---|---|
Valores posibles | ORDERED |
Valor predeterminado | ORDERED |
Tipo de propiedad | Serie de caracteres |
Uso | Se aceptan los valores siguientes:
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 |
Esta propiedad especifica el delimitador para la pareja de nombre-valor de clave de objeto en la tabla 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 |
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.
Necesaria | Sí |
---|---|
Valores posibles | True |
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 |
Esta propiedad contiene una lista delimitada de tipos de suceso que indica al adaptador qué sucesos debe entregar.
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
|
Ejemplo |
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 |
Esta propiedad especifica el formato que se utiliza para la indicación de fecha y hora del suceso.
Fila | Explicación |
---|---|
Necesaria | Sí |
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 |
Esta propiedad especifica el número máximo de conexiones que el adaptador puede utilizar para la entrega de sucesos de entrada.
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 |
Esta propiedad especifica el número mínimo de conexiones que el adaptador puede utilizar para la entrega de sucesos de entrada.
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 |
Esta propiedad especifica la cantidad de tiempo que el adaptador espera entre periodos de sondeo.
Necesaria | Sí |
---|---|
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 |
Esta propiedad especifica el número de sucesos que el adaptador suministra al componente de exportación durante cada periodo de sondeo.
Necesaria | Sí |
---|---|
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 |
Esta propiedad especifica el número de veces que el adaptador intenta restablecer una conexión de entrada.
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 | Sí |
Con soporte Bidi | No |
Esta propiedad especifica si el adaptador detiene el sondeo de sucesos cuando encuentra un error durante el sondeo.
Necesaria | No |
---|---|
Valores posibles | True |
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 |
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.
Necesaria | Sí |
---|---|
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 |