--- title: "Report Bausteine" slug: "report-bausteine" description: "Ein PDF-Report setzt sich im VASGARD/IAN aus einer ineinander verschachtelten Folge von Bausteinen zusammen. Erfahren Sie welche Bausteine zur Verfügung stehen." updated: 2024-12-05T13:51:43Z published: 2024-12-05T13:51:43Z canonical: "docs.vasgard.com/report-bausteine" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.vasgard.com/llms.txt > Use this file to discover all available pages before exploring further. # Report Bausteine Ein PDF-Report setzt sich aus einer ineinander verschachtelten Folge von Bausteinen zusammen. ![](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/neuen-baustein-auswahl.png) An jeder Stelle, an der diese Funktion zu sehen ist, kann ein weiterer Baustein hinzugefügt werden. Dazu muss zunächst dessen Typ ausgewählt werden. ![bausteinliste](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/bausteinliste.png) Liste der Bausteine Es stehen die folgenden Typen von Bausteinen zur Verfügung: - **Auswertungergebnis:** Diese Auswahl bei einer ermöglicht die Anzeige einer einzelnen Auswertung einer Anforderung in einem Case und ist nur bei der Ausgabe von Cases sinnvoll. - **Case Auswertungsbaum:** Diese Auswahl bei einer ermöglicht die Darstellung von allem, was auf der Case-Übersichtsseite dargestellt wird. Sie ist nur bei der Ausgabe von Cases sinnvoll. - **Daten-Chart:** Hier kann eine Grafik eingefügt werden, die aus dem aktuellen CCDB-Datenbestand erzeugt wird. Dazu ist die Eingabe einer Abfrage nötig, welche eine Grafik ausgibt. Diese kann unter der Funktion [Abfrage Testumgebung](/v1/docs/abfrage-testumgebung) erstellt und getestet werden. - **Datentabelle:** Hier kann eine Tabelle eingefügt werden, die aus dem aktuellen CCDB-Datenbestand erzeugt wird. Dazu ist die Eingabe einer Abfrage nötig, welche eine Tabelle ausgibt. Diese kann unter der Funktion [Abfrage Testumgebung](/v1/docs/abfrage-testumgebung) erstellt und getestet werden. - **If (Bedingung):** Hier wird eine Abfrage eingetragen, die als Wert **WAHR** oder **FALSCH** ausgibt. Nur bei **WAHR** werden die untergeordneten Bausteine ausgeführt. - **Iterator:** Es wird ein Iterator definiert, d. h. eine Variable, deren Namen frei gewählt werden kann. Mit dieser kann dann eine bestimmte festgelegte Menge an Daten durchlaufen werden, z. B. ein Case oder eine Asset-Klasse. Der Zeiger bezieht sich dann auf die Daten, die im Bereich **Query** festgelegt werden. Sollen Angaben aus den einzelnen Assets in den Unterkapiteln eingefügt werden, wird der Name des jeweiligen Feldes in doppelte geschweifte Klammern geschrieben. Dort wird dann bei der Erzeugung des Reports der Inhalt des Feldes eingefügt. - **Kapitel:** Es wird ein neues Kapitel hinzugefügt. Gibt es in demselben Bereich schon ein Kapitel, so handelt es sich um ein Unterkapitel. Die Gliederung und Nummerierung wird automatisch erstellt. Es wird hier nur die Kapitel/Unterkapitel Überschrift angegeben. Wie die Gliederung aussieht, wird ist an den geschachtelten Rahmen erkannt. - **Markdown:** Liegt ein Feld in der Datenbank schon im formatierten Format vor, so wird dieses hier genauso übernommen. - **Neue Seite:** An der Stelle dieses Bausteines wird ein Seitenumbruch eingefügt. - **Risikomatrix:** Hier wird der Wert **X-VALUES** einer Abfrage eingetragen, der nur Risiken als Ergebnis hat. Daraus wird dann eine vordefinierte Risikomatrix erzeugt. - **Text:** Ein Freitextfeld in das einfacher Text eingegeben werden kann, der genau so im Report ausgegeben wird. - **Text (Markdown):** Ein Freitextfeld in welchen formatierter Text eingegeben eingegeben wird. - **Variable setzen:** Eine Variable mit einem selbstgewählten Namen wird festgelegt. Diese kann dann in allen folgenden Bausteinen verwendet werden. - **Visualisierung:** Es wird eine vorher erstellte und abgespeicherte Visualisierung in den Report eingefügt. Sinnvollerweise wird mit einem Kapitel begonnen und dann evtl. mit einem weiteren Unterkapitel versehen. In dem Kapitel wechseln sich Texte mit grafischen Darstellungen ab, bevor das nächste Kapitel/-Unterkapitel hinzugefügt wird. Bereits erstellte Bausteine können mithilfe der Maus ausgewählt und innerhalb der Vorlage verschoben werden. Nicht mehr benötigte Bausteine können mit dem Löschen-Button, der sich hinter jeder Baustein Bezeichnung befindet, entfernt werden. ## Bausteine mit Beispielen In diesem Kapitel werden Beispiele für ausgefüllte Bausteine gegeben, welche zeigen, wie diese im Detail benutzt werden. ### Auswertungsergebnis Der Baustein **Auswertungsergebnis** ermöglicht es, die Ergebnisse von Auswertungen anzuzeigen. Diese können entweder nach Anforderungen oder nach Assets gruppiert dargestellt werden. Zusätzlich kann noch ausgewählt werden, ob ausgegeben werden soll, wer die Auswertung vorgenommen hat und welcher Grund dort im Kommentarfeld angegeben wurde. Dieser Baustein wird üblicherweise mit einem Iterator verwendet. ![auswertungsergebnis(1)](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/auswertungsergebnis(1).png) Beispiel für ein Auswertungsergebnis im Case ![ausgabe-pdf](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/ausgabe-pdf.png) Ausgabe als PDF ### Case Auswertungsbaum Durch den Baustein **Case Auswertungsbaum** wird eine Tabelle der Anforderungen generiert. Dort ist erkennbar, welchen Anforderungen **PASS (P)**, **Akzeptiert (A)**, **Mitigiert (M)**, **PARTIAL (PT)**, **FAIL (F)**, **Nicht anwendbar (N)** und noch gar nicht bearbeitet sind **(-)**. ![auswertungsbaum_case](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/auswertungsbaum_case.png) Beispiel für einen Case Auswertungsbaum ![ausgabe_pdf](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/ausgabe_pdf.png) Ausgabe im PDF-Dokument ### Daten-Chart Der Baustein **Daten-Chart** ermöglicht das Einfügen von Grafiken, die durch Queries erzeugt werden. Dazu wird die komplette Abfrage (Query) eingetragen. ![daten-chart](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/daten-chart.png) Beispiel für eine Grafik ![datenchart-pdf](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/datenchart-pdf.png) Ausgabe im PDF-Dokument ### Datentabelle Über den Baustein **Datentabelle** wird ein Query für eine Tabelle eingefügt, die die Mitarbeiter mit ihren Email-Adressen ausgibt. ![datentabelle](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/datentabelle.png) Beispiel für eine Tabelle ![datentabelle_pdf](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/datentabelle_pdf.png) Ausgabe im PDF-Dokument ### If (Bedingung) In dieses Feld muss eine Abfrage eingetragen werden, die als Ergebnis **WAHR** oder **FALSCH** ausgibt. Nur wenn das Ergebnis **WAHR** ist, werden die darunter liegenden Bausteine ausgeführt. Bei **FALSCH** werden sie ignoriert. Beispiel einer Verwendung im Zusammenhang mit einem Iterator und einer Funktion. ![if-bedingung](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/if-bedingung.png) Beispiel Verwendung der IF (Bedingung) ![if-bedingung-pdf](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/if-bedingung-pdf.png) Ausgabe im PDF-Dokument ### Iterator Ein **Iterator** ist eine Variable, deren Name frei festgelegt werden kann, in diesem Fall **anwnr***.* Unter **Abfrage** wird eingetragen, welche Assets durchlaufen werden sollen. Es entspricht der **X-VALUES** Angabe der Abfragen in den Abfragen. Hier werden nacheinander alle Anwendungen durchlaufen und zu jeder werden die untergeordneten Bausteine ausgeführt. ![iterator](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/iterator.png) Beispiel für einen Iterator ### Kapitel Die Bausteine **Kapitel** legen die Überschriften fest und bestimmen die Gliederung des Dokumentes. Dabei muss immer nur ein neues Kapitel hinzugefügt werden. Die Nummerierungen und die Gliederung erfolgen automatisch, je nachdem, wo dieses Kapitel eingefügt wurde. ![kapitel](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/kapitel.png) Beispiel für ein Kapitel ![kapitel_pdf](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/kapitel_pdf.png) Ausgabe im PDF-Dokument Wenn mit einem Iterator mehrere Assets durchlaufen werden, dann soll oft für jedes Asset ein Unterkapitel gebildet werden. Dazu wird der Anzeigennamen des Assets als Kapitelname angezeigt, indem er in doppelte geschweifte Klammern gesetzt wird und dann das Feld mit dem **Iterator** (anwnr) und dem **Feldnamen** (display_name) durch einen Punkt getrennt angibt. ![unterkapitel-iterator](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/unterkapitel-iterator.png) Unterkapitel mittels Iterator ### Markdown Es gibt Attributfelder, die schon im Markdownformat in der CCDB vorliegen. Um diese genau so ins Dokument zu übernehmen, gibt es diesen Baustein. Es wird nur der Feldname eingetragen. In diesem Fall ist es der Iterator **anwnr***,* ergänzt durch den internen Feldnamen **description** und getrennt durch einen Punkt. Es wird also die Beschreibung genau so ausgegeben, wie sie in der CCDB abgespeichert wurde. ![markdown](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/markdown.png) Beispiel für ein Markdown-Feld ### Neue Seite Wird dieser Baustein eingefügt, so wird an dieser Stelle im PDF-Report ein Seitenumbruch erzeugt. ### Risikomatrix Hier wird ein **X-VALUES** Ausdruck eingetragen, der als Ergebnis nur Risiko-Assets ausgibt. Aus diesen wird eine vordefinierte Risikomatrix erzeugt. ![risikomatrix](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/risikomatrix.png) Beispiel für die Auswahl von Risiken für eine Risikomatrix ![risikomatrix-pdf](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/risikomatrix-pdf.png) Ausgabe im PDF-Dokument ### Text In diesen Baustein kann Text eingetragen werden. Dieser wird als Klartext eins zu eins in das Dokument übernommen. Formatierungen werden in diesem Fall ignoriert. ![textfeld](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/textfeld.png) Beispiel für ein Textfeld ![textfeld-pdf](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/textfeld-pdf.png) Ausgabe im PDF-Dokument ### Text (Markdown) In diesen Baustein kann Text eingetragen und formatiert werden. ![text-markdown](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/text-markdown.png) Beispiel für ein Textfeld mit Markdown-Format ![text-markdown_pdf](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/text-markdown_pdf.png) Ausgabe im PDF-Dokument ### Variable setzen Durch diesen Baustein kann eine Variable definiert und mit einem Wert belegt werden. Dieser kann dann im Report, in den Bausteinen danach, verwendet werden. Eine sinnvolle Verwendung dafür ist es, den Baustein zu Anfang einzufügen und den eigentlichen Wert zurückzustellen. So ist es z. B. möglich, Vorlagen für die Ausgabe von Assets zu erstellen und nachträglich bei der Erzeugung anzugeben, welches Asset ausgegeben werden soll. Zuerst wird die Variable definiert und dann die Werteingabe zurückgestellt. ![variable-setzen](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/variable-setzen.png) Beispiel für die Definition einer Variable Im Report kann die Variable dann verwendet werden. ![variable-query](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/variable-query.png) Verwendung der Variable in einem Query Wird der Report generiert, so öffnet sich die Vorlage und der Wert kann eingegeben werden. Asset-Namen müssen dafür in Hochkommas eingeschlossen werden. Der Fehler kann hier ignoriert werden. ![variable-setzen_fehlermeldung](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/variable-setzen_fehlermeldung.png) Eingabe des Wertes bei der Generierung ![variable-setzen_fehlermeldung_pdf](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/variable-setzen_fehlermeldung_pdf.png) Ausgabe im PDF-Dokument ### Visualisierung Gespeicherte Visualisierungen können in den Report übernommen werden. Dazu wird ausgewählt, ob es sich um eine Visualisierung aus der CCDB oder aus einem Case handelt. Dann werden alle gespeicherten Visualisierungen angezeigt und können ausgewählt werden. Case Visualisierungen können nicht in einem CCDB Report benutzt werden. Sie werden zur Zeit auch noch automatisch **Zurückgestellt**. Im Anzeigebereich wird die Visualisierung angezeigt. Dort kann sie noch verschoben und in der Größe geändert werden. Das Bild wird dann eins zu eins in das Dokument übernommen. Es ist auch möglich in den gespeicherten Visualisierungen zu suchen. ![visualisierung](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/visualisierung.png) Beispiel für eine Visualisierung ![visualisierung-ausgewaehlt](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/visualisierung-ausgewaehlt.png) Visualisierung ausgwählt ![visualisierung_server_pdf](https://cdn.document360.io/d068286e-12b7-4de8-b129-2985cf0b4f54/Images/Documentation/visualisierung_server_pdf.png) Ausgabe im PDF-Dokument Als CCDB wird die Compliance Configuration Database bezeichnet. Die Datenbank konsolidiert alle Informationen über den aktuellen Compliance- und Sicherheitsstatus von relevanten, d.h. an einer IT-Wirkungskette beteiligten Assets.