Tema anterior: Acceso simplificado a Servicios WebTema siguiente: Actualizaciones del sistema y almacenamiento en caché


Objetos

El sistema CA SDM trata cada entidad, como un contacto o una incidencia, como un objeto. Estos objetos de alto nivel se definen en archivos majic (.maj) y mod (.mod) en el servidor de CA SDM en el directorio siguiente:

/bopcfg/majic

Los objetos personalizados se definen en el directorio siguiente:

/site/mods/majic

Los objetos son, esencialmente, contenedores de alto nivel en torno a una tabla de base de datos.

Un tipo de objeto (a veces llamado tabla) define el objeto. Por ejemplo, los objetos de solicitud pertenecen al tipo "cr" (solicitud de llamada). Cada tipo de objeto se define mediante la declaración de “OBJECT” en un archivo majic.

Nota: Todos los objetos incluidos en CA SDM se enumeran en la Guía de referencia técnica de CA SDM.

Un objeto tiene atributos, que son, básicamente, columnas de una tabla de base de datos (no deben confundirse éstos con los atributos XML). Servicios Web ofrece muchos métodos para recuperar valores para atributos. Muchos métodos exigen que se asigne un nombre a los atributos para definir o recuperar valores. Debe utilizar el nombre de atributo asignado en el archivo majic o mod que define el objeto, que puede ser distinto del nombre de la base de datos real. Los sitios de cliente pueden agregar atributos adicionales como personalización.

Nota: Para obtener una lista de todos los atributos de cada objeto, consulte la Guía de referencia técnica de CA SDM.

Servicios Web determina de manera única un objeto por su identificador, que es un valor de cadena con el formato objectType:ID, donde objectType es el nombre del tipo de objeto (tabla) e ID es un valor único. El valor de ID coincide con el atributo "id" que se encuentra en cada objeto de CA SDM. Como el atributo "id" está casi siempre indizado en DBMS, es especialmente útil usar la parte del ID del identificador de objeto para formar consultas eficaces. Cada objeto, independientemente de su tipo, almacena este valor en un atributo de objeto llamado “persistent_id”.

Nota: En versiones anteriores, la parte del ID del identificador siempre constaba de una cadena de números enteros. En Unicenter Service Desk r11.0 y versiones posteriores, la parte del ID también puede ser una representación de cadena de un UUID, que suele constar de 32 caracteres.

La siguiente información muestra los nombres de objeto y de tabla de las entidades que utilizan un UUID:

Nombre de objeto

Nombre de la fábrica

Contacto

cnt

Activo

nr

Organización

org

Ubicación

loc

Compañía/Distribuidor

ca_cmpny

Modelo

mfrmod

Los identificadores son persistentes; un identificador que represente a un objeto determinado será siempre único durante su ciclo de vida, incluso en migraciones de bases de datos. Puede que los clientes deseen aprovechar esta persistencia al trabajar con objetos bastante estáticos como, por ejemplo, Estado o Tipos de contactos.

Los identificadores de objeto son la clave para utilizar correctamente Servicios Web de CA SDM. Muchos métodos, especialmente los que actualizan datos, necesitan identificadores. La mayoría de los métodos que devuelven datos de objetos también incluyen el identificador del objeto.