Go to PGM-AUA V1.0 Data Types

Definition
Functional Requirements
Syntax
Semantics
Conformance Testing
Performance Assessment

Definition

Action Object (PGM-ACO): Action of the Persona with no effect on the M-Instance, produced by Basic Knowledge in a vocabulary named by its Qualifier and consumed by A-User Formation.

Functional Requirements

  1. Header: The Data shall have Header “PGM-ACO-V1.0”.
  2. Identification: The Data shall carry the identifiers of the M‑Instance, of the U‑Environment and of the session, and a unique identifier and a time (ActionObjectID, ActionObjectTime).
  3. MInstanceID: The Data may include minstance id.
  4. UEnvironmentID: The Data may include uenvironment id.
  5. SubjectID: The Data may include identifier of the Persona or of the Item the Action is applied to; a simple string.
  6. TargetIDs: The Data may include identifiers (simple strings) of the Items, Personae or Locations the Action refers to.
  7. ActionObjectData: The Data shall include action object data.
  8. ActionQualifier: The Data may include action qualifier.
  9. Metadata: The Data shall include DataXMData and may include DescrMetadata.

Syntax

https://schemas.mpai.community/PGM1/V1.0/data/ActionObject.json

Semantics

Table 1 – Semantics of Action Object

Label Description
Header Header of the Data Type, with the version. (required)
MInstanceID MInstance ID.
UEnvironmentID UEnvironment ID.
ActionObjectID Action Object ID. (required)
ActionObjectTime Time at which the Data was produced.
SubjectID Identifier of the Persona or of the Item the Action is applied to; a simple string.
TargetIDs Identifiers (simple strings) of the Items, Personae or Locations the Action refers to.
ActionObjectData Action Object Data. Each item provides the data as inline content (Data), a URI reference (DataLength and DataURI), or an external ID (ID). (required)
ActionQualifier Action Qualifier.
DataXMData Data Exchange Metadata of MPAI-PTF: provenance, authorisation, security and confidence of the Data.
DescrMetadata Descriptive metadata (plain text, at most 2048 characters).

Conformance Testing

Data conforms with Action Object if it validates against the schema of Section 3. If a schema contains references to other schemas, conformance of data for the primary schema implies that any data referencing a secondary schema shall also validate against the relevant schema.

Performance Assessment

Not part of this specification.

Go to PGM-AUA V1.0 Data Types