This topic is under construction for the 17.3 release of LabKey Server. For current documentation of this feature, click here.
The Data Views
web part displays a catalog of available queries and reports. This provides a convenient dashboard for selecting among the available ways to view data in a given folder or project. In a Study
the Data Views web part also includes datasets and customized data grids that have been saved.
By default, the Data Views
web part lists all the queries, reports, and datasets you have permission to read. If you would like to view only the subset of items you created yourself, click the Mine
checkbox in the upper right.
Add and Manage Views
Users with sufficient permission can add new content and make some changes using the
menu in the corner of the web part. Administrators have additional options, detailed below.
- Add Report: Click for a submenu of report types to add.
- Add Chart: Use the plot editor to add new visualizations.
- Manage Views: Manage reports, queries, and grids, including the option to delete multiple items at once. Your permissions will determine your options on this page.
- Manage Notifications: Subscribe to receive notifications of report and dataset changes.
Toggle Edit Mode
Users with Editor (or higher) permissions can edit metadata about items in the databrowser.
- Click the pencil icon in the webpart border to toggle edit mode. Individual pencil icons show which items have metadata you can edit here.
- When active, click the pencil icon for the desired report or query.
- Edit Properties, such as status, author, visibility to others, etc.
- If you want to move the item to a different section of the web part, select a different Category.
- If there are associated thumbnails and mini-icons, you can customize them from the Images tab. See Manage Thumbnail Images for more information.
- Click Save.
Notice that there are three dates associated with reports: the creation date, the date the report itself was last modified, and the date the content of the report was last modified.
Customize the Data Views Browser
An administrator adds the Data Views web part to a page:
- Enter > Page Admin Mode.
- Select Data Views from the <Select Web Part> pulldown in the lower left.
- Click Add.
menu in the upper corner of the webpart gives admins a few additional options:
- Manage Datasets: Create and manage study datasets.
- Manage Queries: Open the query schema browser.
- Customize: Customize this web part.
- Permissions: Control what permissions a user must have to see this web part.
- Move Up/Down: Change the sequence of web parts on the page. (Only available when an admin is in page admin mode).
- Remove From Page: No longer show this web part - note that the underlying data is not affected by removing the web part. (Only available when an admin is in page admin mode).
- Hide Frame - remove the header and border of the web part. (Only available when an admin is in page admin mode).
Administrators can also customize display parameters within the web part.
from the triangle pulldown menu to open the customize panel:
You can change the following:
- Name: the heading of the web part (the default is "Data Views").
- Display Height: adjust the size of the web part. Options:
- Default (dynamic): by default, the data views browser is dynamically sized to fit the number of items displayed, up to a maximum of 700px.
- Custom: enter the desired web part height. Must be between 200 and 3000 pixels.
- Upgrade note: if an existing data views webpart used one of the prior small, medium, or large options, that height setting will be preserved as a custom height.
- Sort: select an option:
- By Display Order: the default: the order items are returned from the database
- Alphabetical: alphabetize items within categories; categories are explicitly ordered
- View Types: check or uncheck boxes to control whether reports, queries, or datasets are displayed.
- Visible Columns: check and uncheck boxes to control which columns appear in the web part.
- Manage Categories: Click to define and use categories and subcategories for grouping.
- To close the Customize box, select Save or Cancel.