<- Go to ProcessActions  ->

1 Definition 2 Protocol 3 Syntax 4 Semantics

1 Definition

The Action of a User requesting that a Locate Service

  1. Modify the characteristics of an Item:
    1. Change the Perceptibility of the Item.
    2. Apply an affine transformation to the Item.
    3. Change the attributes of:
      1. SourceType, ColourInfo, Intensity (if a Light Source)
      2. SourceType (If an Audio Source)
      3. Mass, Material, Gravity Property, TextureMap (if a Basic Visual Object or a Basic 3D Model Object)
    4. Set the Perceptibility of an Item.
    5. Display a specific Personal Status (if a Persona).
  2. Grant Rights to the Property-Managed Item based on requested Rights.

If the request is accepted, the Locate Service changes the Properties as requested and provides the  requested Rights, if the request is accepted.

2 Protocol

  1. Process sends “Property Change Service Property Change PA Request including Properties to be changed and Rights (Status=Model) to Property-Changed Item” to Property Change Service.
    1. If Property Change Service is a free service, goto Property Change.
    2. If Property Change Service is a pay service:
      1. User sends “Property Change PA Request including Service Pricing Model (Status=Model)” to Property Change Service.
      2. Property Change Service sends “Property Change PA Response”:
        1. If “Property Change PA Response includes Status=Err”, goto End
        2. If “Property Change PA Response includes Status=Ack and Service Pricing Model with Transaction (both Status=Model)”, User
          1. Transacts “Value included in Transaction”.
          2. Sends “Property Manage PA Request including SPM with Transaction (both Status=Final)” to Property Change Service.
  2. Property Change: Property Change Service
    1. Changes “Item Properties”.
    2. Identifies “Property-Changed Item”.
    3. Sends Property Change PA Response including:
      1. “Property-Changed Item and Rights (Status=Final) to Property-Changed Item”.
      2. .”Service Pricing Model (Status=Final)”, if Property Change Service is a pay service,
  3. End

The protocol described using Workflow Description Language (WDL) is available at this link:

https://schemas.mpai.community/MMM4/V2.2/wdl/PropertyChangePA.wdl

3 Syntax

The structure of the input and output messages, using JavaScript Object Notation (JSON)  is available at this link:

https://schemas.mpai.community/MMM4/V2.2/actions/PropertyChangePA.json

4 Semantics

Label Description
Header Property Change Process Action Header – Standard “MMM-PCP-Vx.y”
MInstanceID Identifier of M-Instance.
UEnvironmentID Identifier of U-Environment.
PropertyChangePAID Identifier of this PA Instance.
PropertyChangePATime Creation time of this PA Instance.
PropertyChangePAData Data included in this PA Instance.
– Time Time of PA Request emission and execution or PA Response emission.
– RQ-Complements Complements in the PA Request.
  – Nil ItemID Item whose Properties are to be Changed.
  – With PerceptibilityStatus 0= non perceptible, 1 = perceptible.
  – With Resize Resize the Item by Rx, Ry, Rz where x, y, and z are the Objects axes rotated according to an Orientation.
  – With 3DModelObject Change Mass, Material Property, and Gravity Property, TextureMap, Acoustic Profile.
  – With VisualObject Change Mass, Gravity and Material Property, TextureMap, Acoustic Profile.
  – With Acoustic Profile Change the Acoustic Profile of an Item.
  – With LightSource Change any of SourceType, ColourInfo, Intensity.
  – With AudioSource Change  Source Type.
  – With PersonalStatus Display a specific Personal Status (if a Persona).
  – With Rights Requested Rights to the Property Changed Item.
  – With SPM Service Pricing Model, if Item Manage is a pay service.
– RS-Complements Complements in the PA Request.
  – With Rights Rights based on requested Rights if PA Request is accepted.
  – With SPM Service Pricing Model, if Item Manage is a pay service.
  – With PAStatus Possible Error Messages.
    – Ack If PA Request could be performed.
    – Err If PA Request could not be performed.
      – FaultyPA Faulty PA Request.
      – IncID Incorrect ID.
      – MLocOOR M-Location out of range.
      – InsRights Insufficient Rights.
      – InsValue Insufficient Value in Wallet.
DataXMData Identity, provenance, authorised usage, source, type, governance context, security, legality, and annotation of exchanged data.
DescMetadata Descriptive Metadata.

<- Go to ProcessActions  ->