Exago Logo
Search
Generic filters
Exact matches only

WebReports.Api

Note

This version of the .NET API documentation is deprecated. A new version can be found at https://www.exagoaccess.com/api-docs/.

Api Class

The Api class is the main interaction class between Exago and the host application. All API session parameters are accessed through this class.

Note

An Api object should be the first thing that is created to interact with Exago.

Properties

An Api object has the following properties:

  • Action — Value that may indicate to execute a report or open Exago directly in to the Report Designer or Report Wizard. For the values EditReport, NewReport, NewCrossTabReport and NewExpressReport the main menu will be disabled.
    • Uses the enumeration wrApiAction
    • If you have a Report object loaded then the value of Default will execute the report directly. Otherwise it will open the home page.
  • AppVirtualPath — IIS virtual directory of Exago’s location. This should be set to an absolute path (i.e. /ExagoWebSite/Exago).
  • DataSources — DataSources collection.
  • Parameters — Parameters collection.
  • ReportObjectFactory — Used to manage all report objects within the application.
  • ReportScheduler — Scheduler object.
  • Roles — Roles collection.
  • ShowTabs — Boolean value. Set to False to hide the tab bar, context help Help.png and user preferences UserPreferences.png icons and to disable the Export option from tiles in the Dashboard Viewer.
  • DefaultReportName — String value used in conjunction with api.Action.
    • When api.Action is set to NewReport, NewCrossTabReport or NewExpressReport: The DefaultReportName provides the full path name for the report. The Info tab of the new report wizard will be hidden and the report designer will not display menus to rename the report or change its description.
    • When api.Action is set to EditReport: If DefaultReportName is any non-empty value the report designer will not display menus to rename the report or change its description.

Methods

An Api object has the following methods:

Constructor( )

Remark

Warning

Do not call this method from the .NET API.

Constructor(string appVirtualPath)

DescriptionInitializes an Api object and sets the AppVirtualPath.
RemarksReturn value is void.

Constructor(string appVirtualPath, string configFile)

DescriptionInitializes an Api object, sets the AppVirtualPath and loads the specified configuration.
RemarksCan be used to load configuration other than WebReports.xml.

Return value is void.

Constructor(string appVirtualPath, string configFile, string azurePath)

DescriptionInitializes an Api object, sets the AppVirtualPath and loads the specified configuration from Azure.
RemarksThe specified Azure path must match that in app.config in the Exago installation. See Azure Cloud Support for more information.

Return value is void.

GetUrlParamString( )

DescriptionCalls GetUrlParamString(“ExagoHome”)
RemarksReturn value is void.

GetUrlParamString(string webPageName)

DescriptionReturns the URL parameter string used to redirect browser or frame to Exago. Append this string to your Exago URL.

GetUrlParamString(string webPageName, boolean showErrorDetail)

DescriptionReturns the URL parameter string used to redirect browser or frame to Exago. Append this string to your Exago URL. Set showErrorDetail to True to display detailed error messages.

SaveConfigToApi()

DescriptionSaves configuration changes only for the current user session. Changes will not persist once the session ends.

SaveConfigToFile()

DescriptionSaves configuration changes to disk, overwriting the configuration from the current location. Only those settings which differ from the defaults will be written to the file.

SaveConfigToFile(string fileName, boolean forceAllValues)

DescriptionSaves configuration changes to disk, to the configuration file specified by the fileName argument.

If forceAllValues is True, all of the general configuration settings will be written to the file. If False, only those settings which differ from the defaults will be written to the file. Default value is False.

Was this article helpful?
0 out of 5 stars
5 Stars 0%
4 Stars 0%
3 Stars 0%
2 Stars 0%
1 Stars 0%
How can we improve this article?
Please submit the reason for your vote so that we can improve the article.
Table of Contents