Attachments Control

 

Content

Overview

Description

Configuration Properties

 
 

 

 

 

Overview

Top../images/arwup.gif (846 bytes)

The "Attachments" Control displays Attachments to SDIs in the Worksheet or Control.

 

Description

Top../images/arwup.gif (846 bytes)

Attahcments can be shown from the Worksheet itself or from the LIMS.

The following provides an example of an Attachment shown from the Worksheet (inline).

 

The example below shows the Attachments Control rendering two Attachments to a Sample SDI that has been added to the Worksheet. The Configuration Properties are setup to show thumbnails.

 

 

 

Configuration Properties

Top../images/arwup.gif (846 bytes)

These properties are available for configuring overall behavior.

Property Description
Name Name of the Control that is displayed in the ELN interface. Leaving this blank defaults to the Control name provided in the OOB configuration.
Mode Determines behavior of the Control based on the relationship of the Atachments to the Worksheet.
OptionDescription
Worksheet AttachmentsView and manage Attachments added to the Control.

When selected, the Worksheet Source property (below) becomes available.

Standard AttachmentsView and maintain SDI Attachments added to either the Worksheet or the Control.
Worksheet Source This is applicable only when "Mode" is "Worksheet Attachments". Choose how Attachments are linked, either by:
OptionDescription
WorksheetAttachments are linked to the Worksheet in which the Control resides.
SectionAttachments are linked to the immediate parent Section of the Control.
ControlAttachments are linked directly to the Control itself. An option to manage Attachments directly on the Control is provided.

If the Attachment shown on a Worksheet, Section or Control is altered, any corresponding Control that displays the Attachment is automatically refreshed.

NOTE:If a Control is configured to show Attachments for its "Section" or "Worksheet", the option to manage Attachments directly on the Control is unavailable.
Data Source This is applicable only when "Mode" is "Standard Attachments". Determines the source of the SDIs associated with the Control.
OptionDescription
WorksheetSDIs are retrieved from the WorksheetSDI table, which persists SDIs associated with the Worksheet.
ControlSDIs are retrieved from the WorksheetItemSDI table, which persists SDIs associated with the Control.
QuerySDIs are retrieved by a Query defined in the Control. This displays the "Query" property.
Data Source SDC This is applicable only when "Mode" is "Standard Attachments". SDC for the SDIs that are in the Control or Worksheet.
Query These properties are available if the "Data Source" is "Query".
PropertyDescription
QueryQuery SDI.
Query ParametersParameters to use in the Query SDI.
Query From

Query Where

If you are doing a generic SQL query rather than defining a Query SDI, these define the From and Where Clauses.
Layout Style Determines the graphical layout.
OptionDescription
Attachment OnlyShows the image or thumbnail of the Attachment.
TableShows a table that can include columns from the SDI table itself.
Show Attachment Class Only Only Attachments of this Attachment Class will be displayed.
Show Image Attachments Only Determines if only image Attachments are displayed.
Show Description As Caption Inculdes the Attachment description below the image.
Show Border Determines if a border is added around the image and caption.
Show View Hyperlink [DEBUG:Not found in Confluence. Could you provide some details.]
Image Display Mode Determines how the image is rendered.
OptionDescription
Full SizeRenders an image to its full extent. Non-image Attachments are rendered as a thumbnail of default size.
Fixed SizeRenders images and thumbnails of the size specified by "Image Width" and "Image Height" (below).
ThumbnailsRenders all Attachments as thumbnails. Thumbnails should be used if large images are expected, as this option downloads a smaller image file to the browser.
Image Width If "Image Display Mode" is "Fixed Size", this is the width of the image in pixels.
Image Height If "Image Display Mode" is "Fixed Size", this is the height of the image in pixels.
Export Image Display Mode Determines how the image is rendered when exported.
OptionDescription
Full SizeRenders an image to its full extent. Non-image Attachments are rendered as a thumbnail of default size.
Fixed SizeRenders images and thumbnails of the size specified by "Image Width" and "Image Height" (below).
ThumbnailsRenders all Attachments as thumbnails. Thumbnails should be used if large images are expected, as this option downloads a smaller image file to the browser.
Export Image Width If "Export Image Display Mode" is "Fixed Size", this is the width of the image in pixels.

By default, this is set the same as "Image Width" (above).

To preserve the aspect ratio of the image, define either the height or width as -1 (a height of -1 and a width of 300 for example). The image will calculate the other dimension maintaining the aspect ratio.

Please note that changing this property after a file has been selected (or changes have been saved), will have no effect on the stored data and thus only effects re-uploading, or when changes are made in the edit screen.
Export Image Height If "Export Image Display Mode" is "Fixed Size", this is the height of the image in pixels.

By default, this is set the same as "Image Height" (above).

To preserve the aspect ratio of the image, define either the height or width as -1 (a height of -1 and a width of 300 for example). The image will calculate the other dimension maintaining the aspect ratio.

Please note that changing this property after a file has been selected (or changes have been saved), will have no effect on the stored data and thus only effects re-uploading, or when changes are made in the edit screen.
Primary Columns Defines columns rendered for the SDI List.
OptionFilters by:
Column IdColumn Id to be retrieved for the selected SDC.
TitleTitle rendered on the column header.
ShowDetermines if the column is rendered.
Display ValueValues displayed in place of the corresponding retrieved values. Separate each with a semicolon. For example, if you retrieve values from the createby column, you could specify JDrake=JD. All values retrieved as JDrake would then be displayed as JD. This works only if you replace the entire retrieved string (it does not work on partial strings).
Date FormatFormat in which date/time is displayed, as determined by the user's Locale and the Date Format Policy. For information about how LabVantage handles Locale, see Internationalization and Localization → Locale and Time Zone and Date Format Policy.
Translate ValueDetermines if the retrieved value is translated (see Translations).
Primary Sort By Allows the SDIs in the Control to be sorted by a column value. If no property collection is specified here, the default is to use the key column(s) of the SDIs.
PropertyDescription
ColumnColumn by which to sort. This column must be one of the columns that is being retrieved by the Control for display. It is not possible to sort by a column that is not being retrieved.
DirectionDetermines if the column value is sorted in "Ascending" or "Descending" order.
No Data Available Message Specify text to show when there are no SDIs to display.
Operations Defines Operations available on the Control Toolbar. See Common Control Operations for details.
Includes Allows complex/extended JavaScript to be added to an Operation of Type "Custom".