The ELN Policy defines global configuration options for ELN/LES functionality.

 

Property Description
Name Currently unused. This is the name used in the Worksheet Options that describes the node that can be chosen. 
Worksheet Manager Role When using Worksheets based on Worksheet Templates, a user with this Role bypasses many of the restrictions imposed by the Worksheet Template from which the Worksheet was created. Users in the "Worksheet Manager" Role can perform administrative functions such as modify Change Author, User Privileges, Worksheet Options, and Advanced Configuration.
User Privileges Defines Worksheet Options that can be perfomed by each User. See ELN Worksheet Manager → Detail Panel → Actions → User Privileges.
Add Content Determines the content and rendering of the "Add Content" dialog in the Worksheet Manager. Among other things, this can be useful when you want different Worksheet Types to have different Controls.
PropertyDescription
ControlsConfigures the "Add Content" dialog.
PropertyDescription
Type Defines the dialog that opens when you click the "Add Content" button or press the "Insert" key.
DialogShows:
Control Selection button that adds that Control into the Worksheet.
SectionSelection button that adds a Section into the Worksheet.
CopySelection button that copies a Section or Control from another Worksheet.
GroupSelection button that displays a sub-group of selection buttons that are defined in the "Controls" property collection below. As such, this option makes the "Controls" collection available for use.
TextText that identifies the Control.
ImageImage displayed next to the text.
ShowDetermines if the item appears in the "Add Content" dialog.
TipTooltip displayed for the Control.
Key Determines the keyboard shortcut key. Options are A through Z.
Property TreeControl to which the "Add Content" dialog applies.
Template OnlyWhen adding a Control, this determines if you are required to choose a Control Template.
Add TextText shown in the "Add Content" dialog when adding content to the Worksheet (such as "Add a new Form").
Default TemplateIf "Template Only" is "Yes", this determines the default Template.
Template CategoryDetermines the Template Categories that are available.
Group NameAllows Controls to be grouped in the "Add Content" dialog. For example, if the Group Name is "LIMS Controls", this Control will be in the "LIMS Control" group.
Controls This collection is available if the "Type" is "Group". Defines a Group of Controls.
PropertyDescription
TextText displayed to identify the Group.
ImageImage displayed to identify the Group.
ShowDetermines if the item appears in the "Add Content" dialog.
TipTooltip displayed for the Group.
Property Tree Control in the Group. Choices are the same as Add Content → Controls → Property Tree.
Template OnlyWhen adding a Control, this determines if you are required to choose a Control Template.
Add TextText shown in the "Add Content" dialog when adding content to the Worksheet (such as "Add a new Form").
Default TemplateIf "Template Only" is "Yes", this determines the default Template.
Template CategoryDetermines the Template Categories that are available.
NOTE: The items rendered in the "Add Content" dialog depend on the ELN Policy node to which the Worksheet Template points. The node is set by the Worksheet Options → Policy option in the Worksheet Manager.

As configured OOB:

The Sapphire Custom node renders all Controls in a single list.
The Experiment Custom node renders all Controls that do not apply to LIMS Data. A "LIMS Data" link is provided to render all LIMS Data Controls. A "Back" button is provided.
The LES Custom node renders all LIMS Data Controls. An "ELN Controls" link is provided to render all Controls that do not apply to LIMS Data. A "Back" button is provided.
Publish Format Defines Microsoft Word publish formatting properties. This is based solely on Word, before any other conversion occurs. 
PropertyDescription
Publish Options Offers options for exported files.
PropertyDescription
Publish Filename Filename for the published file. Two default options are provided: [worksheetid] and [worksheetname].

This property is editable and supports many substitution options, including [currentuser], [authorid], [author], [authorname], [title], [worksheetname], [worksheetdesc], [worksheetid], [worksheetversionid], [worksheetstatus], [workbookid], [workbookdesc], [workbookname], [workbookownerid], [workbookowner], [workbookownername], [shortdate], [mediumdate], [longdate], [shortdatetime], [mediumdatetime], [longdatetime], [date], [datetime], [currentdate], and [currentdatetime].

Based on Word Template Word template to be used as the basis for the exported document, e.g., [applicationhome]/officetemplates/ELN2.dotx.

Two example templates (ELN1.dotx and ELN2.dotx) are available OOB in the LABVANTAGE_HOME\APPLICATION_HOME\officetemplates directory. Projects can add their own additional templates in this folder if desired.

Word Templates can include tokens whose values will be substituted from the Worksheet at publish time. These token can be used in both the title page and in headers and footers. For example, the following header in the Word Template:

Looks like this at publish time:

The following tokens are available for use (tokens in parentheses are synonyms): [currentuser], [authorid], ( [author], [authorname] ), ( [title], [worksheetname], [worksheetdesc] ), [worksheetid], [worksheetversionid], [worksheetstatus], [workbookid], ( [workbookdesc], [workbookname] ), [workbookownerid], ( [workbookowner], [workbookownername] ), [shortdate], ( [date], [mediumdate], [currentdate] ), [longdate], [shortdatetime], ( [datetime], [mediumdatetime], [currentdatetime] ), and [longdatetime].

Using a Word template has the following affect on other Publish options:

"Text Style" properties are ignored. All styling information should be defined within the template.
The "Include Title Page" option is still honored. If set to "Yes", the publish routine will generate a title page. However, it is recommended that the title page is included in the Word template itself, as this allows for more visually pleasing documents.
The "Include Table of Contents" option is still honored. If set to "Yes", a Table of Contents page will be automatically generated.
Header and Footer properties are ignored when using a Word template. These are expected to be defined in the template itself.
Allow MS Word

Allow PDF

Allow HTML

These properties are provided to restrict exports to specified file formats. When set to "Yes", the publish file format is shown when clicking the "Publish" button on the Worksheet Manager Toolbar, and allows the format to be exported using the ExportWorksheet Action. Setting the relevant property to "No" prevents the format from being shown by the Publish button, and prevents the format from being published by the Action.
PageSetup Defines page formatting in the exported document. 
PropertyDescription
Page Size Determines the printed page size. Options are Letter, Legal, A4, A5, B5, Custom. Alternatively, you can also specify custom page width and height below.
Custom PageWidth Custom page width. The units can be any supported by Word.
Custom Height Custom page height in the same units as page width. 
Orientation Determines the printed page orientation. Options are Portrait and Landscape.
Margin Style Options are Normal, Narrow, Moderate, Wide (as defined by Word). Alternatively, you can also specify custom margins below.
Custom Margin Top Custom top margin (if desired) in the same units as page width.
Custom Margin Bottom Custom bottom margin (if desired) in the same units as page width.
Custom Margin Left Custom left margin (if desired) in the same units as page width. 
Custom Margin Right Custom right margin (if desired) in the same units as page width. 
Text Styles Defines text formatting in the exported document. 
PropertyDescription
Style Name Microsoft Office style defined for the docx format. Options are Normal, Heading 1, Heading 2, Heading 3, Heading 4, Header Footer, Caption, Main Title.

You can also create your own additional styles by adding Reference Values to the ELNExportTextStyles Reference Type.

Font Name Windows TTF to use in the document.
Font Size Font size for the style in units supported by the corresponding Word style.
Text Color Color of the text.
Bold Applies bold text formatting.
Italics Applies italic text formatting.
Underline Applies underline text formatting.
Title Page Defines the format of the Title Page in the published document.
PropertyDescription
Include Title Page Determines if the document contains a title page. If "Yes", the options below determine formatting.
Top Text Text shown at the top of the Title Page. 
MiddleText Text shown at the middle of the Title Page. 
Bottom Text Text shown at the bottom of the Title Page. 
Top Text Style Office style applied to the Top Text. Choices are the same as Publish Format → Text Styles → Style Name.
Middle Text Style Office style applied to the Middle Text. Choices are the same as Publish Format → Text Styles → Style Name.
Bottom Text Style Office style applied to the Bottom Text. Choices are the same as Publish Format → Text Styles → Style Name.
paddingbottom Padding applied to the bottom of the page.
paddingtop Padding applied to the top of the page.
Table of Contents Defines the format of the Table of Contents in the exported document. 
PropertyDescription
Include Table of Contents Determines if a Table of Contents is generated. If "Yes", the options below determine formatting.
ToC Title Title of the Table of Contents.
ToC Title Text Style Office style applied to the ToC style. Choices are the same as Publish Format → Text Styles → Style Name.
Headers and Footers Defines the format of Headers and Footers in the exported document. 
PropertyDescription
Show Header Determines if Headers are shown. If "Yes", the options below determine formatting.
Header Left Text Left-justified Header text. 
Header Middle Text Centered Header text. 
Header Right Text Right-justified Header text. 
Header Text Style Office style applied to the Header Text. Choices are the same as Publish Format → Text Styles → Style Name.
Show Footer Determines if Footers are shown. If "Yes", the options below determine formatting.
Footer Left Text Left-justified Footer text.  
Footer Middle Text Centered Footer text. 
Footer Right Text Right-justified Footer text. 
Footer Text Style Office style applied to the Footer Text. Choices are the same as Publish Format → Text Styles → Style Name.
Sections Defines Section formatting in the exported document.
PropertyDescription
New Page on Level 1 Sections Determines if a page break is added with Level 1 Word section formatting.
Suppress NumberingWhen "Yes", export of a Worksheet will not render numbers for each Section.
Level 1 Text Style Office style applied to the Level 1 Text. Choices are the same as Publish Format → Text Styles → Style Name.
Level 2 Text Style Office style applied to the Level 2 Text. Choices are the same as Publish Format → Text Styles → Style Name.
Level 3 Text Style Office style applied to the Level 3 Text. Choices are the same as Publish Format → Text Styles → Style Name.
Level 4 Text Style Office style applied to the Level 4 Text. Choices are the same as Publish Format → Text Styles → Style Name.
PDF Options Defines options compatible with the specified Adobe Acrobat PDF compliance standard. 
PropertyDescription
Add Bookmarks Determines if PDF Bookmarks are shown.
Bookmark Mode Determines the PDF elements for which Bookmarks are created. Choices are Level 1 Sections, All Sections, All Sections, and Captions.
PDF Standard Adobe Acrobat PDF format compliance standard. Choices are PDF 1.5, PDF/A-1a, and PDF/A-1b. See http://www.pdfa.org/2011/06/pdfa-faq.
Notes and Comments Determines which Notes are shown.
PropertyDescription
Show Notes "Yes" shows only the top-level Notes.
Show Additional Comments "Yes" shows the levels below the top-level Notes (such as Comments).
Images Determines image behavior in the export.
PropertyDescription
Show Image MarkupDetermines if image markups are shown.
Metadata Determines metadata behavior in the markup.
PropertyDescription
Show MetadataDetermines if metadata are shown.
Caption TitleIf metadata are shown, this is the relevant Caption Title.
Attachments Determines the behavior of ELN Attachments, which include images uploaded into the Rich Text Control, files uploaded into the File Viewer Control, and Attachments added to ELN Worksheets.
PropertyDescription
Store attachments by reference"Yes" uploads ELN Attachments as Reference Attachments. "No" stores ELN Attachments directly in the database.
FileLocationPolicy node for attachments by referenceIf "Store attachments by reference" is "Yes", this is the node in the File Location Policy that specifies the upload location. Note that OOB, the File Location Policy has an "ELN Custom" node that points to LABVANTAGE_HOME\eln\attachments.
FileLocationPolicy node file idIf "Store attachments by reference" is "Yes", this is the "File Locations Id" in the File Location Policy for the upload location node specified by "FileLocationPolicy node for attachments by reference".
ChemAxon Settings Determines how the ChemAxon Marvin Editor Control is licensed and deployed.
PropertyDescription
Marvin License Type Configures the mode in which the Marvin Editor Control is used.
ModeDescription
None (Evaluation Only) The Marvin Editor Control operates without a ChemAxon license or ChemAxon Web Services in an "evaluation" mode. The Control indicates that it cannot find a ChemAxon license by displaying "Valid license cannot be found" in the upper left corner of the editor.

This is the mode preselected in the OOB configuration.

MarvinJS Only The Marvin Editor Control operates in a "basic" mode without the additional capabilities provided by Chem Axon Web Services (such as extended file types, image rotation, etc.).

In this mode, the "Marvin License File" property (below) is made available to specify the location and name of your license file if it differs from the default provided in the OOB configuration.

MarvinJS + WebServices The Marvin Editor Control attempts to connect to ChemAxon Web Services to gain extended functionality. In this mode, ChemAxon Web Services (webservices.war) must be deployed in the Application Server. The Application Server must be running in a JDK 8 environment. The ChemAxon Web Services will not deploy in an environment lower than JDK 8.

For users with ChemAxon licenses, detailed instructions regarding Web Service deployment are available at www.chemaxon.com. At the time this document was written, only sections 1 and 2 of these instructions were applicable ("Prerequisites" and "Deploying Web Application"), as the database, authentication, and reagent libraries are not currently used.

The ChemAxon webservices.war file is provided in the LabVantage distribution. When using these Web Services, the two license files (one for MarvinJS, one for the Web Services) must be placed in a specific folder as described in the ChemAxon installation instructions (such as in %UserProfile%\chemaxon\licenses on a Windows OS platform). Current testing indicates that the Web Service license file can be given any name, but the MarvinJS license file must be named "licenseMarvinJS.cxl".

The "WebServices Server Name" and "WebServices Web App" properties (below) are made available to specify the name of the host machine and Web Application if they differ from the default provided in the OOB configuration.

Marvin License FileThe default value provided in the OOB configuration is LABVANTAGE_HOME/APPLICATION_HOME/chemaxon/licenseMarvinJS.cxl. In "MarvinJS Only" mode, you can change both the location and name of the license. If you do this, change this property to point to different location and filename.
WebServices Server NameIn the OOB configuration, this is left blank. A blank value defaults to the hostname of the machine hosting the Application Server.
WebServices Web AppThe default is webservices.
Worksheet Name Uniqueness Determines whether Worksheet Name uniqueness is required across all Worksheets, globally, or within the same Workbook.
PropertyDescription
GlobalWorksheet Name must be unique within the system.
Per WorkbookWorksheet Names within the same Workbook must be unique.