| 1 Definition | 2 Functional Requirements | 3 Syntax | 4 Semantics |
1 Definition
The Action of a User requesting a Rights Service to:
1. Modify the Rights of a Process or an Item based on Model Rights.
2. Grant the requesting User the Rights to further RightsChange the Rights to the Process or Item.
If the request is accepted, the User will receive Rights to Items based on Model Licence and the RightsChanged Process the new Rights.
2 Functional Requirements
The RightsChange Process Action includes:
In the request
– The ID of the Item or Process whose Rights are to be changed.
– The M-Location wrapping the Item.
– The Model Rights to be granted to or revoked from the Item or Process.
– The User that should receive notification of Rights Change.
– A Transaction if requested by the Rights Service.
In the response
– The Rights granted or revoked from the Item or process per the Model Rights.
3 Syntax
https://schemas.mpai.community/MMM4/V2.1/data/RightsChange.json
4 Semantics
| Label | Description |
| Header | RightsChange Process Action Header |
| – Standard-RightsChangePA | The characters “MMM-RCP-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. |
| RightsChangePAData | Data included in the RightsChange Process Action. |
| – Time | Time of PA request emission and Time of PA request execution. |
| – RQ-Complements | Complements in the PA Request. |
| – Nil ProcessID or |
Process whose Rights are requested to be Changed. |
| – oneOf | One of |
| – Nil ProcessID | – Process |
| -oneOf | – One of |
| – Nil ItemIDs | – Item whose Rights are requested to be Changed. |
| – At MLocationID | -M-Location wrapping the Item. |
| – With ModelRights | Rights that are requested to be Changed. |
| – To ProcessID | Process that should receive Rights. |
| – With Transaction | Transaction made to Rights Service if requested. |
| – RS-Complements | Complements in the PA Response. |
| – 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 PA Request could not be performed. |
| – FaultyPA | Faulty PA Request. |
| – IncID | Incorrect ID. |
| – InsRights | Insufficient Rights. |
| – InsValue | Insufficient Value in Wallet. |
| – MLocOOR | No such M-Location. |
| DescMetadata | Descriptive Metadata. |
