Changes

Jump to: navigation, search

Configuring Ajax List Views

1,641 bytes removed, 14:04, 27 February 2018
Definition of Options Available on the Columns Tab
{{ListViewHeader}}__TOC__
Ajax [[list view]]s can be configured to choose the fields shown when contact or organization records are searched for using [[Ajax]] lookups.
===System Views===Unlike other [[list view]]s in the system, records shown on Ajax list views cannot be edited or opened. Ajax list views present information on records for selection of contacts or organizations.
* When you click on the "New" button in the System View section, you will be prompted to select The list views are configured from the role to which [[Global Settings]] page under the System View pertains. * Select the appropriate role, enter a name for the list view and click "OK."* You will now see four following tabs in the right-hand frame: Properties, Columns, Sort Order and Export.
[[Image:ConsolidatedAjaxListViewsonGlobalSettingsPage.png|link===Personal Views===|600px]]
* When you click on Note that the "New" button columns selected in the Personal View section, the only difference from System Views Ajax list view will be that you will not have the option to select a rolefields searched upon when values are typed into an Ajax lookup field. * Enter <br />For example, when a name for the contact lookup list view is configured with the Name, Organization, Title and Address columns, and click "OK.art"* You is typed into a contact lookup field, records will now see four tabs be returned where the string "art" is found in the right-hand frameany of those fields: Properties, Columns, Sort Order and Export.
[[Image:AjaxLookup.png|link=]]
==The Properties Tab==<!--When you click on one of the above links, you will be given a choice to build the list view using either the Classic or the New List View Builder. [[Image:ListViewSettingsChooseListViewBuilder.png|link=|200px]]* '''For instructions on use of the Classic List View Name''' - The name of Builder, see the list view is editable. Give your list view a distinctive name.* '''Display Order''' - Enter a following page: [[display order]]. This will define which list view will be the default for users who possess multiple roles. Historic List views with lower [[display orderView]]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 To configure a New List View, click 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.Use New ListView Builder"* '''Other Options''' ** Open in edit mode: Checking this option will mean that when records are opened, they will default to edit mode as opposed to view mode.** Enable Quick Editand follow these steps: Checking this option will allow the list view to be configured with the [[Quick Edit|Quick Edit]] feature enabled.** Manifest as Tab (Arcadia only): Only appears for UTA specific list views and will mean the list view appears as separate tab when the UTA is accessed in Arcadia mode.-->
==The Columns Tab==
* When you first click on this tab, you will see the default four blank columns.
<BR><br>
[[Image:ListviewblankcolumnsshortAjaxListViewBuilderInitialView.PNGpng|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.
* Note that multiple fields can be selected for each column in the list view. In the example below, both the [[Status]] field First Name and Last Name standard fields have been added to column number 2 and the Header Caption has just been selected for Column 4. [[Image:Listviewfieldsselectedchanged to "Name.PNG|link=]]"
[[Image:AjaxListViewBuilder.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, You can also 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 AmountFirst Name@ <b>(@% Foundation FundingLast Name@ of Foundation Funding)</b></nowiki>'' into the Content Template, which would result in Requested Amount Name values in the list view displaying in the format: $25,000.00 FirstName '''(0% of Foundation Funding)LastName'''
<pre style="white-space: pre-wrap;
word-wrap: break-word;">Note: Since the configuration of list views is performed by system administrators, any field can be selected to display in the list view. This means that if a field is selected for a given role's list view that has field permissions that deny visibility to that given role, that field will be visible to that role on that list view. The edit permissions set on the field permissions setting of custom fields will still hold sway, however.</pre>
===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 access their records from the list view.
* The Open button can be added to any column in the list view, by selecting the "Show Open Button" option while clicked into a cell.
 
[[Image:Listviewopenbutton.PNG|link=]]
 
* Clicking on the "Show Open Button" option displays the @OPENBUTTON@ variable in the Content Template, which displays the button on the list view.
* As described [[Configuring_List_Views#The_Properties_Tab|above]], the caption on the Open button can be changed on the "Properties" tab of the list view.
===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 number of columns shown by editing this value and clicking out of the field.<br />For an optimal user experience, it is recommended to not exceed 4 columns, however you can exceed this limit.
* '''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.
Now that the list view has been created and the fields that should be presented have been defined, you will define the Sort Order for your list view. Please visit see [[Setting the following pages:Sort Order on a List View]] for instructions.
* [[Setting the Sort Order on a List View]] and==See Also==
* [[Ajax|Ajax Lookup]]
{{ListViewFooter}}[[Category:List Views]][[Category:Global Settings]]
Smartstaff
281
edits

Navigation menu