| 1 Definition | 2 Protocol | 3 Syntax | 4 Semantics |
1 Definition
The Action of a User requesting an Export Service to:
- Place an R-Item at a U-Location with a Spatial Attitude.
- Grant Rights to the MU-Added R-Item based on requested Rights.
If the request is accepted, the Export-Import Service places the R-Item and grants the requested Rights to the R-Item.
2 Protocol
- User sends MU-Add PA Request including R-Item, Point of View, Rights (Status=Model) to Export.
- If MU-Add is a free service, goto MU-Add.
- If MU-Add is a pay service:
- User sends MU-Add PA Request with Service Pricing Model (Status=Model) to Export.
- Export sends MU-Add PA Response:
- If MU-Add PA Response includes Status=Err, goto End
- If MU-Add PA Response includes Status=Ack and Service Pricing Model including Transaction (both Status=Model), User:
- Transacts Value contained in Transaction.
- Sends MU-Add PA Request including Service Pricing Model (Status=Model) with Transaction (Status=Final) to MU-Actuate.
- MU-Add: Export
- MU-Adds R-Item.
- Sends MU-Add PA Response including:
- Rights (Status=Final)
- Service Pricing Model (Status=Final), if MU-Add is a pay service.
- End
3 Syntax
https://schemas.mpai.community/MMM4/V2.2/actions/MUAddPA.json
4 Semantics
| Label | Description |
| Header | MU-Add Process Action Header – Standard “MMM-3DP-V” |
| MInstanceID | Identifier of M-Instance. |
| MEnvironmentID | Identifier of the M-Environment. |
| UEnvironmentID | Identifier of the U-Environment. |
| AddPAData | Data included in the MU-Add Process Action. |
| – Time | Time of PA request emission and Time of PA request execution. |
| – RQ-Complements | Complements in the PA Request. |
| – Nil RItemID | R-Item to be MU-Added. |
| – At ULocationID | U-Location where the Item is to be MU-Added. |
| – With SpatialAttitude | The Spatial Attitude of the Item to be MU-Added. |
| – With Rights | Requested Rights to the MU-Added Item. |
| – With SPM | Service Pricing Model, if MU-Add is a pay service. |
| – D-Complements | Complements in the PA Response. |
| – With Rights | Rights based on Requested Rights, if PA Request is accepted. |
| – With SPM | Service Pricing Model, if MU-Add is a pay service. |
| – With PAStatus | Status of PA Request. |
| – Ack | If PA Request could be performed |
| – Err | If Error was found |
| – Clash | R-Item clashes with another R-Iten. |
| – FaultyPA | Faulty PA Request. |
| – IncID | Incorrect ID. |
| – ULocOOR | 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. |