La operación de creación de relación agrega una nueva relación entre dos entidades de un modelo de Context Graph. Los metadatos de relación ya deben existir en el modelo de Context Graph.
Formato de dirección URL de HTTP PUT
La solicitud se especifica de la siguiente manera: El servidor de Spectrum es compatible con HTTP y HTTPS.
PUT 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 | sí | El ID de origen de la entidad que conecta una relación. Este parámetro especifica el par de valor entityType:entityLabel. |
targetID | cadena | sí | 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. |
Formato del cuerpo de la URL del método PUT
Content-Type:application/json {Property Name-Value Pairs}
De manera opcional, puede especificar un par de nombre de propiedad y valor para cualquier propiedad existente en el siguiente formato. No se creará una propiedad si contiene un valor nulo o vacío. Los pares de nombre de propiedad tienen el siguiente formato:
{ "Property1":"Value1", "Property2":"Value2", ... }
Respuesta
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.
Creación de relación con respuesta JSON
La siguiente solicitud crea un rótulo de relación de compañero de habitación en el modelo "911" entre dos entidades persona, y agrega las siguientes propiedades: "Fecha" y "Rango".
PUT http://localhost:8080/rest/ContextGraph/operations/911/relationships/Roomate?sourceID=Person:Ahmed%20al-Haznawi&targetID=Person:Ziad%20Jarrah
Cuerpo:
{ "Date":1275782400000, "Rank":"0" }
Respuesta:
{ "success":"200 OK" }
Creación de relación con el mismo rótulo
Lo siguiente crea un rótulo de relación de compañero de habitación en el modelo "911", donde el ID de relación entre dos entidades de persona es igual a "4".
PUT http://localhost:8080/rest/ContextGraph/operations/911/relationships/Roomate?sourceID=Person:Ahmed%20al-Haznawi&targetID=Person:Ziad%20Jarrah&uniqueID=4