connect

connect can be used to create a connection between objects (when present in an Add* command).

Parameters

  • ref: Reference to other objects within the transaction.

  • [optional] class: Name of the class that is used to describe the relationship between the objects.

  • [optional] direction: [in, out]. Default is “out. “in” indicates that the relationship actually ends at the object (object) in the Add*.

Here is an example of an isolated connect:

# Isolated connect parameter
"connect": {
    "ref":       1234,      # Reference to the result of another command
    "class":     "Visit",   # Class name for the connection
    "direction": "out"      # Direction of the connection
}

connect indicates parameters of a connection that will be created between the added object and an object (or objects) referenced by the ref parameter.

For instance, we can create a connection between newly inserted entities as follows:

[ {
    "AddEntity":  {
        "class": "Person",
        "_ref":  1234,
        "properties":  {
            "name":   "Jane Doe",
            "age":    20,
            "gender": "F",
            "email":  "jane.doe@jupiter.pla"
        }
    }
},{
    "AddEntity":  {
        "class": "Person",
        "properties":  {
            "name":   "Jon Doe",
            "age":    18,
            "gender": "M",
            "email":  "jon.doe@mars.pla"
        },
        "connect": {
            "class": "BestFriendForever"
            "ref":   1234
        },
    }
}]