Beiträge in diesem Abschnitt

Report Vorlagen

Jörn Rettweiler
  • Erstellt
  • Aktualisiert
Folgen

Themen als Übersicht

  1. Instanzliste
  2. Instanzliste (mit Instanzrelationen)
  3. Instanzliste (mit Typrelationen)
  4. Instanzliste (mit Versionen)
  5. Instanzliste (mit Versionsvergleich)
  6. Attributblatt
  7. Attributblatt (gruppiert nach Typ)
  8. Attributblatt (incl. Bib-Einträge)
  9. Attributliste
    1. Spezielle big-Attribute
  10. Attributliste (mit Revisionen)
  11. Attributsliste (Typen)
  12. Attributsliste (Typengruppen)
  13. Typenblatt
  14. Typengruppenliste
  15. Typenliste
  16. Weiterführende Dokumentation zu Excel basierten Reportsvorlagen
  17. COBieLite XML
  18. Reporting Issues mit Vorlage
  19. Oft gestellte Fragen

 

 

 

Instanzliste

  • (1) Report Instanzliste auswählen
  • (2) Elementen auswählen die im Report erscheinen sollen
  • (3) Filter Profil wählen
  • (4) Ausnahmen und / oder Disziplinen wählen [Optional]
  • (5) Report ggf. freigeben, damit dieser von allen Usern gesehen werden kann, und von PowerBi abgegriffen werden kann 

mceclip0.png

 

Instanzliste (mit Instanzrelationen)

  • (1) Elementen auswählen die im Report erscheinen sollen
  • (2) Filter Profil wählen
  • (3) Report ggf. freigeben, damit dieser von allen Usern gesehen werden kann, und von PowerBi abgegriffen werden kann 
  • (4) Speichern

mceclip0.png

 

Instanzliste (mit Typrelationen)

  • (1) Elementen auswählen die im Report erscheinen sollen
  • (2) Filter Profil wählen
  • (3) Report ggf. freigeben, damit dieser von allen Usern gesehen werden kann, und von PowerBi abgegriffen werden kann 

mceclip2.png

Instanzliste (mit Versionen)

Bei dieser Reportart können mehrere Versionen miteinander Verglichen werden, die Identifizierung der Version erfolgt dabei über eine Tabellenspalte in der die Version dargestellt ist

  • (2) Elementen auswählen die im Report erscheinen sollen
  • (3) Filter Profil wählen
  • (4) Versionen auswählen die im Report erscheinen sollen
  • (5) Report ggf. freigeben, damit dieser von allen Usern gesehen werden kann, und von PowerBi abgegriffen werden kann 

mceclip4.png

 

Instanzliste (mit Versionsvergleich)

 Bei dieser Reportart können zwei Versionen und deren Status (neu, entfallen, geändert) miteinander Verglichen werden. Der Status wird dabei koloriert dargestellt.

mceclip5.png

 

mceclip7.png

 

 

Attributblatt

 Das Attributblatt ist ein Export welcher im Format eines Raumbuchs erfolgt, er kann jedoch auf aus allen Elementen generiert werden. Das Setup ist dabei in folgende Schritte aufgeteilt:

  1. Perimeter
  2. Attributvariabel
  3. Spezielle big-Attribute
  4. Dateinamen
  5. Voll umfängliches Beispiel
  6. Hinweise

 Anlegen des Reports

Nach Selektion des Attributblatts  (1) ist die Reportvorlage (2) einzufügen, (mehr dazu unter dem nachfolgenden Abschnitt Reportvorlage ) , das Element / die Elemente (3), ein Filter-Profil (4), und die Freigabe (4)

mceclip6.png

 

Reportvorlage

Perimeter

Die Vorlage kann in Excel erstellt werden:: Die Zellen in denen der Report Daten eintragen soll, muss mit einem Kommentar gekennzeichnet in der Zelle A1 sein, diese Kommentar muss die folgenden Zeichen beinhalten: 

 

jx:area(lastCell="H45")

H45 heisst in diesem Fall, dass das Attributsblatt von Reihe A bis H und von Zeile 1 bis 45 abgebildet wird, bzw. nur Variablen befüllt werden welche sich innerhalb dieses Perimeters befinden.

mceclip10.png

In dem grün markierten Bereich können nun die "Report Variable" hinterlegt werden, die rot markierten Zellen werden nicht befüllt.

mceclip8.png

 

Attributvariabel

Um ins Attributblatt Attribute  zu überführen müssen diese mit folgender Variable gefüllt sein:

${values["BIGATTRIBUT"]}

Sollte auf das big-Attribut Geschoss zugegriffen werden sollen, so ist folgende Report Variable zu hinterlegen. 

${values["Geschoss"]}

Die Syntax, der Variable setzt sich wie im Bild unter Punkt (2) aus der Abfrage und dem big-Attribut zusammen, Punkt (1) ist ein einfaches Textfeld, das entsprechend frei gewält werden kann

mceclip13.png

 

Das big-Attribut in der Variable muss exakt so heissen wie auf big

mceclip11.png

 

Spezielle big-Attribute

Um auf die Systemattribute Typname, GUID, oder die Instance ID zuzugreifen muss folgende Variable eingetragen werden

  • Typ:             
${values["instancetype_name"]}
  • GUID:          
${values["instance_guid"]}
  • Interne ID: 
${values["instance_id"]}
  • Benutzer welcher zuletzt die Daten editiert hat (Modelllaufausführer oder manuelle Editierung ab bgi)
${row["Freigabe Fachkoordinator___Benutzer"]}
  • Datum Erstellung des Export [bei Attributsblättern]
${creation_date}
  • Datum Erstellung des Export [bei Attributslisten]
${Stand}
  • Datum von der letzten Attributswertänderung (dieses Attributs) [nur bei Listen]
${row["BIG_ATTRIBUT___Datum"]}
  • Elementname
${row["element_name"]}
  • Relationen: Hierbei ist als Notiz noch die folgende Formel zu hinterlgen 

    jx:each(items="relations" var="t_relation" lastCell="E34") jx:if(condition="t_relation.elementTypeName == 'ELEMENTNAME DER RELATION'", lastCell="E34")

${t_relation.instanceTypeName}

 

  • Replace Value 
${t_relation.values["Türschliesser X=mechanisch / el=elektrisch / BFS=brandfallgesteuert"]} 

 

Dateinamen

Die Namen der Raumblätter können anhand von einem Attribut oder mehrerer Attribute  erzeugt werden, die Syntax ist dabei folgende:

Einfach

${BIGATTRIBUT}

Bezogen auf das Beispiel

${Raumnummer}

mceclip15.png

mceclip3.png

 

Mehrfach

Die Bezeichnung der Attributsblätter mit mehreren big-Attributen wie z.B. der Raumnummer und dem Typennamen (instancetype_name) und einem Fixwert wie z.B. Kaulquappe ist folgender massen möglich:

${Raumnummer} Kaulquappe ${instancetype_name}

 

mceclip2.png

 

Voll umfängliches Beispiel

Ein Beispiel ist im Anhang "Vorlage_Attributblatt_Werte.xlsx" angehängt

 

Hinweise

  • Der Export dieser Reports nimmt ggf. etwas Zeit in Anspruch, da pro Instanz ein Raumblatt angefertigt wird.
  • Sollte man den Report testweise exportieren wollen, so empfiehlt es sich in diesen Report ein Filter (1 bzw. 2) einzusetzen, damit nicht alle Instanzen des / der Elemente exportiert werden, siehe dazu nachfolgende Bilder oder Gesamtmodell.

mceclip0.png

 

Der angelegte Filter kann nun selektiert und angewendet werden

mceclip1.png

  • Die Syntax auf der Kommandos ist JXLS (externer Link), bei der dort dokumentierte Syntax sind nur die Beispiele unter den Punkten "Excel markup usage" funktionierend.

 

Attributblatt (gruppiert nach Typ)

Nach Selektion des Attributblatts  (1) ist die Reportvorlage (2) einzufügen, (mehr dazu unter dem nachfolgenden Abschnitt Reportvorlage ) , das Element / die Elemente (3), ein Filter-Profil (4), und die Freigabe (4)

mceclip7.png

 

Das weitere Vorgehen ist analog zum vorherigen Punkt Attributblatt in Abschnitt Reportvorlage.

Der Export des Reports fügt die Attributswerte, sofern diese pro Typ unterschiedlich sind (i.d.R. sind dies die Instanzttribute) aneinander, wie den gelben Feldern markiert. Bei identischen Attributswerten des selben Typs wird nur dieser einmalig angefügt (rosa markiertes Feld)

mceclip6.png

 

 

 

Attributblatt (incl. Bib-Einträge)

Die Vorlage "Attributliste (incl. Bib-Einträge)" wird benutzt um ein Attributblatt inkl. der Einträge aus den Bibliotheken zu expotieren

 

Variablen

Die Syntax um ein Bild eines Bibliothekeintrages einzufügen ist folgender, zubeachten ist dabei auch der Bildtyp bzw. imageType PNG, JPG, etc. 

jx:image(lastCell = "CELL" src = "values_bib_image[0]" imageType = "PNG")

Die Syntax auf das Beispiel bezogen ist:

jx:image(lastCell = "H40" src = "values_bib_image[0]" imageType = "PNG")

Als CELL ist die letzte Zelle (unten rechts) vom Bildplatzhalter zuwählen, im nachfolgenden Beispiel:

  • ist das gelbe Feld eine Zelle in welcher die letzte Zelle E30 ist.
  • die violette(n) Zelle(n) ist eine "Merge & Center" Zelle in der die letzte die Zelle H40 ist:

mceclip0.png

 

 

Um die Beschreibung eines Bibliothekseintrages einzufügen

${values_bib_Beschreibung[INDEX]}
${values_bib_Beschreibung[0]}

Um den Bibliohtkesnamen einzufügen

${values_bib_Name[Index]}
${values_bib_Name[0]}

 

Beispiel

Beispiel Excel Vorlage zum Download.

  • Beispiel Formatierung:

Report_Bibliothek_Eintrag.JPG

  • Beispiel Ergebnis:

Report_Bibliothek_Eintrag2.JPG

 

Attributliste

Die Vorlage "Attributliste" wird benutzt um eine Bauteilliste (Instanz Join) mit einer Excel Vorlage zu formatieren. Weitere Informationen.

Beispiel Excel Vorlage zum Download.

 

Es muss eine Notiz in der Zelle A1 (1) sowie in der ersten Zeile  (2) ab der Daten abgesetzt werden sollen geschrieben werden:

mceclip3.png

Notiz (1)

jx:area(lastCell="K4")

Notiz (2)

jx:each(items="values" var="row" lastCell="K4")

 

Spezielle Attributsformeln sind im nachfolgenden Abschnitt Spezielle big-Attribute aufgeführt

 

Die Kommentare (1) spezifizieren den Perimeter in denen die Instanzen aufgelistet werden, der rote Bereich wird nicht beschrieben, da sich dieser ausserhalb befindet, der gelbe Bereich kann frei editiert werden z.B. mit Logos, Filtern, etc. 

mceclip4.png

Der Zugriff auf die Attribute erfolgt mit folgender Syntax:

${row["BIGATTRIBUT"]}

Bezogen auf das Beispiel und das big-Attribut Geschoss lautet die Syntax

${row["Geschoss"]}

mceclip10.png

 

Spezielle big-Attribute

Um auf die Systemattribute Typname, GUID, oder die Instance ID zuzugreifen muss folgende Variable eingetragen werden

  • Typ:             
${row["instancetype_name"]}
  • GUID:          
${row["instance_guid"]}
  • Interne ID: 
${row["instance_id"]}
  • Datum
${row["BIG_ATTRIBUT___Datum"]}
  • Name (Letzter Benutzer der Eintrageänderung und/oder des Modelllaufs)
${row["BIG_ATTRIBUT___Benutzer"]}

 

 

Beispiel Ergebnis:

mceclip12.png

 

 

Attributsliste - Hierachisierte Auflistung

Die Vorlage "Attributliste" kann auch benutzt werden um eine Liste zu erstellen welche nach gruppen bzw. nach einer Hierarchie sortiert ist.

Hierzu ist das aufsetzen des Reports analog zur Attributsliste vorzunehmen und um folgende Punkte zu ergänzen:

In der Zelle zuoberst der Tabelle in derer die Auflistung vorgenommen werden soll ist (in jedem Fall) folgender Kommentar zu platzieren:

jx:each(items="values" var="valuesPerElement" groupBy="element_id" lastCell="O19")

Im Tabellenkopf oben links ist als Text - nicht als Kommentar der folgende Wert zu hinterlegen:

${valuesPerElement.item.element_name}

In der Zeile in derer die Auflistung beginne soll ist zum einen als Text der mit dem Hierachisierungsattribut - hier instancetype_name zu vergeben:

${rows.item.instancetype_name}

Sowie als Kommentar der folgende Wert - wiederum mit dem Hierarchiesierungsattribut, sowie die Angabe der letzten Zelle 

jx:each(items="valuesPerElement.items" var="rows" groupBy="instancetype_name" lastCell="O17")

An beginn der Auflistung - immer in selber Zeile rechts vom vorherigen Wert ist die Indizierung mit folgenden Wert zu triggern:

${rows.items.size()}

Unterhalb der Zeile kann dann analog zum vorherigen Report das einzutragende Attribut ausgegeben werden, z.B.:

Um den Typennamen in die Liste zu schreiben ist die Variable

${row["instancetype_name"]}

Um z.B. das Attribut "Kostengruppe" von big in die Vorlage zu überführen, ist die identische Bezeichnung einzutragen. 

${row["Kostengruppe"]}

 

Zum Abschluss muss noch in der Zeile in derer die Attribute zuvor ergänzt worden sind der folgende Wert angeben werden:

jx:each(items="rows.items" var="row" lastCell="O17")

 

Korrekt sieht dieser Report wie folgt aus:

mceclip2.png

 

Das Beispiel dieser Excel ist hier angehängt, siehe dazu Vorlage_Attributsliste_Hierachisierung.xlsx. 

 

Attributliste (mit Revisionen)

Attributsliste (Typen)

 Dieser Report exportiert nur die Typenattribute, Instanzattribute werden nicht exportiert bzw. befüllt auch wenn diese in der Vorlage angegeben worden sind, 

 

Die Vorlage ist analog zu Abschnitt Attributliste anzulegen, (nur mit Typenattributen)

 

Die Typenattribute (2) im Beispiel:

mceclip8.png

 Das Ergebnis, die "leeren" Attributswerte sind entweder auf leere Daten, oder darauf zurückzuführen, dass diese Instanzattribute sind.

mceclip14.png

 

Attributsliste (Typengruppen)

Bei dieser Reportart können Typengruppendefinitionen / Gruppendefinitionen exportiert werden:

  • (1) Reportart selektieren
  • (1.5) Vorlage importieren
  • (2) Elementen auswählen die im Report erscheinen sollen
  • (3) Filter Profil wählen
  • (4) Report ggf. freigeben, damit dieser von allen Usern gesehen werden kann, und von PowerBi abgegriffen werden kann 

mceclip9.png

 

Das Anlegen der Vorlage ist analog zum vorherigen Abschnitt Instanzliste.

 

Typenblatt

 

Bei dieser Reportart können Typen exportiert werden:

  • (2) Reportart selektieren
  • (3) Vorlage importieren
  • (4) Elementen auswählen die im Report erscheinen sollen
  • (5) Filter Profil wählen
  • (6) Report ggf. freigeben, damit dieser von allen Usern gesehen werden kann, und von PowerBi abgegriffen werden kann 

 

Das Anlegen der Vorlage ist analog zum vorherigen Abschnitt Instanzliste.

 

Typengruppenliste

Bei dieser Reportart können Typengruppendefinitionen / Gruppendefinitionen exportiert werden:

  • (1 & 2) Reportart selektieren
  • (3) Element auswählen das im Report erscheinen soll
  • (4) Gruppen wählen Hinweis:  wenn keine Typengruppendefinitionen angelegt sind erscheinen hier keine Typengruppen !
  • (5) Report ggf. freigeben, damit dieser von allen Usern gesehen werden kann, und von PowerBi abgegriffen werden kann 

 

mceclip14.png

Typenliste

 

Bei diesem Report werden mir die Typattribute exportiert:

  • (1) Reportart selektieren
  • (2) Elementen auswählen die im Report erscheinen sollen
  • (3) Filter Profil wählen
  • (4) Report ggf. freigeben, damit dieser von allen Usern gesehen werden kann, und von PowerBi abgegriffen werden kann 

mceclip11.png

Das Anlegen der Vorlage ist analog zum vorherigen Abschnitt Instanzliste.

 

Weiterführende Dokumentation zu Excel basierten Reportsvorlagen

Die vollständige Dokumentation zum JXLS Framework kann unter https://jxls.sourceforge.net/index.html

abgerufen werden

 

COBieLite XML

 Bei diesem Report werden die Instanzen im COBieLite XML Format exportiert, mehr dazu unter https://www.nibs.org/page/bsa_cobie:

 

Die Einrichtung und der Export einer COBieLite XML ist im Abschnitt CoBie Export detailliert beschrieben.

 

 

Reporting Issues mit Vorlage

  • Issue Report können als Excel oder PDF exportiert werden
  • Dazu "Issue Liste" auswählen (1)
  • Template hochladen (2)

mceclip0.png

  • Filter ggf. weiter spezifizieren
  • Standardmässig werden Issue mit dem Status Offen, Entwurf, Rückfrage mitexportiert

mceclip1.png

  • Im Nachgang kann noch spezifiziert werden ob der Bericht als PDF exportiert werden soll, dazu in die Einstellung gehen

mceclip5.png

  • Der Bericht kann anschliessend als PDF oder Excel exportiert werden

mceclip2.png

  • In der Vorlage können in Kopf folgende den Report an sich betreffende Schlüsselvariablen vergeben werde
    • ${creation_date}  => Schreibt das Erstellungsdatum des Reports
  • In der Vorlage können für die Spalten folgende Schlüsselvariablen verwendet werden
${issue["id"]}                                  => big ID des Issues

${issue["description"]}                         => Bezeichnung

${issue["area"]}                                => Bereich* 

${issue["milestone"]}                           => Meilenstein* 

${issue["assigned_to"]}                         => dem Issue Zugewiesener 

${issue["title"]} ${issue["description"]}       => Titel

${issue["type"]}                                => Typ (Daten, Koordinatives 
                                                   Thema, Abweichung BIM)*
 Richtlinien)*

${issue["status"]}                              => Status des Issues (Entwurf, Offen, 
                                                   Geschlossen, Gelöst, Rückfrage)

${issue["priority"]}                            => Priorität*

${issue["due_date"]}                            => Fälligkeitsdatum*

${issue["created_at"]}                          => Erstellungsdatum

${issue["updated_at"]}                          => Datum der letzten Änderung im Issue

${issue["tags"]}                                => Tag des Issues hinterlegen*

${issue["author"]}                              => Ersteller des Issues

${issue["comments"]}                            => Schreibt die Textkommentare aus dem Issue-
                                                   Verlauf mit Zeitstempel in die Zelle.*


*Optionaler Wert im Issue

 

Ein direkt Link zum Issue in big kann mit nachfolgender Phrase erzeugt werden, dabei ist:

=HYPERLINK(CONCATENATE("https://app.build-big.ch/issues/demo-de/21/",A4),"LINK")
  • demo-de durch den Namen der big Domain zu ersetzen
  • 21 durch die in der Projektübersicht mit der Nummer welche in der Projektkachel neben dem Hashtag  steht

 

 

Das Datum der Reporterstellung kann im Issue Report mit folgende Syntax in hinterlegt werden, hierbei ist es wichtig den Datentyp der Zelle auf Datum und dort auf Short Date im Excel zu konfigurieren

${creation_date}

 

 

Oft gestellte Fragen

  • Gibt es eine ausführliche Auflistung der möglichen Kommandos? Ja in der Dokumentation zum genutzten Framework ist eine technische Auflistung vorhanden https://jxls.sourceforge.net/reference/xls_area.html
  • Wie kann ich einen Report nach einer Spalte sortieren? Dies kann am einfachsten eines Filters im Gesamtmodell erreicht werden. Hierzu ist
    1. im Gesamtmodell das entsprechende Attribut im Datenfeld absteigen oder aufsteigend zu sortieren und dieses dann als Filterset zu speichern.
    2. Dieser Filter kann im Anschluss im Report hinterlegt werden
  • Bei weiteren Fragen, gerne eine Email an: info@kaulquappe.com

 

Zurück zum Anfang.

 

Verwandte Beiträge

Kommentare

0 Kommentare

Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.