ExportWorksheet
Description:
Export an ELN or LES Worksheet
This action offers similar options to what is described in the Product Documentation when a user chooses to publish a worksheet.
Input Properties
worksheetid
Description:
Identifier of the worksheet. Accepts a semicolon separated list. If multiple values are supplied, each worksheet will be published separately to your specified destination.
Required:
Yes
worksheetversionid
Description:
Version identifier of the worksheet. Accepts a semicolon separated list. Each worksheet version will be published separately to your specified destination.
Required:
Yes
destination
Description:
Destination for the export. Valid values are: file, email, printer, and sdi.
Required:
Yes
destination_file
Description:
Possible value for PROPERTY_DESTINATION property. For example, your code might include: props.setProperty( PROPERTY_DESTINATION, PROPERTY_DESTINATION_FILE )
destination_email
Description:
Possible value for PROPERTY_DESTINATION property. For example, your code might include: props.setProperty( PROPERTY_DESTINATION, PROPERTY_DESTINATION_EMAIL )
destination_printer
Description:
Possible value for PROPERTY_DESTINATION property. For example, your code might include: props.setProperty( PROPERTY_DESTINATION, PROPERTY_DESTINATION_PRINTER )
destination_sdi
Description:
Possible value for PROPERTY_DESTINATION property. For example, your code might include: props.setProperty( PROPERTY_DESTINATION, PROPERTY_DESTINATION_SDI )
filetype
Description:
Format for the export. Valid values are: word and pdf.
Required:
Yes
filetype_word
Description:
Possible value for PROPERTY_FILETYPE property. For example, your code might include: props.setProperty( PROPERTY_FILETYPE, PROPERTY_FILETYPE_WORD )
filetype_pdf
Description:
Possible value for PROPERTY_FILETYPE property. For example, your code might include: props.setProperty( PROPERTY_FILETYPE, PROPERTY_FILETYPE_PDF )
filename
Description:
Destination filename for the export. This may be used by email, file or attachment destinations. When exporting to file, this filename should include the path. The path must be a valid destination as defined in your FileLocationPolicy.

Note: When exporting multiple worksheets, each export will require its own filename. This can be done in one of three ways:

  1. Provide a semi-colon list of fully qualified filenames - one for each worksheet
  2. Provide a single filename with [worksheetid], [worksheetversionid] or [worksheetname] substitution in the filename
  3. Provide a single filename. After the first export, subsequent files will receive a _1, _2, _3 etc suffix
Note: ${worksheetid}, ${worksheetversionid} and ${worksheetname} substitution is also supported. This may be useful if calling the action from a listpage - where the [worksheetid] property value gets substituted by the list prior to calling the action
Required:
Yes
emailfrom
Description:
Email addresses to which the recipient can reply.
Required:
Only if the destination is email.
emailtolist
Description:
Email addresses to which the report is sent.
Required:
Only if the destination is email.
emailcclist
Description:
List of recipients copied on the email.
Required:
No
emailsubject
Description:
Email "Subject" (text description of email).
Required:
No
emailmessage
Description:
Email message to include with the Report.
Required:
No
addressid
Description:
Identifier of an Address SDI that specifies the target printer.
Required:
Only if the destination is printer.
Comments:
If you want to send the report to a printer, you must enter the identifier of an Address SDI that specifies the target printer. In this case, you must also specify an addresstype.
addresstype
Description:
Address Type for the SDI identified by addressid.
Required:
Only if you specify an addressid.
sdisdcid
Description:
Destination SDI for the export - sdcid. Using this approach, the worksheet exported to PDF or Word will become an attachment to an SDI in this SDC.
Required:
Only if the destination is sdi.
sdikeyid1
Description:
Destination SDI for the export - keyid1
Required:
Only if the destination is sdi.
sdikeyid2
Description:
Destination SDI for the export - keyid2
Required:
Only when the destination SDC uses multiple columns to form the unique identifier for for SDIs in this SDC.
sdikeyid3
Description:
Destination SDI for the export - keyid3
Required:
Only when the destination SDC uses more than two columns to form the unique identifier for for SDIs in this SDC.
sdiattachmentdesc
Description:
Attachment description for file attached to SDI
Required:
Only if the destination is sdi.
sdiattachmentbyref
Description:
Determines if the exported file will be a reference attachment to an SDI or if it is uploaded and stored in an attachment repository.
Required:
Only if the destination is sdi.
Comments:
Set to Y if the attachment to the sdi will be unmanaged by LabVantage.
IMPORTANT: If attaching by reference, you must provide a fully qualified filename - likely pointing to a shared network drive Set to N if the attachment will be processed by LabVantage and copied into a repository from which the SDI will retrieve the file on demand.
pagesize
Description:
Pagesize override for the export. Valid values are:
  • letter
  • legal
  • a4
  • a5
  • b5
Required:
No
pagesize_letter
Description:
Possible value for PROPERTY_PAGESIZE property. For example, your code might include: props.setProperty( PROPERTY_PAGESIZE, PROPERTY_PAGESIZE_LETTER )
pagesize_legal
Description:
Possible value for PROPERTY_PAGESIZE property. For example, your code might include: props.setProperty( PROPERTY_PAGESIZE, PROPERTY_PAGESIZE_LEGAL )
pagesize_a4
Description:
Possible value for PROPERTY_PAGESIZE property. For example, your code might include: props.setProperty( PROPERTY_PAGESIZE, PROPERTY_PAGESIZE_A4 )
pagesize_a5
Description:
Possible value for PROPERTY_PAGESIZE property. For example, your code might include: props.setProperty( PROPERTY_PAGESIZE, PROPERTY_PAGESIZE_A5 )
pagesize_b5
Description:
Possible value for PROPERTY_PAGESIZE property. For example, your code might include: props.setProperty( PROPERTY_PAGESIZE, PROPERTY_PAGESIZE_B5 )
orientation
Description:
Orientation override for the export. Valid values are:
  • portrait
  • landscape
Required:
No
orientation_portrait
Description:
Possible value for PROPERTY_ORIENTATION property. For example, your code might include: props.setProperty( PROPERTY_ORIENTATION, PROPERTY_ORIENTATION_PORTRAIT )
orientation_landscape
Description:
Possible value for PROPERTY_ORIENTATION property. For example, your code might include: props.setProperty( PROPERTY_ORIENTATION, PROPERTY_ORIENTATION_LANDSCAPE )
shownotes
Description:
Show notes override for the export. Set to "Y" to include Notes that were added to controls. Set to "N" to exclude these notes from the publication.
Required:
No
showimagemarkup
Description:
Show image markup override for the export. Set to "Y" if images included in any file controls on the worksheet have been marked up and those markups should be published.
Required:
No
showmetadata
Description:
Show metadata override for the export. Set to "Y" if metadata (Attributes) addeds to the worksheet controls should be included in the publication.
Required:
No
Additional Information
Additional information concerning this Action:
When a property has a fixed set of possible values, you can code your calls to this action by setting properties.
In Java, the setProperty method uses (String key,String value). For example, you could write:
props.setProperty( PROPERTY_DESTINATION, "file" )
or, you could write:
props.setProperty( PROPERTY_DESTINATION, PROPERTY_DESTINATION_FILE )
...which also sets the String value to "file".
The second approach offers more flexibility in case the text, 'file', needs to be replaced with different text in the future which theoretically will mean the same thing.
Copyright © 1999-2025 LabVantage Solutions, Inc.