<- Go to ProcessActions  ->

1 Definition 2 Functional Requirements 3 Syntax 4 Semantics

1 Definition

The Action of a Process requesting an Item Manage Service to:

  1. Change the Data of an Item according to a given Qualifier.
  2. Grant Rights to the Converted Item based on requested Model Rights.

If the request is  accepted, the Item Manage Service responds with an Item including embedded Rights (Status=Final) to the Item.

2 Protocol

  1. Process sends PA Request including Item to Convert and Rights (Status=Model) to Item Manage Service.
    1. If Convert is a free service, goto Convert.
    2. If Convert is a pay service:
      1. Process sends PA Request including Service Pricing Model (Status=Model) to Convert.
      2. Convert sends PA Response:
        1. If PA Response includes Status=Err, goto End.
        2. If PA Response includes Status=Ack and SPM with Transaction (both Status=Model), Process:
          1. Transacts Value contained in Transaction.
          2. Sends PA Request with SPM including Transaction (both Status=Final) to Item Manage.
  2. Convert: Item Manage
    1. Converts Data per input Qualifier
    2. Identifies Item including Data, input Qualifier, and Rights (Status=Final).
    3. Sends PA Response to Process including Service Pricing Model (Status=Final), if Authenticate is a pay Service.
    4. Sends Item with embedded Rights (Status=Final) to Destination Process.
  3. End

3 Syntax

https://schemas.mpai.community/MMM4/V2.2/actions/ConvertPA.json

4 Semantics

Label Description
Header Convert Process Action Header – Standard “MMM-CVP-Vx.y”
MInstanceID Identifier of M-Instance.
MEnvironmentID Identifier of M-Environment.
ConvertPAData Data included in the Convert Process Action.
– Time Time of PA request emission and Time of PA request execution.
– RQ-Complements Source Complements.
  – Nil ItemID Item whose Data should be Converted.
  – At ProcessID
 Process holding Item whose Data is requested to be Converted.
  – At MLocation M-Location where the Item is MM-Embedded.
  – With ModelQualifier Qualifier to be used to Convert the Data of the Item.
  – At ProcessID The Process that should receive the Converted Item.
  – With Rights Rights (Status=Model) that are requested to the Converted Item.
  – With SPM Service Pricing Model if Convert Service is a pay service.
– RS-Complements Destination Complements.
  – Nil Item Item whose Data have been Converted.
  – With Rights Rights (Status=Final) based on requested Rights if PA Request is accepted.
  – With SPM Service Pricing Model if Convert Service is a pay service.
  – With PAStatus Possible Error Messages.
    – Ack If PA Request could be performed
    – Err If Error was found
      – FaultyPA Faulty PA Request.
      – IncID Incorrect ID.
      – MLocOOR M-Location out of range.
      – InsRights Insufficient Rights.
      – InsValue Insufficient Value in Wallet.
      – QualNS Qualifier not supported.
Trace Authentication provenance information and time of PA production.
 DescMetadata Descriptive Metadata.

<- Go to ProcessActions  ->