Difference between revisions of "Fusion-Excel-Series"

From Fusion Registry Wiki
Jump to navigation Jump to search
(Formatting Using Query Parameters)
(Example)
Line 42: Line 42:
  
 
=Example=
 
=Example=
//TODO
 
<i>https://demo.metadatatechnology.com/FusionRegistry/ws/public/sdmxapi/rest/data/WB,GCI,1.0/GHA.GCI..?format=xxxx</i>
 
 
<strong>Note:</strong> The same formatting can be applied using [[Data_Formats|HTTP Accept Headers]] as opposed to query parameters.
 

Revision as of 05:43, 28 July 2020


Fusion Excel Series with header section and tabs
Fusion Excel Series with only the series key as the header (not broken down by dimensions)
Showing Currency at the Observation Level

Overview

The Fusion-Excel-Series format is not an official SDMX format. It has a similar layout to the Fusion-CSV-Series format, in that a Series is output per Column. The series can iterate values over time, or any other designated dimension to be at the observation level.

The advantages over CSV is that Excel provides a few additional features which are now possible in CSV, these are:

  • The ability to slice the data over a Dimension to output a worksheet per Dimension value, e.g slice by FREQ would output Annual Data in one worksheet, Monthly data in another, and so on.
  • The ability to promote fixed values to a header. Similar to the Fusion_Excel_Data format, reported values which are the same for the whole worksheet can be reported once in a header section
  • Excel's freeze pane feature is used to make the inner table scrollable while keeping the column and row headers in place
  • The use of colour to style the output, making the data easier to read

Fusion-Excel-Series is an export format only, supported by Fusion Registry, Fusion Edge Server and Fusion Data Browser.

Fusion-Excel-Series became available from Fusion Registry v10.4.5 onwards

Formatting Using Query Parameters

The following URL parameters can be used in a RESTful query for to get data in Excel format.

Query Parameter Values Description
format excel-series Required to output the dataset in fusion-excel-series format
dimensionAtObservation [dimension id]
default TIME_PEREIOD for time series data
Defines which dimension is iterated over on the rows
slice [dimension id]
default to N/A
If provided, an Excel worksheet will be created for each distinct value in the dataset for this Dimension
labels id or name or both
(id is default)
Output Ids or the corresponding name, or id and name
header exclude
(include is default)
The header refers to the breakdown of Dimension values that sits above each series column. If excluded each column header is simply the series key.
fixedvalues keep or promote or remove
(keep is default)
Describes how to handle Dimension values which are the same for the whole dataset.
  • keep - keep the values in the header
  • promote - remove the values from the header, promote them to a high level 'fixed values' table
  • remove - do not ouput Dimension lables when they have a fixed value

Example