Properties Common to All Web Parts

Two properties exist for all web parts. These properties can be set in addition to the web-part-specific properties listed below.

  • showFrame: Whether or not the title bar for the web part is displayed. For example, for wiki pages, the title bar includes links such as "Edit" and "Manage". You will want to set showFrame='false' to show web part content seamlessly within a wiki page, for example. Values:
    • true (the default)
    • false
  • location: Indicates whether the narrow or wide version of the web part should be used, if both options are available. Including a second location setting of 'menu' will make the web part available for use as a custom menu.
    • !content (the default)
    • right (aka 'narrow')
    • menu
Not all web parts provide different formatting when the location parameter is set to 'right'. For example, the Wiki web part does not change its display, it merely tightens the word wrap. Others (such as Protein Search, Sample Sets, Protocols and Experiments) change their layout and/or the amount of data they display.

Properties Specific to Particular Web Parts

Properties specific to particular web parts are listed in this section, followed by acceptable values for each. Unless otherwise indicated, listed properties are optional.

Issues List/Summary

The Issues List and Issues Summary web parts list issues in the current folder's issue tracker.

  • title: Title of the web part. Useful only if showFrame is true. Default: "Issues List" or "Issues Summary" respectively.

Query

The Query web part shows the results of a query as a grid.

  • schemaName: Required. Name of schema that this query is defined in.
  • title: title to use on the web part. Default: "[schemaName] Queries"
  • queryName: Query or Table Name to show.
  • viewName: Custom view to show from that query or table.
  • buttonBarPosition: Determines how the button bar is displayed.
    • none
    • top
    • bottom
    • both (the default)
  • allowChooseQuery: If the button bar is showing, whether to let the user choose a different query.
    • true
    • false
  • allowChooseView: If the button bar is showing, whether to let the user choose a different view.
    • true
    • false

Report

  • reportId: The ID of the report you wish to display, shown in the URL. If the URL includes 'db:151', the reportID would be 151.
  • schemaName, queryName and reportName: You can use these three properties together as an alternative to reportId. This is a handy alternative in scripts designed to run on both test and production systems when the reportID would be different.
  • showSection: Optional. The section name of the R report you wish to display. Optional. Section names are the names given to the replacement parameters in the source script. For example, in the replacement '${imgout:image1}' the section name is 'image1'. If a section name is specified, then only the specified section will be displayed. If not, by default, all sections will be rendered.

Search

The Search web part is a text box for searching for text strings.

  • includeSubFolders: Whether to include subfolders in the search
    • true (the default)
    • false

Files

The Files web part supports uploading and browsing of files in the container.

  • fileSet: The set of files to display.
  • folderTreeVisible: Whether to show the folder tree panel on the left.

Wiki

  • name: Required. Title name of the page to include.
  • webPartContainer: The ID of the container where the wiki pages live. Default: the current container. Obtain a container's ID by using the containerId.view action in the admin controller.

Wiki Table of Contents

  • title: Title for the web part. Only relevant if showFrame is TRUE. Default: "Pages".
  • webPartContainer: The ID of the container where the wiki pages live. Default: the current container. Obtain a container's ID by using the containerId.view action in the admin controller.

Projects

The Projects webpart displays the projects or folders as configured.

  • containerTypes: Which content to display in this webpart:
    • Project (the default)
    • Subfolder
  • iconSize: What size icons to show
    • large (the default)
    • medium
    • small
  • labelPosition: Where to display the text label
    • bottom (the default)
    • side
  • directDescendents: Whether to limit the set of subfolders shown to include direct children only.
    • true
    • false
  • includeWorkbooks: Whether to include workbooks as "subfolders"
    • true
    • false
  • hideCreateButton: Whether to hide the "Create New Project" button.
    • false (the default - i.e. by default the button is shown
    • true

Related Topics

discussion

Discussion

Search 

Pages 

previousnext
 
expand all collapse all