UN - Comtrade - User Guide
UN - Comtrade - User Guide
1.1. Subscription
Guest Users can become Registered Users and gain full access to Comtrade by paying an annual fee. The
Subscription menu in the main interface is reproduced below:
The following paragraph is reproduced from the “Why subscribing?” entry display:
This is why subscribing to an individual or site license and becoming a registered User may be interesting to
most trade Statisticians.
User license
Site license
On-line subscription
Download Word
subscription document
Notice that the Subscription Price form has Online and Word download subscription links.
A Comtrade Guest User isn’t registered in the Joint System administration, nor is the IP address they use to
connect to the Application server 1 . Anyone with the proper equipment (see above) can get connected to the
UNSD Comtrade application and become a Guest User.
Guests can use most of Comtrade capabilities, while Registered Users have unrestricted access to all of
them. Section 3. of this document deals with Registered Users, either individual or belonging to a registered
site.
Current
User status
Registered
User Login
Example of query
List of links and corresponding
results
1 In fact, guest Users are registered in Comtrade as Users with IP address 0.0.0.0. and restricted rights.
The left part of the Main interface is a list of function links that allow Users to select the query processor,
define reference data, subscribe to extended services, get technical support and link to related Websites. This
document will describe and exemplify all of these function links.
Query links share in fact the interfaces of only four selection/display processors; this is why parts of the text in
this document often refer –via Word links– to other sections where interfaces have already been discussed or
introduced.
Notes:
1. Free access as a Guest User to the database and search engines is restricted: for instance, up to
1,000 records SDMX-downloaded per day and no direct data downloading capability. This type of
access is used in this section. Extended service, with full capabilities, is available for an annual fee.
See the Subscription and Registered User sections for more details.
2. As already mentioned, most of the interface objects and some labels display a ‘tool tip’ text when
pointed to by the mouse cursor –see for instance fig. 5.
3. The “Example of query and corresponding results” area in fig. 1 depends on the User’s settings –
namely the ‘Customize Front Page’ parameters. It may be empty. Only a Registered User can access
the setting options.
Figure 1: Shortcut Query selection interface – here: cars exported from Japan in 2004
Clicking Search displays the following summarized results:
Note: the date contained in some commodity classification codes isn’t related to the selected statistics year(s).
It is the date the classification was defined or revised. UNSD and OECD mostly receive data according to the
last HS version. Data is then converted into older HS and SITC versions as well as into BEC.
In the example above, HS2002 is used. HS stands for ‘Harmonized System’, 2002 means that this
classification has been in use since 2002. Another classification is SITC rev. 3 (Standard International Trade
Classification revision 3). All the classifications are based on commodity features (kind, production stage,
primary material of not, durable or not, etc). The default classification in Comtrade is HS2002. See the
Comtrade Glossary entry later in this document.
If a commodity isn’t found in a classification, Shortcut Query searches other classifications for it.
In fig. 13, we notice that commodity codes are in fact links; what we get when clicking them is illustrated
below:
Extra links
Figure 4: description of the selected commodity and its ancestors
This tree-structured report describes all the commodity classes from the root (ALL COMMODITIES) to the
selected item. Again, the item codes can be selected to get more specific information.
The Snapshot link leads to the already met Comtrade Explorer –Snapshot. Refer to fig. 5 for an example of
such a snapshot, and to the Comtrade Explorer section for a thorough description of the processor.
Clicking one year in the list leads back to another query processor and shows the trade values:
Query processor
name
List of actions
Back to fig. 13, we see that the imprecise commodity definition results in a wide range of retrieved items. We
can select some of these items by ticking their checkboxes:
Then clicking ‘View trade Data’ displays detailed information about the selected items through the Basic Query
processor:
Quick filter
combo
Selection summary
List of actions
The order retrieved entries are displayed can be changed through the Sort Order combo. This combo contains
all the criterion combinations that can be used as ordered sort list:
There are no actions to directly download query results or record queries: this is because the connected User
is a Guest. Downloading extracted data as a text file (what we call ‘direct download’) and saving the definition
of a query are reserved to registered Users. What registered Users only can do is described in section 3.
Processor name
Figure 10: getting the Express Selection interface from the Shortcut Query
The User can add selection criteria, modify the existing ones or change the display sort order. The Express
Selection form is fully described in this document.
This is the Comtrade Explorer Processor interface we already met in fig. 5; also see Note 1 below this figure.
The pie chart shows the two selected items trade values compared to all the other commodities.
Again, a “tooltip” text pops up when moving the mouse cursor over the pie chart.
Back to fig. 5, we notice the already described Quick Filter and Further Research combos.
‘Free On
Board’
‘All’ can be selected from Reporter (country) and Year combos; in this case, the resulting report looks like this:
Links to
other pages
Figure 14: trade notes for all countries and all years (first page bottom part)
The SDMX format is introduced in the Data Transfer Mechanism Manual; it is based on the XML 1 format and
adapted to statistical data description and transfer.
To illustrate this download operation, we can start from the following query results:
Notice the constant filename. Clicking Save displays the usual ‘Save As’ interface that allows the User to
select the destination file (path and name)
1 Extensible Markup Language: a standard for designing and creating HTML documents
Figure 17: the downloaded SDMX file (highlighted) – the name was left unchanged
As stated before, this file has a XML-like structure; it can be read by Internet Explorer:
Figure 20: data from Albania unavailable in 2002 for the selected commodities
A subset of the Quick Search list is displayed as soon as a letter is typed. Extra letters refine the selection, like
in the example below:
Processor name
Selection
summary To filter the
selection
We won’t reproduce the whole report here. Other pie charts show the six top import / top export partners, with
the corresponding commodity descriptions and trade values. The query processor used, Comtrade Explorer,
is fully described in its own section.
Figure 6: results of selection by country (France) and commodity (gases except from petroleum)
Finally, the Further Research combo allows Users to change the selection criteria without returning to the
original interface. For instance, we can select other reporting countries:
List of currently
selected countries
List
management
buttons
We can add Japan to the country selection by selecting the Japan entry and clicking Add; we finally get:
Figure 11: Shortcut Query selection interface – here: cars exported from Japan in 2004
Clicking Search displays the following summarized results:
In the example above, HS2002 is used. HS stands for ‘Harmonized System’, 2002 means that this
classification has been in use since 2002. Another classification is SITC rev. 3 (Standard International Trade
Classification revision 3). All the classifications are based on commodity features (kind, production stage,
primary material of not, durable or not, etc). The default classification in Comtrade is HS2002. See the
Comtrade Glossary entry later in this document.
If a commodity isn’t found in a classification, Shortcut Query searches other classifications for it.
In fig. 13, we notice that commodity codes are in fact links; what we get when clicking them is illustrated
below:
Figure 13: direct selection of an item by clicking its code (here, 871130)
Extra links
Figure 14: description of the selected commodity and its ancestors
This tree-structured report describes all the commodity classes from the root (ALL COMMODITIES) to the
selected item. Again, the item codes can be selected to get more specific information.
The Snapshot link leads to the already met Comtrade Explorer –Snapshot. Refer to fig. 5 for an example of
such a snapshot, and to the Comtrade Explorer section for a thorough description of the processor.
Clicking one year in the list leads back to another query processor and shows the trade values:
Query processor
name
List of actions
Back to fig. 13, we see that the imprecise commodity definition results in a wide range of retrieved items. We
can select some of these items by ticking their checkboxes:
Then clicking ‘View trade Data’ displays detailed information about the selected items through the Basic Query
processor:
Quick filter
combo
Selection summary
List of actions
The order retrieved entries are displayed can be changed through the Sort Order combo. This combo contains
all the criterion combinations that can be used as ordered sort list:
There are no actions to directly download query results or record queries: this is because the connected User
is a Guest. Downloading extracted data as a text file (what we call ‘direct download’) and saving the definition
of a query are reserved to registered Users. What registered Users only can do is described in section 3.
Processor name
Figure 20: getting the Express Selection interface from the Shortcut Query
The User can add selection criteria, modify the existing ones or change the display sort order. The Express
Selection form is fully described in this document.
This is the Comtrade Explorer Processor interface we already met in fig. 5; also see Note 1 below this figure.
The pie chart shows the two selected items trade values compared to all the other commodities.
Again, a “tooltip” text pops up when moving the mouse cursor over the pie chart.
Back to fig. 5, we notice the already described Quick Filter and Further Research combos.
‘Free On
Board’
‘All’ can be selected from Reporter (country) and Year combos; in this case, the resulting report looks like this:
Links to
other pages
Figure 24: trade notes for all countries and all years (first page bottom part)
The SDMX format is introduced in the Data Transfer Mechanism Manual; it is based on the XML 1 format and
adapted to statistical data description and transfer.
To illustrate this download operation, we can start from the following query results:
Notice the constant filename. Clicking Save displays the usual ‘Save As’ interface that allows the User to
select the destination file (path and name)
1 Extensible Markup Language: a standard for designing and creating HTML documents
Figure 27: the downloaded SDMX file (highlighted) – the name was left unchanged
As stated before, this file has a XML-like structure; it can be read by Internet Explorer:
Figure 30: data from Albania unavailable in 2002 for the selected commodities
Tab selection
The Basic Selection feature allows the User to select the commodities, classification, reporting Nations,
partner countries and year values. It also makes it possible to filter and sort the data as well as select the type
of trade flow required (tab Others).
Each tab relates to a selection parameter and has its list of selecting (or filter) values. A group of buttons
(tagged as ‘Filter list management’) makes it possible to add, remove and exclude filter values.
The classification has already been discussed. The examples below show the selection of other parameters
tab by tab. Once all the parameters are selected, clicking Submit Query displays the records retrieved –if there
are less than 1,000 of them; otherwise, only the number of records appears.
The Source combo makes it possible to select the data source from which records will be selected:
These data selection sources are discussed in this paragraph, tagged with a ‘ ’ sign.
Clicking Search displays a tree view that allows the User to precisely select the commodities to retrieve (the
whole contents of the tree are in fact any car-related items):
Selection-resulting tree
Figure 35: commodity selection – a node (Motorcycles) and a leaf (type of vehicle) are selected
Finally, clicking Add displays the selection in the Selected Items (a filter list) frame:
As mentioned above, the selection list management buttons (see fig. 32) allow the User to edit the selection
list. Items that must be individually removed must be highlighted with the mouse; multiple selection is possible
through the Shift and Crtl keys, like in a Windows list.
Ticking the ‘All commodities’ checkbox selects the whole commodity set; the selected items are ignored in this
case.
One or more items can be excluded from the selection by clicking the Exclude button after ticking their nodes;
the excluded items are flagged with a minus sign:
Selected
Excluded
Of course, exclusion only makes sense when applied to the descendants of an already selected node for
which the ‘Include the children’ option is set.
‘Save Selection to Favorites’ is reserved to Registered (not Guests) Users. Refer to section 3. for details on
this function.
The digit-number selection can be added to commodity type conditions. Remember that the query processor
makes the union (not the intersection) of selected commodities, like they appear, for instance, in fig. 37.
The TOTAL entry means the total of trade flows. This entry should not be confused with (All): (All) means all
the registered commodities (or countries, or years, depending on the current tab of the selection interface –
see fig. 32). 'TOTAL' returns one summarized record while (All) returns all the available items, with one record
per item.
When it comes to country selection, (All) should neither be confused with ‘World’. ‘World’ is a pre-aggregated
group of the countries that make up the world. (All) means all the partner countries. 'World' is similar to
'TOTAL'.
Note: when used by the Comtrade Explorer processor, TOTAL and (All) have other meanings. Refer to
Comtrade Explorer section.
Figure 40: standard country groups (or trade agreements between countries)
Nb of records retrieved
Selection summary
Action links
The interface above, and especially its action links, has already been discussed with the Shortcut Query
function, which in fact makes use of the Basic Query processor. Again, we notice that no Direct Download or
Save Query options are available. We can still refine the selection, for instance by selecting 2002 as year; we
just have to click the 2002 link. The results are now:
New nb of records
We notice that the records themselves are now displayed: this is because there are less than 1,000 of them.
In fact, this is more an aggregation than a filtering operation: retrieved records are aggregated by reporting
countries. A true filtering by partner can be achieved through the Partners tab interface
The Quick Filter combo can also be used to filter the selection. Refer to the Shortcut Query section for details
and examples.
The Sort Order combo gives the list of all parameter permutations and makes it possible to select the order
records will be displayed.
Back to fig. 32, we notice a ‘Go to Comtrade Explorer’ button. Clicking this button leads to the Comtrade
Explorer - snapshot display we already met in the Shortcut Query section, since Shortcut Query uses in fact
the Comtrade Explorer processor. This processor is discussed in its own section.
The Reporters selection has already been discussed in the Quick Search section. Keeping the Commodities
selection of fig. 36, we can filter the query by two reporting countries:
Figure 45: two countries (Italy and Japan) selected in Reporters interface
Query summary
The links in the Basic Query results interface have been described with the Shortcut Query form.
1.1.3.4. Partners
An additional selection can be performed through the Partners interface:
Reminder: a Partner is a country that carries out trade operations with a reporting country. The trade
operations are defined by the Trade Flow parameter: import, export, re-export. Of course, all the reporting
countries are also partners.
Figure 48: query results for Commodities, Reporters and Partners selection (partial view)
We notice that this time, the retrieved records are also displayed. This is because there aren’t too many of
them.
1.1.3.5. Years
One or more years can be selected through the Years tab:
Figure 50: selection by Commodities, Reporters, Partners and Years (full view)
Figure 51: the Others selection interface – notice the aggregation option
Sorted by…
Figure 52: selection by Commodities, Reporters, Partners, Years, Trade Flow and Trade Value (full view)
The selection settings and the query results are reproduced below:
‘Ignored for
Aggregation’
Figure 53: an intra trade query – Transport Equipment within Europe for 2003 - 2004
When clicking the Comtrade Explorer entry, the following interface pops up:
The User can enter any word that defines a commodity, a county or a year. For instance:
Links
Notice that the parents and children (no child here) of the Product are also displayed; the code of the selected
product appears in red.
The ‘Input keywords’ textbox can be used to run another independent query –it doesn’t filter the current query
results.
1.1.4.2. Snapshot
Clicking the Snapshot link for an entry provides a summary report with graphic information on the selected
item. Comtrade Explorer is the query processor used:
Selection reminder
Figure 58: results of snapshot function: upper part of Comtrade Explorer interface – see lower part below
Keywords TOTAL and All in figs 58 and 59 have already been explained in the Basic Selection section. But
their meanings are different here because of the snapshot report type:
– If All is selected as partner, it will be considered as single entity World
– If All is selected as commodity, it will be considered as single entity TOTAL
– For years and reporters, All means ‘all available data’ -refer to Data Availability.
Percentage
repartition
by country
If we select ‘France (Partner Name)’ and click Apply, we get the following report:
Selection reminder:
France added as Partner
Note: if Quick Filter is used for a criterion that is already set (value ≠ ‘All’ in query summary), the Quick Filter
value replaces the already set value; in this case, Quick Filter redefines the query rather than filters it.
Then if we select ‘Gold compounds’ and click Apply, we get the following selection summary:
Summary of
reported data
Details by
country
Figure 64: data availability report for selected commodity (partial view)
This interface is addressed in the Data Availability / Commodities section later in this document.
Meta-language
capabilities
Links
Notice the Save and Lookup links that make it possible to save the codes entered and retrieve them from a list
(‘Favorites’). The interface used by Lookup has been introduced in section Quick Search.
Reminder: saving a selection or a report is reserved to registered Users (unavailable to free Users, also called
“Guests”). Refer to section 3. for information on registered Users and Favorites.
This interface has already been discussed in the Basic Query section, form Others.
List of actions
Several pages to display
Refer to the Basic Query and Shortcut Query sections for details, especially on the list of actions that is tagged
above. Note that the commodity codes and quantity units used are described by a ‘tooltip’ text.
While the data Query section explains how to retrieve information on commodities (e.g., quantities in terms of
trade value, mass or number of items exported), the Data Availability section deals with the amount of data
records collected for a given selection, whatever type they are.
Several interfaces provide the User with data availability results, for instance the already discussed Comtrade
Explorer.
The Data Availability functions are activated through the links below:
1.1.1. Interactive
The Interactive interface is reproduced below, with a selection already carried out:
The comments in the form itself explain the role of each field. The values between parentheses are the
number of records collected for the selected classification.
Year range
Filter part
Region
Real
value
The filter part of the interface makes it possible to select the reporting country, commodity codes and years.
Two bars at the top and bottom of the filter area allow the User to select a year range and a geographic entity
(e.g., European Union), instead of a country and one or more years. The Lookup links brings an already met
interface that makes it possible to select commodities by their names instead of their codes, or to select
standard Favorites.
In this interface, the results are contained in the same form as the filter values, and displayed as a bar chart.
All the classification types are used and appear with different colors. Moving the mouse cursor over a bar
displays the real number of data records, like exemplified above.
Several pages
Figure 5: the data records selected from the In Graph interface (partial)
Refer to fig. 44 in the Basic Selection section for comments on this report.
Country selection –
first letter
As usual, clicking an underlined year displays detailed information on the data records provided this year. The
Basic Query processor is used.
Links to reporting
interfaces
1.1.4. Commodities
This processor makes it possible to filter the provided data records by Commodities. Commodities are
selected from a tree-structured list we already described in the Basic Selection section:
Figure 8: commodity selection – food is the main selection – two items selected
Once the nodes or leaves are selected, clicking Add stores them in the Selected Items frame.
Two food
items selected
Clicking View description brings up the Commodity List interface; clicking Snapshot leads to the Comtrade
Explorer Snapshot form.
Several pages
in this report
Figure 10: report on specific year for selected commodities – Data Availability
Year range
selection
Filter section
Figure 12: selection by record upload date – Data Availability – ‘one month ago’
In this example, the only filter parameter is the upload date, and it is set to ‘1 month ago’. The picture below
shows the possible values:
As usual, clicking an underlined country allows Users to get trade details on it.
1.1. Support
The Support menu includes the following entries:
These entries provide online Help and remote communication with UNSD. Since they are by nature strongly
User-oriented, we won’t describe them but briefly. For some entries, we just reproduce the form they display.
Notice that, for each data upload entry, a link provides data availability by date of loading. The ‘What’s New’
link in the main interface displays the same kind of information in an abbreviated format.
Clicking the RSS button at the right of the entry displays the same information as fig. 99, but in RSS format:
The Data Transfer Mechanism document gives a few details about SDMX and its usage by the Joint System
Application.
Clicking this entry loads introductory pages to RSS with definitions, links to related sites and links to published
papers.
The ‘First Time User’ link is also present on the top right part of the main interface (fig. 1):
Figure 10: frequently asked questions and their answers (partial view) – some may be outdated
ECLAC and SDMX have already been mentioned in the Support section.
1 Feb 2006
UNSD - OECD Joint System Page ii
Web Browser Client - UN Comtrade Version User Manual
UPDATE FORM
1. INTRODUCTION .................................................................................................................................................... 1
1.1. WHAT IS MEANT BY “JOINT SYSTEM”? ................................................................................................................. 1
1.2. ABOUT THIS DOCUMENT ...................................................................................................................................... 2
1.3. PREREQUISITES ................................................................................................................................................... 2
1.4. ASSOCIATED DOCUMENTS ................................................................................................................................... 2
2. THE MAIN INTERFACE (GUEST USER).......................................................................................................... 3
2.1. HOME PAGE ......................................................................................................................................................... 3
2.2. DATA QUERY & EXTRACTION............................................................................................................................... 4
2.2.1. Quick Search ............................................................................................................................................ 4
2.2.2. Shortcut Query ....................................................................................................................................... 11
2.2.2.1. Outline and Examples.........................................................................................................................................11
2.2.2.2. Modify Selection ..................................................................................................................................................15
2.2.2.3. View Graph...........................................................................................................................................................16
2.2.2.4. Printable Format ..................................................................................................................................................16
2.2.2.5. View Explanatory Notes .....................................................................................................................................17
2.2.2.6. SDMX Download .................................................................................................................................................18
2.2.2.7. View Not Available Data.....................................................................................................................................20
2.2.3. Basic Selection ....................................................................................................................................... 21
2.2.3.1. Outline...................................................................................................................................................................21
2.2.3.2. Commodities ........................................................................................................................................................22
2.2.3.3. Reporters..............................................................................................................................................................29
2.2.3.4. Partners ................................................................................................................................................................30
2.2.3.5. Years.....................................................................................................................................................................31
2.2.3.6. Others ...................................................................................................................................................................33
2.2.3.7. A Useful Capability: the Intra Trade Query......................................................................................................34
2.2.4. Comtrade Explorer................................................................................................................................. 35
2.2.4.1. Outline and Examples.........................................................................................................................................35
2.2.4.2. Snapshot ..............................................................................................................................................................36
2.2.4.3. Data Availability ...................................................................................................................................................39
2.2.5. Express Selection .................................................................................................................................. 40
2.3. DATA AVAILABILITY............................................................................................................................................. 44
2.3.1. Interactive................................................................................................................................................ 44
2.3.2. In Graph................................................................................................................................................... 46
2.3.3. Reporters................................................................................................................................................. 48
2.3.4. Commodities ........................................................................................................................................... 49
2.3.5. Year.......................................................................................................................................................... 52
2.3.6. By Date of Loading ................................................................................................................................ 53
2.4. METADATA & REFERENCE ................................................................................................................................. 54
2.4.1. Commodity List....................................................................................................................................... 54
2.4.2. Country List ............................................................................................................................................. 55
2.4.3. Explanatory Notes.................................................................................................................................. 58
2.4.4. Glossary .................................................................................................................................................. 59
2.5. SUBSCRIPTION ................................................................................................................................................... 60
2.5.1. “Why Subscribing?”................................................................................................................................ 60
2.5.2. Subscription Prices ................................................................................................................................ 61
2.5.3. Order Form.............................................................................................................................................. 62
2.6. SUPPORT ............................................................................................................................................................ 63
2.6.1. Service Message.................................................................................................................................... 63
2.6.2. Comtrade SDMX .................................................................................................................................... 64
2.6.3. Comtrade RSS ....................................................................................................................................... 64
2.6.4. Comtrade Features ................................................................................................................................ 65
2.6.5. Help Index ............................................................................................................................................... 66
2.6.6. Questions and Answers ........................................................................................................................ 68
2.6.7. Contact Us............................................................................................................................................... 69
2.7. LINKS .................................................................................................................................................................. 70
1. Introduction
Since 2000, UNSD 1 and OECD 2 have joined forces to reduce the response burden for national data
providers in the field of merchandise trade statistics and to agree on one unique and transparent set of data
instead of having parallel (and often not harmonized) data collections. This considerable amount of very
detailed investigation has led to the signing of an UNSD/OECD Memorandum of Understanding in January
2001 and further extensions, where UNSD and OECD jointly developed
(i) an agreement on data collection and data sharing
(ii) common trade data processing standards, and
(iii) computer applications for use in processing of trade data.
This set of agreements, standards and applications is referenced by both organizations as:
UN─OECD Joint Trade Data Collection and Processing System (Joint System)
Both organizations agreed to use the above name in any documents describing their cooperative activities. It
is also to be used when referring to the respective databases.
The Joint System is the foundation of the trade databases maintained by both organizations. Both
organizations continue to keep separate (institutionally and legally) trade databases to ensure rights and
ability of each organization to pursue their own policies with regard to
(i) storing various data in addition to those agreed in Joint System [e.g., historical data, memorandum
items, derived data etc],
(ii) developing additional analytical and presentational functionalities and controlling user access to
them,
(iii)dissemination practices including pricing of user access to the database services, entering into
contracts with users, etc.
Each organization maintains its own brand name for use in data dissemination activities. The names of those
databases are:
• For UNSD: UN Comtrade 3
• For OECD: OECD ITCS 4 Database
To ensure user awareness of the joint efforts of both organizations in the area of international merchandise
trade statistics, both organizations agreed to make data responsibility very clear.
Similarly, the OECD trade database disclaimer contains the following statement:
“The trade data for the selected non-OECD member countries are compiled by UNSD in accordance
with UN/OECD Common Trade Data Processing Standards and are available in OECD ITCS Database
in accordance with UN-OECD Data Sharing Agreement. Any deviation from this practice is reflected in
the country/period metadata.”
This Manual is the UNSD version and deals with the data retrieving/displaying interfaces of the Application.
These interfaces can be used by connecting to a specific UN Web site, hence the name of the corresponding
application module: Web Browser Client. The OECD version is largely identical, with the exception of
organization-specific particularities, such as captions, URLs, etc.
1.3. Prerequisites
Joint System Web Browser Client workstations should be equipped with:
• MS Windows operating system version 2000 or higher;
• MS Internet Explorer version 6 or higher
(other browsers can be used; they must support cookies, JavaScript and Java applets);
• An Internet connection to the server that hosts the Joint System Application
(the current UNSD Comtrade URL is http://unstats.un.org/unsd/comtrade/ ).
9
A Comtrade Guest User isn’t registered in the Joint System administration, nor is the IP address they use to
connect to the Application server 5. Anyone with the proper equipment (see above) can get connected to the
UNSD Comtrade application and become a Guest User.
Guests can use most of Comtrade capabilities, while Registered Users have unrestricted access to all of
them. Section 3. of this document deals with Registered Users, either individual or belonging to a registered
site.
Current
User status
Registered
User Login
Example of query
List of links and corresponding
results
5 In fact, guest Users are registered in Comtrade as Users with IP address 0.0.0.0. and restricted rights.
The left part of the Main interface is a list of function links that allow Users to select the query processor,
define reference data, subscribe to extended services, get technical support and link to related Websites. This
document will describe and exemplify all of these function links.
Query links share in fact the interfaces of only four selection/display processors; this is why parts of the text in
this document often refer –via Word links– to other sections where interfaces have already been discussed or
introduced.
Notes:
1. Free access as a Guest User to the database and search engines is restricted: for instance, up to
1,000 records SDMX-downloaded per day and no direct data downloading capability. This type of
access is used in this section. Extended service, with full capabilities, is available for an annual fee.
See the Subscription and Registered User sections for more details.
2. As already mentioned, most of the interface objects and some labels display a ‘tool tip’ text when
pointed to by the mouse cursor –see for instance fig. 5.
3. The “Example of query and corresponding results” area in fig. 1 depends on the User’s settings –
namely the ‘Customize Front Page’ parameters. It may be empty. Only a Registered User can access
the setting options.
A subset of the Quick Search list is displayed as soon as a letter is typed. Extra letters refine the selection, like
in the example below:
Processor name
Selection
summary To filter the
selection
We won’t reproduce the whole report here. Other pie charts show the six top import / top export partners, with
the corresponding commodity descriptions and trade values. The query processor used, Comtrade Explorer,
is fully described in its own section.
Figure 7: results of selection by country (France) and commodity (gases except from petroleum)
Finally, the Further Research combo allows Users to change the selection criteria without returning to the
original interface. For instance, we can select other reporting countries:
List of currently
selected countries
List
management
buttons
We can add Japan to the country selection by selecting the Japan entry and clicking Add; we finally get:
Figure 12: Shortcut Query selection interface – here: cars exported from Japan in 2004
Clicking Search displays the following summarized results:
In the example above, HS2002 is used. HS stands for ‘Harmonized System’, 2002 means that this
classification has been in use since 2002. Another classification is SITC rev. 3 (Standard International Trade
Classification revision 3). All the classifications are based on commodity features (kind, production stage,
primary material of not, durable or not, etc). The default classification in Comtrade is HS2002. See the
Comtrade Glossary entry later in this document.
If a commodity isn’t found in a classification, Shortcut Query searches other classifications for it.
In fig. 13, we notice that commodity codes are in fact links; what we get when clicking them is illustrated
below:
Figure 14: direct selection of an item by clicking its code (here, 871130)
Extra links
Figure 15: description of the selected commodity and its ancestors
This tree-structured report describes all the commodity classes from the root (ALL COMMODITIES) to the
selected item. Again, the item codes can be selected to get more specific information.
The Snapshot link leads to the already met Comtrade Explorer –Snapshot. Refer to fig. 5 for an example of
such a snapshot, and to the Comtrade Explorer section for a thorough description of the processor.
Clicking one year in the list leads back to another query processor and shows the trade values:
Query processor
name
List of actions
Back to fig. 13, we see that the imprecise commodity definition results in a wide range of retrieved items. We
can select some of these items by ticking their checkboxes:
Then clicking ‘View trade Data’ displays detailed information about the selected items through the Basic Query
processor:
Quick filter
combo
Selection summary
List of actions
The order retrieved entries are displayed can be changed through the Sort Order combo. This combo contains
all the criterion combinations that can be used as ordered sort list:
There are no actions to directly download query results or record queries: this is because the connected User
is a Guest. Downloading extracted data as a text file (what we call ‘direct download’) and saving the definition
of a query are reserved to registered Users. What registered Users only can do is described in section 3.
Processor name
Figure 21: getting the Express Selection interface from the Shortcut Query
The User can add selection criteria, modify the existing ones or change the display sort order. The Express
Selection form is fully described in this document.
This is the Comtrade Explorer Processor interface we already met in fig. 5; also see Note 1 below this figure.
The pie chart shows the two selected items trade values compared to all the other commodities.
Again, a “tooltip” text pops up when moving the mouse cursor over the pie chart.
Back to fig. 5, we notice the already described Quick Filter and Further Research combos.
‘Free On
Board’
‘All’ can be selected from Reporter (country) and Year combos; in this case, the resulting report looks like this:
Links to
other pages
Figure 25: trade notes for all countries and all years (first page bottom part)
The SDMX format is introduced in the Data Transfer Mechanism Manual; it is based on the XML 6 format and
adapted to statistical data description and transfer.
To illustrate this download operation, we can start from the following query results:
Notice the constant filename. Clicking Save displays the usual ‘Save As’ interface that allows the User to
select the destination file (path and name)
6 Extensible Markup Language: a standard for designing and creating HTML documents
Figure 28: the downloaded SDMX file (highlighted) – the name was left unchanged
As stated before, this file has a XML-like structure; it can be read by Internet Explorer:
Figure 31: data from Albania unavailable in 2002 for the selected commodities
Tab selection
The Basic Selection feature allows the User to select the commodities, classification, reporting Nations,
partner countries and year values. It also makes it possible to filter and sort the data as well as select the type
of trade flow required (tab Others).
Each tab relates to a selection parameter and has its list of selecting (or filter) values. A group of buttons
(tagged as ‘Filter list management’) makes it possible to add, remove and exclude filter values.
The classification has already been discussed. The examples below show the selection of other parameters
tab by tab. Once all the parameters are selected, clicking Submit Query displays the records retrieved –if there
are less than 1,000 of them; otherwise, only the number of records appears.
The Source combo makes it possible to select the data source from which records will be selected:
These data selection sources are discussed in this paragraph, tagged with a ‘ ’ sign.
Clicking Search displays a tree view that allows the User to precisely select the commodities to retrieve (the
whole contents of the tree are in fact any car-related items):
Selection-resulting tree
Figure 36: commodity selection – a node (Motorcycles) and a leaf (type of vehicle) are selected
Finally, clicking Add displays the selection in the Selected Items (a filter list) frame:
As mentioned above, the selection list management buttons (see fig. 32) allow the User to edit the selection
list. Items that must be individually removed must be highlighted with the mouse; multiple selection is possible
through the Shift and Crtl keys, like in a Windows list.
Ticking the ‘All commodities’ checkbox selects the whole commodity set; the selected items are ignored in this
case.
One or more items can be excluded from the selection by clicking the Exclude button after ticking their nodes;
the excluded items are flagged with a minus sign:
Selected
Excluded
Of course, exclusion only makes sense when applied to the descendants of an already selected node for
which the ‘Include the children’ option is set.
‘Save Selection to Favorites’ is reserved to Registered (not Guests) Users. Refer to section 3. for details on
this function.
The digit-number selection can be added to commodity type conditions. Remember that the query processor
makes the union (not the intersection) of selected commodities, like they appear, for instance, in fig. 37.
The TOTAL entry means the total of trade flows. This entry should not be confused with (All): (All) means all
the registered commodities (or countries, or years, depending on the current tab of the selection interface –
see fig. 32). 'TOTAL' returns one summarized record while (All) returns all the available items, with one record
per item.
When it comes to country selection, (All) should neither be confused with ‘World’. ‘World’ is a pre-aggregated
group of the countries that make up the world. (All) means all the partner countries. 'World' is similar to
'TOTAL'.
Note: when used by the Comtrade Explorer processor, TOTAL and (All) have other meanings. Refer to
Comtrade Explorer section.
Figure 41: standard country groups (or trade agreements between countries)
Nb of records retrieved
Selection summary
Action links
The interface above, and especially its action links, has already been discussed with the Shortcut Query
function, which in fact makes use of the Basic Query processor. Again, we notice that no Direct Download or
Save Query options are available. We can still refine the selection, for instance by selecting 2002 as year; we
just have to click the 2002 link. The results are now:
New nb of records
We notice that the records themselves are now displayed: this is because there are less than 1,000 of them.
In fact, this is more an aggregation than a filtering operation: retrieved records are aggregated by reporting
countries. A true filtering by partner can be achieved through the Partners tab interface
The Quick Filter combo can also be used to filter the selection. Refer to the Shortcut Query section for details
and examples.
The Sort Order combo gives the list of all parameter permutations and makes it possible to select the order
records will be displayed.
Back to fig. 32, we notice a ‘Go to Comtrade Explorer’ button. Clicking this button leads to the Comtrade
Explorer - snapshot display we already met in the Shortcut Query section, since Shortcut Query uses in fact
the Comtrade Explorer processor. This processor is discussed in its own section.
The Reporters selection has already been discussed in the Quick Search section. Keeping the Commodities
selection of fig. 36, we can filter the query by two reporting countries:
Figure 46: two countries (Italy and Japan) selected in Reporters interface
Query summary
The links in the Basic Query results interface have been described with the Shortcut Query form.
2.2.3.4. Partners
An additional selection can be performed through the Partners interface:
Reminder: a Partner is a country that carries out trade operations with a reporting country. The trade
operations are defined by the Trade Flow parameter: import, export, re-export. Of course, all the reporting
countries are also partners.
Figure 49: query results for Commodities, Reporters and Partners selection (partial view)
We notice that this time, the retrieved records are also displayed. This is because there aren’t too many of
them.
2.2.3.5. Years
One or more years can be selected through the Years tab:
Figure 51: selection by Commodities, Reporters, Partners and Years (full view)
Figure 52: the Others selection interface – notice the aggregation option
Sorted by…
Figure 53: selection by Commodities, Reporters, Partners, Years, Trade Flow and Trade Value (full view)
The selection settings and the query results are reproduced below:
‘Ignored for
Aggregation’
Figure 54: an intra trade query – Transport Equipment within Europe for 2003 - 2004
When clicking the Comtrade Explorer entry, the following interface pops up:
The User can enter any word that defines a commodity, a county or a year. For instance:
Links
Notice that the parents and children (no child here) of the Product are also displayed; the code of the selected
product appears in red.
The ‘Input keywords’ textbox can be used to run another independent query –it doesn’t filter the current query
results.
2.2.4.2. Snapshot
Clicking the Snapshot link for an entry provides a summary report with graphic information on the selected
item. Comtrade Explorer is the query processor used:
Selection reminder
Figure 59: results of snapshot function: upper part of Comtrade Explorer interface – see lower part below
Keywords TOTAL and All in figs 58 and 59 have already been explained in the Basic Selection section. But
their meanings are different here because of the snapshot report type:
– If All is selected as partner, it will be considered as single entity World
– If All is selected as commodity, it will be considered as single entity TOTAL
– For years and reporters, All means ‘all available data’ -refer to Data Availability.
Percentage
repartition
by country
If we select ‘France (Partner Name)’ and click Apply, we get the following report:
Selection reminder:
France added as Partner
Note: if Quick Filter is used for a criterion that is already set (value ≠ ‘All’ in query summary), the Quick Filter
value replaces the already set value; in this case, Quick Filter redefines the query rather than filters it.
Then if we select ‘Gold compounds’ and click Apply, we get the following selection summary:
Summary of
reported data
Details by
country
Figure 65: data availability report for selected commodity (partial view)
This interface is addressed in the Data Availability / Commodities section later in this document.
Meta-language
capabilities
Links
Notice the Save and Lookup links that make it possible to save the codes entered and retrieve them from a list
(‘Favorites’). The interface used by Lookup has been introduced in section Quick Search.
Reminder: saving a selection or a report is reserved to registered Users (unavailable to free Users, also called
“Guests”). Refer to section 3. for information on registered Users and Favorites.
This interface has already been discussed in the Basic Query section, form Others.
List of actions
Several pages to display
Refer to the Basic Query and Shortcut Query sections for details, especially on the list of actions that is tagged
above. Note that the commodity codes and quantity units used are described by a ‘tooltip’ text.
While the data Query section explains how to retrieve information on commodities (e.g., quantities in terms of
trade value, mass or number of items exported), the Data Availability section deals with the amount of data
records collected for a given selection, whatever type they are.
Several interfaces provide the User with data availability results, for instance the already discussed Comtrade
Explorer.
The Data Availability functions are activated through the links below:
2.3.1. Interactive
The Interactive interface is reproduced below, with a selection already carried out:
The comments in the form itself explain the role of each field. The values between parentheses are the
number of records collected for the selected classification.
Year range
Filter part
Region
Real
value
The filter part of the interface makes it possible to select the reporting country, commodity codes and years.
Two bars at the top and bottom of the filter area allow the User to select a year range and a geographic entity
(e.g., European Union), instead of a country and one or more years. The Lookup links brings an already met
interface that makes it possible to select commodities by their names instead of their codes, or to select
standard Favorites.
In this interface, the results are contained in the same form as the filter values, and displayed as a bar chart.
All the classification types are used and appear with different colors. Moving the mouse cursor over a bar
displays the real number of data records, like exemplified above.
Several pages
Figure 74: the data records selected from the In Graph interface (partial)
Refer to fig. 44 in the Basic Selection section for comments on this report.
Country selection –
first letter
As usual, clicking an underlined year displays detailed information on the data records provided this year. The
Basic Query processor is used.
Links to reporting
interfaces
2.3.4. Commodities
This processor makes it possible to filter the provided data records by Commodities. Commodities are
selected from a tree-structured list we already described in the Basic Selection section:
Figure 77: commodity selection – food is the main selection – two items selected
Once the nodes or leaves are selected, clicking Add stores them in the Selected Items frame.
Two food
items selected
Figure 78: commodities – report for two selected items – Data Availability
Clicking View description brings up the Commodity List interface; clicking Snapshot leads to the Comtrade
Explorer Snapshot form.
Several pages
in this report
Figure 79: report on specific year for selected commodities – Data Availability
Year range
selection
Filter section
Figure 81: selection by record upload date – Data Availability – ‘one month ago’
In this example, the only filter parameter is the upload date, and it is set to ‘1 month ago’. The picture below
shows the possible values:
As usual, clicking an underlined country allows Users to get trade details on it.
Links
We see the ISO country codes and data collection year range for each country. A country selection can be
achieved through a first-letter list.
The links in this interface display economic data in PDF (Adobe) or Excel format; for instance:
Figure 88: ITC country information for Bahrain - National Import Profile selected (partial view)
We won’t discuss this ITC interface to any longer extent, for it is not directly related to the Joint System
application.
Answers to
UN questions
This form is essentially a country report on national compilation and reporting practices in international
merchandise trade statistics. It lists the answers to a series of 156 questions sent to countries, asking them:
• what they include in trade statistics (e.g., postal items, products mined from the seabed…),
• which trade system they use (general, special),
• which classification system they use (e.g., SITC, HS),
• what sources they use (e.g., customs declarations),
• how quickly they report their data, …
For 52 of the 156 questions there is a UN recommendation on what countries should do.
When an answer doesn’t comply with the corresponding UN recommendation (if any), it appears in red and is
flagged with a question mark (?), like entry 10. above. A non-complying answer can be YES or NO. Complying
answers appear in blue. Answers to questions that haven’t a UN recommendation appear in grey.
The Trade compilation form also includes links to publications, explanatory texts and specific statistical
reports. These topics are considered beyond the scope of this Manual.
The View Description link gives the same results as the Country list entry –for the associated country only.
Clicking a year in a country entry brings up the already met detailed report:
Cost
Insurance
and Freight
Free On
Board
2.5. Subscription
Guest Users can become Registered Users and gain full access to Comtrade by paying an annual fee. The
Subscription menu in the main interface is reproduced below:
The following paragraph is reproduced from the “Why subscribing?” entry display:
This is why subscribing to an individual or site license and becoming a registered User may be interesting to
most trade Statisticians.
User license
Site license
On-line subscription
Download Word
subscription document
Notice that the Subscription Price form has Online and Word download subscription links.
These entries provide online Help and remote communication with UNSD. Since they are by nature strongly
User-oriented, we won’t describe them but briefly. For some entries, we just reproduce the form they display.
Notice that, for each data upload entry, a link provides data availability by date of loading. The ‘What’s New’
link in the main interface displays the same kind of information in an abbreviated format.
Clicking the RSS button at the right of the entry displays the same information as fig. 99, but in RSS format:
The Data Transfer Mechanism document gives a few details about SDMX and its usage by the Joint System
Application.
Clicking this entry loads introductory pages to RSS with definitions, links to related sites and links to published
papers.
The ‘First Time User’ link is also present on the top right part of the main interface (fig. 1):
Figure 107: frequently asked questions and their answers (partial view) – some may be outdated
ECLAC and SDMX have already been mentioned in the Support section.
3.1. Overview
In section 2., we described the Web Browser Client functions a Guest (i.e., non registered) User can run, and
their inherent limitations. These limitations are summarized here (some of them have already been
mentioned):
Figure 112: Guest User limitations – copied from the on-line Help
All these limitations are cancelled when connecting as a Registered (or Subscriber) User. There are two ways
to do so:
• by providing a known User ID and its associated password (Individual license);
• by connecting from a registered IP address (Site license).
Section 2.5 explains how to get registered for an annual fee. How a User ID / password or a registered IP
address and other User features can be defined is explained in the Database Administrator Client Manual –a
document intended for Comtrade Administrators.
In section 3 of this document, only the functions and capabilities a Guest User isn’t allowed to use will be
discussed. This section will focus on the following Registered User capabilities:
• Download statistical data;
• Create and manage Sub Users (reserved to Master Users);
• Save the definitions of queries to use them later;
• Submit batch queries;
• Define and restore a User’s working environment through the ‘My Comtrade’ menu.
In addition, Registered Users automatically get upload news (new available datasets, data availability by date)
through the RSS capability; provided they have downloaded an RSS ‘feed reader’ from the Web (e.g., from
Google. Visit, for instance, www.feedreader.com).
For each IP address access (or site license) that is granted, there is an associated Master User. This Master
User, in addition to connecting through the IP address, has to provide a registered User ID / password pair.
The Master User has special privileges among the site Users, such as creating global favorites that can be
shared. They can also create and manage sub Users.
Master Users and the associated topics are discussed in the IP Authentication section.
These two authentication modes are not totally equivalent: they imply some differences in the way the
Application behaves. Due to the fact that a site license (registered IP address) is granted to several Users
(typically, the employees of a company), individual features such as environment personalization cannot be
granted, unless Comtrade knows the email address of each User. This point is developed later in this section.
We will first discuss the registered User environment then describe the IP address mode specificities.
In the example below, a registered User ID and its associated password have been entered:
Blurred User ID
Note: the User ID (labeled ‘Name’) in the picture above is blurred for confidentiality reasons; it appears clearly
in the real interface.
If the ‘Remember me’ box is ticked, the entered User ID will be memorized and displayed in a list each time its
first letter is typed in the textbox. The User can then select the proper User ID instead of typing it in its whole.
Finally, entering the User ID and the User email address, then clicking Recover will send an email with the
User ID and the password to the provided address. This is a way to recover a forgotten password.
9 This will be the IP address of the Web access provider (often called ‘router’), not the local network address of
the connecting station.
‘My
Comtrade’
Connected
User’s Name
Figure 114: Registered User main interface – Shortcut Query and Trade in graph are examples
As already stated, only the functions and capabilities a guest User isn’t allowed to use will be discussed here.
An example of such functions is the ‘My Comtrade’ menu and its entries.
The entries in this menu are discussed in the rest of this section. For consistency purposes, topics related to
query saving/loading, data downloading and batch processing are fully described in the ‘Additional
Capabilities’ section.
3.3.2.1. Account Info
Clicking the Account Info link displays the following form:
Edit User
Information
Links to
Favorites
Account
expiration date
This page displays the connected User’s personal data: ID, name, email… It also gives information on their
‘Favorites’, front page, group and so on. Front pages and groups are discussed later. Also notice the account
expiration date: each registered User account is defined for a certain time period by the Comtrade
Administrator.
Display
options
Alphabetical selection
Name of by first letter of Name
the favorite
Figure 118: favorites display/update interface – Commodities selected - one favorite recorded
This form shows the current User’s favorites by categories (Commodities, Reporters, Partners,…) and makes
it possible to add new favorites or remove existing ones for each category. Changing the contents of an
existing Favorite is also possible. In the example above, Commodities is selected and only one commodity set
is registered as Favorite.
Common Global Favorites exist for any registered User. These global favorites are defined within Comtrade.
The links in this form –and a few others– are discussed below. They are tagged with a ‘ ’ symbol.
Links
View Snapshot apparently wasn’t implemented at the time this document was drawn up.
Figure 121: Name and Codes fields of a commodity set – updates have been carried out
Clicking Update records the new definitions and leads back to the interface in fig. 118. Cancel has the same
effect but doesn’t record the updates.
Insert New allows the User to include a new Favorite in their list:
Figure 122: the Insert New Favorite interface – nothing added yet
The User enters the Name of the new Favorite and the item codes it will contain. These codes can be keyed
in, like in the example below:
Figure 123: keying in the Name and Codes for a new Favorite
Finally, back to the Insert interface in fig. 122, clicking Insert shows the newly added entry:
Again we get a multi-tab interface that makes it possible to select Favorite sets in each category; here we
keep using Commodities. An example of pre-defined Country Groups is given later in this document.
Notice that the original Favorite entry, “Textile products; Section XI (HS1996)” has probably been obtained
from the global Favorite list. This entry has been changed to “Textile products bis; Section XI (HS1996)”. Had
it been saved with its original name, it would have remained local to the current User: global pre-defined items
cannot be changed by Users.
There are also an alphabetical selection (Favorite name’s first letter) and a detailed format for this pre-defined
favorite list. Selecting ‘Detail View’ changes the display to:
Clicking ‘here’ in fig. 128 leads back to the initial Favorites interface, with the new entry added –to compare
with fig. 118:
Links
New favorite
Comtrade behaves exactly the same for Commodity, Reporters, Partners and Years, with the exception that
Years have no codes (they are selected directly by their four-digit value) and no global pre-selected values
(although the ‘View pre-defined…’ link is still present).
Figure 131: the Favorites interface – Reporters selected – two favorites recorded
Warning message
Country group
already defined
Figure 133: the Favorites interface – Country Groups selected – one ‘favorite’ recorded
Countries can be grouped within Comtrade. A country group is considered as an entity with its name (North
Africa in the example above). There is a pre-defined set of country groups that appears when clicking ‘View
pre-defined…’:
This interface has already been described (Commodity tab). The ‘Copy to favorite’ link allows the User to add
each group to their Favorite list.
Notice the ‘+’ signs that separate the country codes instead of the usual commas. This means that the six
countries are considered as an aggregate: they make up a single entity.
We can now submit this country group as reporter in a query. For instance:
We notice that there is only one row returned, not six, while the group is made of six countries. The collected
values for the six countries have been aggregated.
The same operations can be carried out for Commodity Groups: once several commodities make up a group,
using the group name in a query aggregates the commodity associated values.
For each operation, the usual selection criteria are present. Clicking one of them displays its definition and
expands it if it’s a node in a tree structure (e.g., a class of commodities). For instance, if ‘95’ in the first History
entry is clicked, the familiar Commodity List with its links is displayed:
Clicking a Load link displays the corresponding query in an Express Selection form, from which the query can
be run again. This feature is fully described in the ‘Additional Capabilities’ section.
Display options
Filter by first
letter of
query name
Links
Notice the three links associated with each query entry. Delete deletes the associated query. Load and Edit
are discussed later in this section. Delete simply deletes the saved query.
How a query can be saved and what can be done with saved queries is discussed in the ‘Additional
Capabilities’ section.
Also refer to this section for the meaning of ‘Notification Enabled’, ‘Auto Batch Enabled’ and ‘Update Type’,
and the description of Load, Edit and Delete links.
The selected processors: Shortcut Query, First Time User and Trade In Graphs are present and exemplified
with data. The User is advised to try other settings (e.g., the Default setting) and compare their results.
3.3.2.10.Batch Monitor
Clicking this entry displays the status of the current batch tasks (aka jobs) the User initiated, as exemplified
below:
Click to get
Job results
Two jobs are displayed here (there are four of them in all) One is still running, the other is completed. Notice
the submission, start and completion dates. Entries of completed jobs remain 48 hours before being deleted.
As usual, clicking a link displays the related data (definition, availability, etc. For instance:
Notice the file format (.zip). This file can be saved as usual or directly opened with WinZip, like illustrated
below:
Job results
filename
The file has now the CSV 10 format; it can be opened, for instance, by Notepad or Excel:
Figure 147: contents of the job results file – the first line is made of column names
We can check that these results match the query definition in fig 141. Again, the file can be saved –
presumably with a more convenient name.
10 Comma Separated Values: a plain text file that can be opened by Notepad or Excel.
Nb of records retrieved
Selection summary
Action links
If we compare this form with fig. 42, the following points stand out (from top to bottom):
1. The number of records retrieved is greater: this is because the second query was run a few weeks
after the first one;
2. The action list includes three additional links:
• Direct Downloading
• Save Queries
• Batch Submission.
To follow the ‘My Comtrade’ menu order in the main interface, we already got onto these three topics. They
will now be discussed in detail in this separate section. This layout seems more consistent and will probably
be clearer to non-technical Users: they will tackle the matters in two steps, a quick look followed by an in-
depth study.
Action
links
Figure 149: basic query results (cars and related commodities exported from Russia to Afghanistan
If we select the Download action, we get the usual file download form:
Figure 151: query data results downloaded and displayed by Excel (may need enlargement)
This CSV data display has already been commented. Remember that the first line is the column (or field)
header.
Data Downloading Customization
This is an entry in ‘My Comtrade’ menu. But it obviously has to be discussed with the download function. The
common field (or column) selection form is used:
Selected
fields
Available
fields
The way to select fields has been explained earlier in this document; in fact, this is a common Windows item
selection list: selection from Available frame to Selected frame is achieved via the Add and Remove buttons
once available columns are highlighted. As usual, no selection means ‘all possible fields selected’. Multi-
selection is possible through the Shift and Crtl keys. Notice that the selected fields stay in the Available field
list.
The order of the selected columns that will be used in the downloaded reports can also be changed through
the Up and Down buttons.
The User must click Update for the options to be saved. Then, running the download operation again, the
following data is displayed:
If we compare figures 151 and 154, the following points stand out:
1. in fig. 154, only the fields we selected are present;
2. in fig. 154, the field order follows the selection order;
3. the Commodity Code format is different; this is because option Excel Compatible Format was selected
for fig. 154. Setting this option ensures that the numeric values are considered as strings, not as
numbers, and therefore are left unchanged. For instance, Commodity Code “010111” will be left
unchanged, while it would be stored as number 10111 had the option not been set.
Clicking Back to Default restores the default download layout: all the fields available are displayed in the order
they are found.
Action
links
If we click Save Query in the list of action links, we get the following interface:
Figure 156: Save Query interface – query name has just been entered
The User enters the query name (as illustrated above) and clicks Add. A Save confirmation message box
pops up.
The query we just saved appears now –there were none before. Fig. 139 is an example of three saved
queries. Saved queries can be called back (the link used is labeled ‘Load’) in the Basic Selection and Express
Selection interfaces to be run gain or modified, optionally under another name. Examples of such operations
are given in the rest of this section.
The already met Detail View button displays a thorough definition of the query.
Clicking Delete deletes the registered query. The Load and Edit links are discussed below, tagged with a ‘ ’
symbol.
Current
query Extra
pane
Figure 144: Express Selection – Registered User. Notice the additional ‘step 3’ pane
As a registered User, we notice an extra pane (labeled ‘Step 3’) at the bottom of the form. Its functions are
described below, prefixed with a ‘ ’ sign. These functions concern query saving operations and database
change notifications. They apply to the current (or loaded) query ―the one whose name appears in the Step 3
pane.
Back to the initial Saved Query form, we now have two entries:
o Save As Default: there is a Default query in Comtrade that can be created and submitted
through the Basic or Express query processors. This query appears with name ‘_default’, for
instance in the Basic Selection interface:
Figure 160: the Default query – Basic query processor (partial view)
In this example, the initial ‘Hungary …’ query as been saved as Default query.
Figure 161: the Saved Query Edit interface – query definition can be changed
The Lookup link has already been described; remember that it allows the User to select query parameters
through a friendly interface. Clicking Update saves the new definition and exits the Edit interface; Cancel exits
the interface without saving its data.
The actions below are not directly related to query saving. They are described here for consistency with the
interface layout (see fig. 144).
o Submit Query
See, for instance, fig. 32 and the comments that follow.
o Go to Comtrade Explorer
Clicking this button simply links to the already discussed Comtrade Explorer – Snapshot interface, with the
current query loaded.
Figure 162: batch submission of a query – the summarizing information can be used to run another query
The links in this form have already been described in other parts of this document. As clearly stated, the User
is informed of the job completion by an email. Of course, a proper mail address has to be present in the User’s
Account information.
Batch actions
and options
Some time after, depending on what the submitted query had to do, the following email is received by the
sender:
Notice the ‘From’ and ‘To’ fields, the query definition summary and the link to the .zip file that contains the
results. Clicking this link opens the file with WinZip, as illustrated in fig. 146.
The resulting CSV file can be locally saved and opened with Notepad or Excel. We can compare its contents
with those already downloaded in the Batch Monitor section (fig. 147).
The already discussed Batch Monitor form displays the status (Running or Completed) of current jobs initiated
by a User and makes it possible to download the data extracted by completed jobs without using a mail
notification.
Enable Notification (fig. 163)
This very interesting feature allows the User to be notified by an email when the data availability the
associated query refers to is modified in any way as to reporting Country, Classification or Year. In other
words, an email notification will be sent if there are changes in the high-level data that matches the selections.
Example: Indonesia and Malaysia are defined as reporters in a query and new Indonesia data arrives; with
Incremental option set, the system will submit Indonesia data only, while Full option will submit Indonesia and
Malaysia data. Note that only Full option can be used with Country groups.
Update Type is ignored if AutoBatch is disabled.
The welcome part of the main interface for an institutional-type connection is as follows:
Extra capability
To record the
email address
Figure 166: welcome box for a registered IP address connection – email address unknown
Compare this ‘Comtrade Access’ welcome box with the ones used for guest Users (fig. 1) and individually
registered Users (fig. 114). The ‘My Comtrade’ menu is also displayed in the institutional User main interface.
From the Application point of view, a connection to Comtrade takes place this way:
1. The User links to Comtrade Web site;
2. Comtrade compares the User’s IP address to list of registered IP addresses;
3. If it is found, the User become an IP (or Institutional) User;
4. If it isn’t found, the User is considered as Guest User;
5. If the User enters a registered ID and its associated password, he/she becomes an individual
Registered User. The IP address is ignored, except if the ID entered is the IP address Master User
ID: in this case, the User is considered as Master User. Master Users are discussed in their own
section.
However, as mentioned in fig. 166 above, an institutional User whose email address is known from Comtrade
will access all the personalization (or customization) capabilities (e.g., front page, download format, query
saving, etc). The email address is necessary because a site IP address doesn’t allow the Application to
differentiate between Users and therefore to record their individual profiles. Email recording is achieved
through the Account Info entry of ‘My Comtrade’.
IP Users with email addresses have in fact the same rights as individual (registered) Users, except that they
can’t log in from outside their IP addresses.
3.4.2.4. To Sum it up
A table at the end of this document summarizes the different types (or profiles) of Comtrade Users and their
associated rights; this table is certainly clearer than text explanations.
Since Master Users have a recorded login ID and a password, they can connect to Comtrade like any
registered User, from any workstation; but they will get their specific privileges only when they log in from their
associated IP address.
For instance:
“Hello Master
John Smith”
As usual, the User’s name is blurred in this document. It appears clearly in the real interface. The name / first
name information is part of the recorded User definition.
Master Users have all the privileges of individually registered Users. In addition, they can:
1. Create and manage sub Users;
2. Define the following shared entities:
o saved queries
o customized front page
o customized download format
These personalization features are visible from Users who connect through the Master User’s IP
address, except if they are sub Users –see below.
Since point 2. has already been discussed and has no specificities compared to registered Users features,
we’ll just address the sub User management here.
Note: like any individual accounts, Master User accounts have an expiration date defined by the Comtrade
Administrator.
Link to sub
User creation –
notice the limit
Figure 168: Sub User management frame – none for the moment
The limit to sub User creation is set at Comtrade Administrator level. Clicking Insert New brings up the
following form:
The Master User enters the sub User’s features, like in the example below:
Figure 170: defining the sub User – notice the comment about download limit: 0 (or blank) means no limit
Another
sub User
No download can be
limit added
The Edit and Delete links make it possible to change the sub User settings or delete it; in the latter case, a
confirmation message box pops up.
In fact, sub Users behave like individually registered Users (see section 3.3), except that their expiration date
is the related Master User’s expiration date. If this date is extended, the extension will be taken into account
for all the associated sub Users.
Compared to IP Users, sub Users have another restriction: they cannot use the shared favorites created by
their Master User, while IP Users can.
If we log in from the IP address we’ve been using so far, we will be considered as Master User or associated
sub User, depending on the latest connection performed. If we’re the Master User, clicking Log Off will bring
up the following sub User Access form:
The table below summarizes the different User types (or profiles) in Comtrade and their corresponding rights:
User Guest Individually IP IP Sub User Master
Type Registered Address Address
without with email
Related
Rights
email
‘My No Yes No Yes Yes Yes
Comtrade’
Menu
Submit No Yes No Yes Yes Yes
Batch
Batch No Yes No Yes Yes Yes
Notification
AutoBatch No Yes No Yes Yes Yes
function
Direct No Yes Yes Yes Yes Yes
Downloading
View/Print Yes Yes Yes Yes Yes Yes
Data
Download No direct Set by UNSD Up to Unlimited Set by Set by
Limit download 150,000 13 Master User UNSD
capability
Sub User No No No No No Yes
Creation
13 Subject to checking
FIGURES
Figure 1: Joint System main interface – connection as Guest – Shortcut Query and In Graph functions exemplified............... 4
Figure 2: Data Query & Extraction links .................................................................................................................................... 4
Figure 3: Quick Search entries for first letter F.......................................................................................................................... 4
Figure 4: two-letter selection from the Quick Search list ........................................................................................................... 5
Figure 5: results of a Quick Search for France (upper part) ...................................................................................................... 6
Figure 6: Extra selection by commodity (first three letters are ‘pet’).......................................................................................... 7
Figure 7: results of selection by country (France) and commodity (gases except from petroleum) ........................................... 8
Figure 8: changing selection criteria in the Comtrade Explorer report....................................................................................... 8
Figure 9: country selection interface ......................................................................................................................................... 9
Figure 10: adding a country to the current selection ................................................................................................................. 9
Figure 11: new selection (two countries) report....................................................................................................................... 10
Figure 12: Shortcut Query selection interface – here: cars exported from Japan in 2004 ....................................................... 11
Figure 13: search results for the selected data ....................................................................................................................... 11
Figure 14: direct selection of an item by clicking its code (here, 871130) ............................................................................... 12
Figure 15: description of the selected commodity and its ancestors ....................................................................................... 12
Figure 16: data availability by year for the selected commodity .............................................................................................. 13
Figure 17: data availability - trade details for year 2003 .......................................................................................................... 13
Figure 18: two items selected from the commodity list............................................................................................................ 14
Figure 19: detailed information on two commodities ............................................................................................................... 14
Figure 20: sort order selection ................................................................................................................................................ 14
Figure 21: getting the Express Selection interface from the Shortcut Query........................................................................... 15
Figure 22: detailed information on two commodities – graphical form..................................................................................... 16
Figure 23: Printable Format display – may need enlargement ................................................................................................ 16
Figure 24: notes on Japan for 2004 ........................................................................................................................................ 17
Figure 25: trade notes for all countries and all years (first page bottom part).......................................................................... 17
Figure 26: Basic Query results ................................................................................................................................................ 18
Figure 27: file download warning message ............................................................................................................................. 18
Figure 28: the downloaded SDMX file (highlighted) – the name was left unchanged.............................................................. 19
Figure 29: SDMX file contents (partial view) ........................................................................................................................... 19
Figure 30: not available data: none for this example............................................................................................................... 20
Figure 31: data from Albania unavailable in 2002 for the selected commodities..................................................................... 20
Figure 32: Basic Selection interface (Commodities tab).......................................................................................................... 21
Figure 33: selection of commodity “cars” ................................................................................................................................ 22
Figure 34: selecting the data selection source ........................................................................................................................ 22
Figure 35: commodity tree view (only root is expanded) ......................................................................................................... 23
Figure 36: commodity selection – a node (Motorcycles) and a leaf (type of vehicle) are selected .......................................... 24
Figure 37: commodity list populated after clicking Add ........................................................................................................... 24
Figure 38: a node is selected with its descendants ................................................................................................................. 25
Figure 39: a category of vehicles is excluded from the vehicle selection ................................................................................ 25
Figure 40: selecting commodities by number of digits in code ................................................................................................ 26
Figure 41: standard country groups (or trade agreements between countries) ....................................................................... 26
Figure 42: results of a Basic Query operation ......................................................................................................................... 27
Figure 43: results of a Basic Query operation; extra selection by Year ................................................................................... 27
Figure 44: country-broken down report (first page partial view)............................................................................................... 28
Figure 45: Reporters tab interface .......................................................................................................................................... 29
Figure 46: two countries (Italy and Japan) selected in Reporters interface ............................................................................. 29
Figure 47: query results for Commodities and Reporters selection......................................................................................... 30
Figure 48: three partners selected .......................................................................................................................................... 30
Figure 49: query results for Commodities, Reporters and Partners selection (partial view) .................................................... 31
Figure 50: additional selection by year .................................................................................................................................... 31
Figure 51: selection by Commodities, Reporters, Partners and Years (full view).................................................................... 32
Figure 52: the Others selection interface – notice the aggregation option .............................................................................. 33
Figure 53: selection by Commodities, Reporters, Partners, Years, Trade Flow and Trade Value (full view)........................... 33
Figure 54: an intra trade query – Transport Equipment within Europe for 2003 - 2004 ........................................................... 34
Figure 55: Comtrade Explorer initial interface ......................................................................................................................... 35
Figure 56: example of search string ........................................................................................................................................ 35
Figure 57: Comtrade Explorer – global results for the query ................................................................................................... 35
Figure 58: detailed information about an entry ........................................................................................................................ 36
Figure 59: results of snapshot function: upper part of Comtrade Explorer interface – see lower part below ........................... 36
Figure 60: Comtrade Explorer (lower part) – summary graphic report .................................................................................... 37
Figure 61: filtering list – entries beginning with ‘Fr’.................................................................................................................. 38
Figure 62: Comtrade Explorer (upper part) – selection filtered by Partner .............................................................................. 38