Difference between revisions of "Configuring List Views"

From SmartWiki
Jump to: navigation, search
 
(62 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{ListViewHeader}}
+
#REDIRECT [[List View Overview#Configuring List Views]]
 
 
==Defining a List View==
 
There are two types of List Views: System Views and Personal Views.<br>
 
[[File:Newlistviews.PNG|link=|300px]]
 
* ''System Views'' belong to a specific [[role]]. All users in that role will have the option to select this List View. <!--There can only be one System View assigned to each role. [CHANGED PER TICKET 18863 - List View Enhancements WITH MARCH 14, 2013 UPGRADE]--> Multiple System Views can be defined for each role.
 
* ''Personal Views'' are only visible to the user who creates them. Multiple Personal Views can be defined for each user.
 
 
 
===System Views===
 
 
 
* When you click on the "New" button in the System View section, you will be prompted to select the role to which the System View pertains.
 
* Select the appropriate role, enter a name for the list view and click "OK."
 
* You will now see four tabs in the right-hand frame: Properties, Columns, Sort Order and Export.
 
 
 
===Personal Views===
 
 
 
* When you click on the "New" button in the Personal View section, the only difference from System Views will be that you will not have the option to select a role.
 
* Enter a name for the list view and click "OK."
 
* You will now see four tabs in the right-hand frame: Properties, Columns, Sort Order and Export.
 
 
 
 
 
==The Properties Tab==
 
[[Image:Listviewspropertiestab.PNG|link=]]
 
* '''View Name''' - The name of the list view is editable. Give your list view a distinctive name.
 
* '''Display Order''' - Enter a [[display order]]. This will define which list view will be the default for users who possess multiple roles. List views with lower [[display order]]s will be displayed before those with higher display orders.
 
* '''Open Button Label''' - The default value for the "Open Button Label" is "Open." Changing this value will change the caption on the button used to access a specific record in the list view.
 
* '''Role''' - The [[Role]] dropdown will be available only for System Views (see above). The list view can be made available for all roles by selecting "All."
 
* '''Other Options''' - Checking the "Open in edit mode" option will mean that when records are opened, they will default to edit mode as opposed to view mode.
 
 
 
 
 
==The Columns Tab==
 
* The Columns tab is where the [[standard fields|standard]] and [[custom fields]] that you want to be displayed in your list view are defined.
 
* When you first click on this tab, you will see the default four blank columns.
 
<BR><br>
 
[[Image:Listviewblankcolumnsshort.PNG|link=]]
 
 
 
 
 
* When you click into a cell, you will see the configuration options below. Note that the '''Available Field List''' will display at the right. [[Standard Fields|Standard]] fields are shown first, followed by the [[Custom Fields|custom]] fields available.
 
 
 
[[Image:Listviewselectingfields.png|link=]]
 
 
 
 
 
* You can quickly click through the cells and use the Available Field List to choose the fields you wish to display.
 
* When you select a field from the Available Field List, the '''Content Template''' will be populated with a SmartSimple [[variable]] that references that field.
 
* In the example below, the [[Status]] field has just been selected for Column 4.
 
 
 
[[Image:Listviewfieldsselected.PNG|link=]]
 
 
 
 
 
* Note that multiple fields can be selected for each column in the list view.
 
* First, click into an Active Cell and click on the fields you want to display in the column in the Available Field List.
 
* Then, add extra characters, such as parentheses and explanatory text as in the example below.
 
 
 
[[Image:Listviewmultfieldsselected.PNG|link=]]
 
 
 
* HTML tags can also be employed, surrounding the variable(s) in the Content Template, to add formatting to the column values.
 
* An example would be entering ''<nowiki>@Requested Amount@ <b>(@% Foundation Funding@ of Foundation Funding)</b></nowiki>'' into the Content Template, which would result in Requested Amount values in the list view displaying in the format: $25,000.00 '''(0% of Foundation Funding)'''
 
 
 
 
 
==Allowing users to click into the records from the list view===
 
* What's missing from the "Sample List View" example above is a way for the user to click into the list view.
 
* The Open button can be added to any column in the list view, by selecting the "
 
 
 
 
 
===Definition of Options Available on the Columns Tab===
 
* '''Number of Columns''' - This is the total number of columns visible in your list view. You can add or subtract the columns by editing this value and clicking out of the field.
 
* '''Header Caption''' - You can choose the name of the columns in your list view using the Header Caption option.
 
* '''Content Template''' - This will display the [[Variables|variable]] or variables you have selected using the Available Field List.
 
* '''Align''' - This will determine the alignment of the values in your list view column. The options available are "Left," "Right," and "Center."
 
* '''Show Total''' - If you have selected a single field containing numeric values, checking this option will display the total of the values currently displayed in your list view at the bottom of the list view.
 
* '''Show Open Button''' - Selecting this value will display the open button in the column selected, allowing users to click into the pertinent record from the list view.
 
* '''Shift Column Position''' - This will move the currently selected column to the left or right, relative to the other columns.
 
 
 
==Sort Order and Export Tabs==
 
 
 
Now that the list view has been created and the fields that should be presented have been defined, you will define the Sort Order and Export Settings (optional) for your list view.
 
 
 
Please visit the following pages:
 
 
 
* [[Setting the Sort Order on a List View]] and
 
* [[Exporting List View Results to Microsoft Excel]]
 
 
 
{{ListViewFooter}}
 

Latest revision as of 13:29, 7 June 2019