Applicable Versions: 5.00.0050 onwards


The ManagedDashboard class contains a Publish method that allows you to publish dashboards to a DataPA Enterprise server. The first argument of the Publish method requires a ClientConfig object that defines the location of the server and any licensing or security details that are required to successfully publish the dashboard.


The second argument of the Publish method takes the unique ID of the Category you wish to publish the dashboard to. You can obtain the unique ID of a Category from the context menu (press the right mouse button) of the Managed Publish screen.


If you wish to change the name used to reference the dashboard in DataPA Enterprise, assign your changed value to the Title property of the ManagedDashboard object before calling the Publish method. 


SilentPublishDashboard.p is an example Progress OpenEdge ABL procedure for publishing a dashboard. It requires the following parameters;


ipDashboardFileName
The fully qualified pathname to the dashboard to be published
ipPublishName
The name the dashboard will be given on the server (if blank uses the name saved in the dashboard)
ipCategory
The Unique ID of the category to publish to (if blank if blank will publish to the category defined in the dashboard, or the default category if not set)
ipServerURL
The URL of the DataPA Enterprise server i.e. localhost:80 (if blank the current DataLocation for the client will be used)
ipUsername
The username to be used to publish the dashboard (if left blank, the user will be prompted for a username and password if required)
ipPassword
The password to use to publish the dashboard.
ipSerialNo
The serial number of a client license to create the appropriate client objects (if not entered, the license currently entered on the client will be used).
ipLicenseCode
The license code of a client license to create the appropriate client objects (if not entered, the license currently entered on the client will be used).
opSuccess
Returns true if the dashboard is published succesfully, else false
opError
If the publish operation fails, returns a message that indicates why


An example call of SilentPublishDashboard.p might be;


DEFINE VARIABLE lSuccess AS LOGICAL NO-UNDO.
DEFINE VARIABLE chError AS CHARACTER NO-UNDO.

RUN SilentPublishDashboard.p
  (INPUT ""C:\Dashboards\Sales Dashboard.edp"",
   INPUT ""Sales Dashboard"",
   INPUT ""41348dfc-9691-4936-bc1d-510b93b6e4e7"",
   INPUT ""myhost"",
   INPUT ""psmith"",
   INPUT ""password"",
   INPUT ""0000000123"",
   INPUT ""412390CRE792ABCE211FBC1B"",
   OUTPUT lSuccess,
   OUTPUT chError).