Skip to content

Commit 565c875

Browse files
authored
Merge pull request #744 from ritza-co/898-custom
898: update page, custom-column-views
2 parents 5cecaf9 + a64f717 commit 565c875

11 files changed

Lines changed: 71 additions & 11 deletions

docs/administration/custom-column-views.mdx

Lines changed: 71 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -3,24 +3,84 @@ title: "Custom Column Views"
33
sidebar_position: 6
44
---
55

6-
### Customs Column Views in Device42
6+
import ThemedImage from '@theme/ThemedImage'
7+
import useBaseUrl from '@docusaurus/useBaseUrl'
78

8-
You can set custom column views in Device42, allowing you to chooose which columns you see in most list views. The objects with customizable list view pages include: Application Components, Assets, Blade Devices, Buildings, Certificates, Cluster Devices, Customers, DNS Records, DNS Zones, Departments, Devices, Device Hardware Models, Other Devices, End Users, IP Addresses, IP Nat/Maps, MAC Addresses, Operating Systems, PDUs, Purchases, QR/Barcodes, Racks, Rooms, Services, Service Instances, Service Ports, Service Schedules, Software Components, Software In Use, Software Licensing Models, Subnets, Switch Ports, Telco Circuits, Transfers, Unknown Devices, VLANs, VRF Groups, Vendors, and Virtual Devices.
9+
## Customs Column Views in Device42
910

10-
To add a custom column view, click the drop down on the right above the column headers on a list view page and select "Add column list..." ![List view drop down](/assets/images/custom-columns-001.png)
11+
You can customize the column views of all list pages in Device42. You can create and save multiple custom column views for each list page, then set a global default view or set specific custom column views as the default views for particular users.
1112

12-
In the pop up screen, name the column list, select the object category that you are viewing (ie, choose Device for the Device list page), and then click the "Add another Selected Column" link and choose your columns.
13+
To add a custom column view, navigate to a list page, such as **Resources > Compute > All Devices**.
1314

14-
![List view drop down](/assets/images/custom-columns-002.png)
15+
Click the **gear icon** on the far right of the screen - to right of the current view name. The default view is **System Column List**.
1516

16-
You can reorder the columns as well or delete them. If you would like to make this new list view the default, select the "Make this list the default column list" option.
1717

18-
To choose between column lists, simply use the same drop down from the list view page that you used to create the list view, and choose the column view you would like to see.
18+
<ThemedImage
19+
alt="Gear icon on Devices list page"
20+
sources={{
21+
light: useBaseUrl('/assets/images/custom-column-views/gear-icon-light.png'),
22+
dark: useBaseUrl('/assets/images/custom-column-views/gear-icon-dark.png'),
23+
}}
24+
/>
1925

20-
### Important Custom Column Layout Information
26+
- In the pop-up screen, name the new view (1), click the **Table Columns** dropdown, and select (2) and deselect the columns you want.
2127

22-
Always ensure, when creating custom column layouts that the first column is a text column. By design, the first column on a given pages view contains the hyperlink to the Device or Asset (CI's) details. If, for example, 'Status' or 'In Service' is set as the first column, the small green CheckMarks or Red 'minus' signs become the hyperlink, which can prove very confusing.
28+
<ThemedImage
29+
alt="Table Columns dropdown"
30+
sources={{
31+
light: useBaseUrl('/assets/images/custom-column-views/table-columns-light.png'),
32+
dark: useBaseUrl('/assets/images/custom-column-views/table-columns-dark.png'),
33+
}}
34+
/>
2335

24-
Always ensure the first column contains text. See this example:
36+
- You can reorder the columns by clicking and dragging column headings and moving them to a new position. Adjust column widths by dragging the column edges, and save the desired column widths to the view by checking the **Custom Column Sizes** checkbox.
2537

26-
![Ensure 1st Column Contains Text](/assets/images/ensure_1st_col_text.png)
38+
<ThemedImage
39+
alt="Reorder columns"
40+
sources={{
41+
light: useBaseUrl('/assets/images/custom-column-views/reorder-columns-light.png'),
42+
dark: useBaseUrl('/assets/images/custom-column-views/reorder-columns-dark.png'),
43+
}}
44+
/>
45+
46+
- Check the **Custom Filters** checkbox to save the currently configured filters. You can filter the records for this view using the basic dropdown filters or the **Advanced** search feature for more fine-grained control.
47+
48+
<ThemedImage
49+
alt="Type filter dropdown"
50+
sources={{
51+
light: useBaseUrl('/assets/images/custom-column-views/basic-type-filter-light.png'),
52+
dark: useBaseUrl('/assets/images/custom-column-views/basic-type-filter-dark.png'),
53+
}}
54+
/>
55+
56+
- Clicking the **Advanced** button reveals a text box where you can query specific field values using conditionals and equality selectors. See the [Advanced Search Feature page](getstarted/advanced-search-feature.mdx) for details.
57+
58+
<ThemedImage
59+
alt="Advanced filter text box"
60+
sources={{
61+
light: useBaseUrl('/assets/images/custom-column-views/advanced-filter-light.png'),
62+
dark: useBaseUrl('/assets/images/custom-column-views/advanced-filter-dark.png'),
63+
}}
64+
/>
65+
66+
- Click the **Save As New** button to return to the list page with the new view applied.
67+
68+
## Customizable List Pages
69+
70+
Customizable column views are available on all list pages, including:
71+
72+
| | | |
73+
|-------------------------|-------------------------|---------------------------|
74+
| Application Components | IP Addresses | Software In Use |
75+
| Assets | IP Nat/Maps | Software Licensing Models |
76+
| Blade Devices | MAC Addresses | Subnets |
77+
| Buildings | Operating Systems | Switch Ports |
78+
| Certificates | Other Devices | Telco Circuits |
79+
| Cluster Devices | PDUs | Transfers |
80+
| Customers | Purchases | Unknown Devices |
81+
| Departments | QR/Barcodes | VLANs |
82+
| Device Hardware Models | Racks | VRF Groups |
83+
| Devices | Rooms | Vendors |
84+
| DNS Records | Service Instances | Virtual Devices |
85+
| DNS Zones | Service Ports | |
86+
| End Users | Service Schedules | |
66.6 KB
Loading
60.9 KB
Loading
82.5 KB
Loading
83.1 KB
Loading
55.1 KB
Loading
53.3 KB
Loading
78.4 KB
Loading
81.4 KB
Loading
82.3 KB
Loading

0 commit comments

Comments
 (0)