Linked Art API: Assigned Relationship Structure

Table of Contents

Introduction
Property Definitions
Example

Introduction

It is often useful to have direct relationships between entities, such as objects that have some (unstated) relationship to each other, inter-personal relationships that are too convoluted to express semantically, or just an arbitrary set of recommendations for other entities that might be of interest to a consuming application and its users. In order to manage such arbitrary, non-semantic relationships, the AttributeAssignment activity is used with the optional assigned_property to give an identifier for the relationship, if known.

Property Definitions

The relationship assignment data structure has the following properties.

Properties of Assignments

Property Name	Datatype	Requirement	Description
`id`	string	Optional	If present, the value MUST be a URI identifying the assignment
`type`	string	Required	The class for the assignment, which MUST be the value `"AttributeAssignment"`
`_label`	string	Recommended	A human readable label for the assignment, intended for developers
`identified_by`	array	Recommended	An array of json objects, each of which is a name of the assignment and MUST follow the requirements for Name, or an identifier for the assignment and MUST follow the requirements for Identifier
`classified_as`	array	Recommended	An array of json objects, each of which is a further classification of the assignment and MUST follow the requirements for Type
`referred_to_by`	array	Optional	An array of json objects, each of which is an embedded statement about the assignment
`carried_out_by`	array	Optional	An array of json objects, each of which is a reference to a Person or Group which made the assignment
`timespan`	json object	Optional	A json object which describes when the relationship was assigned, and MUST follow the requirements for timespans
`assigned`	array	Required	An array of json objects, each of which is a reference to another entity that is related to the current one
`assigned_property`	string	Optional	A string which is either a URI, or resolves to a URI via a context document, for the specific relationship between the main entity and the entity referenced in `assigned`

Property Diagram

Incoming Properties

Relationship Assignment instances are typically found as the object of the following properties. This list is not exhaustive, but is intended to cover the likely cases.

Property Name	Source Endpoint	Description
`attributed_by`	All Endpoints	A list of Relationship Assignments for the entity

Example

A Human-Made Object instance:

{
  "@context": "https://linked.art/ns/v1/linked-art.json",
  "id": "https://linked.art/example/object/3",
  "type": "HumanMadeObject",
  "_label": "Painting of a Fish",
  "attributed_by": [
    {
      "type": "AttributeAssignment",
      "classified_as": [
        {
          "id": "http://example.org/types/recommending",
          "type": "Type",
          "_label": "Recommendation"
        }
      ],
      "identified_by": [
        {
          "type": "Name",
          "classified_as": [
            {
              "id": "http://vocab.getty.edu/aat/300404669",
              "type": "Type",
              "_label": "Display Title"
            }
          ],
          "content": "Related Object: Another Painting of a Fish"
        }
      ],
      "carried_out_by": [
        {
          "id": "https://linked.art/example/person/1",
          "type": "Person",
          "_label": "Curator"
        }
      ],
      "assigned": [
        {
          "id": "https://linked.art/example/object/4",
          "type": "HumanMadeObject",
          "_label": "Another Painting of a Fish"
        }
      ]
    }
  ]
}

graph TD classDef object stroke:black,fill:#E1BA9C,rx:20px,ry:20px; classDef actor stroke:black,fill:#FFBDCA,rx:20px,ry:20px; classDef type stroke:red,fill:#FAB565,rx:20px,ry:20px; classDef name stroke:orange,fill:#FEF3BA,rx:20px,ry:20px; classDef dims stroke:black,fill:#c6c6c6,rx:20px,ry:20px; classDef infoobj stroke:#907010,fill:#fffa40,rx:20px,ry:20px classDef timespan stroke:blue,fill:#ddfffe,rx:20px,ry:20px classDef place stroke:#3a7a3a,fill:#aff090,rx:20px,ry:20px classDef event stroke:#1010FF,fill:#96e0f6,rx:20px,ry:20px classDef literal stroke:black,fill:#f0f0e0; classDef classstyle stroke:black,fill:white; O1(object3) class O1 object; O1-- type -->O1_0[HumanMadeObject] class O1_0 classstyle; O1-- _label -->O1_4("''Painting of a Fish''") class O1_4 literal; O2( _ ) class O2 event; O2-- type -->O2_0[AttributeAssignment] class O2_0 classstyle; O3(http://example.org/types/recommending) class O3 type; O3-- type -->O3_0[Type] class O3_0 classstyle; O3-- _label -->O3_3("''Recommendation''") class O3_3 literal; O2-- classified_as -->O3 O4( _ ) class O4 name; O4-- type -->O4_0[Name] class O4_0 classstyle; O5(aat:300404669) class O5 type; O5-- type -->O5_0[Type] class O5_0 classstyle; O5-- _label -->O5_3("''Display Title''") class O5_3 literal; O4-- classified_as -->O5 O4-- content -->O4_3("''Related Object: Another Painting of a Fish''") class O4_3 literal; O2-- identified_by -->O4 O6(person1) class O6 actor; O6-- type -->O6_0[Person] class O6_0 classstyle; O6-- _label -->O6_3("''Curator''") class O6_3 literal; O2-- carried_out_by -->O6 O7(object4) class O7 object; O7-- type -->O7_0[HumanMadeObject] class O7_0 classstyle; O7-- _label -->O7_3("''Another Painting of a Fish''") class O7_3 literal; O2-- assigned -->O7 O1-- attributed_by -->O2

Other Representations: JSON-LD (raw) | JSON-LD (playground) | Turtle (raw) | Turtle (styled)