Gestione dei servizi Web › Oggetti

Oggetti

CA SDM considera ogni entità, ad esempio un contatto o una Issue, come un oggetto. Questi oggetti di alto livello sono definiti nei file majic (.maj) e mod (.mod) sul server CA SDM nella directory seguente:

/bopcfg/majic

Gli oggetti personalizzati sono definiti nella directory seguente:

/site/mods/majic

Gli oggetti sono essenzialmente wrapper generali disponibili in una tabella di database.

Un tipo di oggetto (talvolta chiamato factory) definisce l'oggetto. Ad esempio, gli oggetti Richiesta appartengono al tipo 'cr'. Ogni tipo di oggetto viene definito dalla dichiarazione "OBJECT" in un file majic.

Nota: tutti gli oggetti forniti con CA SDM vengono enumerati nella Guida di riferimento tecnico di CA SDM.

Un oggetto dispone di attributi, che sono essenzialmente colonne di una tabella di database (da non confondersi con gli attributi XML). I servizi Web offrono molti metodi per recuperare i valori degli attributi. Molti metodi richiedono l'assegnazione dei nomi agli attributi per impostare o recuperare i valori. È necessario utilizzare il nome di attributo assegnato nel file majic o mod che definisce l'oggetto, che può essere differente dal nome di database effettivo. I siti client possono aggiungere altri attributi come personalizzazione.

Nota: per un elenco completo di tutti gli attributi per ogni oggetto, consultare la Guida di riferimento tecnico di CA SDM.

I servizi Web identificano in modo univoco un oggetto dal relativo handle, ovvero un valore di tipo stringa in formato objectType:ID, dove objectType è il nome del tipo (factory) di oggetto e ID è un valore univoco. Il valore ID corrisponde a quello dell'attributo 'id' presente in qualsiasi oggetto di CA SDM. Poiché l'attributo 'id' è quasi sempre indicizzato nel DBMS, l'utilizzo della parte id dell'handle dell'oggetto è particolarmente importante per creare query efficienti. Ogni oggetto, indipendentemente dal tipo, memorizza questo valore in un attributo dell'oggetto denominato "persistent_id".

Nota: nelle versioni precedenti la parte ID dell'handle è sempre costituita da una stringa di valori interi. In Unicenter Service Desk r11.0 e versioni successive la parte ID può anche essere la rappresentazione stringa di un UUID, in genere di 32 caratteri.

Nella tabella seguente sono elencati i nomi di oggetto e factory delle entità che utilizzano gli UUID:

Gli handle sono persistenti; un handle che rappresenta un oggetto specifico è sempre univoco per tutta la sua durata, anche nelle migrazioni del database. I client possono avvalersi di questa persistenza quando utilizzano gli oggetti statici, ad esempio gli oggetti Stato o Tipi contatto.

Gli handle degli oggetti sono essenziali per utilizzare correttamente i servizi Web di CA SDM. Molti metodi, specialmente quelli che aggiornano i dati, richiedono l'utilizzo degli handle. La maggior parte dei metodi che restituisce i dati dell'oggetto include anche l'handle dell'oggetto.