Definición de propiedades en el archivo de configuración

Cuando el usuario crea y designa un nuevo archivo de configuración de conector, o cuando abre uno existente, el Configurador de conectores muestra una pantalla de configuración con pestañas correspondientes a las categorías de valores de configuración necesarios.

El Configurador de conectores solicita valores para las propiedades comprendidas en las categorías siguientes para los conectores que se ejecutan en todos los intermediarios:

Nota:
Para los conectores que hacen uso de la mensajería JMS, se puede visualizar una categoría adicional para configurar los gestores de datos que convierten datos en objetos comerciales.

Para los conectores que se ejecutan en ICS, son también necesarios valores para estas propiedades:

Importante:
El Configurador de conectores acepta valores de propiedad expresados utilizando juegos de caracteres ingleses o no ingleses. Pero los nombres de las propiedades estándar, los nombres de las propiedades específicas del conector y los nombres de los objetos comerciales compatibles se deben expresar utilizando solamente el juego de caracteres inglés.

Las propiedades estándar difieren de las propiedades específicas del conector en estos aspectos:

Los campos para las Propiedades estándar y las Propiedades específicas del conector muestran colores que denotan qué propiedades son configurables:

Definición de propiedades estándar de conector

Para cambiar el valor de una propiedad estándar:

  1. Pulse el campo cuyo valor desee definir.
  2. Escriba un valor, o seleccione uno en el menú desplegable, si hubiera.
  3. Después de entrar todos los valores para las propiedades estándar, puede seguir una de estas opciones:

Definición de propiedades de configuración específicas de la aplicación

Para las propiedades de configuración específicas de la aplicación, puede añadir o cambiar nombres de propiedades, configurar valores, suprimir una propiedad y cifrar una propiedad. La longitud por omisión de una propiedad es 255 caracteres.

  1. Pulse con el botón derecho del ratón sobre la parte superior izquierda de la tabla. Se mostrará una barra de menús emergentes. Pulse Agregar para añadir una propiedad. Para añadir una propiedad hija, pulse con el botón derecho del ratón sobre el número de fila del padre y pulse Agregar hijo.
  2. Especifique un valor para la propiedad o propiedad hija.
  3. Para cifrar una propiedad, seleccione la casilla Cifrar.
  4. Elija guardar o descartar los cambios, tal como se describe en Definición de propiedades estándar de conector.

El Método de actualización mostrado para cada propiedad indica si es necesario reiniciar un componente o agente para activar valores modificados.

Importante:
Cambiar el nombre predefinido de una propiedad de conector específica de la aplicación puede hacer que el conector falle. Determinados nombres de propiedad pueden ser necesarios para que el conector se conecte a una aplicación o se ejecute correctamente.

Cifrado de propiedades de conector

Puede cifrar propiedades específicas de la aplicación seleccionando la casilla Cifrar en la ventana Propiedades específicas del conector. Para descifrar un valor, pulse en la casilla Cifrar para quitar la marca de selección, escriba el valor correcto en el recuadro de diálogo Verificación y pulse Aceptar. Si el valor entrado es correcto, el valor se descifra y se muestra.

La guía del usuario del adaptador correspondiente a cada conector contiene una lista y descripción de las propiedades y su valor por omisión.

Si una propiedad tiene varios valores, la casilla Cifrar se mostrará para el primer valor de la propiedad. Cuando selecciona Cifrar, se cifran todos los valores de la propiedad. Para descifrar varios valores de una propiedad, pulse en la casilla Cifrar para quitar la marca de selección para el primer valor de la propiedad, y luego especifique el nuevo valor en el recuadro de diálogo Verificación. Si el valor entrado es correcto, se descifran todos los valores.

Método de actualización

Consulte las descripciones de métodos de actualización que se encuentran en la sección Definición y actualización de valores de propiedades del apéndice Propiedades de configuración estándar para conectores.

Especificación de definiciones de objetos comerciales compatibles

Utilice la pestaña Objetos comerciales compatibles del Configurador de conectores para especificar los objetos comerciales que utilizará el conector. Debe especificar objetos comerciales genéricos y específicos de la aplicación, así como asociaciones para las correlaciones entre objetos comerciales.

Nota:
Algunos conectores requieren que determinados objetos comerciales se especifiquen como compatibles para realizar la notificación de sucesos o tareas adicionales de configuración (utilizando metaobjetos) con sus aplicaciones. Para obtener más información, consulte los manuales Connector Development Guide for C++ o Connector Development Guide for Java.

Cuando el intermediario de integración es ICS

Para especificar que una definición de objeto comercial es compatible con el conector, o para cambiar los valores admitidos para una definición existente de objeto comercial, pulse la pestaña Objetos comerciales compatibles y utilice los campos siguientes.

Nombre de objeto comercial

Para indicar que una definición de objeto comercial es compatible con el conector, efectúe lo siguiente con el Gestor del sistema en ejecución:

  1. Pulse un campo vacío de la lista Nombre de objeto comercial. Se abrirá una lista desplegable, que muestra todas las definiciones de objeto comercial existentes en el proyecto del Gestor del sistema.
  2. Pulse un objeto comercial para añadirlo.
  3. Defina el Soporte de agente (descrito más abajo) para el objeto comercial.
  4. En el menú Archivo de la ventana del Configurador de conectores, pulse Guardar en proyecto. La definición de conector revisada, incluido el soporte designado para la definición de objeto comercial añadida, se guarda en un proyecto de ICL (Integration Component Library) en el Gestor del sistema.

Para suprimir un objeto comercial de la lista de objetos compatibles:

  1. Para seleccionar un campo de objeto comercial, pulse el número situado a la izquierda del objeto comercial.
  2. En el menú Editar de la ventana del Configurador de conectores, pulse Suprimir fila. El objeto comercial se suprime de la lista visualizada.
  3. En el menú Archivo, pulse Guardar en proyecto.

Suprimir un objeto comercial de la lista de objetos compatibles cambia la definición de conector y hace que el objeto comercial suprimido no pueda ser utilizado en la implementación actual del conector. La operación no afecta al código del conector, ni elimina la propia definición del objeto comercial en el Gestor del sistema.

Soporte de agente

Si un objeto comercial tiene Soporte de agente, el sistema intentará utilizar ese objeto comercial para entregar datos a una aplicación a través del agente de conector.

Normalmente, los objetos comerciales específicos de la aplicación correspondientes a un conector son compatibles con el agente de ese conector, pero no así los objetos comerciales genéricos.

Para indicar que el objeto comercial es compatible con el agente de conector, seleccione la casilla Soporte de agente. La ventana del Configurador de conectores no valida las selecciones hechas por el usuario respecto al Soporte de agente.

Nivel máximo de transacciones

El nivel máximo de transacciones de un conector es el nivel más alto de transacciones que el conector admite.

Para la mayoría de los conectores, la única opción posible es Nivel óptimo.

Debe reiniciar el servidor para que los cambios en el nivel de transacciones entre en vigor.

Cuando el intermediario de integración es WebSphere Message Broker

Si está trabajando en la modalidad autónoma (no conectado al Gestor del sistema), debe entrar manualmente el nombre del objeto comercial.

Si el Gestor del sistema está en ejecución, puede seleccionar la casilla vacía situada bajo la columna Nombre de objeto comercial, en la pestaña Objetos comerciales compatibles. Se abrirá un cuadro combinado que muestra una lista de los objetos comerciales disponibles en el proyecto de ICL (Integration Component Library) al que pertenece el conector. Seleccione el objeto comercial que desee de la lista.

El campo ID de conjunto de mensajes es opcional para WebSphere Business Integration Message Broker 5.0, y no es necesario que sea un valor exclusivo si se cumplimenta ese campo. En cambio, para WebSphere MQ Integrator e Integrator Broker 2.1, debe proporcionar un ID exclusivo.

Cuando el intermediario de integración es WAS

Cuando se selecciona WebSphere Application Server como tipo de intermediario utilizado, el Configurador de conectores no necesita los ID de conjunto de mensajes. La pestaña Objetos comerciales compatibles muestra la columna Nombre de objeto comercial s¾lo para objetos comerciales compatibles.

Si está trabajando en la modalidad autónoma (no conectado al Gestor del sistema), debe entrar manualmente el nombre del objeto comercial.

Si el Gestor del sistema está en ejecución, puede seleccionar la casilla vacía situada bajo la columna Nombre de objeto comercial, en la pestaña Objetos comerciales compatibles. Se abrirá un cuadro combinado que muestra una lista de los objetos comerciales disponibles en el proyecto de ICL (Integration Component Library) al que pertenece el conector. Seleccione el objeto comercial que desee de la lista.

Correlaciones asociadas (ICS solamente)

Cada conector admite una lista de definiciones de objetos comerciales y sus correlaciones asociadas que están activas actualmente en WebSphere InterChange Server. Esta lista se muestra cuando selecciona la pestaña Correlaciones asociadas.

La lista de objetos comerciales contiene el objeto comercial específico de la aplicación que es compatible con el conector y el correspondiente objeto genérico que el controlador envía a la colaboración suscriptora. La asociación de una correlación determina la correlación que se utilizará para transformar el objeto comercial específico de la aplicación en el objeto comercial genérico o viceversa.

Si está utilizando correlaciones que están definidas de forma exclusiva para determinados objetos comerciales de origen y de destino, las correlaciones ya estarán asociadas con sus objetos comerciales apropiados cuando abra la pantalla, y no necesitará (o no podrá) cambiarlas.

Si existe más de una correlación disponible para ser utilizada por un objeto comercial compatible, necesitará vincular explícitamente el objeto comercial con la correlación que el objeto debe utilizar.

La pestaña Correlaciones asociadas muestra los campos siguientes:

Recursos (ICS)

La pestaña Recurso le permite definir un valor que determina si, y en qué medida, el agente de conector gestionará varios procesos simultáneamente, utilizando el paralelismo de agente de conector.

No todos los conectores pueden utilizar esta característica. Si está ejecutando un agente de conector que se diseñó en Java para ser de ejecución paralela, no es aconsejable que utilice esta característica, pues a menudo es más eficiente utilizar varias hebras en lugar de varios procesos.

Mensajería (ICS)

Las propiedades de mensajería s¾lo pueden utilizarse si ha definido MQ como valor de la propiedad estándar DeliveryTransport e ICS como tipo de intermediario de integración. Estas propiedades afectan a la forma en que el conector utilizará las colas.

Definición de valores de archivo de rastreo/anotaciones cronológicas

Cuando el usuario abre un archivo de configuración o archivo de definición de un conector, el Configurador de conectores utiliza los valores de anotaciones cronológicas y de rastreo de ese archivo como valores por omisión. El usuario puede cambiar esos valores en el Configurador de conectores.

Para cambiar los valores de anotaciones cronológicas y de rastreo:

  1. Pulse la pestaña Archivos de rastreo/anotaciones cronológicas.
  2. Para las anotaciones cronológicas o el rastreo, puede elegir escribir mensajes en una o en ambas de las ubicaciones siguientes:

Gestores de datos

La sección referente a los gestores de datos s¾lo se puede configurar si ha definido JMS como valor de DeliveryTransport y como valor de ContainerManagedEvents. No todos los adaptadores utilizan gestores de datos.

Consulte las descripciones del Apéndice A correspondientes ContainerManagedEvents, en Propiedades estándar, para conocer los valores que se deben utilizar para estas propiedades. Para obtener más información, consulte los manuales Connector Development Guide for C++ o Connector Development Guide for Java.

Copyright IBM Corp. 1997, 2004