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:
Indentation
Presentation Order
Last 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
ROOT
node (set as aDummy
node).- For
Real
nodes, always fill in theDescription
,Description 2
, andSearch Description
fields.- 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.