Introduction

Value Sets Graphical User Interface (VS GUI) is developed using java SWT widgets to help developers/testers to quickly and easily test many of the functions available in LexEVS Value Sets services. This tool is included in LexEVS install package.

This tool is never intended for use in real time production as an interface for LexEVS Value Sets services.

How to Get This Tool

As mentioned earlier, this tool will be downloaded when LexEVS package is installed. The start scripts can be found at <LexEVS install directory/gui/
Different start scripts will be downloaded based on operating system selected during install:
Windows-lbVSGUI.bat - for windows
Linux-lbVSGUI.sh - for linux
Linux_64-lbVSGUI.sh - for linux 64 bit
OSX-lbVSGUI.command - for OS

Major Functions Available

Each of these function are described in following sections.

Configuration

Prior to using this tool, LexEVS instance should be configured properly. File lbconfig.props located at <LexEVS install directory>/resources/config/ should be set up properly, specially the database URL, driver, username and password.

Load function

Using this tool, you can load Value Set Definition(s) or Pick List Definition(s) from an XML file. The contents should confirm to LexGrid valuesets.xsd schema.

Before you start loading any definitions, make sure you have configured the LexEVS instance properly as described above under 'Configuration' section of this document.

Loading Value Set Definition

This function allows you to load Value Set Definition contents from XML file that is in LexGrid format (ie. The contents confirms to LexGrid valuesets.xsd schema).

You can find a test data in <LexEVS install directory>/test/resources/testData/valueDomain/vdTestData.xml, that can be used to load for testing purpose.

Step

Action

1. Make sure to check 'Enable Admin Options' in 'Commands' menu.

[[Image:EnableAdminOptions.jpg

frameless

center

900px

2. Select 'Load Value Set Definition - LexGrid XML' from 'Load' menu.

[[Image:LoadValueSetDefinitionMenu.jpg

frameless

center

900px

3. A separate window will open to select a file to load. Select a file to load.

[[Image:SelectVSDFileToLoad.jpg

frameless

center

900px

4. Click 'Load' button. Status of load process will be displayed as the data is getting loaded. If everything goes well, you should see 'Errors Logged: false' and 'End State: completed' at the bottom of the status output.

[[Image: VSDLoadComplete.jpg

frameless

center

900px

5. Value Set Definitions loaded should be displayed on the main console under 'Available Value Set Definitions'.

[[Image: VSDLoadedContents.jpg

frameless

center

900px

Loading Pick List Definition

This function allows you to load Pick List Definition contents from XML file that is in LexGrid format (ie. The contents confirms to LexGrid valuesets.xsd schema).

You can find a test data in <LexEVS install directory>/test/resources/testData/valueDomain/pickListTestData.xml, that can be used to load for testing purpose.