Estrategias de importación JSON y formato de fichero

Al importar ficheros JSON en Remote Desktop Manager, hay que seguir ciertas especificaciones en cuanto al formato del contenido.

Contenido del fichero

Algunas validaciones de la configuración de las entradas no se realizan en la capa de negocio, sino en los cuadros de diálogo de propiedades. Esto significa que el proceso de importación puede generar entradas no válidas que provoquen errores. Valide cuidadosamente las entradas resultantes.

No existe una lista de todos los campos admitidos para todos los tipos de entrada, ya que Remote Desktop Manager utiliza una arquitectura abierta y, por lo tanto, ni siquiera conoce todos los campos de tipos de entrada que proporciona el sistema de complementos de Devolutions. Además, los valores predeterminados de los campos no se serializan, lo que significa que simplemente se omiten en la estructura serializada.

Un buen método para averiguar la estructura de los campos consiste en crear una entrada del tipo deseado, hacer clic derecho sobre ella y seleccionar Portapapeles – Copiar, y luego pegar el contenido en un editor adecuado. Como alternativa, exportar una entrada existente en formato JSON da una buena idea del formato que se debe adoptar.

Implementar la compatibilidad con todos los campos tiene un coste. El proceso de importación consume mucho tiempo debido a todos los accesos dinámicos a campos que se producen. Una importación inicial masiva de entradas debería dividirse en lotes de tamaños manejables. Realice pruebas y ajuste el número de entradas para lograr un rendimiento aceptable.

Todas las entradas de Devolutions comparten un conjunto básico de campos; el resto está vinculado a la tecnología específica con la que se interactúa (RDP, SSH, etc.). Algunos campos se agrupan en estructuras, como la pestaña Información. Esos campos solo son accesibles al proporcionar el nombre de la estructura como objeto padre, por ejemplo, "MetaInformation\OS" o "MetaInformation\PurchaseDate".

El fichero JSON puede contener variables de Devolutions, que se resuelven al guardar. Por ejemplo, la variable $HOST$ puede utilizarse en campos como Descripción, URL y Nombre. Se sustituirá por el valor correspondiente.

A continuación se muestra una lista no exhaustiva de algunos campos relevantes.

OPCIÓN	DESCRIPCIÓN
Host	Nombre de host del dispositivo.
Name	Nombre de la entrada.
ConnectionType	Token que representa el tipo de conexión. Es preferible utilizar el método Portapapeles – Copiar para obtener los valores aceptables. Si no se especifica ningún tipo de conexión, se utilizará RDP de forma predeterminada.
Group	Carpeta de destino. Tenga en cuenta que si el propio proceso de importación definió una carpeta de destino, la carpeta indicada aquí se crearía debajo de la del proceso.
Description	Descripción de la entrada.
Open (Embedded)	Valor booleano (true o false) que indica que la sesión debe abrirse incrustada. El valor predeterminado es false, lo que significa que se utilizará el cliente nativo según la tecnología (MSTSC.EXE, por ejemplo).
Username	Nombre de usuario utilizado para abrir una sesión en el dispositivo.
Domain	Dominio utilizado para abrir una sesión en el dispositivo.
Password	Contraseña utilizada para abrir una sesión en el dispositivo. Tenga en cuenta que este campo se cifra y se almacena en otro campo al importarse.
SerialNumber	Número de serie del dispositivo.
ServiceTag	Etiqueta de servicio del dispositivo.
PurchaseDate	Fecha de compra en formato ISO8601 (es decir, aaaa-mm-dd).

Ejemplos de ficheros JSON

Para una entrada de credenciales de nombre de usuario y contraseña

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

Para una entrada RDP con credenciales de nombre de usuario y contraseña vinculadas

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

Véase también

• Devolutions Academy - Importing and Exporting Data