Stratégies d'importation JSON et format de fichier

Lors de l'importation de fichiers JSON dans Remote Desktop Manager, certaines spécifications doivent être respectées concernant le format du contenu.

Contenu du fichier

Certaines validations des paramètres d'entrée ne se trouvent pas dans la couche métier, mais plutôt dans les boîtes de dialogue de propriétés. Cela signifie que l'utilisation du processus d'importation peut produire des entrées non valides qui déclenchent des erreurs. Validez soigneusement les entrées résultantes.

Il n'existe pas de liste complète de tous les champs pris en charge pour tous les types d'entrées, car Remote Desktop Manager utilise une architecture ouverte et n'est donc pas même informé de tous les champs de types d'entrées fournis par le système de modules complémentaires de Devolutions. De plus, les valeurs par défaut des champs ne sont pas sérialisées, ce qui signifie qu'elles sont simplement omises de la structure sérialisée.

Une bonne méthode pour découvrir la structure des champs consiste à créer une entrée du type souhaité, à faire un clic droit dessus et à sélectionner Presse-papiers – Copier, puis à coller le contenu dans un éditeur approprié. Alternativement, l'exportation d'une entrée existante au format JSON donne une bonne idée du format à adopter.

La mise en œuvre de la prise en charge de tous les champs a un coût. Le processus d'importation est chronophage en raison de tous les accès dynamiques aux champs qui s'y produisent. Une importation initiale massive d'entrées doit être divisée en lots de tailles gérables. Effectuez des essais et ajustez le nombre d'entrées pour obtenir des performances acceptables.

Toutes les entrées de Devolutions partagent un ensemble de champs de base ; le reste est lié à la technologie spécifique avec laquelle on interagit (RDP, SSH, etc.). Certains champs sont regroupés dans des structures, comme l'onglet Informations. Ces champs ne sont accessibles qu'en fournissant le nom de la structure comme objet parent, par exemple, « MetaInformation\OS » ou « MetaInformation\PurchaseDate ».

Le fichier JSON peut contenir des variables Devolutions, qui sont résolues lors de l'enregistrement. Par exemple, la variable $HOST$ peut être utilisée dans des champs tels que Description, URL et Nom. Elle sera remplacée par la valeur correspondante.

Voici une liste non exhaustive de quelques champs pertinents.

OPTION	DESCRIPTION
Host	Nom d'hôte du dispositif.
Name	Nom de l'entrée.
ConnectionType	Jeton représentant le type de connexion. Il est préférable d'utiliser la méthode Presse-papiers – Copier pour obtenir les valeurs acceptables. Si aucun type de connexion n'est spécifié, RDP sera utilisé par défaut.
Group	Dossier de destination. Notez que si le processus d'importation lui-même a défini un dossier de destination, le dossier indiqué ici sera créé sous celui du processus.
Description	Description de l'entrée.
Open (Embedded)	Valeur booléenne (true ou false) indiquant d'ouvrir la session en mode intégré. La valeur par défaut est false, ce qui signifie que le client natif sera utilisé selon la technologie (MSTSC.EXE, par exemple).
Username	Nom d'utilisateur utilisé pour ouvrir une session sur le dispositif.
Domain	Domaine utilisé pour ouvrir une session sur le dispositif.
Password	Mot de passe utilisé pour ouvrir une session sur le dispositif. Veuillez noter que ce champ est chiffré et stocké dans un autre champ lors de l'importation.
SerialNumber	Numéro de série du dispositif.
ServiceTag	Étiquette de service du dispositif.
PurchaseDate	Date d'achat au format ISO8601 (c.-à-d., aaaa-mm-jj).

Exemples de fichiers JSON

Pour une entrée d'identifiants avec nom d'utilisateur et mot de passe

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

Pour une entrée RDP avec des identifiants de nom d'utilisateur et mot de passe liés

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

Voir aussi

• Devolutions Academy - Importing and Exporting Data