Fork me on GitHub

STN-Operations

Socio-technical networks (STNs) are networks of people and social things (i.e. autonomous physical or virtual objects). An STN mirrors the physical world by creating digital counterparts of physical and abstract entities and relating them to one another. In the same time, applications running in the digital world may reflect back into the physical world (e.g. through actuators).

An STN encodes the different relations among people and smart things, such as friendship, ownership, provenance or colocation. An STN may not exist outside of the minds of its members, however, in most cases, an STN is reified within an STN platform.

STN-Operations defines the set of generic operations and parameters that allow agents to participate in any STN platform compatible with STN-Core.

Classes

Accept Connection

IRI: https://w3id.org/stn/core/operations#AcceptConnection

A kind of action an agent may perform in order to accept a connection from another entity. Required parameters: EntityID.

Action

IRI: https://w3id.org/stn/core/operations#Action

An action is an operation that affects the STG and thus defines a transition from one state of an STN to another. For instance, creating a connection to another agent would have the effect of adding an edge (labeled stn:connectedTo) to the STG.

Add Owner

IRI: https://w3id.org/stn/core/operations#AddOwner

A kind of action a smart thing may perform in order to add an agent as its owner. This might be a delayed action. Required parameters: OwnerID.

Add Possession

IRI: https://w3id.org/stn/core/operations#AddPossession

A kind of action an agent may perform in order to add a smart thing as a possession. This might be a delayed action. Required parameters: UserID.

Check In

IRI: https://w3id.org/stn/core/operations#CheckIn

A kind of action an agent may perform in order to be located at a given spatial thing. Required parameters: SpatialThingID.

Check Out

IRI: https://w3id.org/stn/core/operations#CheckOut

A kind of action an agent may perform in order to stop being located at a given spatial thing. Required parameters: SpatialThingID.

Communication Action

IRI: https://w3id.org/stn/core/operations#CommunicationAction

unstable

Connection Action

IRI: https://w3id.org/stn/core/operations#ConnectionAction

The class of all actions that affect connections among agents, user accounts and/or groups in an STN.

Create Connection

IRI: https://w3id.org/stn/core/operations#CreateConnection

A kind of action an agent may perform in order to establish a connection to another agent. This action might require the consent of the targeted agent, in which case it is a delayed action. Required parameters: UserID.

Create Connection Request

IRI: https://w3id.org/stn/core/operations#CreateConnectionRequest

A kind of action an agent may perform in order to establish a connection to another entity with the consent of that entity.

Create Group

IRI: https://w3id.org/stn/core/operations#CreateGroup

A kind of action an agent may perform in order to create a group digital artifact.

Create User Account

IRI: https://w3id.org/stn/core/operations#CreateUserAccount

A kind of action a smart thing may perform in order to create a user account digital artifact. Required parameters: OwnerID, DisplayedName.

Delayed Action

IRI: https://w3id.org/stn/core/operations#DelayedAction

unstable

A delayed action is an action which does not have an immediate effect and requires further steps to be taken (e.g. the approval of an agent, further processing by the STN platform). For instance, establishing a connection that requires the targeted agent’s consent is a delayed action.

Delete Connection From

IRI: https://w3id.org/stn/core/operations#DeleteConnectionFrom

unstable

A kind of action an agent may perform in order to delete a connection from an entity. This might be a delayed action. Required parameters: UserID.

Delete Connection From Request

IRI: https://w3id.org/stn/core/operations#DeleteConnectionFromRequest

unstable

A delayed action an agent may perform in order to delete a connection from another entity with the consent of that entity.

Delete Connection To

IRI: https://w3id.org/stn/core/operations#DeleteConnectionTo

unstable

A kind of action an agent may perform in order to delete a connection to an entity. This might be a delayed action. Required parameters: UserID.

Delete Connection To Request

IRI: https://w3id.org/stn/core/operations#DeleteConnectionToRequest

unstable

A delayed action an agent may perform in order to delete a connection to another entity with the consent of that entity.

Delete Group

IRI: https://w3id.org/stn/core/operations#DeleteGroup

A kind of action an agent may perform in order to delete a group digital artifact. Required parameters: GroupID.

Delete User Account

IRI: https://w3id.org/stn/core/operations#DeleteUserAccount

A kind of action an agent may perform in order to delete a user account digital artifact.

Description

IRI: https://w3id.org/stn/core/operations#Description

A parameter which represents a general purpose description of an entity.

Displayed Name

IRI: https://w3id.org/stn/core/operations#DisplayedName

A parameter which represents the name displayed in an STN for an entity.

Entity ID

IRI: https://w3id.org/stn/core/operations#EntityID

A parameter which represents the ID of an entity.

Get Aggregated Feed

IRI: https://w3id.org/stn/core/operations#GetAggregatedFeed - sub class of: GetFeed

Get Connections

IRI: https://w3id.org/stn/core/operations#GetConnections - sub class of: Query

Get Description

IRI: https://w3id.org/stn/core/operations#GetDescription

A kind of query an agent may perform in order to retrieve the description of a given entity (if available). Required parameters: EntityID.

Get Feed

IRI: https://w3id.org/stn/core/operations#GetFeed - sub class of: Query

Get Group

IRI: https://w3id.org/stn/core/operations#GetGroup - sub class of: Query

Get Group Feed

IRI: https://w3id.org/stn/core/operations#GetGroupFeed - sub class of: GetFeed

Get Groups

IRI: https://w3id.org/stn/core/operations#GetGroups - sub class of: Query

Get Groups Of User

IRI: https://w3id.org/stn/core/operations#GetGroupsOfUser - sub class of: GetGroups

Get Messages

IRI: https://w3id.org/stn/core/operations#GetMessages - sub class of: Query

Get Received Messages

IRI: https://w3id.org/stn/core/operations#GetReceivedMessages - sub class of: GetMessages

Get Sent Messages

IRI: https://w3id.org/stn/core/operations#GetSentMessages - sub class of: GetMessages

Get User Account Feed

IRI: https://w3id.org/stn/core/operations#GetUserAccountFeed - sub class of: GetFeed

Get User Connections

IRI: https://w3id.org/stn/core/operations#GetUserConnections

A kind of query an agent may perform in order to retrieve the connections of a user account digital artifact. Required parameters: UserID.

Group Action

IRI: https://w3id.org/stn/core/operations#GroupAction

The class of all group-related actions.

Implementation

IRI: https://w3id.org/stn/core/operations#Implementation

An abstract concept describing implementations of operations. This is intended to be extended by implementation-specific modules, such as STN-Core-Operations-HTTP.

Join Group

IRI: https://w3id.org/stn/core/operations#JoinGroup

A kind of action an agent may perform in order to join a group digital artifact. Required parameters: GroupID.

KeyValuePair

IRI: https://w3id.org/stn/core/operations#KeyValuePair

A parameter represents structured data that may be provided as input to, or may be returned as output of, an operation.

Leave Group

IRI: https://w3id.org/stn/core/operations#LeaveGroup

A kind of action an agent may perform in order to leave a group digital artifact. Required parameters: GroupID.

Operation

IRI: https://w3id.org/stn/core/operations#Operation

An operation is an atomic activity performed by an agent within the scope of an STN platform. An operation may be related to a set of input and output parameters. Known types of operations are actions and queries.

Owner ID

IRI: https://w3id.org/stn/core/operations#OwnerID

unstable

A parameter which represents the ID of a smart thing’s owner, such as the ID of a person or group.

Post Message

IRI: https://w3id.org/stn/core/operations#PostMessage

unstable

Post Message To Group

IRI: https://w3id.org/stn/core/operations#PostMessageToGroup - sub class of: PostMessage

Query

IRI: https://w3id.org/stn/core/operations#Query

A query is an operation that only retrieves information from the STG, e.g. retrieving the connections of a user.

Read Data Object

IRI: https://w3id.org/stn/core/operations#ReadDataObject - sub class of: DataAction

Read Key Value Pair

IRI: https://w3id.org/stn/core/operations#ReadKeyValuePair - sub class of: Query

Read Triple

IRI: https://w3id.org/stn/core/operations#ReadTriple - sub class of: Query

IRI: https://w3id.org/stn/core/operations#ReassignToRole

TBD (taken from Singh’s ontology for commitments)

Reject Connection

IRI: https://w3id.org/stn/core/operations#RejectConnection

A kind of action an agent may perform in order to reject a connection from another entity. Required parameters: EntityID.

Representation

IRI: https://w3id.org/stn/core/operations#Representation - sub class of: Parameter - domain of: contains, hasFormat - range of: hasRepresentation

Role Action

IRI: https://w3id.org/stn/core/operations#RoleAction - sub class of: Action

Send Message

IRI: https://w3id.org/stn/core/operations#SendMessage

unstable

Send Message to Group

IRI: https://w3id.org/stn/core/operations#SendMessageToGroup - sub class of: SendMessage

Spatial Action

IRI: https://w3id.org/stn/core/operations#SpatialAction

The class of all actions related to spatial things.

Spatial Thing ID

IRI: https://w3id.org/stn/core/operations#SpatialThingID

A parameter which represents the ID of a spatial thing.

Update Group

IRI: https://w3id.org/stn/core/operations#UpdateGroup

A kind of action an agent may perform in order to update a group digital artifact. Required parameters: GroupID.

Update User Account

IRI: https://w3id.org/stn/core/operations#UpdateUserAccount

A kind of action an agent may perform in order to update a user account digital artifact.

User Account Action

IRI: https://w3id.org/stn/core/operations#UserAccountAction

The class of all actions related to user accounts.

User ID

IRI: https://w3id.org/stn/core/operations#UserID

A parameter which represents the ID of an agent or user account.

Write Data Object

IRI: https://w3id.org/stn/core/operations#WriteDataObject - sub class of: DataAction

Object Properties

IRI: https://w3id.org/stn/core/operations#consumes

IRI: https://w3id.org/stn/core/operations#contains - domain: Representation - range: KeyValuePair

IRI: https://w3id.org/stn/core/operations#hasClass - domain: https://w3id.org/stn/core#SmartThing - range: SocialThingClass

IRI: https://w3id.org/stn/core/operations#hasFormat - domain: Representation - range: RepresentationFormat

has input

IRI: https://w3id.org/stn/core/operations#hasInput

An input parameter for this operation.

has output

IRI: https://w3id.org/stn/core/operations#hasOutput

A parameter returned by this operation.

implemented as

IRI: https://w3id.org/stn/core/operations#implementedAs

An implementation of this operation.

IRI: https://w3id.org/stn/core/operations#key - domain: KeyValuePair

performed

IRI: https://w3id.org/stn/core/operations#performed

An operation that has been performed by this user.

Data Properties

Parameter Name

IRI: https://w3id.org/stn/core/operations#paramName

A sequence of characters used to identify a parameter of an operation within the scope of an STN platform. For instance, when creating a connection, the required UserID parameter might be referred to as “user_id” in one platform and “id” in another.

IRI: https://w3id.org/stn/core/operations#required - domain: Parameter - range: http://www.w3.org/2001/XMLSchema#boolean