<- Go to ProcessActions  ->

1 Definition 2 Protocol 3 Syntax 4 Semantics

1 Definition

The Action of a User requesting a Locate Service to

  1. Place an Item at an M-Location with a Spatial Attitude.
  2. Grant Rights to the MM-Added Item based on requested Rights.

If the request is accepted, the Locate Service places the Item at the requested M-Location providing  Rights (Status=Final) to the requesting User.

2 Protocol

  1. User sends MM-Add PA Request including Item, Point of View, Location, and Rights (Status=Model).
    1. If MM-Add is a free service, goto MM-Add.
    2. If MM-Add is a pay service:
      1. User sends MM-Add PA Request with Service Pricing Model (Status=Model) to Locate.
      2. Locate sends MM-Add PA Response:
        1. If MM-Add PA Response includes Status=Err, goto End
        2. If MM-Add PA Response includes Status=Ack and Service Pricing Model including Transaction (both Status=Model), User:
          1. Transacts Value contained in Transaction.
          2. Sends MM-Add PA Request with Service Pricing Model (Status=Model) including Transaction (both Status=Final) to MM-Add.
  2. MM-Add: Locate
    1. MM-Adds Item.
    2. Sends MM-Add PA Response including
      1. Rights (Status=Final) to MM-Added Item.
      2. Service Pricing Model (Status=Final), if MM-Add is pay.
  3. End.

3 Syntax

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

4 Semantics

Label Description
Header MM-Add Process Action Header – Standard “MMM-2DP-V”
MInstanceID Identifier of M-Instance.
MEnvironmentID Identifier of M-Environment.
MMAddPAData Data included in the MM-Add Process Action.
– Time Time of PA request emission and Time of PA request execution.
– RQ-Complements Source Complements.
  – Nil Item Item to be MM-Added.
  – At MLocationID M-Location where the Item is to be MM-Added and may subsequently MM-Move.
  – With SpatialAttitude The Spatial Attitude of the Item to be MM-Added.
  – With Perceptibility State 0=Imperceptible, 1=Perceptible.
  – With Rights Requested Rights to the MM-Added Item.
  – With SPM Service Pricing Model, if Locate is a pay service.
– RS-Complements Destination Complements.
  – With Rights Rights (Status=Final) based on requested Rights.
  – With SPM Service Pricing Model (Status=Final), if Locate is a pay service.
  – With PAStatus Possible Error Messages.
    – Ack If PA Request could be performed
    – Err If Error was found
      – Clash MM-Added Item clashes with an existing Item.
      – FaultyPA Faulty PA Request.
      – IncID Incorrect ID.
      – MLocOOR M-Location out of range.
      – InsRights Insufficient Rights.
      – InsValue Insufficient Value in Wallet.
Trace Authentication provenance information and time of PA production.
 DescMetadata Descriptive Metadata.

<- Go to ProcessActions  ->