Paket auf Open ITSM Hub veröffentlichen

Open ITSM Hub ist ein offenes, versioniertes Verzeichnis: Jedes Paket lebt als JSON-Datei unter content/packages/ im GitHub-Repository. „Veröffentlichen" bedeutet also schlicht: eine JSON-Datei per Pull-Request hinzufügen. Es gibt keine Registrierung und kein separates Backend.

Weg 1: Direkt aus dem .sopm-Generator (empfohlen)

1. Öffnen Sie den .sopm-Generator und füllen Sie das Formular aus.
2. Klicken Sie im Abschnitt „Auf Open ITSM Hub veröffentlichen" auf Pull-Request vorbereiten.
3. GitHub öffnet die Ansicht „neue Datei" mit bereits vorausgefülltem Katalog-JSON.
4. Committen Sie in einen Branch und öffnen Sie den Pull-Request — fertig.

Der Generator übernimmt Name, Version, Vendor, Lizenz und — dank Kompatibilitäts-Analyse — automatisch alle passenden compatibility.systems-Einträge.

Weg 2: Aus einem bestehenden .sopm (CLI)

Wenn Sie bereits ein .sopm haben, konvertieren Sie es mit dem mitgelieferten Skript:

python data-scrape/sopm_to_catalogue.py pfad/zu/MyPackage.sopm --write

Das schreibt content/packages/<slug>.json. Anschließend committen und einen Pull-Request öffnen.

Der Katalog-Eintrag

Das erzeugte JSON folgt dem packages-Schema (siehe content.config.ts) und enthält u. a.:

{
  "basic_info": { "title": "MyPackage", "slug": "my-package", "summary": "..." },
  "provider": { "vendor_name": "Example GmbH", "vendor_type": "community" },
  "compatibility": {
    "systems": [
      { "system_id": "otobo", "system_name": "OTOBO", "supported_versions": ["11.0.x"] },
      { "system_id": "znuny", "system_name": "Znuny", "supported_versions": ["7.0.x"] }
    ]
  },
  "technical_details": { "latest_version": "1.0.0", "package_type": ".opm" }
}

Warum das gut ist

• Auffindbarkeit — Ihr Paket erscheint in den Fork-spezifischen Verzeichnissen (/otobo-plugins, /znuny-plugins, …) und in der Suche.
• Mehr Reichweite — cross-kompatible Pakete werden allen passenden Communities gezeigt.
• Transparenz — die Datenherkunft ist versioniert und nachvollziehbar.

Tipp: Prüfen Sie vorher mit dem Kompatibilitäts-Checker, welche Forks Sie deklarieren sollten.