| 1 Definition | 2 Protocol | 3 Syntax | 4 Semantics |
1 Definition
The Action of a User requesting that an Identity Service:
- Produce a new Item starting from an existing Item using new Data and Qualifier.
- Grant Rights to the Modified Item based on requested Rights.
If the request is accepted, the Identity Service provides the ID of the Modified Item and grants requested Rights to the Modified Item.
2 Protocol
- User sends Modify PA Request including Data, Qualifier, Process ID, and Rights (Status=Model) to Identity Service.
- If Modify is a free service, goto Modify.
- If Modify is a pay service:
- User sends Modify PA Request with Service Pricing Model (Status=Model) to Identity.
- Identity sends Modify PA Response:
- If Modify PA Response includes Status=Err, goto End
- If Modify PA Response includes Status=Ack and Service Pricing Model including Transaction (both Status=Model), User:
- Transacts Value contained in Transaction.
- Sends Modify PA Request with Service Pricing Model (Status=Model) including Transaction (Status=Final) to Identity.
- Modify: Item Manage
- Creates Item (Status=Model) with Data, Rights (Status=Model), and Item ID.
- Verifies Rights.
- Identifies Rights and Item.
- Sends to User Modify PA Response including:
- Item and Rights (Status=Final).
- Service Pricing Model (Status=Final).
- End
3 Syntax
https://schemas.mpai.community/MMM4/V2.2/actions/ModifyPA.json
4 Semantics
| Label | Description |
| Header | Modify Process Action Header – Standard “MMM-MOP-V” |
| MInstanceID | Identifier of M-Instance. |
| MEnvironmentID | Identifier of M-Environment. |
| ModifyPAData | Data included in the Modify Process Action. |
| – Time | Time of PA request emission and Time of PA request execution. |
| – RQ-Complements | Complements in PA Request. |
| – Nil ItemID | Item to be Modified-Sent. |
| – With Data | Data To Modify the Item. |
| – With Qualifier | Data Qualifier for Item modification. |
| – With Rights | Requested Rights to the Modified Item. |
| – With SPM | Service Pricing Model, if Modify is a pay service. |
| – D-Complements | Complements in PA Response. |
| – Nil ItemID | Modified Item. |
| – With Rights | Rights based on requested 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. |
| – IncDQ | Incorrect Data and/or Qualifier. |
| – InsRights | Insufficient Rights. |
| – InsValue | Insufficient Value in Wallet. |
| Trace | Authentication provenance information and time of PA production. |
| DescMetadata | Descriptive Metadata. |