Start

User Guide

• User Guide
  • Prerequisites
  • Main window
  • Create Lot
  • Lot Positions
    • Drug finder
  • Stock Data (Warehouse)
    • Integration mechanism
    • Getting and reserving drugs
    • Save lot position
  • Export lot (auction) into Excel file

Prerequisites

See Installation Guide

• JDK 1.7 installed
• Glassfish 4 installed
• Glassfish user was created and included in the following groups
  • managers
  • administrators
• Sample database with sample data was created
• ExtJS-web project was deployed
• AuCa-ear project was deployed
• Allowed Internet browsers: IE 8 and above, FireFox, Chrome, etc.

Main window

Open following URL: http://localhost:8080/AuCa-web/. If the system installed properly, main desktop should appear. Left mouse click on Lot icon opens lot (auction) management window.
Here user can use filter panel to filter auction list by time period. By default "from" date equals to month before current date and "to" date is current date. Therefore all lots for last month should be listed.

Also user can use action buttons to search, add, edit and export lots.

Most of UI elements can store it's state using cookies. Such as columns order in grid, width and so on.

If the system installed properly you can see one lot. This lot has start date - 19/09/2013 (d.M.Y), therefore you should set filter so that it include this date in the period.

In spite of lot already exist let create another one.

Create Lot

Press "Add.." button. New window named Lot Editor will be opened.
Here we should fill basic information about lot (auction).
Required fields are following:

• Code - short name of this lot. This field should briefly describe this auction
• Version - reserved for future use.
• Name - name of this auction
• Client code - short name for client (customer) for which this auctions will create
• Start At - date at which this auction will be started
• Status - current status of this lot
• Likeliness - This field describes possibility to win this lot in percents
• Profit (plan) - Desired profit for whole lot

All other fields are optional

Also you can add additional costs e.g. taxes.
After pressing OK button all information will be saved in database and new lot will be appears in the list.

Changing auction action performs in the same way

Lot Positions

After new lot was added we can insert drugs inside it. To do this press "Add drugs.." action button. Now you can see Drugs Finder dialog. This window consists of two big parts:

• Drugs reference including general tab
• Stock data tab

Drug finder

First part provides view for drugs reference loaded using LoadDrugs program or entered manually. Each record for drug contains basic information which represented as grid in top of dialog and also shown in fields below, in general tab. Also drug's records contains drug forms and drug instructions.
Drug forms represents in grid in the bottom of dialog.
Drug instructions in grid in the left of the dialog. Drug instructions includes picture or PDF file which can be shown by clicking twice on relevant row in instructions grid.

To find desired drugs user should use filter which located in the top of dialog window.
Searching is allowed for following fields:

• International name
• Trade name
• Drug form
• Registry number
• Registry owner (Producer)

Stock Data (Warehouse)

Integration mechanism

When desired drug found and selected - stock data tab should be enabled. In this tab user can get information from WMS (Warehouse Management System). First of all user should configure integration interface between AuCa system and WMS.There are several approaches to implement integration between systems. We decided to use web services. So as this system doesn't include any SOA component such as ESB, we use Apache CXF to interact with outbound web services.
WMS system should develop (if it's doesn't exists) web services to provide following functions:

• Retrieve drugs from a warehouse
• Reserve drugs in a warehouse

Further, user using special LinkEditor configure mapping between data inside AuCa system and WMS. There are action buttons "Stock get config..." and "Stock reserve config..." should be used to to this. by pressing on one of this buttons, new dialog will be open. This dialog named link editor. here we just make mapping between Local data in AuCa system and Service data from WMS. For test purposes the AuCa system provides special Web Service to simulate WMS services. WSDL URL for this service is: http://localhost:8080/StockSimulatorService/StockSimulator?wsdl and operation names is findDrugsInStock - to getting data from WMS and reserveDrugsInStock - to reserve drugs.

Further, when user finished mapping for both Input and Output tabs, she must open JavaScript tab. When he did this javaScript for mapping was generated. After all press save button in the dialog.

Getting and reserving drugs

• Press action button "Get Stock data" to get data from WMS
• Select desired drugs in Stock data grid
• Press action button "Reservve stock data" to reserve drugs

Save lot position

Press OK button. Lot position will be added to lot

Export lot (auction) into Excel file

• Select lot
• Press export button