ACM ships with pre-made reports covering many different data topics. Custom reports can be created that are specific to your organization’s needs. This page will show how to create a new custom report and where to save it for users to access.
| Note | ||
|---|---|---|
| ||
Custom reports interact with the ACM database directly, and misconfigured reports can modify or delete contents from the ACM database which may cause issues. See Reports Tab on how to configure the reporting account to a read-only SQL user/account. |
Instructions
- Create a new file with the .XML extension.
- Paste in the sample File Format shown on this page.
- Enter a Name and Description for the report. Assign a unique name. This is the display name that will appear in report listings. The description is supporting text to explain what the report provides.
- Enter the SQL for the report:
SQL Query method.
Info Example: <!-- SELECT * FROM TblObjects ORDER BY ObjectId -->
Stored Procedure method.
Info Example: <!–EXECUTE dbo.asi_spProcedureName '@Parameter' -->
- Create one or more parameters as needed. If no parameters are needed, leave the parameters node empty. See Parameters section for details and examples.
- Save the file to the File Location shown below. The Report Service will include the new report the next time the listing is loaded or refreshed. There is no need to restart the Report Service.
...
| Info |
|---|
| Example: C:\ProgramData\AutoSol\Communication Manager\7\Reports |
| Anchor | ||||
|---|---|---|---|---|
|
Reports are XML files with the following schema:
...
Parameters consist of the following elements:
- Type (Determines the data type and user entry method .such as checkbox or drop-down listing and its choices)
- Name (The label for the parameter and the token used in the SQL statement to resolve the value when executing.
- Description (Helpful description shown to guide user.)
- Default (Default value for parameter. Can be Custom Default for Date/DateTime types only.)
- Min/Max (If applicable, include the minimum and maximum range the value can be.)
...
| Info | ||
|---|---|---|
| ||
<parameters> <parameter type="Integer" name="Missing" description="Missing Record Count" default="0" min="-1" max="100"/> <parameter type="Boolean" name="IncludeStation" description="Include Station Meters" default="false" /> <parameter type="Device" name="DeviceName" description="Device" default="0" /> </parameters> |
Supported Parameter Types
| Type | Description |
|---|---|
DateTime Date | A value representing a |
datetime. Modifiers can be used to set a default. Uses the default attribute of the parameter node. See Supported Custom Defaults below. |
| Boolean | A value representing a choice of True or False. The UI will display a toggle or checkbox control. |
| Integer | A value representing a generic number such as a number of days or hours. The UI will display a number entry control. |
| Device | A value representing a device object number. The UI will display a listing of protocol devices to choose from. |
| Object | A value representing an object number. The UI will display a listing of objects to choose from. |
| Meter | A value representing a meter object number. The UI will display a listing of meters to choose from. |
| Archive | A value representing an archive object number. The UI will display a listing of archives to choose from. |
| Publisher | A value representing a publisher object number. The UI will display a listing of publishers to choose from. |
| Filter | A value representing an archive filter object number. The UI will display a listing of archive filters to choose from. |
Supported Custom Defaults
| Type | Description |
|---|---|
| Current | The current date and time as of executing the SQL. |
| TopHour | The current top of hour as of executing the SQL. Example: Current Time=12 |
| :30PM, TopHour=12 |
| :00PM | |
| StartDay | The current date as of executing the SQL. |
| EndDay | The current date plus 1 day as of executing the SQL. |
| Yesterday | The current date minus 1 day as of executing the SQL. |
| PriorHour | The last top hour minus 1 hour from current date and time as of executing the SQL. Example: Current Time=12 |
| :30PM, PriorHour=11 |
| :00AM | |
| NextHour | The next top of hour plus 1 hour from current date and time as of executing the SQL. Example: Current Time=12 |
| :30PM, NextHour=1 |
| :00PM | |
| StartMonth | The date of the first day of the current month as of executing the SQL. |
Examples
| Info | ||
|---|---|---|
| ||
<?xml version="1.0" encoding="utf-8" ?> Note: Stored Procedure Parameters are preceded by the "@" character. The matches the name of the corresponding parameter.
|
...