<- Go to ProcessActions  ->

1 Definition 2 Protocol 3 Syntax 4 Semantics

1 Definition

The Action of a User requesting that Rights Manage Service:

  1. Modify the Rights of a Process or an Item.
  2. Grant to the User the Rights to further Rights Change the modified Rights to the Process or Item, based on User’s request.

If the requests are accepted, the User will receive Right to either

  1. The Items based on Licence (Status=Final)
  2. The Rights-Managed Process.

2 Protocol

  1. Process sends “Rights Change PA Request including ID of Process or Item and the Rights to be Changed (removed or added) with the Rights (Status=Model) to further Right Change them” to Rights Change Service.
  2. Rights Change Service MM-Sends a Message including Rights Change PA Request to:
    1. The Process if the entity to be Rights Changed is a Process.
    2. To the Processes holding “Rights to the Item” if the entity to be Rights Changed is an Item.
  3. If Rights Change PA Response is
    1. Negative from the Process or from at least one Process holding “Rights to the Item” got End.
    2. Positive from the Process or all the Processes
      1. If Rights Change Service is a free service, goto Rights Change.
      2. If Rights Change Service is a pay service:
        1. User sends “Rights Change PA Request including Service Pricing Model (Status=Model)” to Rights Change Service.
        2. Rights Change Service sends “Rights Change PA Response”:
          1. If “Rights Change PA Response includes Status=Err”, goto End.
          2. If “Rights Change  PA Response includes Status=Ack and Service Pricing Model with Transaction (both Status=Model)”, User:
            1. Transacts “Value included  in Transaction”.
            2. Sends “Rights Change PA Request including Service Pricing Model (Status=Model) with Transaction (Status=Final)” to Rights Change Service.
  4. Rights Change: Rights Change Service
    1. Adds and/or removes “Rights to Process or Item””.
    2. Identifies new “Process or Item”.
    3. If “Item”, creates “Licence”.
    4. Sends “Rights Change PA Response” including one of
      1. “ID of Rights-Changed Service or Item”.
      2. “Licence” if  Rights-Changed entity is Item.
      3. “Service Pricing Model”, if Rights Change is a pay service.
  5. End

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

https://schemas.mpai.community/MMM4/V2.2/wdl/RightsChangePA.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.1/actions/RightsChangePA.json

4 Semantics

Label Description
Header Rights Change Process Action Header – Standard “MMM-RCP-Vx.y”
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 the PA Request.
  – oneOf
    – Nil ProcessID
 Process whose Rights are requested to be Changed.
      – oneOf – One of
        – Nil ItemID   – Item whose Rights are requested to be Changed.
        – Nil MLocationID   -M-Location wrapping the Item.
  – With NewRights New requested Rights to be added to or removed from Process or Item.
  – With FutureRights Requesting Process’s requested Rights to further change Rights Changed Process or Item.
  – With SPM Service Pricing Model, if Rights Change is a pay service.
– RS-Complements Complements in the PA Response.
  – With Rights Actual Rights based on Model Rights if PA Request is accepted.
  – With SPM Service Pricing Model, if Rights Change is a pay service.
  – 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.
DataXMData Identity, provenance, authorised usage, source, type, governance context, security, legality, and annotation of exchanged data.
DescMetadata Descriptive Metadata.

<- Go to ProcessActions  ->