Difference between revisions of "FXLData Wizard"

From Fusion Registry Wiki
Jump to navigation Jump to search
(Overview)
 
(27 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
+
[[Category:How to and other features in FXLData]]
'''An Excel ribbon bar tool for interactively building and editing [[FXLData]] functions'''
+
__NOTOC__
 
+
An Excel ribbon bar tool for interactively building and editing [[FXLData]] functions.
 
=Overview=
 
=Overview=
 
The FXLData Wizard is part of the [[FXLData]] add-in for Excel which provides a collection of functions for retrieving statistical data from a Fusion Registry directly into a worksheet.
 
The FXLData Wizard is part of the [[FXLData]] add-in for Excel which provides a collection of functions for retrieving statistical data from a Fusion Registry directly into a worksheet.
Line 7: Line 7:
 
The Wizard helps in the task of building and modifying =FXLData() and =FXLDataV() functions which take a number of parameters including the Fusion Registry to connect to, the Dataflow and a data query expression - typically an SDMX [[Series Key|series key]].
 
The Wizard helps in the task of building and modifying =FXLData() and =FXLDataV() functions which take a number of parameters including the Fusion Registry to connect to, the Dataflow and a data query expression - typically an SDMX [[Series Key|series key]].
  
 
+
[[File:FXLData Wizard Ribbon 058.JPG|FXLData Excel ribbon]]
  
 
[[FXLData#Quick_Start|Installing]] the FXLData Excel add-in adds a FXLData menu option and the ƒ''x'' button to the ribbon to launch the Wizard.  
 
[[FXLData#Quick_Start|Installing]] the FXLData Excel add-in adds a FXLData menu option and the ƒ''x'' button to the ribbon to launch the Wizard.  
Line 14: Line 14:
  
 
=Wizard=
 
=Wizard=
[[File:FXLData Wizard Example with Annotations.jpg|900px]]
+
==FXL Data Version Version 1.3==
 +
[[File:Wizard-r1-3.png|1200px]]
 +
 
 +
===Rest Argument Builder ===
 +
[[FXLData_what%27s_new_in_R1.3%3F#Rest_Arguments | Click here to learn more about the new Rest Arguments Builder.]]
 +
 
 +
==FXL Data Version Version 1.0==
 +
[[File:Wizard.png|1200px]]
  
 
=Guidance=
 
=Guidance=
Line 32: Line 39:
 
* The REST Args expression must follow the standard syntax for URL parameters using '&' as a separator , e.g. ''round=2&attributes=UNIT''
 
* The REST Args expression must follow the standard syntax for URL parameters using '&' as a separator , e.g. ''round=2&attributes=UNIT''
 
* Favourite Rest Arg expressions can be saved and deleted using the '''+''' and '''-''' buttons - the '''?''' button provides help on the available arguments and their usage
 
* Favourite Rest Arg expressions can be saved and deleted using the '''+''' and '''-''' buttons - the '''?''' button provides help on the available arguments and their usage
 +
* Daily Time Format check box - (introduced in July 2024) - '''Daily Time Format''' or YYYY-MM-DD both an Excel friendly and [[SDMX_Time_Formats |SDMX compatible format]]. For instance if Daily Time Format is checked and an underlying date is 2024 then  2024-12-31 will be rendered to Excel.

Latest revision as of 07:41, 15 June 2026


An Excel ribbon bar tool for interactively building and editing FXLData functions.

Overview

The FXLData Wizard is part of the FXLData add-in for Excel which provides a collection of functions for retrieving statistical data from a Fusion Registry directly into a worksheet.

The Wizard helps in the task of building and modifying =FXLData() and =FXLDataV() functions which take a number of parameters including the Fusion Registry to connect to, the Dataflow and a data query expression - typically an SDMX series key.

FXLData Excel ribbon

Installing the FXLData Excel add-in adds a FXLData menu option and the ƒx button to the ribbon to launch the Wizard.

  • Select a blank cell in the worksheet and launch the Wizard to create a new FXLData function.
  • Modify an existing =FXLData() or = FXLDataV() function by selecting the worksheet cell before launching the Wizard.

Wizard

FXL Data Version Version 1.3

Wizard-r1-3.png

Rest Argument Builder

Click here to learn more about the new Rest Arguments Builder.

FXL Data Version Version 1.0

Wizard.png

Guidance

  • All parameters can take either a literal value (e.g. a number or a text string), a cell reference (e.g. A4) or an Excel formula (e.g. sum(A4,A6))
  • A parameter's result value is shown to the right which is just the literal, the contents of the referenced cell, or the result of the Excel formula
  • Red indicates the value is not valid
  • Use the Apply button to apply changes made in the Wizard to the worksheet
  • The FXLData function is refreshed automatically everytime the Apply button is clicked
  • The Registry URL is the base URL of the Fusion Registry data source - the same URL used to access the web user interface
  • Use the + and - buttons to add and remove favourite Fusion Registries from the drop down list - the Def button sets the default
  • The Dataflow can be either just the source Dataflow's ID (e.g. EXR) provided that is unique, or the fully-qualified Dataflow identifier (e.g. ECB,EXR,1.0)
  • The Dataflow drop down provides an up to date list of all dataflows from the selected Fusion Registry that contain data
  • The Data Expression defines precisely what series to retrieve using an SDMX Series Key or JSON packet describing a series basket that can be generated using Fusion Data Browser
  • Use the keyword all for the Data Expression to retrieve all series for the selected Dataflow
  • The Start Period and End Period select only observations between those dates which must be in SDMX time format - both are optional
  • REST Args allows additional data REST query arguments to be set such as rounding, calculated measures, dimension at observation and aggregations
  • The REST Args expression must follow the standard syntax for URL parameters using '&' as a separator , e.g. round=2&attributes=UNIT
  • Favourite Rest Arg expressions can be saved and deleted using the + and - buttons - the ? button provides help on the available arguments and their usage
  • Daily Time Format check box - (introduced in July 2024) - Daily Time Format or YYYY-MM-DD both an Excel friendly and SDMX compatible format. For instance if Daily Time Format is checked and an underlying date is 2024 then 2024-12-31 will be rendered to Excel.