Create Aspect Models

As the modeling expert in your team, you will create the Aspect Models. The easy way is to create them in the right namespace from scratch.
Therefore, first of all ask the tenant owner to tell you the "root" namespace reserved.

  1. In your Aspect Model Editor, set up the workspace and create and validate your Aspect Models.
    For support with the Aspect Model Editor, refer to Aspect Model Editor documentationexternallink 20.

  2. Export your Aspect Models from the Aspect Model Editor and import them into the Aspect Model Catalog.

    Once you are done with modeling and want to share the models with your team, proceed as follows:

    1. Export the namespace as a ZIP archive.

      • By default, the archive is named package.zip.

      • Make sure it does not exceed 10 MB, as the UI is currently configured with this limit.

    2. Open the Aspect Model Catalog UI

      https://catalog.bosch-semantic-stack.com/?tenant=<your-tenant-id>

    3. Click the blue + button in the upper right corner and follow all steps in the dialog.
      Upon success, you can see the uploaded Aspect Model.

Create an Aspect Model in the Aspect Model Editor

  1. Click File.

  2. Click Export Package.
    aspect model editor export package

  3. Select the checkbox of the namespace to be exported.

  4. Click Next.
    aspect model editor export namespace

  5. Click Export.
    aspect model editor validation result export

  6. Select a file path to save the ZIP file.

Create an Aspect Model without the Aspect Model Editor

You can also prepare a namespace ZIP package manually without using the Aspect Model Editor. This is achieved by respecting the requirements for namespaces and their correct folder structure.

  1. Create a namespace folder and name it using the namespace name.

  2. Create a sub-folder for every version your aspect will have.
    This means that whenever you create a new version, you will also need to create a new sub-folder.

  3. Create your aspect in TTL format using your preferred text editor.

  4. Put the aspect file inside the version sub-folder.

  5. Compress your main namespace folder(s) into a ZIP file.
    → Your namespace’s folder structure looks similar to the example shown below and is ready to be uploaded to the Aspect Model Catalog.

    ZIP folder/
    ├─ namespace/
    │ ├─ 1.0.0/
    │ │ ├─ AspectModel.ttl
    │ ├─ 1.1.0/
    │ │ ├─ AspectModel.ttl
    │ ├─ 2.0.0/
    │ │ ├─ AspectModel.ttl
    ├─ dependency namespace/
    │ ├─ 1.0.0/
    │ │ ├─ AspectModel.ttl
    │ ├─ 2.0.0/
    │ │ ├─ AspectModel.ttl
    ├─ dependency namespace/
    │ ├─ 1.0.0/
    │ │ ├─ AspectModel.ttl

Upload an Aspect Model in the Aspect Model Catalog UI

  1. Open the Aspect Model Catalog.

    https://catalog.bosch-semantic-stack.com/?tenant=<your-tenant-id>

  2. Click the blue + to upload a package.

    aspect model catalog namespace upload

  3. Navigate to the ZIP archive that you want to add or drag and drop it.

    aspect model catalog namespace upload new package

  4. Upon success, the Aspect Model Catalog shows a green notification.

    aspect model catalog namespace upload new package succeed

→ Congratulations, all team members of your tenant will now be able to see and work with your Aspect Models.