Action extends Thing
An action performed by a direct agent and indirect participants upon a direct object. Optionally happens at a location with the help of an inanimate instrument.
The execution of the action may produce a result. Specific action sub-type documentation specifies the exact expectation of each argument/role.
Tags
Table of Contents
Constants
- CONTEXT = 'https://schema.org'
- JSON-LD @context declaration for Schema.org.
Properties
- $_from : string|null
- The metadata to indicates the edge 'from' identifier.
- $_id : null|string
- The metadata identifier of the item.
- $_key : null|string
- The metadata unique key identifier of the thing.
- $_rev : null|string
- The metadata revision value of the thing.
- $_to : string|null
- The metadata to indicates the edge 'to' identifier.
- $actionProcess : HowTo|null
- Description of the process by which the action was performed.
- $actionStatus : ActionStatusType|DefinedTerm|null
- Indicates the current disposition of the Action.
- $active : bool|null
- The active flag.
- $additionalType : array<string|int, mixed>|string|null|object
- An additionalType for the item.
- $agent : Person|Organization|null
- The direct performer or driver of the action (animate or inanimate). E.g. John wrote a book.
- $alternateName : string|object|null
- An alias for the item.
- $created : null|string|DateTime
- Date of creation of the resource.
- $description : string|null
- A short description of the item.
- $disambiguatingDescription : string|null
- A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation.
- $endTime : null|string|int|DateTime
- The endTime of something.
- $error : Thing|null
- For failed actions, more information on the cause of the failure.
- $hasPart : string|Thing|array<string|int, mixed>|null
- Indicates an item that this part of this item.
- $id : null|int|string
- The unique identifier of the item.
- $identifier : string|null
- The identifier of the item.
- $image : string|object|null
- The image reference of this resource.
- $instrument : Thing|null
- The object that helped the agent perform the action. E.g. John wrote a book with a pen.
- $isPartOf : string|Thing|array<string|int, mixed>|null
- Indicates an item that this item is part of.
- $license : string|object|null
- A legal document giving official permission to do something with the resource.
- $location : Place|PostalAddress|string|VirtualLocation|null
- The location of, for example, where an event is happening, where an organization is located, or where an action takes place.
- $modified : null|string|DateTime
- Date on which the resource was changed.
- $name : int|string|null
- The name of the item.
- $object : Thing|null
- The object upon which the action is carried out, whose state is kept intact or changed. Also known as the semantic roles patient, affected or undergoer (which change their state) or theme (which doesn't). E.g. John read a book.
- $participant : array<string|int, mixed>|Person|Organization|null
- Other co-agents that participated in the action indirectly. E.g. John wrote a book with Steve.
- $provider : array<string|int, mixed>|Person|Organization|null
- The service provider, service operator, or service performer; the goods producer.
- $publisher : string|array<string|int, mixed>|Person|Organization|null
- The publisher of the resource.
- $result : Thing|null
- The result produced in the action. E.g. John wrote a book.
- $startTime : null|string|int|DateTime
- The startTime of something. For a reserved event or service (e.g. FoodEstablishmentReservation), the time that it is expected to start. For actions that span a period of time, when the action was performed. E.g. John wrote a book from January to December. For media, including audio and video, it's the time offset of the start of a clip within a larger file.
- $target : string|EntryPoint|null
- Indicates a target EntryPoint, or url, for an Action.
- $url : int|string|null
- URL of the item.
Methods
- __construct() : mixed
- Constructor to hydrate public properties from an array or stdClass.
- jsonSerialize() : array<string|int, mixed>
- Serializes the current object into a JSON-LD array.
Constants
CONTEXT
JSON-LD @context declaration for Schema.org.
public
mixed
CONTEXT
= 'https://schema.org'
Properties
$_from
The metadata to indicates the edge 'from' identifier.
public
string|null
$_from
$_id
The metadata identifier of the item.
public
null|string
$_id
$_key
The metadata unique key identifier of the thing.
public
null|string
$_key
$_rev
The metadata revision value of the thing.
public
null|string
$_rev
$_to
The metadata to indicates the edge 'to' identifier.
public
string|null
$_to
$actionProcess
Description of the process by which the action was performed.
public
HowTo|null
$actionProcess
$actionStatus
Indicates the current disposition of the Action.
public
ActionStatusType|DefinedTerm|null
$actionStatus
$active
The active flag.
public
bool|null
$active
$additionalType
An additionalType for the item.
public
array<string|int, mixed>|string|null|object
$additionalType
$agent
The direct performer or driver of the action (animate or inanimate). E.g. John wrote a book.
public
Person|Organization|null
$agent
$alternateName
An alias for the item.
public
string|object|null
$alternateName
$created
Date of creation of the resource.
public
null|string|DateTime
$created
$description
A short description of the item.
public
string|null
$description
$disambiguatingDescription
A sub property of description. A short description of the item used to disambiguate from other, similar items. Information from other properties (in particular, name) may be necessary for the description to be useful for disambiguation.
public
string|null
$disambiguatingDescription
$endTime
The endTime of something.
public
null|string|int|DateTime
$endTime
For a reserved event or service (e.g. FoodEstablishmentReservation), the time that it is expected to end. For actions that span a period of time, when the action was performed. E.g. John wrote a book from January to December. For media, including audio and video, it's the time offset of the end of a clip within a larger file. Note that Event uses startDate/endDate instead of startTime/endTime, even when describing dates with times. This situation may be clarified in future revisions.
$error
For failed actions, more information on the cause of the failure.
public
Thing|null
$error
$hasPart
Indicates an item that this part of this item.
public
string|Thing|array<string|int, mixed>|null
$hasPart
$id
The unique identifier of the item.
public
null|int|string
$id
$identifier
The identifier of the item.
public
string|null
$identifier
$image
The image reference of this resource.
public
string|object|null
$image
$instrument
The object that helped the agent perform the action. E.g. John wrote a book with a pen.
public
Thing|null
$instrument
$isPartOf
Indicates an item that this item is part of.
public
string|Thing|array<string|int, mixed>|null
$isPartOf
$license
A legal document giving official permission to do something with the resource.
public
string|object|null
$license
$location
The location of, for example, where an event is happening, where an organization is located, or where an action takes place.
public
Place|PostalAddress|string|VirtualLocation|null
$location
$modified
Date on which the resource was changed.
public
null|string|DateTime
$modified
$name
The name of the item.
public
int|string|null
$name
$object
The object upon which the action is carried out, whose state is kept intact or changed. Also known as the semantic roles patient, affected or undergoer (which change their state) or theme (which doesn't). E.g. John read a book.
public
Thing|null
$object
$participant
Other co-agents that participated in the action indirectly. E.g. John wrote a book with Steve.
public
array<string|int, mixed>|Person|Organization|null
$participant
$provider
The service provider, service operator, or service performer; the goods producer.
public
array<string|int, mixed>|Person|Organization|null
$provider
Another party (a seller) may offer those services or goods on behalf of the provider. A provider may also serve as the seller.
$publisher
The publisher of the resource.
public
string|array<string|int, mixed>|Person|Organization|null
$publisher
$result
The result produced in the action. E.g. John wrote a book.
public
Thing|null
$result
$startTime
The startTime of something. For a reserved event or service (e.g. FoodEstablishmentReservation), the time that it is expected to start. For actions that span a period of time, when the action was performed. E.g. John wrote a book from January to December. For media, including audio and video, it's the time offset of the start of a clip within a larger file.
public
null|string|int|DateTime
$startTime
$target
Indicates a target EntryPoint, or url, for an Action.
public
string|EntryPoint|null
$target
$url
URL of the item.
public
int|string|null
$url
Methods
__construct()
Constructor to hydrate public properties from an array or stdClass.
public
__construct([array<string|int, mixed>|object|null $init = null ]) : mixed
This allows objects to be quickly populated with associative data without manually setting each property.
Parameters
- $init : array<string|int, mixed>|object|null = null
-
A data array or object used to initialize the instance. Keys must match public property names.
Tags
jsonSerialize()
Serializes the current object into a JSON-LD array.
public
jsonSerialize() : array<string|int, mixed>
This method will include all public properties, the schema.org @context, and the inferred @type based on the class name.
Null values will be automatically removed using compress()
.
Tags
Return values
array<string|int, mixed> —A JSON-LD array representation of the object.