JSON-Importstrategien und Dateiformat

Beim Importieren von JSON-Dateien in Remote Desktop Manager sind hinsichtlich des Inhaltsformats einige Spezifikationen zu beachten.

Dateiinhalt

Einige Validierungen der Eintragseinstellungen befinden sich nicht in der Business-Schicht, sondern in den Eigenschaftsdialogen. Das bedeutet, dass der Importvorgang zu ungültigen Einträgen führen kann, die Fehler auslösen. Prüfen Sie die resultierenden Einträge sorgfältig.

Es gibt keine Liste aller unterstützten Felder für alle Eintragstypen, da Remote Desktop Manager eine offene Architektur verwendet und daher nicht einmal alle Eintragstypfelder kennt, die durch das Add-on-System von Devolutions bereitgestellt werden. Außerdem werden Standardwerte für Felder nicht serialisiert, das heißt, sie werden einfach aus der serialisierten Struktur ausgelassen.

Eine gute Methode, die Feldstruktur herauszufinden, besteht darin, einen Eintrag des gewünschten Typs zu erstellen, mit der rechten Maustaste darauf zu klicken und Clipboard – Copy auszuwählen, und den Inhalt dann in einem geeigneten Editor einzufügen. Alternativ vermittelt der Export eines bestehenden Eintrags im JSON-Format einen guten Eindruck des zu übernehmenden Formats.

Die Implementierung der Unterstützung für alle Felder hat ihren Preis. Der Importvorgang ist zeitaufwendig, da viele dynamische Feldzugriffe stattfinden. Ein umfangreicher Erstimport von Einträgen sollte in Stapel überschaubarer Größe aufgeteilt werden. Führen Sie Testläufe durch und passen Sie die Anzahl der Einträge an, um eine akzeptable Leistung zu erzielen.

Alle Einträge von Devolutions teilen einen grundlegenden Satz von Feldern; der Rest ist an die jeweilige Technologie gebunden, mit der die Schnittstelle besteht (RDP, SSH usw.). Einige Felder sind in Strukturen gruppiert, wie die Registerkarte Information. Diese Felder sind nur zugänglich, wenn der Strukturname als übergeordnetes Objekt angegeben wird, zum Beispiel „MetaInformation\OS“ oder „MetaInformation\PurchaseDate“.

Die JSON-Datei kann Devolutions-Variablen enthalten, die beim Speichern aufgelöst werden. Beispielsweise kann die Variable $HOST$ in Feldern wie Description, URL und Name verwendet werden. Sie wird durch den entsprechenden Wert ersetzt.

Nachfolgend finden Sie eine nicht abschließende Liste einiger relevanter Felder.

OPTION	BESCHREIBUNG
Host	Hostname des Geräts.
Name	Name des Eintrags.
ConnectionType	Token, das den Verbindungstyp darstellt. Am besten verwenden Sie die Methode Clipboard – Copy, um die zulässigen Werte zu erhalten. Wenn kein Verbindungstyp angegeben ist, wird standardmäßig RDP verwendet.
Group	Zielordner. Beachten Sie, dass, wenn der Importvorgang selbst einen Zielordner definiert hat, der hier aufgeführte Ordner unterhalb des Ordners aus dem Vorgang erstellt wird.
Description	Beschreibung des Eintrags.
Open (Embedded)	Boolescher Wert (true oder false), der angibt, die Sitzung eingebettet zu öffnen. Der Standardwert ist false, das heißt, es wird je nach Technologie der native Client verwendet (zum Beispiel MSTSC.EXE).
Username	Benutzername, der zum Öffnen einer Sitzung zum Gerät verwendet wird.
Domain	Domäne, die zum Öffnen einer Sitzung zum Gerät verwendet wird.
Password	Passwort, das zum Öffnen einer Sitzung zum Gerät verwendet wird. Bitte beachten Sie, dass dieses Feld verschlüsselt und beim Import in einem anderen Feld gespeichert wird.
SerialNumber	Seriennummer des Geräts.
ServiceTag	Service-Tag des Geräts.
PurchaseDate	Kaufdatum im ISO8601-Format (d. h. yyyy-mm-dd).

JSON-Dateibeispiele

Für einen Eintrag mit Anmeldeinformationen aus Benutzername und Passwort

{"Connections":
	[
		{
			"ConnectionType":"Credential",
			"Group":"My credentials folder",
			"Name":"User",
			"Credentials":
			{
				"Password":"MyNewPassword!@#",
				"UserName":"User"
			}
		}
	]
}

Für einen RDP-Eintrag mit verknüpften Anmeldeinformationen aus Benutzername und Passwort

{
  "Connections": [
    {
      "Url": "serverxyz.domain.loc",
      "UsesHardDrives": false,
      "ConnectionType": "RDPConfigured",
      "CredentialConnectionID": "d2fe9656-d3dd-4511-813e-b9bc4ab341c1",
      "CredentialConnectionSavedPath": "Bob",
      "Description": "Description of this RDP entry",
      "Name": "Server XYZ",
      "OpenEmbedded": true,
      "MetaInformation": {
        "PurchaseDate": "20XX-XX-XX",
        "ResourceText": "Resource",
        "SerialNumber": "AV123-456-7890",
        "ServiceTag": "AV7890"
      },
      "RDP": {}
    },
    {
      "ConnectionType": "Credential",
      "ID": "d2fe9656-d3dd-4511-813e-b9bc4ab341c1",
      "Name": "Bob",
      "Credentials": {
        "Domain": "domain",
        "Password": "ThisIsAPassword!@#",
        "UserName": "bob"
      },
    }
  ]
}

Siehe auch

• Devolutions Academy - Importing and Exporting Data