Skip to content

Commit

Permalink
Merge pull request #694 from i-doit/683-update-httpskbi-doitcomeneval…
Browse files Browse the repository at this point in the history
…uationvariable-reportshtml

683-update-httpskbi-doitcomenevaluationvariable-reportshtml
  • Loading branch information
MichaelOv authored Aug 19, 2024
2 parents 358b241 + 9c665c6 commit e8837de
Show file tree
Hide file tree
Showing 16 changed files with 33 additions and 29 deletions.
23 changes: 14 additions & 9 deletions docs/de/auswertungen/variable-reports.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,10 @@
# Variable Reports
---
title: Variable Report
description: Variable Report
icon:
status:
lang: de
---

Die variablen Reports sind nützlich, um die eigene i-doit-Installation noch weiter auf den persönlichen Zuschnitt hin anzupassen.

Expand All @@ -8,7 +14,7 @@ Viele Anwender haben bereits heute [benutzerdefinierte Kategorien](../grundlagen

Nehmen wir an, in der Organisation sind Bereichsdrucker definiert. Die Räume **1.01** bis **1.07** verwenden **HQ Staff Printer 01**, die Räume **1.0****8** bis **1.11** den **HQ Staff Printer 02**.

Dokumentiert wird das mit der benutzerdefinierten Kategorie **Bereichsdrucker**. Diese wird dem [Objekttyp](../grundlagen/struktur-it-dokumentation.md) **Drucker** zugeordnet und als [Single-Value-Kategorie](../grundlagen/struktur-it-dokumentation.md), nicht als [Listen-Kategorie (Multi-Value)](../grundlagen/struktur-it-dokumentation.md) definiert. Das [Attribut](../grundlagen/struktur-it-dokumentation.md) **Bereichsdrucker für** wird als **Objekt-Beziehung (Mehrfachauswahl)** mit **Zusatz Freigabenzugriff** hinzugefügt.
Dokumentiert wird das mit der benutzerdefinierten Kategorie **Bereichsdrucker**. Diese wird dem [Objekttyp](../grundlagen/struktur-it-dokumentation.md) **Drucker** zugeordnet und als [Single-Value-Kategorie](../grundlagen/struktur-it-dokumentation.md). Das [Attribut](../grundlagen/struktur-it-dokumentation.md) **Bereichsdrucker für** wird als **Objekt-Beziehung (Mehrfachauswahl)** mit Zusatz **Freigabenzugriff** hinzugefügt.

[![benutzerdefinierte-kategorien](../assets/images/de/auswertungen/variable-reports/1-vr.png)](../assets/images/de/auswertungen/variable-reports/1-vr.png)

Expand All @@ -24,25 +30,24 @@ Dies lässt sich auch mit dem [CMDB-Explorer](../auswertungen/cmdb-explorer/inde

[![cmdb-explorer](../assets/images/de/auswertungen/variable-reports/4-vr.png)](../assets/images/de/auswertungen/variable-reports/4-vr.png)

## Rückwärtige Ansicht für benutzerdefinierte Kategorie

So weit so gut. Doch wie findet man heraus, wenn man sich den Raum **1.05** ansieht, welcher Bereichsdrucker für diesen Raum definiert ist? Dafür ist eine rückwärtige Ansicht nötig, mit der man feststellen kann, welcher Drucker in Beziehung zu diesem Raum steht. Mit den variablen Reports gibt für solche kontextabhängigen Abfragen eine Lösung.

Dazu wird ein [Report](../auswertungen/report-manager.md) und eine weitere benutzerdefinierte Kategorie erstellt. Zunächst zum Report **Bereichsdrucker rückwärtig**. Dort wird die Checkbox **Variabler Report** angehakt und unter **Ausgabe** einige interessante Attribute zu den Druckern ausgewählt.
Dazu wird ein [Report](../auswertungen/report-manager.md) und eine weitere benutzerdefinierte Kategorie erstellt. Zunächst zum Report **Zugewiesene Bereichsdrucker**. Unter **Ausgabe** einige interessante Attribute zu den Druckern ausgewählt.

[![abfrage-editor](../assets/images/de/auswertungen/variable-reports/5-vr.png)](../assets/images/de/auswertungen/variable-reports/5-vr.png)
Im Abfrage-Editor gibt es die Möglichkeit, bei Verknüpfungen, die Beziehungen generieren, unter **Bedingungen** einen **Feldplatzhalter** zu setzen.

Im Abfrage-Editor gibt es die Möglichkeit, bei allen Verknüpfungen, die Beziehungen generieren, unter **Bedingungen** einen **Feldplatzhalter** zu setzen.
Für diesen Anwendungsfall heißt das: Der Report "sucht" nach jenen Objekten, in denen in der benutzerdefinierten Kategorie **Bereichsdrucker** im Attribut **Bereichsdrucker für** die [Objekt-ID](../grundlagen/eindeutige-referenzierungen.md) des aktuell ausgewählten Objektes eingetragen ist. Doch was ist das ausgewählte Objekt? Im Kontext des Report Managers gibt es kein ausgewähltes Objekt. Dadurch wird der Report zu einem variablen Report.

Für diesen Anwendungsfall heißt das: Der Report "sucht" nach jenen Objekten, in denen in der benutzerdefinierten Kategorie **Bereichsdrucker** im Attribut **Bereichsdrucker für** die [Objekt-ID](../grundlagen/eindeutige-referenzierungen.md) des aktuell ausgewählten Objektes eingetragen ist. Doch was ist das ausgewählte Objekt? Im Kontext des Report Managers gibt es kein ausgewähltes Objekt.
[![abfrage-editor](../assets/images/de/auswertungen/variable-reports/5-vr.png)](../assets/images/de/auswertungen/variable-reports/5-vr.png)

Daher muss stets ein Objekt auswählt werden, um den Report ausfüllen zu können. Das geschieht dadurch, indem man zum Report eine Kategorie erstellt, die den Report innerhalb eines Objektes ausführt. Diese wird **Bereichsdrucker rückwärtig** genannt, dem Objekttyp **Raum** zugeordnet und als Single-Value-Kategorie definiert. Zudem erhält sich ein namenloses Attribut mit dem **Feldtyp Report**. Unter **Zusatz** wird die ID des oben erstellten Reports angegeben.
Daher muss stets ein Objekt auswählt werden, um den Report ausfüllen zu können. In diesem Fall geschieht dies indem man zum Report eine Kategorie erstellt, die den Report innerhalb eines Objektes ausführt. Diese wird **Bereichsdrucker rückwärtig** genannt, dem Objekttyp **Raum** zugeordnet und als Single-Value-Kategorie definiert. Zudem erhält sich ein namenloses Attribut mit dem **Feldtyp Report**. Unter **Zusatz** wird die ID des oben erstellten Reports angegeben.

[![report-1](../assets/images/de/auswertungen/variable-reports/6-vr.png)](../assets/images/de/auswertungen/variable-reports/6-vr.png)

Die Report-ID ist in der Übersicht der bereits definierten Reports enthalten.

[![report-2](../assets/images/de/auswertungen/variable-reports/7-vr.png)](../assets/images/de/auswertungen/variable-reports/8-vr.png)
[![report-2](../assets/images/de/auswertungen/variable-reports/7-vr.png)](../assets/images/de/auswertungen/variable-reports/7-vr.png)

In Raumobjekten steht jetzt die neue Kategorie zur Verfügung, die den Report immer für das Objekt ausführt, in dem sich der Anwender befindet. Dadurch erhält man eine rückwärtige Ansicht über die Beziehung zum Bereichsdrucker.

Expand Down
39 changes: 19 additions & 20 deletions docs/en/evaluation/variable-reports.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,24 @@
# Variable Reports
---
title: Variable report
description: Variable report
icon:
status:
lang: en
---

Variable reports are very useful to customize your own i-doit installation for your individual needs.
Variable reports are very useful to customize your own i-doit installation for your individual needs.

Custom Categories
-----------------
## Example department printer

A lot of users already use the [custom categories](../basics/custom-categories.md). One thing which characterizes the custom categories is the possibility to link [objects](../basics/structure-of-the-it-documentation.md).

To give an example: Say that your company uses printers which are assigned to certain offices. The rooms **1.01** to **1.07** use **Printer A**, rooms **1.0****8** to **1.11** use **Printer B**.
To give an example: Say that your company uses printers which are assigned to certain offices. The rooms **1.01** to **1.07** use **HQ Staff Printer 01**, rooms **1.0****8** to **1.11** use **HQ Staff Printer 02**.

This can be documented with the custom category **Department**. This category is assigned to the [object type](../basics/structure-of-the-it-documentation.md) **Printer** and defined as [single-value category](../basics/structure-of-the-it-documentation.md), not as [list category ("Multi-Value")](../basics/structure-of-the-it-documentation.md). The **Department** [attribute](../basics/structure-of-the-it-documentation.md) is added as **Object-Relation (multiple selection)** with the addition **Share Access**.
This can be documented with the custom category **Department printer**. This category is assigned to the [object type](../basics/structure-of-the-it-documentation.md) **Printer** and defined as [single-value category](../basics/structure-of-the-it-documentation.md). The **Department printer for** [attribute](../basics/structure-of-the-it-documentation.md) is added as **Object-Relation (Several objects)** with the addition **Share Access**.

[![Object-Relation](../assets/images/en/evaluation/variable-reports/1-vr.png)](../assets/images/en/evaluation/variable-reports/1-vr.png)

Then change to the object **Printer**. Now you can select the assigned rooms in the **Department** category.
Then open the object **HQ Staff Printer 01**. Now you can select the assigned rooms in the **Department printer** category.

[![Printer](../assets/images/en/evaluation/variable-reports/2-vr.png)](../assets/images/en/evaluation/variable-reports/2-vr.png)

Expand All @@ -25,28 +30,22 @@ You can also visualize the result with the [CMDB explorer](./cmdb-explorer/index

[![CMDB explorer](../assets/images/en/evaluation/variable-reports/4-vr.png)](../assets/images/en/evaluation/variable-reports/4-vr.png)

Mirrored View for Custom Category
But when you have a look at room **1.05** now, how can you find out which printer is assigned to this room? For this purpose, you need a "mirrored view" with which you can see which printer is related to this room. The variable report provide a good solution for such context-related queries.

------------------------------------
To this end, you set up a [report](./report-manager.md) and another custom category. First, you create the report **Assigned department printer**. Select some significant **attributes** regarding the printers for the **Output**. The query builder provides the possibility to set a **Placeholder** for all links which generate relations under **Conditions**.

But when you have a look at room **1.05** now, how can you find out which printer is assigned to this room? For this purpose, you need a mirrored view with which you can see which printer is related to this room. The variable reports provide a good solution for such context-related queries.
In our case this means: The report "searches" for those objects in which the [object ID](../basics/unique-references.md) of the currently selected object is listed in the custom category **Department printer** in the attribute **Department printer for**. But what is the selected object? There is no selected object in the context of the report manager. This turns the report into a variable report.

To this end, you set up a [report](./report-manager.md) and another custom category. First of all, you create the report **Department-related hardware**. Check the box **Variable Report** and select some significant attributes regarding the printers under **Output**.
[![Report](../assets/images/en/evaluation/variable-reports/5-vr.png)](../assets/images/en/evaluation/variable-reports/5-vr.png)

[![Output](../assets/images/en/evaluation/variable-reports/5-vr.png)](../assets/images/en/evaluation/variable-reports/5-vr.png)

The query builder provides the possibility to set a **Placeholder** for all links which generate relations under **Conditions**.

In our case this means: The report "searches" for those objects in which the [object ID](../basics/unique-references.md) of the currently selected object is listed in the custom category **Department** in the attribute **Department**. But what is the selected object? There is no selected object in the context of the report manager.

Therefore you always have to select an object to be able to fill out the report. You can achieve this by creating a category for the report which executes the report within an object. This is called **Department**, assigned to the object **Room** and defined as single-value category. There also is an unnamed attribute with the **Field type Report**. The ID of the above mentioned report is specified under **Addition**.
Therefore, an object must always be selected in order to populate the report. In this case you can achieve this by creating a category for the report which executes the report within an object. This is called **Department**, assigned to the object **Room** and defined as single-value category. There also is an unnamed attribute with the **Field type Report**. The ID of the above mentioned report is specified under **Addition**.

[![Field type Report](../assets/images/en/evaluation/variable-reports/6-vr.png)](../assets/images/en/evaluation/variable-reports/6-vr.png)

The report ID is contained in the overview of the already defined reports.
The report ID is contained in the overview of the already defined reports.

[![Field type Report](../assets/images/en/evaluation/variable-reports/7-vr.png)](../assets/images/en/evaluation/variable-reports/7-vr.png)

Now the new category is available in room objects. It always generates the report for the object in which the user currently is. By this means, you get a mirrored view of the relation to the department.

[![Field type Report](../assets/images/en/evaluation/variable-reports/8-vr.png)](../assets/images/en/evaluation/variable-reports/8-vr.png)
[![Field type Report](../assets/images/en/evaluation/variable-reports/8-vr.png)](../assets/images/en/evaluation/variable-reports/8-vr.png)
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified overrides/assets/images/en/evaluation/variable-reports/1-vr.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified overrides/assets/images/en/evaluation/variable-reports/2-vr.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified overrides/assets/images/en/evaluation/variable-reports/3-vr.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified overrides/assets/images/en/evaluation/variable-reports/4-vr.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified overrides/assets/images/en/evaluation/variable-reports/5-vr.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified overrides/assets/images/en/evaluation/variable-reports/6-vr.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified overrides/assets/images/en/evaluation/variable-reports/7-vr.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified overrides/assets/images/en/evaluation/variable-reports/8-vr.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit e8837de

Please sign in to comment.