{{ListViewHeader}}==Defining a List View==There are two types of List Views:<br />'''System Views''' and '''Personal Views'''.<br><br />[[File:Newlistviews.png|link=|600px]]* ''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:ListViewSettings3.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]] Lookup field will specify which user roles the list view will be available to. This option is available only for System Views (see above).* '''Tabs''' - The Lookup field will specify which [[Types]], configured as [[Display as Tab]], that the list view will be available against. This option is available only for Level2 and Level 3 List views.* '''Color Based On''':* '''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 Edit: Checking this option will allow the list view to be configured with the [[Quick Edit|Quick Edit]] feature enabled.** Enable Row Clickable: Checking this option will mean that each row will act as a clickable button to open the referenced record.<!--** Enable Fixed Header (Arcadia only): Only appears for UTA specific list views. If checked then the column headers in the list will always be displayed at the top of the report even when a scroll bar is required to view all returned results.-->**Enable Map Panel - Displays a map panel to the right of the list view.**[[Download files from List View|Enable Download Files Option]] - Displays download icon to allow downloading of files from [[Custom Field Type: Link – Single File|single file]] or [[Custom Field Type: Link – Multiple File|multiple file]] fields on the selected records ** Manifest as Tab (Arcadia only): Only appears for UTA specific system list views and will mean the list view appears as separate tab when the UTA is accessed in Arcadia mode. It also means that the list view will not be made available in the normal list view drop-down.<!--<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-pre-wrap; word-wrap: break-word;">NOTE: If a user switches on the Fixed Header feature, they will be required to explicitly define the widths of each column for that list view.</pre>-->* '''Filter Option''' - Select from a saved [[Filter|System Filter]] to default the list view to the filter's search criteria. Users will be able to choose search criteria other than the default.* '''Language Option''' - Select an alternate language for multi-language systems. The column headings and record Open button can be re-captioned.==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.* There are a maximum of 15 columns that can be configured per list view.<BR><br>[[Image:Listviewblankcolumnsshort2.png|link=]]* When you click into a cell, you will see the configuration options below. * The '''Available Field List''' will display at the right. The '''Available Field List''' displays those fields that can be added to the list, organised by entity or object, with the available categories dependent on the current object that the list is being created against. For each category [[Standard Fields|Standard]] fields are shown first, followed by the [[Custom Fields|custom]] fields available. * The Available Field List appears with certain meta-data against each field, including Field Type, Validation Type and Field Name if different from the caption.[[Image:Listviewselectingfield.png|link=|900px|border]]* 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. :* 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. #REDIRECT [[Image:Listviewmultfieldsselected.png|link=|1200px]]* 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 ''@Requested Amount@('''@Currency@''')'' into the Content Template, which would result in Requested Amount values in the list view displaying in the format: $25,000.00'''USD or Cdn'''<pre style="white-space: pre-wrap; white-space: -moz-pre-wrap; white-space: -pre-wrap; white-space: -o-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=|1200px]]* 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_ViewsOverview#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.* '''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."* '''Font Color''' - Allows you to choose the color used for the column text.* '''Bold Text''' - This option will boldface the text in this column.* '''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 Tab==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.{{SortOrderOnListView}}==Export Tab==[[Image:ListViewExportSettings.png|600px|link=]]* '''Enable Export''': * '''SmartFolder''':* '''MS Excel Settings''': See [[Positioning Exported List View Results in your Excel Spreadsheet]]* '''MS Word Settings''': Enter semicolon-delimited list of [[Custom Field Type: Special - MS Word Merge|MS Word Merge field]] names (''fieldname1;fieldname2;fieldname3'') into the ''Field Names'' setting.* '''Custom Export Settings''':*'''Header''': define the text and column headings that will appear above the main body of the exported list view :*'''Record template''': define the columns from within the list view that are to be exported:*'''Footer template''': define text that will appear below the main body of the exported list view :*'''Default filename''': define the name of the exported file :*'''Export Values Only''': will strip out any formatting (e.g. commas, currency, decimal places) associated with the selected field :*'''Update Status after export''': each exported record will be updated to the selected Status:*'''Trigger Workflow after export''': selected workflow will be triggered for each exported record==Language Settings==When configuring a list view users will see a language drop-down on the top right of the screen. This drop-down is used to create other language specific versions of the same list view. When the user selects the new Language from the drop-down they are taken to a screen with the following : * Columns: Fields for entering new language specific column headers. There should be the same number and order of columns as in the original list view. * List View Name: language specific name for the list view * Open Button label: language specific text to appear on the Open buttons * Edit button label: language specific text to appear on the Quick Edit buttons. Only appears if Quick Edit enabled on the list view. ==List View on multiple tabs==When creating a Level 2 or Level 3 list view then there will be an additional '''Tabs''' setting. Clicking on the Lookup button will display a list of those [[Types]] that have the [[Display as Tab]] option set. The list view will then be available against all selected Tabs when accessing the parent entity. ==Copying Configuring List Views==:[[Image:CopyListView.png|link=|300px|border]]Users who are [[Global User Administrator|Global Admins]] or [[Local User Administrator|Local Admins]] can copy a System List View and configure as either a [[List_View_Overview#System_Views_and_Personal_Views|System View or Personal View]]. The Configuration page for the System List View will have a Copy button, with the option to copy as either a System View or Personal View.[[Category:Translation]]{{ListViewFooter}}
