Bridging the Cloud Catalogue (PISTIS Marketplace) and the Factory Catalogues

As explained in PISTIS platform usage section, data owners can publish a metadata from their own Factory Catalogue to PISTIS Marketplace, so that the associated dataset is available for acquisition. Once a dataset is acquired and transfered to the buyer's Factory Catalogue, the buyer should be able to reference that dataset back to the Marketplace.

Datasets in a Factory Catalogue and in PISTIS Marketplace share an identical structure. To facilitate datasets cross-referencing between them, each dataset has:

1. A unique id that distinguishes it from others.
2. An offer object, which can consist of:
   • original_id that refers to the dataset's id in a Factory Catalogue. Typically this is available in each dataset in PISTIS Marketplace.
   • marketplace_offer_id that refers to the dataset's id in PISTIS Marketplace. Typically this is available in each dataset that has been acquired.

While both marketplace_offer_id and original_id can coexist in an offer, only one is typically required depending on the context.

Factory to Marketplace to Buyer

Step 1: Dataset in a Factory Catalogue

Suppose a Data Owner has the following dataset in his Factory Catalogue

API Request:

GET https://factory1.pistis-market.eu/srv/search/datasets/dataset-123

Response:

{
    "result": {
        "id": "dataset-123",
        "offer": null
        // The rest is ommited
    }
}

Note: The offer field is null, indicating that the dataset has not yet been published to the Marketplace.

Step 2: Dataset published to the Marketplace

After publishing, the dataset is available in the Marketplace with a reference to its origin.

API Request:

GET https://pistis-market.eu/srv/search/datasets/dataset-offer-123

Response:

{
    "result": {
        "id": "dataset-offer-123",
        "offer": {
            "original_id": "dataset-123"
        },
        "publisher": {
            "name": "FACTORY1",
            "organization_id": "e4d9a549-0cb0-4162-bce8-e5cd028ea660",
            "email": "mailto:admin-factory1@pistis.eu"
        }
        // The rest is ommited
    }
}

Step 3: Dataset acquired by a Data Buyer

Once purchased, the dataset is transfered to the buyer's Factory Catalogue with traceability:

API Request:

GET https://factory2.pistis-market.eu/srv/search/datasets/1234-5678-9012

Response:

{
    "result": {
        "id": "1234-5678-9012",
        "offer": {
            "original_id": "dataset-123",
            "marketplace_original_id": "dataset-offer-123"
        }
        // The rest is ommited
    }
}