Importing treeviews
Importing Treeviews
Importing treeviews using a configuration package allows you to efficiently build complex hierarchical structures from Excel files. This method is especially useful when setting up multiple treeviews (e.g., for customers, vendors, items, etc.) in a new or existing environment.
⚠️ Important:
- Prior knowledge of the Configuration Package tool (also known as RapidStart) is required.
- Always test your import in a sandbox environment before applying it to a live system.
- Importing treeviews into a fresh database requires a clear understanding of how node relationships are structured.
Step 1: Create the Configuration Package
- Navigate to the Configuration Packages page.
- Create a new package and include Table 8119062 (Treeview table).
- Exclude the following fields from configuration package:
IndentationPresentation OrderLast Modified DateTime
- Export the package as an Excel file.
💡 If you’ve already created multiple treeviews (e.g., Customer, Item, Location), all records will be included in the same Excel file.
To isolate specific treeview data, apply a filter on the Treeview Type field before exporting.
Step 2: Edit the Excel File
Update the exported Excel file with the appropriate data. Below is a description of the key fields:
| Field | Description |
|---|---|
| Treeview Type | Select the entity type: Customer, Vendor, Item, Location, or SalesPerson/Purchaser. |
| Node Type | Choose Real for nodes linked to existing entities, or Dummy for virtual grouping nodes. |
| Node Code | For Real nodes, use the existing entity code. For Dummy nodes, create a custom code. |
| Parent Code | Code of the parent node. All nodes (except the ROOT) must have a parent. |
| Description | Description of the node (e.g., Name). |
| Description 2 | Additional description (e.g., City). |
| Search Description | Search-friendly name (e.g., Search Name). |
💡 Tip:
- Each treeview must include one
ROOTnode (set as aDummynode).- For
Realnodes, always fill in theDescription,Description 2, andSearch Descriptionfields.- For customers and vendors, these fields correspond to Name, City, and Search Name in the Treeview UI.
Step 3: Import the Configuration Package
Import the configuration package and apply. After opening the Treeview, click on the Refresh action to see the whole structure being adjusted.