Business Workshop ‐ IC‐Hub ‐ Industry Core Part Management - eclipse-tractusx/eclipse-tractusx.github.io GitHub Wiki

🚀 Tractus-X@Industry Core Challenge: Create, Share, and Explore Your Digital Twin Vehicle Part

Welcome to the Industry Core Hub Workshop — your entry point into the world of Digital Twins and Data Spaces using Eclipse Tractus-X technology. You will step into the role of a digital product creator, crafting your own unique vehicle part and experiencing how data sharing across company boundaries works in a secure and collaborative way.

This challenge is designed for business users, not developers — no coding, no complex installations. Just creativity, curiosity, and a bit of AI help.

🧩 What You'll Learn

How to create digital parts using structured data (JSON)
Why structured data is key for future manufacturing collaboration
How to share your product with partners with TWO CLICK, using the Industry Core Hub
How to explore and consume digital twin data using tools like Postman

🛠️ The Tools

You’ll use:

✅ Industry Core Hub Web App (URL will be provided)
✅ AI Assistant like ChatGPT, Copilot, Claude, etc.
✅ A car in the workshop area for real-world inspiration
✅ API tool like Postman, Bruno, or Insomnia to explore digital twins

📦 STEP 1: Create Your Own Unique Catalog Part

🎯 Goal: Create a vehicle part in JSON format and register it in the Digital Twin Registry.

Open the Industry Core Hub and click on:
- "Create New Catalog Part"
A dialog will appear with a JSON template like this:

{
  "manufacturerPartId": "TX-4003",
  "name": "Example Part Name",
  "description": "Detailed description of the example part.",
  "category": "example-category",
  "materials": [
    {
      "name": "Aluminum",
      "share": 80
    },
    {
      "name": "Rubber",
      "share": 20
    }
  ],
  "bpns": "BPNS000000000ZZ",
  "width": {
    "value": 200,
    "unit": "mm"
  },
  "height": {
    "value": 100,
    "unit": "mm"
  },
  "length": {
    "value": 50,
    "unit": "mm"
  },
  "weight": {
    "value": 5,
    "unit": "kg"
  }
}

Open your favorite AI assistant (e.g. ChatGPT) and prompt it (you can change the material quantity):

"Generate a new vehicle part in the same JSON format below. Give it a unique name, a short technical description, and define at least 4 different materials with their share. Keep the structure the same."
Get inspired by the real cars around you — think brake discs, sensors, seats, handles, etc.
Make sure:
- You do not remove or add fields (keep the JSON structure the same).
- You only change the content (values).
- The BPNS represents a country of origin (e.g., BPNS00000DE00001 for Germany).
Paste your new JSON into the dialog and press "Create".

🎉 Boom! You just created a digital twin product in a live dataspace.

🔄 STEP 2: Share Your Part with a Partner

🎯 Goal: Share your product with another participant or simulated partner.

Go to the Partner View in the Industry Core Hub.
See your available partners.
- You can also add new partners, but remember: this UI is shared, so BPNL numbers must be unique.
Select your created part and click "Share".
Choose your partner and confirm.

✅ That’s it — behind the scenes, the backend has:

Checked if your Digital Twin Registry is reachable via the EDC Connector.
Created a Digital Twin with the IDTA AAS 3.0 Specification + CX-0002 Specifications
Added a Submodel (PartTypeInformation v1.0.0) (Industry Core Standard)
Set up EDC access control (based on configured policies)
Tracked sharing status

If any step fails, it can be resumed automatically.

All of this is powered by the Eclipse Tractus-X SDK, which developers are using to build reference implementations and future integrations into ERP and (e.g. IMDS systems).

It is easy for you to manage the information when the parts are in "Catalog" or "Type" level, you are able to see the information faster and it is easier to share. Also no "instance" twin is needed to be created always, it can be abstracted in the type.

🔍 STEP 3: Consume the Data You Shared (Using Postman or Any API Tool)

🎯 Goal: Discover and retrieve the data of your shared part using APIs.

Download the API walkthrough collection.
- Compatible with Postman, Bruno, or Insomnia.
Follow the steps in the collection on the walk though collections to:

[!IMPORTANT] The walk through collection will not require that you copy and paste stuff, just follow the steps in order please.

🔎 Search the catalog for available digital twin registries (AAS-REST).
✅ Agree to the default usage policy.
🔐 Request a token to access shared twins.
📄 Inspect the digital twin information.
📦 Locate the submodel, using the assetId found in the response.

Once you have the submodelProtocolBody, look for:
- "semanticId": "urn:bamm:io.catenax.part_type_information:1.0.0"
Make a second catalog call (filtered by this specific ID) to retrieve the PartTypeInformation submodel.

🤖 Bonus: What Happens in Future Releases?

In the upcoming R25.09 “Saturn” Release of Catena-X:

This entire workflow will become automated with one click.
You’ll be able to consume and integrate data directly into your systems via connectors.
Industry Core Hub will support use-case agnostic integrations, making it easier to scale and reuse across domains.

This means less manual work and more automation — exactly what Manufacturing-X is aiming for 🚀

🎓 Wrap-Up: Why This Matters

You just experienced the core loop of data spaces:

Data Ownership — You created your own data model.
Data Sovereignty — You controlled who received it.
Interoperability — You shared and consumed it across systems.

This is the future of open, collaborative, and secure manufacturing.

🧠 Got Questions?
Ask your facilitators! They're here to guide you.

🎯 Done with the challenge?
Explore more parts, or create a new one with different materials or dimensions.

🌐 Want to go further?
Check out the Eclipse Tractus-X SDK or learn how companies are integrating this with their ERP systems today.

Happy Engineering!