Exporting and Importing Labels and/or Access Profiles

Thinfinity® Workspace allows administrators to import and export Access Profiles and Labels using .CSV or .JSON files. This functionality helps streamline the management and deployment of configuration data across different environments.

The Import/Export feature is available to users with Web Manager permissions and to users who have Admin permissions inherited from a Label.

To activate the Admin permissions, go to the label editing panel, navigate to the Permissions section, and in the configuration box, select the user you want to grant permissions to. Then, check the Admin permissions box and save the changes.

For more information, refer to the following article. Users can perform the following actions:

• Exporting existing Access Profiles and Labels in .CSV or .JSON formats for backup or replication.

• Importing Profiles or Labels from external files to update or extend current configurations.

Import Requirements

When preparing files for import, make sure they meet the following conditions:

Object Type	Field(s) to Modify or Validate
Label	[Name] must be set to + if it is a new Label.
Access Profile	[Public Key] field must be left empty.
Access Profile	If the Access Profile includes permissions restricted to a specific user or group, those members must have credentials mapped with access to the target VM. The [Permissions] field must follow this format: L:Domain\UserName:[Access].

Important

Files that do not meet these criteria may result in partial imports or errors during processing.

CSV Sample File

Label Path,Name,Virtual Path,Enabled,Default,Visible,Kind,Address,Public Key,Permissions,Inherit Label Access Permissions,Label Permissions,Booking Limit,Booking Permission,Bookers,Program Mode,Program File Path Name,Program Arguments,Program Work Dir,Screen Resolution,Unicode Keyboard,Keyboard Layout,Root Path,Local Server
\Departments,+,,TRUE,FALSE,TRUE,LABEL,,,,TRUE,,0,,,,,,,,,,,
\Departments\HR,+,,TRUE,FALSE,TRUE,LABEL,,,,TRUE,,0,,,,,,,,,,,
\Departments\Finance,+,,TRUE,FALSE,TRUE,LABEL,,,,TRUE,,0,,,,,,,,,,,
\Departments\Engineering,+,,TRUE,FALSE,TRUE,LABEL,,,,TRUE,,0,,,,,,,,,,,
\Locations,+,,TRUE,FALSE,TRUE,LABEL,,,,TRUE,,0,,,,,,,,,,,
\Locations\New York,+,,TRUE,FALSE,TRUE,LABEL,,,,TRUE,,0,,,,,,,,,,,
\Locations\London,+,,TRUE,FALSE,TRUE,LABEL,,,,TRUE,,0,,,,,,,,,,,
\Projects,+,,TRUE,FALSE,TRUE,LABEL,,,,TRUE,,0,,,,,,,,,,,
\Projects\Alpha,+,,TRUE,FALSE,TRUE,LABEL,,,,TRUE,,0,,,,,,,,,,,
\Projects\Beta,+,,TRUE,FALSE,TRUE,LABEL,,,,TRUE,,0,,,,,,,,,,,
\Projects\Gamma,+,,TRUE,FALSE,TRUE,LABEL,,,,TRUE,,0,,,,,,,,,,,
\Desktops,HR-Workstation-01,HR-Workstation-01,TRUE,FALSE,TRUE,RDP,192.168.1.101,,,TRUE,,0,None,,,,,,FitToBrowser,TRUE,,,
\Desktops,Finance-Workstation-01,Finance-Workstation-01,TRUE,FALSE,TRUE,RDP,192.168.1.102,,,TRUE,,0,None,,,,,,FitToBrowser,TRUE,,,
\Desktops,Engineering-VM-01,Engineering-VM-01,TRUE,FALSE,TRUE,RDP,192.168.1.103,,,TRUE,,0,None,,,,,,FitToBrowser,TRUE,,,

Using the CSV template for import and export involves certain parameters, such as Permissions or Program Mode, that must be configured carefully.

For Permissions, the format that must be used to create a template and import it successfully is:

• For users: U:Domain\Username:[Access] — where [Access] specifies the type of permissions the user will have on the access profile.

• For groups: L:Domain\GroupName:[Access] — where [Access] specifies the type of permissions the group will have on the access profile.

Info

Use U: to specify which users will have permissions to use the access profile, and L: to specify groups in the CSV.

Program Mode is a useful parameter for RDP profiles, as it determines whether the profile will behave as a RemoteApp or as a full remote desktop. The parameter accepts three values:

• [Start a program]: indicates that the RDP session should run a specific application at startup without losing the features of a full Remote Desktop. In this case, the Program File Path Name parameter must be set to the path of the program to run. Example:

  scssCopyEdit%Programfiles(x86)%\Google\Chrome\Application\chrome.exe

• [RemoteApp]: configures the access profile as a RemoteApp. The Program File Path Name parameter must also be set.

• [empty]: if the parameter is left blank, the access profile will function as a normal remote desktop.

JSON Sample File

[
  {
    "labelPath": "\\Support Team",
    "name": "+",
    "virtualPath": "",
    "enabled": true,
    "default": false,
    "visible": true,
    "kind": "LABEL",
    "address": "",
    "publicKey": "",
    "permissions": "",
    "inheritLabelAccessPermissions": true,
    "labelPermissions": "L:DOMAIN\\SupportUser:True:[Access]",
    "bookingLimit": 0,
    "bookingBuffer": 0,
    "programMode": "",
    "programFilePathName": "",
    "programArguments": "",
    "programWorkDir": "",
    "screenResolution": "",
    "unicodeKeyboard": "",
    "keyboardLayout": "",
    "rootPath": "",
    "localServer": "",
    "hash": "00000000000000000000000000000001"
  },
  {
    "labelPath": "\\",
    "name": "Internal Help Portal",
    "virtualPath": "",
    "enabled": true,
    "default": false,
    "visible": true,
    "kind": "RDP",
    "address": "https://internal-help.company.com",
    "publicKey": "examplePublicKey123456",
    "permissions": "*",
    "inheritLabelAccessPermissions": true,
    "labelPermissions": "",
    "bookingLimit": 1,
    "bookingBuffer": 0,
    "programMode": "",
    "programFilePathName": "",
    "programArguments": "",
    "programWorkDir": "",
    "screenResolution": "",
    "unicodeKeyboard": "",
    "keyboardLayout": "",
    "rootPath": "",
    "localServer": "",
    "hash": "00000000000000000000000000000002"
  }
]

How to Export Profiles or Labels

1. Log into Thinfinity Workspace as a Web Manager.

2. On the home screen, click the Export icon (top right toolbar).

3. Choose your preferred format: JSON or CSV.

4. The system will download the current Access Profiles and Labels in the selected format.

How to Import Profiles or Labels

1. Log into Thinfinity Workspace as a Web Manager.

2. Click the Import icon (top right toolbar).

3. A file browser window will open. Select the .CSV or .JSON file you want to import.

4. Click Open.

5. The system will process the file and display a summary:

   • Successfully imported Access Profiles or Labels.

   • Any items that failed to import, along with error details.

6. Review the summary. If everything is correct, click Commit to apply the changes.

7. The new Access Profiles and Labels will now appear on the Workspace home page.