Mit dem Vorgang „Beziehung erstellen“ wird eine neue Beziehung zwischen zwei Entitäten in einem Context Graph-Modell hinzugefügt. Die Metadaten der Beziehung müssen bereits im Context Graph-Modell vorhanden sein.
URL-Format von HTTP-PUT-Anforderungen
Die Anforderung wird wie folgt angegeben. Der Spectrum-Server unterstützt sowohl HTTP als auch HTTPS.
PUT http://server_name:port/rest/ContextGraph/operations/modelName/relationships/relationshipLabel?query_parameters
URL-Pfadelemente
- modelName
- Der Name des Context Graph-Modells.
- relationshipLabel
- Der Name der Beziehungsbeschriftung, die zwei Entitäten in einem Modell verbindet.
Abfrageparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| sourceID | string | ja | Die Quell-ID der Entität, die eine Beziehung verbindet. Dieser Parameter gibt ein Wertepaar des Typs entityType:entityLabel an. |
| targetID | string | ja | Die Ziel-ID der Entität, die eine Beziehung verbindet. Dieser Parameter gibt ein Wertepaar des Typs entityType:entityLabel an. |
| uniqueID | string | no | Der Wert, der eine Beziehung auszeichnet, wenn mehrere Beziehungen mit derselben Beschriftung vorhanden sind, die zwei Entitäten in einem Modell verbinden. |
URL PUT-Textformat
Content-Type:application/json {Property Name-Value Pairs}
Optional können Sie für jede vorhandene Eigenschaft einen Eigenschaftsnamen und ein Wertepaar im folgenden Format angeben: Eine Eigenschaft wird nicht erstellt, wenn sie einen Nullwert oder einen leeren Wert enthält. Die Eigenschaftsnamenpaare sind wie folgt formatiert:
{ "Property1":"Value1", "Property2":"Value2", ... }Antwort
Der Vorgang gibt bei Erfolg den Statuscode „200 OK“ zurück. Der Vorgang gibt den Statuscode „500 (Fehler)“ zurück, wenn er fehlschlägt.
Beziehung mit JSON-Antwort erstellen
Die folgende Anforderung erstellt eine Roomate-Beziehungsbeschriftung im Modell „911“ zwischen zwei Personenentitäten und fügt die folgenden Eigenschaften hinzu: „Date“ und „Rank“.
PUT http://localhost:8080/rest/ContextGraph/operations/911/relationships/Roomate?sourceID=Person:Ahmed%20al-Haznawi&targetID=Person:Ziad%20JarrahText:
{ "Date":1275782400000, "Rank":"0" } Antwort:
{ "success":"200 OK" }Beziehung mit derselben Beschriftung erstellen
Im Folgenden wird eine Roomate-Beziehungsbeschriftung im Modell „911“ erstellt, bei der die Beziehungs-ID zwischen zwei Personenentitäten gleich „4“ ist.
PUT http://localhost:8080/rest/ContextGraph/operations/911/relationships/Roomate?sourceID=Person:Ahmed%20al-Haznawi&targetID=Person:Ziad%20Jarrah&uniqueID=4