| 1 Definition | 2 Functional Requirements | 3 Syntax | 4 Semantics |
1 Definition
The Action of a User requesting that an Information Service:
- Interpret an Item relevant to the Interpretation Request Item.
- Grant Rights to the Interpretation Response Item based on requested Rights.
If the request is accepted, Information Service responds with an Interpretation Item.
2 Functional Requirements
- User sends “Interpret PA Request including Interpretation and Rights (Status=Model)” to Interpret Service.
- If Interpret Service is a free service, goto Interpret.
- If Interpret Service is a pay service,
- User sends “Interpret PA Request including Service Pricing Model (Status=Model)” to Information.
- Information sends “Interpret PA Response”:
- If “Interpret PA Response includes Status=Err”, goto End
- If “Interpret PA Response includes Status=Ack and Service Pricing Model with Transaction (both Status=Model)”, User
- Transacts “Value included in Transaction”.
- Sends “Interpret PA Request with Service Pricing Model (Status=Model) with Transaction (Status=Final)” to Interpret Service.
- Interpret: Information
- Identifies “Item”.
- Sends “Interpret PA Response including Interpretation PA Response and Rights (Status=Final)” to User.
- Sends “Service Pricing Model (Status=Final)”, if Interpret Service is a pay service.
- End
The protocol described using Workflow Description Language (WDL) is available at this link:
https://schemas.mpai.community/MMM4/V2.2/wdl/Interpret.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/InterpretPA.json
4 Semantics
| Label | Description |
| Header | Interpret Process Action Header – Standard “MMM-ITP-Vx.y” |
| MInstanceID | Identifier of M-Instance. |
| UEnvironmentID | Identifier of U-Environment. |
| InterpretPAID | Identifier of this PA Instance. |
| InterpretPATime | Creation time of this PA Instance. |
| InterpretPAData | Data included in this PA Instance. |
| – Time | Time of PA Request emission and execution or PA Response emission. |
| – RQ-Complements | Complements in PA Request. |
| – With Interpretation | The Interpretation Request Item. |
| – With Rights | Requested Rights on the Interpretation Response Item. |
| – At User | User receiving Interpretation Response Item with Rights. |
| – With SPM | Service Pricing Model, if Interpret is a pay service. |
| – RS-Complements | Complements in PA Response. |
| – With Interpretation | Interpretation Response Item. |
| – With Rights | Rights (Status=Final) 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. |
| – 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. |