Strategie di importazione JSON e formato del file

Quando si importano file JSON in Remote Desktop Manager, ci sono alcune specifiche da seguire riguardo al formato del contenuto.

Contenuto del file

Alcune convalide sulle impostazioni delle voci non si trovano nel livello business, bensì nelle finestre di dialogo delle proprietà. Ciò significa che l'uso del processo di importazione può generare voci non valide che provocano errori. Convalidi attentamente le voci risultanti.

Non esiste un elenco di tutti i campi supportati per tutti i tipi di voce, perché Remote Desktop Manager utilizza un'architettura aperta e pertanto non è nemmeno a conoscenza di tutti i campi dei tipi di voce forniti dal sistema di add-on di Devolutions. Inoltre, i valori predefiniti dei campi non vengono serializzati, il che significa che sono semplicemente esclusi dalla struttura serializzata.

Un buon metodo per scoprire la struttura dei campi consiste nel creare una voce del tipo desiderato, farci clic con il pulsante destro del mouse e selezionare Clipboard – Copy, quindi incollare il contenuto in un editor adatto. In alternativa, esportare una voce esistente in formato JSON dà una buona idea del formato da adottare.

Implementare il supporto per tutti i campi ha un costo. Il processo di importazione richiede tempo a causa di tutti gli accessi dinamici ai campi che vengono effettuati. Un'importazione iniziale massiva di voci dovrebbe essere suddivisa in lotti di dimensioni gestibili. Esegua delle prove e regoli il numero di voci per ottenere prestazioni accettabili.

Tutte le voci di Devolutions condividono un insieme di campi di base; il resto è legato alla tecnologia specifica con cui si interfacciano (RDP, SSH, ecc.). Alcuni campi sono raggruppati in strutture, come la scheda Information. Tali campi sono accessibili solo indicando il nome della struttura come oggetto padre, ad esempio "MetaInformation\OS" o "MetaInformation\PurchaseDate".

Il file JSON può contenere variabili Devolutions, che vengono risolte al momento del salvataggio. Ad esempio, la variabile $HOST$ può essere utilizzata in campi come Description, URL e Name. Verrà sostituita dal valore corrispondente.

Di seguito è riportato un elenco non esaustivo di alcuni campi rilevanti.

OPZIONE	DESCRIZIONE
Host	Nome host del dispositivo.
Name	Nome della voce.
ConnectionType	Token che rappresenta il tipo di connessione. È preferibile utilizzare il metodo Clipboard – Copy per ottenere i valori accettabili. Se non viene specificato alcun tipo di connessione, verrà utilizzato RDP per impostazione predefinita.
Group	Cartella di destinazione. Si noti che se il processo di importazione stesso ha definito una cartella di destinazione, la cartella qui indicata verrà creata sotto quella del processo.
Description	Descrizione della voce.
Open (Embedded)	Valore booleano (true o false) che indica di aprire la sessione in modalità incorporata. Il valore predefinito è false, il che significa che verrà utilizzato il client nativo a seconda della tecnologia (MSTSC.EXE, ad esempio).
Username	Nome utente utilizzato per aprire una sessione verso il dispositivo.
Domain	Dominio utilizzato per aprire una sessione verso il dispositivo.
Password	Password utilizzata per aprire una sessione verso il dispositivo. Si noti che questo campo è crittografato e memorizzato in un altro campo al momento dell'importazione.
SerialNumber	Numero di serie del dispositivo.
ServiceTag	Service tag del dispositivo.
PurchaseDate	Data di acquisto in formato ISO8601 (ovvero, yyyy-mm-dd).

Esempi di file JSON

Per una voce di credenziali nome utente e password

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

Per una voce RDP con credenziali nome utente e password collegate

{
  "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"
      },
    }
  ]
}

Vedere anche

• Devolutions Academy - Importing and Exporting Data