Gerenciando serviços web › Objetos

Objetos

O CA SDM trata cada entidade, tal como um contato ou uma ocorrência, como um objeto. Esses objetos de alto nível são definidos em arquivos majic (.maj) e mod (.mod) no servidor CA SDM no seguinte diretório:

/bopcfg/majic

Os objetos personalizados são definidos no seguinte diretório:

/site/mods/majic

Os objetos são essencialmente wrappers de alto nível ao redor de uma tabela de banco de dados.

Um tipo de objeto (às vezes, conhecido como factory) define o objeto. Por exemplo, objetos de solicitação pertencem ao tipo "cr"(solicitação de mudança). O tipo de cada objeto é definido pela declaração “OBJECT” em um arquivo majic.

Observação: todos os objetos fornecidos com o CA SDM estão listados no Guia de Referência Técnica do CA SDM.

Um objeto tem atributos, que são essencialmente colunas em uma tabela de banco de dados (não os confunda com atributos XML). Os serviços web oferecem muitos métodos para recuperar os valores para os atributos. Muitos métodos exigem que você nomeie os atributos para definir ou recuperar os valores. Você deve usar o nome de atributo atribuído no arquivo majic ou mod que define o objeto, o qual pode ser diferente do nome real do banco de dados. Os sites de cliente podem ter atributos adicionais como personalização.

Observação: para obter uma lista de todos os atributos para cada objeto, consulte o Guia de Referência Técnica do CA SDM.

Os serviços web identificam exclusivamente um objeto usando um identificador, que é um valor de seqüência de caracteres do formulário objectType:ID, em que objectType é o nome do tipo do objeto (factory), e ID é um valor exclusivo. O valor da ID corresponde ao do atributo "id"encontrado em cada objeto do CA SDM. Como o atributo "id"é quase sempre indexado no DBMS, usar a parte da ID do identificador de objeto é especialmente útil para criar consultas eficientes. Cada objeto, independentemente de seu tipo, armazena esse valor em um atributo de objeto denominado “persistent_id”.

Observação: em versões anteriores, a parte da ID do identificador era sempre uma sequência de caracteres de números inteiros. No Unicenter Service Desk r11.0 e posteriores, a parte da ID também pode ser a representação da sequência de caracteres de uma UUID, geralmente 32 caracteres.

A tabela a seguir lista o objeto e os nomes de fábrica das entidades que usam UUIDs:

Os identificadores são permanentes; um identificador que representa um determinado objeto será sempre exclusivo enquanto durar, mesmo durante as migrações de bancos de dados. Convém aos clientes tirar proveito desta permanência ao trabalhar com objetos estáticos, como, por exemplo, Status ou Tipos de contato.

Os identificadores de objeto são a chave para usar com êxito os serviços web do CA SDM. Vários métodos, especialmente aqueles que atualizam os dados, exigem identificadores. A maioria dos métodos que retorna dados de objeto também inclui o identificador do objeto.