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 accessible to users with Web Manager permissions and supports the following use cases:

• 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 profile includes Permissions restricted by other Access Profiles, those must exist on the target VM. Otherwise, you must manually edit the [Permissions] field before import.

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,,,

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.