<- 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 “Convert PA Request including Item to Convert and Rights (Status=Model)” to Convert Service.
    1. If Convert Service is a free service, goto Convert.
    2. If Convert Service is a pay service:
      1. Process sends “Convert PA Request including Service Pricing Model (Status=Model)” to Convert Service.
      2. Convert Service sends PA Response:
        1. If “PA Response includes Status=Err”, goto End.
        2. If “PA Response includes Status=Ack and Service Pricing Model with Transaction (both Status=Model)”, Process:
          1. Transacts “Value included in Transaction”.
          2. Sends “PA Request with SPM including Transaction (both Status=Final)” to Convert Service.
  2. Convert: Convert Service
    1. Converts “Data to a new format according to input Qualifier”.
    2. Identifies “Item including Data, input Qualifier, and Rights (Status=Final)”.
    3. Sends to Process “Convert PA Response including Service Pricing Model (Status=Final),” if Authenticate is a pay Service.
    4. Sends “Item including embedded Rights (Status=Final)” to Destination Process.
  3. End

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

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

4 Semantics

Label Description
Header Convert Process Action Header – Standard “MMM-CVP-Vx.y”
MInstanceID Identifier of M-Instance.
UEnvironmentID Identifier of U-Environment.
ConvertPAID Identifier of this PA Instance.
ConvertPATime Creation time of this PA Instance.
ConvertPAData Data included in this PA Instance.
– Time Time of PA Request emission and execution or PA Response emission.
– RQ-Complements Source Complements.
  – Nil ItemID Item whose Data should be Converted.
  – At SProcessID
 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 RProcessID 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.
DataXMData Identity, provenance, authorised usage, source, type, governance context, security, legality, and annotation of exchanged data.
 DescMetadata Descriptive Metadata.

<- Go to ProcessActions  ->