Propiedades de atributos de objetos comerciales

La arquitectura de los objetos comerciales define diversas propiedades referentes a los atributos. Esta sección describe cómo el conector interpreta varias de estas propiedades y cómo definirlas al modificar un objeto comercial.

La propiedad Name

Cada atributo de objeto comercial debe tener un nombre exclusivo.

La propiedad Type

Cada atributo de objeto comercial debe tener un tipo, tal como Integer, String o el tipo de un objeto comercial hijo. Cuando el conector encuentra un atributo de tipo Date, Long Text o String, el conector encierra el valor entre comillas y trata el valor como datos de tipo carácter.

La propiedad Cardinality

Cada atributo de objeto comercial que representa un objeto comercial hijo o matriz de objetos comerciales hijo tiene el valor 1 o n, respectivamente, en este atributo. Todos los atributos que representan objetos comerciales hijo tienen una propiedad ContainedObjectVersion (que especifica el número de versión del hijo) y una propiedad Relationship (que especifica el valor Containment).

La propiedad MaxLength

Si el atributo es de tipo String, esta propiedad especifica la longitud máxima permitida para el valor del atributo.

La propiedad Key

Como mínimo un atributo simple de cada objeto comercial se debe especificar como clave. Para definir un atributo como clave, establezca esta propiedad en . Si el atributo del objeto comercial es de tipo String, es recomendable que el tipo de datos en la base de datos sea Varchar en lugar de char.

Nota:
El conector no admite especificar como atributo de clave un atributo que representa un objeto comercial hijo o una matriz de objetos comerciales hijo.

Si la propiedad key se establece en true para un atributo simple, cuando el conector procesa el objeto comercial, añade ese atributo a la cláusula WHERE de las sentencias de SQL SELECT, UPDATE, RETRIEVE y DELETE generadas por el conector.

Si la propiedad key se establece en true para un atributo de un hijo que guarda la relación padre/hijo en el hijo (tanto para la cardinalidad simple como múltiple), el conector utiliza las claves primarias del padre en la cláusula WHERE de la sentencia SELECT, y no utiliza la propiedad Key. Para obtener información sobre la especificación del nombre de atributos de objetos comerciales cuyos valores se utilizan para definir los atributos de clave foránea del hijo, consulte Información específica de la aplicación a nivel de atributo.

La propiedad IsForeignKey

El conector utiliza esta propiedad para determinar si un atributo es una clave foránea.

La propiedad IsRequired

La propiedad IsRequired especifica si un atributo debe contener un valor.

Si se especifica esta propiedad para un atributo que representa un objeto comercial hijo de cardinalidad simple, el conector exige que el objeto comercial padre contenga un objeto comercial hijo para este atributo.

Cuando el conector recibe un objeto comercial con una petición Create, el conector hace que la operación Create falle si se cumplen las dos condiciones siguientes:

Cuando el conector recibe un objeto comercial con una petición Retrieve, el conector hace que la operación de recuperación falle si el objeto comercial no tiene un valor válido ni un valor por omisión para un atributo necesario.

El conector no utiliza esta propiedad para atributos que contienen una matriz de objetos comerciales hijo.

Nota:
Si el atributo de clave utiliza una secuencia o contador o es cumplimentado por la base de datos (UID=AUTO), no se debe marcar como atributo necesario ("Required").

La propiedad AppSpecificInfo

Para obtener información sobre esta propiedad, consulte Información específica de la aplicación a nivel de atributo.

La propiedad DefaultValue

Esta propiedad especifica un valor por omisión que el conector utiliza para asignar un valor a un atributo simple si el atributo no tiene un valor obtenido de la tabla de base de datos. El conector no evalúa esta propiedad para atributos que representan un objeto comercial hijo o una matriz de objetos comerciales hijo.

El conector evalúa esta propiedad sólo si la propiedad de configuración UseDefaults tiene el valor true. Para obtener más información, consulte la Tabla 6.

Valores especiales de atributos

Los atributos simples de objetos comerciales pueden tener el valor especial CxIgnore. Cuando el conector recibe un objeto comercial desde el intermediario de integración, el conector pasa por alto todos los atributos cuyo valor sea CxIgnore. Es como si esos atributos fueran invisibles para el conector.

Cuando el conector recupera datos de la base de datos y la sentencia SELECT devuelve un valor null para un atributo, el conector establece el valor de ese atributo en CxIgnore por omisión. Si se ha especificado un valor para el parámetro UNVL de la información específica de la aplicación correspondiente al atributo, el conector utiliza ese valor para representar el valor null.

Debido a que el conector exige que cada objeto comercial tenga como mínimo un atributo de clave primaria, los desarrolladores deben asegurarse de que los objetos comerciales de WebSphere Business Integration Adapter pasados al conector tengan como mínimo una clave primaria cuyo valor no sea CxIgnore. La única excepción a este requisito es un objeto comercial cuya clave primaria deba ser generada por el conector utilizando una secuencia o contador, o que se generada por la base de datos.

Cuando el conector inserta datos en la base de datos y un atributo de objeto comercial no tiene ningún valor especificado, el conector utiliza el valor especificado por la propiedad UseNullValue del atributo. Para obtener más información sobre UseNullValue, consulte UNVL=value en la Tabla 11.

Copyright IBM Corp. 1997, 2004