| 1 Definition | 2 Functional Requirements | 3 Syntax | 4 Semantics |
1 Definition
The Action of a Process requesting a Convert Service to:
1. Change the Data of an Item according to a given Qualifier.
2. Grant Rights to the Converted Item based on Model Rights.
If the request is accepted, the Convert Service responds with an Item and actual Rights to the Item.
2 Functional Requirements
The Convert Process Action includes:
In the request
– One of
– The ID of Item whose Data is to be Converted.
– The Process holding the Item whose Data is to be Converted.
– The M-Location wrapping the Item whose Data is to be Converted is MM-Embedded.
– The Model Qualifier to be used to Convert the Item.
– The Model Rights to the Converted Item.
– The Process that should receive the Converted Item.
– A Transaction if requested by the Convert Service.
In the response
– The Converted Item.
– The Rights per the Model Rights if the request is successful.
3 Syntax
https://schemas.mpai.community/MMM4/V2.1/data/Convert.json
4 Semantics
| Label | Description |
| Header | Convert Process Action Header |
| – Standard-ConvertPA | The characters “MMM-CVP-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. |
| ConvertPAData | Data included in the Convert Process Action. |
| – Time | Time of PA request emission and Time of PA request execution. |
| – RQ-Complements | Source Complements. |
| – Nil ItemID | Item whose Data is requested to be Converted. |
| – At ProcessID |
Process holding Item whose Data is requested to be Converted. |
| – At MLocation | M-Location where the Item is MM-Embedded. |
| – With ModelQualifier | Qualifier to be used to Convert the Data of the Item. |
| – At ProcessID | The Process that should receive the Converted Item. |
| – With ModelRights | Rights that are requested to the Converted Item. |
| – With Transaction | Transaction made to Convert Service if requested. |
| – RS-Complements | Destination Complements. |
| – Nil ItemIDs | Item whose Data have been Convertedd. |
| – 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 |
| – FaultyPA | Faulty PA Request. |
| – IncID | Incorrect ID. |
| – MLocOOR | M-Location out of range. |
| – InsRights | Insufficient Rights. |
| – InsValue | Insufficient Value in Wallet. |
| – QualNS | Qualifier not supported. |
| DescMetadata | Descriptive Metadata. |
