User manual
Ownership : Fujitsu Systems Europe
Summary: This document describes the user interface developed as part of the Fujitsu Chromatography On Demand solution to automate chemical traces detection in sample.
Each view in the application has a common display zone, the title zone:
Pop-ups are always displayed in the same place, informing the user of what the application is doing:
Information bubbles close after 4 seconds. A progress bar representing these 4 seconds is displayed at the bottom of each message.
You can skip the 4 seconds and close the message by clicking on it.
Similarly, hovering over the message pauses the closing timer, allowing the message to be viewed for as long as you hover over it.
When a message closes, it is automatically added to the message box. (see Message widget)
All the tables in the application have a column sorting mechanism. When you hover over the title of a column, an arrow appears in transparency, indicating that it is possible to sort this column:
Clicking on the column title sorts the column either top-down or bottom-up:
All the tables in the application (except Backlog View) have a multiple selection mechanism. A selection box is present as the first column: .
The selection box in the column title allows you to select or deselect all the rows. When a selection is made, a dot appears next to the main selection box to indicate the number of lines selected: .
A button box also appears when a selection is made, offering possible actions to be taken on the selection: .
Clicking on one of the buttons applies the action to all the selected rows. The possible actions will be detailed in the explanatory sections for the various tables in the application.
Each table line that displays an object can be opened in a different browser tab. To do this, press Ctrl + Mouse Click. The new view is automatically opened in a new tab and the object in the row is loaded. It is also possible to view each table object in its raw version as in a database. To do this, press Ctrl + Alt + Mouse Click. A new window appears with the object loaded. You can then explore the object as it is in the database:
All the tables in the application (except Backlog View) can be customised.
For customisable tables, hovering over the table displays a customisation button with a cogwheel icon: .
Clicking on this button opens the table customisation window:
From this window, you can change the order of the table's columns (except the selection column, if present), their widths and their visibility.
Once you have made your changes, click on the button to save them or
to cancel. In both cases, the window closes.
To return to the table's default values, click on the button, which will also close the window.
Some tables have a “Flags” column which is represented by a pictogram representing the level of the most severe flag present for the compound:
Hovering over the pictogram displays a floating window containing the main details of the flags:
View full details of flags :
The full detailed view uses the information previously seen for the floating window and replaces the single detail of the main channel with the detail of all channels. It is obtained by clicking on the button in the floating window, and also by clicking on the pictogram of the flag representing its highest level.
The main channel is represented with .
In the case of calibration flags, only the tab is present. In other cases, the
tab is also present (see Details).
Some tables have a “Note” column which is represented by a pictogram explaining that notes have been written for the object in the row (with the number of notes):
Hovering over the pictogram of a note displays the list of notes:
For each note, the date the note was created, the note message and the user who wrote the note are displayed.
At the bottom of the note display window, there is a button for adding a new note:
Clicking on this button has the same effect as clicking on the pictogram of a note, and displays the window for editing a new note:
Only the note message needs to be filled in. The button saves the note and the
button cancels the creation of a new note.
When no note is present, the button is represented by :
Notes for Batch objects are displayed differently:
In addition to the Batch notes, it is possible to access the notes of objects inheriting from this batch. Analyses and calibrations
. The number of notes displayed on the pictogram of a Batch note is the sum of the batch notes + the number of notes of the analyses and calibrations inherited from this batch.
Clicking on the analysis note or calibration note buttons opens the window displaying the analysis and calibration notes for the inherited batch:
The window has 2 tabs corresponding to analysis notes and calibration notes.
Some tables have a “Modified” column which is represented by a pictogram explaining that the object in the row has been modified by an operator:
By clicking on it, a window with all the changes appears:
Each modification is represented as follows:
The button closes the modifications window. Similarly, as with all windows, clicking outside the window will close it.
Some tables have a validation column which is specific to the type of table (details of validations are described in the details of the table concerned).
Validation has several states:
If no validation is performed, the validation buttons are all grey:
If a validation is performed, the corresponding validation button is coloured:
Validation buttons are exclusive, and clicking on a validation button that has already been activated will remove the validation.
Some tables have a “Peak name” column containing a pictogram . The pictogram appears after the name if the compound is part of a sum molecule.
When hovered over, the badge gives information on the associated sum molecule, and a detailed bubble appears with the name, formula and coefficient:
The normal view is the representation of chromatograms from the Compound chromatogram panel and Analysis chromatogram panel.
You can zoom in and out of the graph. To zoom in: Ctrl + Mouse Wheel and to move around: Hold down the left mouse button and move around.
Once zoomed or moved, a menu option appears in Main menu allowing you to return to the default position and zoom.
The name of the compound or analysis is displayed at the top. Here it is “TNFA”.
The transitions (channels) available for the compound or analysis are displayed in the top left-hand corner.
The colour of the text corresponds to the colour used to represent it in the graph.
The pictogram indicates which channel displays its area. By clicking on another transition, the new transition obtains the
pictogram with the associated colour and thus displays its area.
The integration of the area under the curve is represented by orange colouring under the integrated curve and bounded by two points represented by the pictogram .
The integration displayed is always that corresponding to the selected transition (see Transitions).
There are 2 possibilities for reinstatement:
When you hover over the integration points, an information bubble appears showing the coordinates of the point: .
A Main menu option allows you to return to the default positions: .
A Main menu option allows you to apply the integration to the entire series: .
When known, the calibration retention time and the corrected retention time are displayed on the graph by a vertical bar:
Calibration retention time: orange colour, “RT Cal” label
Corrected retention time: blue colour, “RT Cor” label
In the top right-hand corner, a pictogram is displayed representing the level of the most severe flag present for the compound or analysis. Clicking on it opens the flag details window (see Flags).
When you hover over a chromatogram, the menu button appears in the top right-hand corner:
The detailed view makes it easier to visualise the chromatogram and to superimpose curves for comparison.
This view has 3 zones:
You can change the display proportions between the graphics area and the other two by moving the separator represented by . By hovering over the separator, the indicator changes to
indicating that you can click and drag this separator.
The result table contains columns which can be sorted and customised as explained in section Tables.
By default, without even changing the selection from the Parameter area, the analysis by which the detailed view was opened will always be present, even if the tick corresponding to its type is not checked.
Details of specific columns :
Clicking on the colour opens the colour customisation window:
The colour can be changed using the “Change colour” insert. A change is automatically applied to the “New colour” insert to show the future colour. A reminder of the current colour is displayed in the “Old colour” insert.
When a colour is changed, all the rows in the table corresponding to the same analysis will be changed in order to keep the same colour per analysis. The colours are stored in the settings panel.
Hovering over a line in the table makes the curve in the Graphic display area thicker, making it easier to see:
Once added, a sticker showing the analysis is displayed in the Samples / Others field:
Use the cross to remove the analysis from the selection.
Information displayed: see Information displayed, with a few differences:
The message widget displays all the messages (information bubbles) that have appeared during the user's session.
The widget button displays the status of the message box:
Hovering over the widget button displays a tooltip with a maximum of the last 10 unread messages:
Clicking on the widget button opens the messages window:
This window lists all the messages and allows you to filter their display.
The banner consists of 2 parts (filter section and on notification section)
The section messages are displayed in the form of a list with icon and message:
The button is used to close the window (same function as the Escape key). By closing the window, all messages that were previously “new” will no longer be so in the future.
The activity widget displays all the operations launched on the platform. System and user actions.
The widget button shows how many tasks are currently running:
Hovering over the widget button displays a tooltip listing all the tasks currently being processed (with the user who launched the task, the operation performed and the time it was run):
Clicking on the widget button opens the activities window:
When this window is opened, if the number of results allows it, the view is automatically scrolled to the most recent element. And if you are scrolling manually, a button appears which takes you directly to the most recent element:
The button closes the window (same function as the Escape key).
The activity window consists of 2 parts:
A result is represented as follows:
Finally, the right-hand side displays information about the action. In the event of an error, a pictogram appears and when you hover over it, a tooltip with the error message is displayed:
The search widget enables you to find an analysis or batch in the database and display it directly, without having to go through the application's traditional navigation.
Entering data in the search box opens the global search panel with the results:
The menu is opened by clicking on the menu button on right side of the banner. The menu options are:
This panel provides a clear summary of the user's access rights, system environment, version details and allow to the release notes.
stephane.romdhane2
stephane.romdhane2
Public
Guest
Laberca
common
alphacod_services
3.2.0_rc2
This interface is a settings panel that allows the user to configure various aspects of the application.
common
). English
with a UK flag). Yes
). Molecule only
). No
). 10,000
ms). No
). Yes → Enabled
). dark blue
). blue
). mg/kg
) µg/l
) µg/l
)Allowed
). Active
). The Backlog view is made up of 2 zones:
A tooltip allows you to view the detailed progress of calibrations and analyses:
By clicking on this button, a menu list of actions is displayed:
Replace
– Replaces the existing batch data. Update
– Updates the batch without full replacement. All
– Applies to all available data. Last 4
– Only applies to the last four data points. Pesticides (current)
.
^Minimized panel^Normal panel^
||
|
The navigation panel is used to navigate between the different views of the application. This panel is visible from the Batch, Overall, Analysis and Compound views and is always positioned on the left of the interface.
Analyses are represented by the pictogram .
They are displayed in order of the type by default and it can be reorder by user with icon.
Each analysis is displayed with its type represented at the end of the button: .
They are displayed in the form of a dot on the pictogram in minimized navigation: .
Display the compound selected via the Compound view.
The view is divided into 6 zones:
When the separator between 2 panels is present and represented by , it is then possible to change the display proportions between them. By hovering over the separator, the indicator changes to
indicating that you can click and move the separator.
Batch Pesticides 1
Shim 21
Urgent
0.4%
and 1.4%
for analyses' validation. st
in a circular icon. It's the last operator who worked on the batch (first 2 letters of the name) Same actions button as in the Backlog view:
The panel can be minimized to increase the display area for other panels.
When you hover over the panel, a tick appears :
Clicking on it reverses the tick and retracts the panel:
The Calibration panel consists of 2 sub-panels:
The delimiter between the two sub-panels can be moved vertically to increase or reduce the size of the 2 sub-panels.
The calibration compounds are displayed in a filtered table. There is a filter section and a results section.
Calibration offers 3 types of filter:
The result table contains sortable columns, multiple selection and customisation as explained in section Tables.
Clicking on a line in the table displays the calibration graph for the compound in the Graphics sub-panel (the text is displayed if no selection is made). The line is then displayed with a coloured background so that you can see which line in the table corresponds to the graph displayed.
Double-click on a line to open the compound in its Compound view.
Details of specific columns :
If a compound has been clicked beforehand, its calibration curve is displayed as above. This view is made up of 2 parts, a parameter setting part and a graphical representation part.
It is possible to modify certain calibration parameters, as well as the display:
* Information is displayed on the graph:
* Context menu:
* Display point:
* Other action:
Quality Control panel presents Quality Control analyses table, including Blank, Matrix bio, End Standards, and Calibration samples.
calibration
, blank
, matrix_bio
). meta
, neg
, default
). The table contains multiple samples with different attributes, such as:
10m 30-11
, std 1 ppb
). blc_001
, blc_002
). pb
, pbd
). pbd
). Move the analyses to outside the panel is the action available in 3 panels : Quality Control, Customer Samples and Others.
Users are prompted to confirm and configure the selected analyses
Example, move the analyses from the Quality Control panel to another panel example
The Customer Samples panel displays analyses table of the “Sample” type. It contains:
* Title: Customer Samples
* Table: sortable columns, multiple selection and customisation.
* Action Icons (Top Right) :
The Others table displays analyses of type “Other” (non-blank, non-bio-matrix, non-bio-matrix spiked, non-end standard, non-calibration and non-sample). Like the Quality Control panel and Customer Samples panel, it lists the analyses in a table and has the following actions.
The view is divided into 5 zones:
When the separator between 2 panels is present and represented by , it is then possible to modify the display proportions between them. By hovering over the separator, the indicator changes to
indicating that you can click and move the separator.
Analysis Info Panel provides an overview of the current batch analysis, displaying key information, along with multiple action and filter icons.
Pesticides 1
→ Indicates the batch name. Dilution: 1
→ Shows the dilution factor or related dilution sample. None
) : This dropdown (next to *Pesticides 1*) likely allows users to select a filter and edit filter. Global filters for compounds that can be displayed: 5. Search bar:
The information panel can be reduced to increase the display area for the other panels. When you hover over the panel, a tick appears:
Clicking on it reverses the tick and retracts the panel:
In retracted mode, the tick is always visible.
This window displays the results of an automated validation process for compound analysis. The system classifies and validates compounds based on predefined scoring rules.
The window is divided into the following sections:
This window streamlines the review of compound validation, enabling users to quickly assess and act on results.
The View Settings window allows users to customize the visualization options for chromatographic data. It is divided into two main tabs:
Users can enable or disable specific display options using checkboxes: enabled options are checked and disabled option are unchecked.
On the right side, there are three sliders and a color palette for customization of display zone on chromatogram:
At the bottom, there are three buttons:
The LAYOUT Tab of View Settings window provides users with the ability to customize the layout of the interface. This tab focuses on selecting a specific layout for data visualization.
At the bottom of the window, the following buttons are available:
Global filters are used to pre-filter the molecules displayed by selecting only the molecules you want to see. The choice of filter type is made automatically when the filter is created.
By default, no global filter is selected:
Clicking on it brings up the global filters menu:
This menu consists of a list of filters, always starting with the default 'None'. No restrictions on molecules are applied.
For each global filter, a range of information is available:
By hovering over the number of molecules, an information bubble appears with the list of molecules contained in the filter.
ISTD molecules are represented with a badge .
Clicking on the create button opens the global filter creation window:
The creation window includes a mandatory editable field for entering the filter title:
As filters are shared between all users, the title field blocks the creation of a filter already bearing the name entered in the field. A message is displayed:
If this field is empty, the filter cannot be created and the save button is disabled: .
On the left-hand side is the list of molecules available to add to the filter:
By default, all ISTD molecules are pre-selected so that they can be added directly to the filter. They are represented by the badge .
A search box allows you to enter the name of the molecule you are looking for to build the filter more easily:
In the centre are 2 buttons that can be used to move a selection from one list to another, in order to add or remove molecules from the filter:
Adds available molecules to the filter
Removes molecules from the filters to the list of available ones
The right-hand side lists the molecules that will be in the filter:
Molecules must be added to this list to create a filter.
ISTD molecules are pre-selected so that they can be added directly to the filter. They are represented by the badge .
A search box allows you to enter the name of the molecule you are looking for to build the filter more easily:
⚠ Displaying the list filtered by a search does not constitute the list that will be saved in the filter.
If no molecule is present in the list on the left , the filter cannot be created and the save button is disabled:
.
If a name is entered and the filter list contains molecules, the save button is activated:
. Clicking on it saves the filter. The
button cancels the filter creation and closes the filter creation window.
Clicking on the edit button opens the global filter editing window:
This is the same view as for creation. (see Creation)
However, on opening, the name of the filter is automatically entered in the field allocated for this purpose and the list of filter molecules is filled with the molecules contained in the filter.
Clicking on the delete button opens a confirmation message:
*
: Permanently removes the filter for all users
*
: Cancels the deletion.
The result table contains sortable columns, multiple selection and customisation as explained in section Tables.
Clicking on a line in the table displays the calibration graph for the compound in the Calibration Panel (the text is displayed if no selection is made, or
if the selection is an ISTD), the line is then displayed with a coloured background so that you can see which line in the table corresponds to the graph displayed. The Compound Chromatogram Panel automatically scrolls to display the associated chromatogram.
Double-click on a line to open the compound in its Compound view.
Some values in the table may be displayed in colour. This means that additional information is visible. The colour defines the level of the message (Info, Warning, Error). If you hover over the value, a detail bubble is displayed:
Details of specific columns :
: Validation OK / Validation KO / Validation relaunch.
: Validation Detected / Validation Not Detected / Validation retry.
validation in OK,
validation in KO,
validation in relaunch.
validation as detected,
validation as not detected,
validation as relaunch.
The current transition is displayed on a grey background.
Once the changes have been made, you can save by clicking on the button or cancel by clicking on the
button.
The chromatogram panel is a different view of the compounds displayed in the Compound Table Panel. It displays the detected retention time curve for each compound in the form of a grid.
Clicking on a chromatogram displays the calibration graph for the compound in the Calibration Panel (the text is displayed if no selection is made, or
if the selection is an ISTD), the chromatogram is then displayed with a coloured background to identify which chromatogram corresponds to the calibration graph displayed. The Compound Table Panel automatically scrolls to the line of the corresponding associated compound.
Double-click on a chromatogram to open the compound in its Compound view.
Use the slider on the left to change the size of the tiles in the grid:
For details of chromatograms, see section Chromatogram.
For details of calibration, see the section Graphics sub-panel.
The view is divided into 5 zones:
When the separator between 2 panels is present and represented by , it is then possible to change the display proportions between them. By hovering over the separator, the indicator changes to
indicating that you can click and move the separator.
The information panel shows the most important information about the analysis. On the first line at the top :
The second line shows the filters applied to the Analysis table panel and to the Analysis chromatogram panel :
The search is based on the values displayed in the columns of the Analysis table panel. This “search” filter is also applied to the Analysis chromatogram panel. When an entry is made in the search field, a cross appears to delete the search entry and remove the filter applied to the table:
On the status, validation and miscellaneous filters, a bubble is displayed to indicate the number of elements corresponding to the filter: .
When a filter is activated, its theme changes from grey to the chosen secondary colour (by default, orange):
The information panel can be reduced to increase the display area for the other panels. When you hover over the panel, a tick appears:
Clicking on it reverses the tick and retracts the panel:
In retracted mode, the tick is always visible.
The result table contains sortable columns, multiple selection and customisation as explained in section Tables.
Clicking on a line in the table displays the calibration graph for the analysis in the - Calibration Panel (the text is displayed if no selection is made, or
if the selection is an ISTD), the line is then displayed with a coloured background so that you can see which line in the table corresponds to the graph displayed. The analysis chromatogram panel automatically scrolls to display the associated chromatogram.
Double-click on a line to open the analysis in its Analysis View.
Some values in the table may be displayed in colour. This means that additional information is visible. The colour defines the level of the message (Info, Warning, Error). If you hover over the value, a detail bubble is displayed:
Details of specific columns :
: Validation OK / Validation KO / Validation relaunch.
: Validation Detected / Validation Not Detected / Validation relaunch.
: Validation Detected, OK / Validation Not Detected, KO / Validation restart.
ℹ In the case of a multiple selection where the analyses are of the mixed type, a finer selection window is displayed:
validation in OK,
validation in KO,
validation in restart.
validation as detected,
validation as not detected,
validation as relaunch.
The current transition is displayed on a grey background.
The chromatogram panel is a different view from the analyses displayed in the Analysis table panel. It displays the chromatogram for each analysis in the form of a grid.
Clicking on a chromatogram displays the calibration graph for the analysis in the [#calibration_panel|Calibration panel]] (the text is displayed if no selection is made, or
if the selection is an ISTD), the chromatogram is then displayed with a coloured background to identify which chromatogram corresponds to the calibration graph displayed. The Analysis table panel automatically scrolls to the line of the corresponding associated compound.
Double-click on a line to open the analysis in its Analysis View.
Use the slider on the left to change the size of the tiles in the grid:
For details of chromatograms, see section Chromatogram.
For details of calibration, see the section Graphics sub-panel.
If the file’s method format is supported by the COD Platform, this tool enables conversion of a method file or other compatible files into a standard COD method file format (.cod.xlsx).
A window will then appear:
In this window, click on the 'Upload method file' button and select a compatible method file from the file explorer.
Next, a reference configuration can be chosen, which is recommended in most cases if available. This will retain specific information from an existing COD method file, such as chromatogram settings for various compounds.
If a reference configuration is not used, a filename will need to be specified.
Once all settings are configured, click on 'Convert.' If the file is processed successfully, a .cod.xlsx file will be generated and downloaded to the computer.
Following manual modifications to user preferences (Settings Panel), it may happen that these modified user preferences cause the application interface to freeze. This may prevent the application's main menu from being displayed and therefore prevent access to the user preferences panel in order to correct the error.
To solve this problem, there is a special page accessible via the following URL:
https://[base_url:port]/[platform]/?clean
This web page displays only a large button in its centre. Clicking on the button erases all user preferences and resets them to their default values.
⚠ This action is irreversible and all user preferences are lost.