Widgets

Widgets enable you to quickly access and update information, including projects, tasks, web sites, custom objects, calendar appointments, and activities.

About Widgets

Widgets are small windows available on a Home Page that let you view information based on:

• Views
• Reports
• Widget Tools
• Pages (JavaServer Pages)
• Relay Feeds (if Relay is enabled)

Widget Types

View

• View-based widgets display data rows from the View you select
• Choose the number of rows to display: 5, 10, 20, 50 or 100

Report

• Report-based widgets display Charts, Table Data or both from the Report you select.
• Choose the number of rows to display: 5, 10, 20, 50 or 100.
• In the widget banner, click the document icon () to view the underlying report.

HTML

Add any HTML code for a fully custom widget.

Note: The one exception is a <form> tag.

Behind the scenes, the dashboard is one big form that submits a widget's new position to the server when you move it.

That way, the position is recorded for the next time you visit.

Since nested <form> tags do not work in HTML browsers, you can use any HTML except a <form> tag.

Enable HTML Sanitization

When this option is selected, it prevents XSS attacks by allowing you to use only the HTML tags and attributes listed in the table. When this option is not selected, all the HTML tags and attributes are allowed and XSS attacks are not prevented.

Allowed Tags

a, abbr, acronym, address, area, b, bdo, big,blockquote, br, button,body,caption, center, cite, code, col, colgroup, dl, dt, dd, del, dfn,dir, div, em, fieldset, font, form, h1, h2, h3, h4, h5, h6, hr, head, html, i, iframe,img, input, ins, kbd, label, legend, li, map, mark, menu, ol, optgroup, option, p,pre, q, s, samp, select, section, small, span, strike, strong, style, sub, sup, table, tbody,td, textarea, tfoot, th, thead, u, tr, tt, ul, var

Tags	Attributes Allowed
col, colgroup	span, align, char, charoff, valign, width
abbr,acronym	title
button	type
p	align
area	alt,shape,coords,href
bdo	bdl
dfn	id, title
div	style
img	src,width,height,alt
label	for, form
form	accept, accept-charset, action, autocomplete, enctype, method ,name, novalidate, target
li	type, value
input	type, value, name
p	title
optgroup	label, disabled
textarea	rows, columns
option	label, disabled, selected, value
table	border, bgcolor, style
font	size, color, face
a	class, id, href
tbody	align
iframe	width, height, src, frameborder
body	bgcolor, link, text

Page

• Display a JSP Page defined and stored on the platform.

Working with Widgets

Widgets can be added and removed, reconfigured, minimized or maximized, and moved around on a home page.

Users that have the Manage Global Views/Reports permission can add/delete Widgets to a home page or modify its layout. In addition, any user who creates a home page can add, delete, and modify widgets on that page.

Add Widget to your Home Page

The Add Widget option allows you to customize your Home Page. To add a widget:

1. Click the Add Widgets link.

   File:HomePage-AddWidgetLink.jpg

2. The Add Widget page opens

   File:Addwidget.gif

3. Select the Widget Type and complete the required fields. (Options will vary, depending on the type of widget selected.)

Edit a Widget

1. In the Home Page, navigate to an existing widget
2. Click the Wrench icon icon in the heading bar.
3. Specify your options. (The available options depend on the type of widget.)
4. Click [Save]

Move a Widget

Widgets can be moved from column to column, or moved up or down within a column. To select a widget, hover the mouse over the header bar of the widget until the mouse cursor changes, then click and drag the widget into a new position.

Minimize a Widget

You can minimize selected widgets by clicking the Minimize button, located in the widget header bar. These widgets will remain minimized during the current session, but will open again at your next login.

[[Category:Template:Features]]