<- Go to ProcessActions  ->

1 Definition 2 Functional Requirements 3 Syntax 4 Semantics

1 Definition

The Action of a User requesting an Information Service to:

  1. Provide information on Items or Processes congruent with a Discovery Request Item.
  2. Grant Rights to the Discovery Response Item based on requested Rights (Status=Model).

If the request is accepted, the Information Service responds with a Discover Response Item and Rights (Status=Final) to the Discover Response Item.

2 Functional Requirements

  1. User sends “Discover PA Request including Discovery and Rights (Status=Model)” to Discover Service.
    1. If Discover Service is a free service, goto Discover.
    2. If Discover Service is a pay service,
      1. User sends “Discover PA Request with Service Pricing Model (Status=Model)” to Discover Service.
      2. Information sends “Discovery PA Response”:
        1. If “Discover PA Response includes Status=Err”, goto End
        2. If “Discover PA Response includes Status=Ack and Service Pricing Model with Transaction (both Status=Model)”, User:
          1. Transacts “Value included in Transaction”.
          2. Sends “Discover PA Request including Service Pricing Model (Status=Model) with Transaction (Status=Final” to Discover Service.
  2. Discover: Discover Service
    1. Produces the “Data requested in Discovery”.
    2. Identifies as “Discovery Response” “Item including the Data with Qualifier and Rights (Status=Final)” .
    3. Sends to User a Discover PA Response including:
      1. “Discovery and Rights (Status=Final)”.
      2. “Service Pricing Model (Status=Final)” if Discover Service is a pay service.
  3. End.

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

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

4 Semantics

Label Description
Header Discover Process Action Header – Standard “MMM-DSP-Vx.y”
MInstanceID Identifier of M-Instance.
UEnvironmentID Identifier of U-Environment.
DiscoverPAID Identifier of this PA Instance.
DiscoverPATime Creation time of this PA Instance.
DiscoverPAData Data included in this PA Instance.
– Time Time of PA Request emission and execution or PA Response emission.
– RQ-Complements Complements in PA Tequest.
  – With Discovery Discovery Request Item.
  – With Rights
 Requested Rights (Status-Model) to the Discovery Response Item.
  – With SPM Service Pricing Model (Status=Model) if Discover is a pay service.
– RS-Complements Complements in PA Response.
  – With Discovery Discovery Response Item.
  – With Rights Rights (Status=Final) based on requested Rights if PA Request is accepted.
  – With PAStatus Status of PA Request.
    – Ack If PA Request was performed.
    – Err If PA Request was not performed.
      – FaultyPA Faulty PA Request.
      – IncID Incorrect ID.
      – MLocOOR M-Location out of range.
      – 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.

<- Go to ProcessActions  ->