Difference between revisions of "Structure Explorer"

From FMR Knowledge Base
Jump to navigation Jump to search
(Search Structure)
(My Recent History)
Line 60: Line 60:
  
 
===My Recent History===
 
===My Recent History===
 +
My recent history shows up to the last 10 structures retrieved against the current Registry connection with the most recently retrieved structure shown first in the menu. If the Registry connection is changed in the Setup, the recent history is updated to show the history of structures retrieved for that connection.
 +
 +
By clicking on a Recent History item, the structure will be retrieved, and the item will be moved to the top of the Recent History menu.

Revision as of 01:10, 14 April 2021


Prerequisites

To use the Structure Explorer you need to have installed the FXL add-in and connected to a Registry from the FusionXL tab in an Excel workbook. Click here to learn how to do that.

If you intend to modify structures you will also need to Login with your Registry username and password.

The image below show the Connected Registry along with the name of the logged in user.


FXL11.png

Features Overview

Button Function Usage
FXL12-structure-browse-button.PNG Browse Registry Allows the user to view all of the available structures, broken down by structure type, and maintenance agency.
FXL12-structure-look-button.PNG Lookup Structure Allows users to find structures that reference other structures. For example look-up ‘Data Structure by Codelist’ enables the user to navigate to a particular codelist, and then discover which Data Structures reference the Codelists.
FXL12-structure-search-button.PNG Search Structure Provides a free-text search for structures.
FXL12-structure-history-button.PNG Recent History FusionXL stores a list of recently viewed structures, allowing the user to easily retrieve recently viewed structures.
FXL12-structure-create-button.PNG Create Structure Allows an authenticated user with the correct permissions to to create new structures within the Registry.
FXL12-structure-delete-button.PNG Delete Structure Allows an authenticated user with the correct permissions to delete an existing structure.
FXL12-structure-save-button.PNG Save Structure Allows an authenticated user with the correct permissions to save modifications. The Registry will ensure all modifications are valid by performing validation checks. Once successfully validated the structure will be accepted into the Registry.
FXL12-structure-language-button.PNG Set Language FusionXL displays structure names and descriptions in the selected language. FusionXL also makes it easy to add names and descriptions in new languages, by merging uploaded content with existing content.

Structure Retrieval

There are 4 ways to retrieve structures from the Registry. Regardless of how a structure is retrieved, the retrieval of the structure will result in a new worksheet being opened. Thus it is possible to have an Excel workbook with multiple worksheets, one for each retrieved structure.

Browse Registry

This button displays a hierarchical menu of all the structures in the connected Registry, broken down by structure type followed by Agency, as shown below.

FXL13.png

Once a structure is selected, for example SDMX:CL_UNIT_MULTIPLIER(1.0), FusionXL will obtain this codelist from the connected Registry, and the resulting structure will be shown in the Excel worksheet, as shown in the example below.

FXL14.png

Lookup Structure

Lookup Structure provides a drop down menu of Registry content where the structures have been organised into folders depending on which structures reference them. This is a very useful mechanism for quickly finding the desired structure, as well as a useful tool to discover which structures make use of other structures.

It should be noted that whilst then ‘Browse Structures’ menu displays all Registry content, ‘Lookup Structure’ may be showing a subset, depending on the Registry content.

Search Structure

The Search Structure provides a free text search of Registry content. The search terms are applied to Ids, names, descriptions of all Registry structures. A search on OBS_STATUS for example will bring back the concept schemes that contain the OBS_STATUS concept, and Data Structure Definitions with dimension Ids of OBS_STATS, as shown below.

FXL15.png


To load a result, either double-click on a search result, or select the result and click the Load Result button.

My Recent History

My recent history shows up to the last 10 structures retrieved against the current Registry connection with the most recently retrieved structure shown first in the menu. If the Registry connection is changed in the Setup, the recent history is updated to show the history of structures retrieved for that connection.

By clicking on a Recent History item, the structure will be retrieved, and the item will be moved to the top of the Recent History menu.