Operación de lectura de relación - web_services - 23.1

Guía de servicios web de Spectrum

Product type
Portfolio
Integrate
Product family
Product
Spectrum > Web Services
Version
23.1
Language
Español (México)
Product name
Spectrum Technology Platform
Title
Guía de servicios web de Spectrum
First publish date
2007
ft:lastEdition
2024-02-07
ft:lastPublication
2024-02-07T18:09:34.894393

La operación de lectura de relación devuelve valores de propiedad de una relación presente en el modelo de Context Graph.

Formato de dirección URL de HTTP GET

La solicitud se especifica de la siguiente manera: El servidor de Spectrum es compatible con HTTP y HTTPS.

GET http://server_name:port/rest/ContextGraph/operations/modelName/relationships/relationshipLabel?query_parameters

Elementos de ruta URL

modelName
El nombre del modelo de Context Graph.
relationshipLabel
El nombre del rótulo de relación que conecta a dos entidades de un modelo.

Parámetros de consulta

Parámetro Tipo Requerido Descripción
sourceID cadena El ID de origen de la entidad que conecta una relación. Este parámetro especifica el par de valor entityType:entityLabel.
targetID cadena El ID de destino de la entidad que conecta una relación. Este parámetro especifica el par de valor entityType:entityLabel.
uniqueID cadena no El valor que distingue una relación cuando hay varias relaciones con el mismo rótulo conectando dos entidades de un modelo.

Códigos de retorno

La operación devuelve el código de estado "200 OK" cuando se realiza correctamente. La operación devuelve el código de estado 500 (Error) cuando falla.

Respuesta

La respuesta devuelve un par de nombre y valor por cada propiedad de relación en el siguiente formato, cuando una entidad tiene N propiedades.

{"result":{     "Property1":"Value1",     "Property2":"Value2",      ...     "PropertyN":"ValueN"  }}

Respuesta JSON

La siguiente solicitud lee propiedades del rótulo de relación Roomate en el modelo “911” entre dos entidades de persona.

GET http://localhost:8080/rest/ContextGraph/operations/911/relationships/Roomate?​sourceID=Person:Ahmed%20al-Haznawi&​targetID=Person:Ziad%20Jarrah

Esto genera la siguiente respuesta:

{"result":{     "Date":1275782400000,     "Rank":"0"     }}         
Nota: Los valores de propiedad fecha, hora y fecha-hora son valores de tiempo UNIX Epoch con formato de tipo de dato long tanto en las solicitudes como en las respuestas.