<- Go to ProcessActions  ->

1 Definition 2 Protocol 3 Syntax 4 Semantics

1 Definition

The Action of a User requesting a Location Service to:

  1. Move an MM-Added Item from an M-Location to another M-Location along a Trajectory.
  2. Preserve any Property Change that may have been applied to the Item.
  3. Grant Rights to the MM-Moved Item based on requested Rights.

If the request is  accepted, the Locate Service responds MM-Moves the Item and provides the  requested Rights if the request is accepted.

2 Protocol

  1. User sends “MM-Move PA Request including Item, Point of View1, Point of View2, and Rights (Status=Model)” to MM-Move Service.
    1. If MM-Move Service is a free service, goto MM-Move .
    2. If MM-Move Service is a pay service:
      1. User sends “MM-Move PA Request with Service Pricing Model (Status=Model)” to MM-Move Service.
      2. MM-Move Service sends “MM-Move PA Response” to User:
        1. If “MM-Move PA Response includes Status=Err”, goto End
        2. If “MM-Move PA Response includes Status=Ack and Service Pricing Model withTransaction (both Status=Model)”, User:
          1. Transacts “Value included in Transaction”.
          2. Sends “MM-Move PA Request including Service Pricing Model (Status=Model) with Transaction (both Status=Final)” to MM-Move Service.
  2. MM-Move: MM-Move Service
    1. MM-Moves “Item”.
    2. Sends “MM-Move PA Response” including:
      1. “Rights (Status=Final)” to MM-Moved Item.
      2. “Service Pricing Model (Status=Final)”, if MM-Move 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/MMMovePA.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/MMMovePA.json

4 Semantics

Label Description
Header MM-Move Process Action Header – Standard “MMM-2MP-Vx.y”
MInstanceID Identifier of M-Instance.
UEnvironmentID Identifier of U-Environment.
MMMovePAID Identifier of this PA Instance.
MMMovePATime Creation time of this PA Instance.
MMMovePAData 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 to be MM-Moved.
  – From Point of View M-Location where the Item is MM-Added.
  – To Point of View M-Location where the Item is to be MM-Moved.
  – With Spatial Attitude The Spatial Attitude of the Item at the new M-Location.
  – With Rights Requested Rights to the MM-Moved Item.
  – With SPM Service Pricing Model, if MM-Move is a pay service.
– RS-Complements Complements in the PA Response
  – With Rights Actual Rights based on Model Rights if PA Request is accepted.
  – With SPM Service Pricing Model, if MM-Move is a pay service.
– With PAStatus Possible Error Messages.
    – Ack If PA Request could be performed.
    – Err If Error was found.
      – Clash MM-Moved Item clashes with existing Item.
      – 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  ->