com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'html' is unknown.

App Settings

Owned by Omry Koschitzky
Dec 28, 2015
3 min read

The App settings contains different settings on the App level. Unless changed individually, Dashboards and Gadgets inherit the Apps settings. There are two options to open the general settings of an App:

  1. In the main Apps screen, mouse over an App and click the  icon to displays the menu items and select Edit App.
  2. Click an App to enter its Dashboards view, and click the Edit App on the left hand side.

App's general settings screen is opened.

General

The general settings section allows to configure Name, Description and color or image identifier to the App (if an image is used, it is recommended to use a square image and not a rectangle)

Time Settings

The time settings section allows to configure the following:

  • Time Range: the default App time range which all dashboards and gadgets will display by default unless configured individually otherwise.
    Time Range which is set to Live determines a real time execution of the dashboards and gadgets under this App. Dashboards and gadgets will not be generated in the background, results will be calculated and displayed in real time only and while a dashboards is opened.
  • Generation Frequency: the frequency that new data will be processed and displayed in the App's dashboards and gadgets.
    Generation frequency which is set to Never determines an offline mode of the App - dashboards and gadgets will be generated only on the exported time definition and/or on demand.

 

App Sources

The App sources enables a generic definition of the Apps logs/folders/servers sources which will be added to all used search queries in the dashboard's gadgets.
For example if the App's dashboards should refer to servers x, y, z then it is possible to specify this directly in each gadget's search query. Alternatively, it is possible to use generic queries in the gadgets and specify the list of sources in the App Sources section.

Using App Sources makes it very simple to duplicate, maintain and manage the list of sources that will be analyzed by the App's dashboards. 


 

Export Settings

 

The export settings section determines if/what to export from this App.

 

  • Exporting Frequency: a frequency, a specific time or several times in which the App's dashboards will be exported according the Export to Email / Export to File definition.
  • Dashboards: by default, all dashboards will be exported based on the export definition. It is possible to select only specific dashboards from the App's dashboards to be exported.
  • Exporting:
    The export mechanism supports an export of all selected dashboards as PDF and/or CSV files by email and/or by saving a file in the specified location.
    • Export To Email: the email settings that will be used when exporting the App's dashboards by email (for multiple recipients use a comma separated list).
    • Export To File: the format, location and retention settings that will be used when exporting the App's dashboards to files on the file system. 

 

 

Note: no images are exported in a CSV formatted file.

 

 

 

  • XpoLog Apps support definition of multiple export schedulers. Using more than one export scheduler allows a configuration of a specific date range for each scheduled export. For example it is possible to configure on the same App an export scheduler once a week on the last week and another scheduler once a day on the last day - the result will be a daily export presenting the last day and a weekly export presenting the last week of the specified dashboards in this App.Â