<- 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.
  2. Rights Manage MM-Sends a Message including the 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 the 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 is a free service, goto Rights Change.
      2. If Rights Change is a pay service:
        1. User sends Rights Change PA Request with Service Pricing Model (Status=Model) to Rights Manage.
        2. Rights Manage 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 contained in Transaction.
            2. Sends Rights Change PA Request including Service Pricing Model (Status=Model) with Transaction (Status=Final) to Rights Manage.
  4. Rights Change: Rights Manage
    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

3 Syntax

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.
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 ItemID   – Item whose Rights are requested to be Changed.
      – At 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.
Trace Authentication provenance information and time of PA production.
 DescMetadata Descriptive Metadata.

<- Go to ProcessActions  ->