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 dialogues de propriétés. Cela signifie que le processus d'importation peut produire des entrées invalides qui déclenchent des erreurs. Validez soigneusement les entrées obtenues.

Il n'existe pas de liste de tous les champs pris en charge pour tous les types d'entrées, car Remote Desktop Manager utilise une architecture ouverte et n'a donc même pas connaissance de tous les champs de types d'entrées fournis par le système d'extensions 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é, à cliquer dessus avec le bouton droit et à sélectionner Presse-papiers – Copier, puis à coller le contenu dans un éditeur approprié. Autrement, l'exportation d'une entrée existante au format JSON donne une bonne idée du format à adopter.

La prise en charge de tous les champs a un coût. Le processus d'importation est long en raison de tous les accès dynamiques aux champs qui ont lieu. Une importation initiale massive d'entrées devrait être séparée en lots de taille gérable. Effectuez des essais et ajustez le nombre d'entrées pour obtenir une performance acceptable.

Toutes les entrées de Devolutions partagent un ensemble de base de champs; le reste est lié à la technologie spécifique avec laquelle l'interface est établie (RDP, SSH, etc.). Certains champs sont regroupés dans des structures, comme l'onglet Informations. Ces champs sont accessibles uniquement 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 de l'appareil.
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 définit un dossier de destination, le dossier indiqué ici serait créé sous celui du processus.
Description	Description de l'entrée.
Open (Embedded)	Valeur booléenne (true ou false) qui indique 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 vers l'appareil.
Domain	Domaine utilisé pour ouvrir une session vers l'appareil.
Password	Mot de passe utilisé pour ouvrir une session vers l'appareil. Veuillez noter que ce champ est chiffré et stocké dans un autre champ lors de son importation.
SerialNumber	Numéro de série de l'appareil.
ServiceTag	Étiquette de service de l'appareil.
PurchaseDate	Date d'achat dans un 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 liés de nom d'utilisateur et de mot de passe

{
  "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 - Importation et exportation de données