Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Get the list of available available SSD 'displays' and 'panels' and additional configuration information that is required to successfully use the SSD web service, like the time step and relative period to use for time 'navigation'. GetCapabilties will return its content as XML. 

Request parameters

  • FORMAT (optional) : the requested capabilities format. ( 'application/xml' or 'application/json')  The default format is XML.
  • SSD : by specifying the name of a SDD display panel the capabilities can be rendered for only one specific SSD display panel.
  • SHOWTIMESTEPS : when SHOWTIMESTEPS =TRUE  the time dimension information will include a list of individual time steps. (default is false)
  • TIMEZERO : the reference time0 which is used to transform relative times used in the SSD configuration to absolute date/time values (default is current time)

...

Get the SSD display as SVG document for one of the configured SSD "DisplayPanel" items listed in the capabilities XML. The DisplayPanel (Scada panel) to be rendered is specified by name using the SSD parameter.

Request parameters

  • SSD (required): the name of the SSD "DisplayPanel" to render. Only one SSD can be rendered at a time.
  • TIME (optional): the time for which the SSD is to be rendered. Time has to be in the ISO_8601 dateformat:  yyyy-MM-ddTHH:mm:ssZ. The default time is the current time.
  • LANGUAGE (optional): a 2 character language code to use while rendering the SVG file. The language control affects how numbers are formatted, i.e. for language=nl a decimal comma will be used as decimal separator. The default is 'US' for US English.

...

For a given X, Y coordinate (in pixels relative to the upper left corner of a rendered SVG graphic), the GetFeatureInfo request will determine the topmost element in the SVG file at that coordinate and return the element Id. This request supports applications where the SVG image is shown on a web page using the <img > HTML element and the user needs to be able to click on elements in the SVG graphic to query the underlying data.

Request parameters

  • SSD SSD (required): the name of the SSD "DisplayPanel" to render. Only one SSD can be queried at a time.
  • X (required): the horizontal X coordinate in pixels relative to the left of the SVG graphic.
  • Y (required): the vertical Y coordinate in pixels relative to the top of the SVG graphic.
  • WIDTH: (optional) If the SVG was displayed with a size different from the default SVG size, this width (in pixels) should be specified so the given X coordinate can be scaled accordingly.
  • HEIGHT: (optional) If the SVG was displayed with a size different from the default SVG size, this height (in pixels) should be specified so the given Y coordinate can be scaled accordingly.
  • TIME (optional): the time for which the SSD is to be rendered. Time has to be in the ISO_8601 dateformat:  yyyy-MM-ddTHH:mm:ssZ. The default time is the current time.
  • FORMAT (optional) : the requested output format. ( 'application/xml' or 'application/json')  The default format is XML.

...

For a given SVG element ID, this request can provide information about specific actions that have been configured in the FEWS scada/ssd display configuration. Specifically the leftSingleClickAction and leftDoubleClickAction that have been configured can be retrieved using this request. This request is designed specifically to support web developers in the development of web applications where the user can click on elements in the SVG image to display more detailed information about a location in the SSD display.

Request parameters

  • SSD (required): the name of the SSD "DisplayPanel" to query. Only one SSD can be queried at a time.
  • OBJECTID: the id of the SVG object to retrieve the configured actions for.
  • ACTION: the type of user interaction, can be either LEFTSINGLECLICK or LEFTDOUBLECLICK (case insensitive)
  • TIMEZERO : the reference time0 which is used to transform relative times used in the SSD or timeseries display configuration to absolute date/time values (default is current time)
  • FORMAT (optional) : the requested output format. ( 'application/xml' or 'application/json')  The default format is XML.

...