<- Go to ProcessActions  ->

1 Definition 2 Protocol 3 Syntax 4 Semantics

1 Definition

The Action of a User requesting that an Identity Service:

  1. Produce a new Item starting from an existing Item using new Data and Qualifier.
  2. 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

  1. User sends “Modify PA Request including Data, Qualifier, Process ID, and Rights (Status=Model)” to Modify Service.
    1. If Modify Service is a free service, goto Modify.
    2. If Modify Service is a pay service:
      1. User sends “Modify PA Request including Service Pricing Model (Status=Model)” to Modify Service.
      2. Modify Service sends “Modify PA Response” to User:
        1. If “Modify PA Response includes Status=Err”, goto End
        2. If “Modify PA Response includes Status=Ack and Service Pricing Model with Transaction (both Status=Model)”, User:
          1. Transacts “Value included in Transaction”.
          2. Sends “Modify PA Request including Service Pricing Model (Status=Model) with Transaction (Status=Final)” to Modify.
  2. Modify: Modify Service
    1. Creates Item (Status=Model) with Data, Rights (Status=Model), and Item ID.
    2. Verifies “Rights”.
    3. Identifies “Rights and Item”.
    4. Sends to User “Modify PA Response” including:
      1. “Item and Rights (Status=Final)”.
      2. “Service Pricing Model (Status=Final)”.
  3. End

The protocol described using Workflow Description Language (WDL) is available at this link:

https://schemas.mpai.community/MMM4/V2.2/wdl/ModifyPA.wdl

3 Syntax

The structure of the input and output messages, using JavaScript Object Notation (JSON)  is available at this link:

https://schemas.mpai.community/MMM4/V2.2/data/ModifyPA.json

4 Semantics

Label Description
Header Modify Process Action Header – Standard “MMM-MOP-V”
MInstanceID Identifier of M-Instance.
UEnvironmentID Identifier of U-Environment.
MMSendPAID Identifier of this PA Instance.
MMSendPATime Creation time of this PA Instance.
MMSendPAData Data included in this PA Instance.
– Time Time of PA Request emission and execution, or PA Response emission.
– 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.
DataXMData Identity, provenance, authorised usage, source, type, governance context, security, legality, and annotation of exchanged data.
 DescMetadata Descriptive Metadata.

<- Go to ProcessActions  ->