| 1 Definition | 2 Functional Requirements | 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 Model Rights.
If the request is accepted, the Locate Service responds places the Item at the requested M-Location providing actual Rights to the requesting User..
2 Functional Requirements
The MM-Add Process Action includes:
In the request
– The Item to be MM-Added.
– The Spatial Attitude of the Item to be MM-Added.
– The M-Location where the Item is to be MM-Added.
– The Perceptibility State
– The Model Rights to the MM-Added Item.
– A Transaction if requested by the Locate Service.
In the response
– The Rights per the Model Rights if request is successful.
3 Syntax
https://schemas.mpai.community/MMM4/V2.1/actions/MMAddPA.json
4 Semantics
| Label | Description |
| Header | MM-Add Process Action Header |
| – Standard-MMAddPA | The characters “MMM-2DP-V” |
| – Version | Major version – 1 or 2 characters |
| – Dot-separator | The character “.” |
| – Subversion | Minor version – 1 or 2 characters |
| 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. |
| – With SpatialAttitude | The Spatial Attitude of the Item to be MM-Added. |
| – With PerceptibilityState | 0=Imperceptible, 1=Perceptible. |
| – With ModelRights | Rights that are requested to the MM-Added Item. |
| – With Transaction | Transaction made to Locate Service if requested. |
| – RS-Complements | Destination Complements. |
| – With Rights | Actual Rights based on Model Rights if PA Request is accepted. |
| – 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. |
| DescMetadata | Descriptive Metadata. |
