Process Aggregation Event

info

Please note that this content is under development and is not ready for implementation. This status message will be updated as content development progresses.

Description

The processAggregationEvent service is responsible for processing an Aggregation Event (DTE), issuing a Verifiable Credential (VC), uploading it to the Storage service, registering the link to the stored DTE with the Identity Resolver service. It handles the entire lifecycle of creating and managing an aggregation event, from data input to storage and resolution.

Diagram

Example

{
  "name": "processAggregationEvent",
  "parameters": [
    {
      "vckit": {
        "vckitAPIUrl": "http://localhost:3332/v2",
        "issuer": "did:web:uncefact.github.io:project-vckit:test-and-development",
        "headers": {
          "Authorization": "Bearer test123"
        }
      },
      "traceabilityEvent": {
        "context": ["https://www.w3.org/2018/credentials/v1", "https://gs1.org/voc/"],
        "type": ["DigitalTraceabilityEvent"],
        "renderTemplate": [
          {
            "type": "html",
            "template": "<div><h2>Aggregation Event</h2><p>Parent: {{parentItem.epc}}</p></div>"
          }
        ],
        "dlrLinkTitle": "Aggregation Event",
        "dlrVerificationPage": "https://verify.example.com",
        "validUntil": "2025-11-28T04:47:15.136Z"
      },
      "storage": {
        "url": "http://localhost:3334/v1/documents",
        "params": {
          "bucket": "verifiable-credentials"
        },
        "options": {
          "method": "POST",
          "headers": {
            "Content-Type": "application/json"
          }
        }
      },
      "dlr": {
        "dlrAPIUrl": "https://dlr.example.com/api",
        "dlrAPIKey": "dlr-api-key-12345",
        "namespace": "gs1",
        "linkRegisterPath": "/api/resolver"
      },
      "identifierKeyPath": "/0/id"
    }
  ]
}

Definitions

Property	Required	Description	Type
vckit	Yes	Configuration for the VCKit service	VCKit
traceabilityEvent	Yes	Configuration for the EPCIS Aggregation Event	Credential
storage	Yes	Configuration for storage service	Storage
dlr	Yes	Configuration for the Digital Link Resolver	IDR
identifierKeyPath	Yes	JSON path to the identifier in the credential subject or the object for function and arguments of JSON path to construct identifier	IdentifierKeyPath

Function type

Type	Description
ReturnData	It processes the input data or generates data independently and returns the processed result after successful execution.