Dateien und Bilder in i-doit verwalten

Dateien hochladen und verknüpfen

Dateien werden in i-doit als eigene Objekte vom Typ Dateien verwaltet:

1. Ein neues Objekt vom Typ Dateien erstellen
2. In der Kategorie Datei-Versionen die Datei hochladen
3. Das Datei-Objekt über die Kategorie Dateizuweisung mit anderen Objekten verknüpfen

Alternativ können Dateien direkt in der Kategorie Dateizuweisung eines Objekts hochgeladen werden — i-doit erstellt das Datei-Objekt automatisch im Hintergrund.

Jede hochgeladene Datei zählt als eigenes Objekt und wird bei der Lizenzierung berücksichtigt.

Infrastrukturbilder

Infrastrukturbilder (z.B. Fotos von Serverschränken, Gebäudepläne) werden über die Kategorie Bilder verwaltet:

1. Die Kategorie Bilder muss dem Objekttyp zugewiesen sein (Verwaltung > Datenstruktur > Objekttyp-Konfiguration)
2. Im Objekt die Kategorie Bilder öffnen
3. Bilder hochladen

Die Bilder werden Base64-kodiert in der Datenbank gespeichert.

Dateien in der Listenansicht

In der Listenansicht von Datei-Objekten werden standardmäßig nicht alle Datei-Attribute als Spalten angeboten. Für detaillierte Dateiinformationen empfiehlt es sich, einen Report zu erstellen, der die gewünschten Datei-Attribute enthält.

Dateien per API hochladen (Base64)

Über die JSON-RPC API können Dateien programmatisch hochgeladen werden. Der Upload erfolgt in zwei Schritten:

Schritt 1: Datei-Objekt erstellen:

{
    "jsonrpc": "2.0",
    "method": "cmdb.object.create",
    "params": {
        "type": "C__OBJTYPE__FILE",
        "title": "Betriebshandbuch.pdf",
        "apikey": "ihr-api-key"
    },
    "id": 1
}

Schritt 2: Dateiinhalt Base64-kodiert hochladen:

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.create",
    "params": {
        "objID": 1234,
        "catgID": "C__CMDB__SUBCAT__FILE_VERSIONS",
        "data": {
            "file_content": "<Base64-kodierter Dateiinhalt>",
            "file_physical": "betriebshandbuch.pdf",
            "file_title": "Betriebshandbuch",
            "version_description": "Erstversion"
        },
        "apikey": "ihr-api-key"
    },
    "id": 2
}

Schritt 3: Datei mit einem Objekt verknüpfen:

{
    "jsonrpc": "2.0",
    "method": "cmdb.category.create",
    "params": {
        "objID": 5678,
        "catgID": "C__CATG__FILE",
        "data": {
            "file": 1234
        },
        "apikey": "ihr-api-key"
    },
    "id": 3
}

Dabei ist 1234 die ID des Datei-Objekts und 5678 die ID des Ziel-Objekts (z.B. Server).

Häufige Fragen

Kann ich Dateien ohne Datei-Objekt speichern? Nein. Jede Datei in i-doit ist ein eigenständiges Objekt. Dies ermöglicht Versionierung, Berechtigungen und Verknüpfungen.

Werden Dateien bei der Lizenz mitgezählt? Ja. Datei-Objekte zählen zur Gesamtanzahl der Objekte.

Ausführliche Dokumentation: Dateien hochladen und verknüpfen in der Knowledge Base