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).