Help Files

Help Files:

Data Service

Introduction

The Data service is used to download data.

User Restrictions

You must have enprompt privileges to access this data.

Calling the Service

The parameters used when calling the service are as follows:

Code Required / Optional Description
username Required The user name
password Required The password
format Required The type of format required
action Required The type of action required
more ... Optional Depending on the action selected there will be more options.

Specific Details on a per Action Basis

Dependent on the action, the request parameters and response are different. The table below specifies the actions that are supported.

Action Description
charts Get Available Charts.
resolutions Get Available Resolutions.
formats Get Available Formats.
data Get Data.

> action=charts

Getting the list of available charts.

https://enprompt.netareports.com/dataService?username=xxx&password=yyy&format=xml&action=charts

> action=resolutions

Getting the list of available resolutions.

https://enprompt.netareports.com/dataService?username=xxx&password=yyy&format=xml&action=resolutions

> action=formats

Getting the list of available formats.

https://enprompt.netareports.com/dataService?username=xxx&password=yyy&format=xml&action=formats

> action=entities

Getting entity information for plants in the market.

https://enbm.netareports.com/dataService?username=xxx&password=yyy&format=xml&action=entities

> action=data

1. Simple time-plot charts, for example deratedmargin<, freq, pricingscreen, systemfuelmix, systemgenoverall, systemimbalanceoverall and systemsummary.

Code Required/Optional Description
chart Required The chart code. The value could be systemsummary. (See 'charts' action)
update Required If false will always return data, else will return no data message if no change since submitted time
gmtupdatetime Required if update=true If update=true must put in the time of the last update. Can use the top field timestamp="2018-06-20T08:46:51" to get the last check time and then this feature can be used to only get data when a change has occurred.
format Required The type of format. The value could be xml, csv or xls. (See 'formats' action)

Example :

enprompt.netareports.com/dataService?username=xxx&password=yyy&format=xml&action=data&chart=systemsummary&update=true&updatetime=2018080620134211



2. Plot for levels of by unit activity, bmops.

Code Required/Optional Description
chart Required The chart code. The value could be bmops. (See 'charts' action)
update Required If false will always return data, else will return no data message if no change since submitted time
gmtupdatetime Required if update=true If update=true must put in the time of the last update. Can use the top field timestamp="2018-06-20T08:46:51" to get the last check time and then this feature can be used to only get data when a change has occurred.
format Required The type of format. The value could be xml, csv or xls. (See 'formats' action)
bmunitid Required The ID of the unit to get data for, e.g. T_ABTH7

Example :

enprompt.netareports.com/dataService?username=xxx&password=yyy&format=xml&action=data&chart=bmops&update=false&updatetime=2018100101000000&fuel=all&bmunitid=T_ABTH7



3. Plot for interconnector flows, interflows.

Code Required/Optional Description
chart Required The chart code. The value could be bmops. (See 'charts' action)
update Required If false will always return data, else will return no data message if no change since submitted time
gmtupdatetime Required if update=true If update=true must put in the time of the last update. Can use the top field timestamp="2018-06-20T08:46:51" to get the last check time and then this feature can be used to only get data when a change has occurred.
format Required The type of format. The value could be xml, csv or xls. (See 'formats' action)
inter Required The interconnector to plot for (look at URL from charts to pair ids with interconnectors)

Example :

enprompt.netareports.com/dataService?username=xxx&password=yyy&format=xml&action=data&chart=interflows&update=false&updatetime=2018100101000000&inter=0



4. Plot to show aggregated activity by fuel or by price; bidtoseloverall, bidvoloverall, bidoffvoloverall or offervoloverall.

Code Required/Optional Description
chart Required The chart code. The value could be bidvoloverall. (See 'charts' action)
update Required If false will always return data, else will return no data message if no change since submitted time
gmtupdatetime Required if update=true If update=true must put in the time of the last update. Can use the top field timestamp="2018-06-20T08:46:51" to get the last check time and then this feature can be used to only get data when a change has occurred.
format Required The type of format. The value could be xml, csv or xls. (See 'formats' action)
series_to_plot Required The type of aggregation to use, e.g. fuel or bidprice (see chart URL for more types)

Example :

enprompt.netareports.com/dataService?username=xxx&password=yyy&format=xml&action=data&chart=bidvoloverall&update=false&updatetime=2018100101000000&series_to_plot=bidprice



5. Plot to show aggregated activity by fuel or by price with spinning reserve selection, systemmarginoverall.

Code Required/Optional Description
chart Required The chart code. The value could be bidvoloverall. (See 'charts' action)
update Required If false will always return data, else will return no data message if no change since submitted time
gmtupdatetime Required if update=true If update=true must put in the time of the last update. Can use the top field timestamp="2018-06-20T08:46:51" to get the last check time and then this feature can be used to only get data when a change has occurred.
format Required The type of format. The value could be xml, csv or xls. (See 'formats' action)
series_to_plot Required The type of aggregation to use, e.g. fuel or bidprice (see chart URL for more types)
spinningreserve Required Whether spinning reserve only (1) or not (0)

Example :

enprompt.netareports.com/dataService?username=xxx&password=yyy&format=xml&action=data&chart=systemmarginoverall&update=false&updatetime=2018100101000000&series_to_plot=offerprice&spinningreserve=1



6. Levels of activity compared across the market; gaa or imbal.

Code Required/Optional Description
chart Required The chart code. The value could be gaa. (See 'charts' action)
update Required If false will always return data, else will return no data message if no change since submitted time
gmtupdatetime Required if update=true If update=true must put in the time of the last update. Can use the top field timestamp="2018-06-20T08:46:51" to get the last check time and then this feature can be used to only get data when a change has occurred.
format Required The type of format. The value could be xml, csv or xls. (See 'formats' action)
targettime Required The time selection (as in the URL on the matching charts), e.g. live or 0

Example :

enprompt.netareports.com/dataService?username=xxx&password=yyy&format=xml&action=data&chart=gaa&update=false&targettime=live



7. Levels of activity compared across the market for Balancing Mechanism activity; boprice or bovol.

Code Required/Optional Description
chart Required The chart code. The value could be boprice. (See 'charts' action)
update Required If false will always return data, else will return no data message if no change since submitted time
gmtupdatetime Required if update=true If update=true must put in the time of the last update. Can use the top field timestamp="2018-06-20T08:46:51" to get the last check time and then this feature can be used to only get data when a change has occurred.
format Required The type of format. The value could be xml, csv or xls. (See 'formats' action)
targettime Required The time selection (as in the URL on the matching charts), e.g. live or 0
accdecl Required Whether for accepted actions (0) or declared ones (1)

Example :

enprompt.netareports.com/dataService?username=xxx&password=yyy&format=xml&action=data&chart=bovol&update=false&targettime=live&accdecl=1



8. Unit data tables; accactions, bidtable, offerontable or offertable.

Code Required/Optional Description
chart Required The chart code. The value could be offertable. (See 'charts' action)
format Required The type of format. The value could be xml, csv or xls. (See 'formats' action)
targettime Required The time selection (as in the URL on the matching charts), e.g. live or 0

Example :

enprompt.netareports.com/dataService?username=xxx&password=yyy&format=xml&action=data&chart=offerontable&targettime=live