List Views

14 August 2013
 Lesson objectives
• By the end of this lesson, you should be able to:
- Describe the functionality of list views
- Create new list views
- Create and modify row iterator, row, and cell widgets
- Reference list views from parent containers

This lesson uses the notes section for additional explanation and information.
To view the notes in PowerPoint, choose ViewNormal or ViewNotes Page.
If you choose to print the notes for the lesson, be sure to select “Print hidden slides.”
© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
2
 Lesson outline
• List view basics

• Creating list views

• List view widgets

• Referencing list views

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
3
 List views

ABContactHistoryLV

• A list view is a container widget that typically displays a set

of rows that are related to one object or one query
- Users can view and, in some cases, edit the data

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
4
 List view root objects
ABContactHistoryLV

HistoryEntry
ABContact HistoryEntry
HistoryEntry
root object
array from root object

• Container widgets typically have one root object

- List views typically display objects in array associated with
root object

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
5
 List view contents

row
row

cells cells cells

• Cell widgets display individual fields of data

• Row widgets organize cells
• Entire structure generated by row iterator

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
6
 Row iterators
HistoryEntry
HistoryEntry
HistoryEntry

row widget
cell cell cell
row
widget widget widget
iterator

• An iterator is a widget that takes a set of items and

performs the same set of actions for each member
• A row iterator is an iterator used to structure list views
- Takes set of objects (typically in an array) and renders one
row of cells for each
© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
7
 Row iterator example: no objects processed
HistoryEntry
HistoryEntry
HistoryEntry

row widget
row cell cell cell
iterator widget widget widget

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
8
 Row iterator example: First object processed

HistoryEntry
HistoryEntry

row widget
row cell cell cell
iterator widget widget widget

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
9
 Row iterator example: Next object processed

HistoryEntry

row widget
row cell cell cell
iterator widget widget widget

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
10
 Row iterator example: Final object processed

row widget
row cell cell cell
iterator widget widget widget

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
11
 Reusable containers

• When container (such as list view) is declared as top-

level, it is reusable and can be embedded by reference
• If container is likely to be needed in multiple places,
create it in its own PCF file as top-level container
• When container is configured as inline it is not reusable
© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
12
 Lesson outline
• List view basics

• Creating list views

• List view widgets

• Referencing list views

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
13
 Steps to create list view
1. Create the LV file
2. Specify the required variables
3. Optionally specify additional properties
4. Add a row iterator widget
5. Add a row widget
6. Add cell widgets
7. Reload UI metadata

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
14
 Step 1: Create the LV file
"LV" automatically
appended to end
of file name

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
15
 Step 2: Specify the required variable(s)
• Root objects
declared on list
view's Required
Variables tab
- To display tab,
click
"ListViewPanel :
<name>" link
- For each required
root object, click
"+" and specify
object's name and
data type

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
16
 Step 3: Optionally specify additional
properties
• By default, all
container
widgets are:
- Editable
- Visible

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
17
 Lesson outline
• List view basics

• Creating list views

• List view widgets

• Referencing list views

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
18
 Required properties of row iterator
Value: anABContact.History
HistoryEntry
HistoryEntry
HistoryEntry

row
cell cell cell
row currentObj. currentObj. currentObj.
Element Name:
iterator CreateDate EventType Description
currentObj

• Editable - whether cells can be edited

• Value - set of objects (array) to process
• Element name - name used by cell widgets to map to
object currently being processed
© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
19
 Step 4: Add a row iterator widget

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
20
 Step 5: Add a row widget

• Typically, do not need to

specify any properties

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
21
 Step 6: Add cell widgets

• Must be added inside row

widget
• Properties
- editable is false by default
- ID is required
(continued)

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
22
 Step 6: Add cell widgets (label property)
• Label property specifies label
for column header

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
23
 Step 6: Add cell widgets (value property)
• Cell widget is inside row
iterator, which is used to
process multiple rows
- Cell's value property must
reference row iterator's
element name

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
24
 Example of second cell

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
25
 Example of third cell

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
26
 Sort order
• Row iterator's Sorting tab used to
specify default sort order of list

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
27
 Lesson outline
• List view basics

• Creating list views

• List view widgets

• Referencing list views

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
28
 What can contain a list view?
screen
Screen a top-level container
one can navigate to

secondary views
Card View / collections of primary
ListDetail View views organized for
usability
panel ref

primary views
Detail LV List a single object (and its
View input View related data) or set of
objects
Input Sets
atomic widgets
Atomic Widgets individual elements of data
and/or functionality
© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
29
 Steps to reference list views
(from screens and secondary views)
1. Create panel ref widget
2. Add toolbar
3. Specify properties
4. Reload the metadata

pascreen
ne
lr ABContact
ef
HistoryLV

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
30
 Step 1: Create panel ref widget

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
31
 Step 2: Add toolbar

• Paging is a list view

behavior in which the set
of rows in the list view is
broken into multiple "list
view pages"
- Set of paging controls
lets user move through
each page of rows
• List views typically
require toolbars for
paging control, even if
toolbar has no buttons

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
32
 Step 3: Specify properties
• def property
identifies:
- Name of list view
to reference
- Object to pass to
list view for it to
use as root objects

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
33
 Step 4: Reload the metadata

• Deploy UI changes by pressing ALT + SHIFT + L

• Toolbar appears only when number of list entries exceeds
maximum paging size
© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
34
 List view inputs
• List view input is similar to panel ref, but used exclusively to
embed list view in detail view
- Treats embedded list view as if it was input widget

ABContactSummaryDV

FlagEntriesLV

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
35
 Steps to reference list views
(from detail views)
1. Create list view input widget
2. Add toolbar
3. Specify properties
4. Reload the metadata

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
36
 List view input labels

• def property identifies list view to embed

• label and labelAbove properties determine exact position
and labeling of list view (see next slide)

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
37
 List view input label settings
no label; labelAbove = true

label specified; labelAbove = true

label specified; labelAbove = false

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
38
 List views in read-only mode

• By default, there is no way to put list view into edit mode

- Next lesson discusses how to add Edit Buttons so that
data can be modified
© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
39
 Lesson objectives review
You should now be able to:
- Describe the functionality of list views
- Create new list views
- Create and modify row iterator, row, and cell widgets
- Reference list views in parent containers

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
40
 Review questions
1. In a list view:
a) What type of widget displays individual fields of data?
b) What type of widget organizes the individual fields of data?
2. Assume you have a list view with "anABContact" as the
root object. The list view displays the contact's addresses.
a) What would the row iterator's "value" property be set to?
b) What would the row iterator's "element name" be set to?
c) What other widgets would make use of the element name?
3. A list view typically needs a toolbar, even if it is read-only.
Why?
4. In what way is embedding a list view in a detail view
different from embedding a list view in a screen?

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
41
 Notices
Copyright © 2001-2013 Guidewire Software, Inc. All rights reserved.
Copyright © 2001-2013 Guidewire Software, Inc. All rights reserved. Guidewire, Guidewire
Software, Guidewire ClaimCenter, Guidewire PolicyCenter, Guidewire BillingCenter,
Guidewire Reinsurance Management, Guidewire ContactManager, Guidewire Vendor Data
Management, Guidewire Client Data Management, Guidewire Rating Management,
Guidewire InsuranceSuite, Guidewire ContactCenter, Guidewire Studio, Guidewire Product
Designer, Guidewire Live, Guidewire DataHub, Guidewire InfoCenter, Guidewire Standard
Reporting, Guidewire ExampleCenter, Gosu, Deliver Insurance Your Way, and the Guidewire
logo are trademarks, service marks, or registered trademarks of Guidewire Software, Inc. in
the United States and/or other countries.

Guidewire products are protected by one or more United States patents.

© Guidewire Software, Inc. All rights reserved. Do not distribute without permission.
42