File Version

Verwaltung von Datei-Versionen.

Seitenverzeichnis:

shd.file_version.read

Beschreibung

Gibt alle Datei-Version eines Objektes zurück.

Beispielaufruf

Lesen einer speziellen Datei-Version:

{
	"method":"shd.file_version.read",
	"params":{
		"apikey":"24174j3tqj",
		"id": 4
	},
	"version":"2.0",
    "id": 1
}

Beispielantwort

Eigenschaften einer Datei-Version:

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": [
        {
            "id": "2",
            "obj_id": "4",
            "obj_title": "guest ",
            "version_id": "4",
            "version_title": "MyFile",
            "version_description": "",
            "version_revision": "3",
            "physical_file_id": "4",
            "physical_file_name": "my_file.txt",
            "physical_file_filename": "4__1560014584__my_file.txt",
            "category_id": null,
            "category_title": null,
            "category_description": null
        }
    ]
}

Parameter

Parameter	Typ	Beschreibung	Version
id	int	Optional: ID des Objektes	ab Version 1.0

Rückgabewert

Eigenschaften einer Datei-Version.

Wert	Typ	Beschreibung	Version
id	int	ID der Datei	ab Version 1.0
obj_id	int	ID des zugewiesenen Objektes	ab Version 1.0
obj_title	string	Name des zugewiesenen Objektes	ab Version 1.0
version_id	int	ID der Version	ab Version 1.0
version_title	string	Titel der Version	ab Version 1.0
version_description	string	Beschreibung der Version	ab Version 1.0
version_revision	int	Jeweilige Revision des Datensatzes	ab Version 1.0
physical_file_id	int	ID der physischen Datei	ab Version 1.0
physical_file_name	string	Originaler Dateiname	ab Version 1.0
physical_file_filename	string	Name der Datei im System	ab Version 1.0
category_id	int	ID der Kategorie der Datei (siehe Hinweis am Ende dieses Abschnittes)	ab Version 1.0
category_title	string	Name der Kategorie der Datei	ab Version 1.0
category_description	string	Beschreibung der Kategorie der Datei	ab Version 1.0

Hinweis: Die verfügbaren Kategorien können über folgende Abfrage ermittelt werden:

{
	"method":"cmdb.dialog.read",
	"params":{
		"apikey":"24174j3tqj",
		"category":"C__CATS__FILE",
		"property":"file_category"
	},
	"version":"2.0",
    "id": 1
}

shd.file_version.versions

Beschreibung

Gibt alle Versionen einer Datei aus.

Beispielaufruf

{
	"method":"shd.file_version.versions",
	"params":{
		"apikey":"24174j3tqj",
		"id": 4
	},
	"version":"2.0",
    "id": 1
}

Parameter

Parameter	Typ	Beschreibung	Version
id	int	ID des Objektes	ab Version 1.0

Rückgabewert

Wert	Typ	Beschreibung	Version
id	int	ID der Version	ab Version 1.0
title	string	Titel der Version	ab Version 1.0
description	string	Beschreibung der Version	ab Version 1.0
revision	int	Jeweilige Revision des Datensatzes	ab Version 1.0
physical_file_id	int	ID der physischen Datei	ab Version 1.0
physical_file_name	string	Originaler Dateiname	ab Version 1.0
physical_file_filename	string	Name der Datei im System	ab Version 1.0

shd.file_version.create

Beschreibung

Legt eine neue Datei inklusive ihrer Datei-Version an.

Beispielaufruf

{
	"method":"shd.file_version.create",
	"params":{
		"apikey":"24174j3tqj",
		"data": {
			"obj_id": 4,
			"title": "MyFile",
            "file": "xyz...",
            "filename": "my_file.txt"
		}
	},
	"version":"2.0",
    "id": 1
}

Beispielantwort

{
    "id": 1,
    "jsonrpc": "2.0",
    "result": {
        "message": "file_version.create.success",
        "id": "2",
        "current_date": "2019-06-08"
    }
}

Parameter

Parameter	Typ	Beschreibung	Version
obj_id	int	ID des zugewiesenen Objektes	ab Version 1.0
title	string	Name der Datei	ab Version 1.0
file	string	Inhalt der Datei base64 kodiert	ab Version 1.0
filename	string	Dateiname der Datei	ab Version 1.0
category_id	int	Optional: ID der Kategorie (siehe Hinweis am Ende des ersten Abschnittes)	ab Version 1.0
description	string	Optional: Beschreibung der Datei	ab Version 1.0

Rückgabewert

Wert	Typ	Version
current_date	string	ab Version 1.0
id	int	ab Version 1.0
message	string	ab Version 1.0

shd.file_version.update

Beschreibung

Aktualisiert eine bestehende Datei-Version.

Beispielaufruf

{
	"method":"shd.file_version.update",
	"params":{
		"apikey":"24174j3tqj",
		"id":4,
		"data": {
			"title": "NewFile"
		}
	},
	"version":"2.0",
    "id": 1
}

Parameter

Parameter	Typ	Beschreibung	Version
id	int	ID der Version	ab Version 1.0
title	string	Name der Datei	ab Version 1.0
description	string	Beschreibung der Datei	ab Version 1.0

Rückgabewert

Wert	Typ	Version
current_date	string	ab Version 1.0
id	int	ab Version 1.0
message	string	ab Version 1.0

shd.file_version.delete

Beschreibung

Löscht eine bestehende Datei inklusive ihrer Datei-Version.

Beispielaufruf

{
	"method":"shd.file_version.delete",
	"params":{
		"apikey":"24174j3tqj",
		"id":4
	},
	"version":"2.0",
    "id": 1
}

Parameter

Parameter	Typ	Beschreibung	Version
id	int	ID der zu löschenden Datei-Version	ab Version 1.0

Rückgabewert

Wert	Typ	Version
current_date	string	ab Version 1.0
id	int	ab Version 1.0
message	string	ab Version 1.0