# Report Elements The reports in IT-Conductor use the IT-Conductor XML markup identified by "itc" namespace prefix. At this time, the XML is not validated against the IT-Conductor schema. ### **Global Variables** "variables ${self/....}, ${report/...}" are supported in any report element #### Qualifiers * **self** - report object like ${self/OBJECT\_Name} * **report** - report specific [ Variables](#reporting-variable) ### **Section** Dynamic Sections behave the same way as "\", producing a list of objects based on select criteria: ``` class-name value ... ... true|false - Optional, allows for selection of objects based on the effective Maintenance Mode Link Target Class - Optional, if the intent is to return a list of linked objects, this is the class of the link objects Link target object attribute name - Optional, if the intent is to return a list of linked objects and the selection targets Links, this attribute contains the target object id in the link, normally LINK_LinkedObjectId or LINK_ObjectId the opposite of what is used in the select criteria ... ``` Where content can be any other construct including another. The essence of sections is that for each object found in the query, the content will be replicated, and if "${context/...}" variables are used in any of the parameters they will be resolved with the query result Object attribute. Nested "\
" push the context into a FIFO stack so all children will have the new object instance set as a context. ``` ${context/OBJECT_Name}

...

``` Assuming the section query finds 3 objects, it will create the following construct: ```

Object 1

Object 2

Object 3

``` ### **Variable** Sets report variable: ``` value ``` The variables can be accessed anywhere in the report elements as ${report/var-name} The variable must be decalred in the report xml before it is used - IT-Conductor processes xml sequentially. ### **If** Conditional block: ``` context|variables value ... ... ... any content ... ``` The optional **mode** parameter (defaults to "context") - determines what the condition criteria (selects) are applied to: * **context** - the current context object (report external context or section-derived context) * **variables** - report variables (assigned with \) If the criteria (all "\" elements) evaluates to true the content of the if is included and evaluated according to report-type supported elements, otherwise it is skipped. ### **Icon** Insert Icon: ``` ``` For available icon names, please refer to: ### **Path** Displays service element path: ``` ``` {% hint style="info" %} **Note:** For PDF reports this is the only itc:... construct currently supported inside heading markup \\ {% endhint %} ### **Object & Context Selectors** In all constructs we now support dynamic object and context selectors in addition to parameters "OBJECT\_Id" & "context": ``` ``` See detail in ["Where"](#reporting-where). ### **Chart** Reports Chart: ``` 100% HOUR true|false New Text true|false none|left|right|top|bottom true|false Category id Range, see below End Time true|false true|false false false true|false Text Text true|false true|false ``` Where Category ID is either category Object Id (for multi-line graphs) or "Alarm", "Warning", "Severity", "itconductor.Annotations", "itconductor.Summary". ### **Threshold** Locates & reports a threshold, based on the target Object ID and value Attribute Name. {% hint style="info" %} **Note:** Only Regular thresholds are supported. Collection thresholds should be accessed using "\" construct. {% endhint %} ``` OBJECT_Availability false 100% HOUR true|false New Text true|false none|left|right|top|bottom true|false Range, see below End Time Value scale, Decimal Unit Name, String Value Format, Java Formatting: %,.2f true|false Alert Status false 100% HOUR Range, see below true|false Comma-separated column Attributes attribute name DESC|ASC ``` ### **Service Query** Query on a service tree (applies the search criteria to each element in the sub-tree): ``` Target Object Class ALERT.ContextService ALERT.Time false 100% Time Scale Range Time Time true|false Comma-separated column Attributes attribute name DESC|ASC ``` ### **Query** Free-form object query: ``` true|false Comma-separated column Attributes Link target object attribute name Linked object Class Name attribute name DESC|ASC ``` ### **Object Details** Display all visible object attributes as a vertical table with "Name:Value" rows: ``` ``` ### **Counter** Object counter based on query returns the number of objects in the query result: ``` Label ``` ### **Saved Search** ``` Saved Search Object ID true|false Comma-separated column Attributes ``` ### **Audit Log** Report audit log events: ``` Min Severity Request Name Range, see below true Timestamp|ObjectId|ObjectName|ObjectClass|AuthorId|AuthorName|Request|Severity DESC|ASC ``` ### **Subscriptions** Creates a table displaying the email addresses of tenant subscriptions: ``` ``` ### **Attribute Text** Display object attribute text based on the attribute Display format. For the HTML report, it is wrapped with "\

value\

". For PDF, a paragraph is created with the value: ``` EXTERNAL_ACTIVITY.Log ``` {% hint style="info" %} **Note:** Avoid HTML content. It can not be converted to PDF {% endhint %} ### **Where** **Object Selector:** ``` ${context/OBJECT_Id} Object Class value ... ``` **Context Selector:** ``` Context ID