Word-Vorlagen sind die Vorlagen für Word-Reporte aus Logo. In diesem Artikel ist erklärt, wie eine Vorlage für einen Word-Report erstellt wird und welche Inhalte zur Verfügung stehen.
Ein Beispiel einer Word-Vorlage steht hier zum Herunterladen bereit:
Wie eine Report-Vorlage abgelegt werden muss, damit sie in Logo zur Verfügung steht, sehen Sie unter Word-Vorlagen implementieren.
Was ist eine Word-Vorlage?
Jeder Word-Report in Logo wird bei der Ausgabe auf einer Word-Vorlage basierend generiert. In der Vorlage sind Inhalt und Layout des Reports festgelegt. Gewisse Vorlagen sind fix programmiert und können nicht verändert werden. Es besteht aber die Möglichkeit, für alle verfügbaren Objekttypen benutzerdefinierte Vorlagen zu erstellen. Nachfolgend ist erklärt, welche Inhalte für benutzerdefinierte Vorlagen zur Verfügung stehen und was bei der Erstellung von Vorlagen berücksichtigt werden muss.
Objektinformationen in Word-Reporten
Word-Reporte können Informationen zu
einem Hauptobjekt
den dem Hauptobjekt übergeordneten Objekten
den dem Hauptobjekt direkt untergeordneten Objekten (nur 1 Ebene)
enthalten.
In der Vorlage wird mithilfe von Platzhaltern definiert, wo welche Information ausgegeben wird. Es gibt einerseits Platzhalter für Werte und andererseits Platzhalter für Karten, Fotos usw.
Platzhalter für Werte
Platzhalter für Werte setzen sich aus der ID des Objekttyps und der ID des Attributs in der Form <ObjekttypID-AttributID> zusammen.
Beispiel Platzhalter von Bauwerken
ObjekttypID von Bauwerken=1031
Bauwerksnummer: <1031-0002>
Länge des Bauwerks: <1031-2019>
Über die Angabe von optionalen Suffixen können zusätzlich zu den eigentlichen Werten weitere Informationen ausgegeben werden. Werte mit Einheiten werden beispielsweise standardmässig mit Wert inklusive Einheit ausgegeben. Über die Suffixe .V (value) oder .U (unit) lässt sich steuern, ob nur der Wert oder nur die Einheit ausgegeben werden soll.
Beispiel Länge des Bauwerkes mit Suffix
<1031-2019> wird zu 12m
<1031-2019.V> wird zu 12
<1031-2019.U> wird zu m
Weitere Suffixe stehen beispielsweise für Katalogwerte oder Adressen zur Verfügung.
Die Liste aller verfügbarer Suffixe finden Sie unter Platzhalter-Suffixe.
Liste der Platzhalter ausgeben
Die Liste der Word-Platzhalter steht im Tab Reporte zur Verfügung und beinhaltet die Platzhalter aller Objekttypen, die in der aktuellen Ansicht vorkommen.
Informationen zu übergeordneten Objekten
Für die Ausgabe von Informationen des Hauptobjektes und dem Hauptobjekt übergeordneter Objekte können die Standard-Platzhalter aus der Liste der Word-Platzhalter verwendet werden. Dies ist möglich, da Objekte in der Hierarchie aufwärts immer nur ein übergeordnetes Objekt haben können und somit immer eindeutig ist, von welchem Objekt Informationen ausgegeben werden sollen.
Beispiel Platzhalter von Bauteilen und dem übergeordneten Bauwerk
Bauwerk <1031-0002> - <1031-0018>
Bauteil <1030-0002> - <1030-0018>
Bauteil Typ <1030-0029>
Einbaujahr <1030-0041>
Informationen zu untergeordneten Objekten
Für die Ausgabe von Informationen zu untergeordneten Objekten müssen Tabellen mit spezifischen Angaben verwendet werden. Dabei gilt Folgendes:
Es können nur Informationen zu dem Hauptobjekt direkt untergeordneten Objekte ausgegeben werden.
In einer Tabelle können nur Informationen zu einem Objekttypen ausgegeben werden. Für mehrere Objekttypen müssen mehrere Tabellen verwendet werden.
Bei der Ausgabe des Reports werden die Werte der untergeordneten Objekte in Word-Tabellen abgefüllt. Dabei werden Tabellentitel und Tabellenbeschreibung benötigt. Tabellentitel und Tabellenbeschreibung sind unter Tabelleneigenschaften im Tab Alternativtext zu finden.
Tabellentitel:
Angabe einer Bezeichnung zur Identifikation der Tabelle
Tabellenbeschreibung:
Angabe des Objekttyps (EntityType) und der ersten Zeile, welche Werte enthalten soll (StartRow)
Die Informationen "EntityType=" und "StartRow=" müssen in der Tabellenbeschreibung vorhanden sein.
Die Platzhalter für die auszugebenden Werte werden in der Tabelle selbst eingegeben. Die Platzhalter müssen als Präfix den Tabellentitel enthalten, d.h. sie müssen die Form <T1.XXXX-XXXX> haben. Dies ist notwendig, weil ein bestimmter Wert in einem Report theoretisch an mehreren Stellen bzw. in mehreren Tabellen vorkommen kann, und ohne dem Präfix nicht klar ist, welcher Wert wo abgefüllt werden soll. Für die Tabelle gilt Folgendes:
Die Tabelle …
… darf beliebig viele Spalten haben
… kann keine, eine oder mehrere Titelzeilen haben
… muss genau eine Zeile mit Daten in Form von Platzhaltern haben (die Datenzeile darf auch mehrzeilig sein). Diese Zeile wird bei der Ausgabe des Reports für jedes vorhandene Unterobjekt repetiert und abgefüllt.
Beispiel einer Tabelle von Unterobjekten mit einer Titelzeile:
Beispiel einer Tabelle von Unterobjekten ohne Titelzeile (hier muss in den Tabelleneigenschaften "StartRow=1" stehen):
Sind für eine Verkehrszählstelle beispielsweise mehrere Messungen vorhanden, können diese folgendermassen aufgelistet werden (die letzte Zeile mit den Platzhaltern <T1.1713-2003> und <T1.1713-2007> wird für jede einzelne Messung wiederholt):
Der Report wird dann folgendermassen zusammengestellt:
Einbindung einer Karte
Eine Karte wird ebenfalls über eine Tabelle in die Vorlage integriert. Breite und Höhe der Tabellenzelle bestimmen Breite und Höhe der Karte. Auch hier werden Tabellentitel und Tabellenbeschreibung in den Tabelleneigenschaften benötigt, um Eigenschaften der Karte festzulegen.
Die Tabelle …
… muss den Titel "MAP" haben
… kann in der Beschreibung den minimalen Massstab enthalten: "MinScale=5000” (Standardwert=1000)
… kann in der Beschreibung die Angabe zur Zeile enthalten, in der die Karte ausgegeben wird: “MapRow=2” (Standardwert=1)
… kann in der Beschreibung die Angabe zur Spalte enthalten, in der die Karte ausgegeben wird:“MapCol=2” (Standardwert=1)
… kann in der Beschreibung die Angabe enthalten, ob die Karte mit oder ohne Rand ausgegeben wird: “WithBorder=False” (Standardwert=True)
Beispiel einer Karte mit einer Höhe von 13 cm
Einbindung von Fotos
Einzelnes Foto (Objektfoto, nur bei bestimmten Objekten)
Ein Objektfoto kann über eine Tabelle mit nur einer Zelle in die Vorlage integriert werden. Breite und Höhe der Tabelle bestimmen Breite und Höhe des Fotos.
Die Tabelle …
… muss den Titel "FOTO" haben
Alle Fotos des Hauptobjekts und optional aller untergeordneten Objekte
Die Fotos des Hauptobjekts und der untergeordneten Objekte können ebenfalls über eine Tabelle in die Vorlage integriert werden.
Die Tabelle …
… muss den Titel "FOTOS" haben
… kann beliebig viele Spalten haben (entsprechend viele Fotos werden pro Zeile dargestellt)
… muss mindestens eine Zeile für die Fotos haben (Fotozeile)
… kann oberhalb der Fotozeile eine Zeile für Objekttitel haben (ist dann sinnvoll, wenn auch die Fotos der untergeordneten Objekte dargestellt werden)
… kann unterhalb der Fotozeile eine Zeile für die jeweiligen Fototitel mit gleich vielen Spalten wie die Fotozeile haben.
In der Tabellenbeschreibung können folgende Informationen vorhanden sein, wobei 1 für true und 0 für false steht:
Verwendung der Zeile für Objekttitel: "UseObjectCaption=1"
Verwendung der Zeile für Fototitel: “UseFotoName=1” und/oder "UseFotoCaption=1" und/oder "UseTimeStamp=1".
Mit diesen Angaben lassen sich die Fototitel aus dem Dateinamen, der Bezeichnung und dem Zeitstempel des Fotos frei zusammenstellen.Darstellung der Fotos der untergeordneten Objekte: "Recursive=1"
Die Anzahl Zeilen der Tabelle muss mit den in der Beschreibung aktivierten Optionen (=true) übereinstimmen.
Damit die Grösse der Zellen beibehalten wird, muss die Option “Automatische Grössenänderungen zulassen” ausgeschaltet werden:
Beispiel - Resultat:
Den angehängten Fotos muss ein Dokumenttyp vergeben sein, dem im Katalog die Dokumentart Foto zugewiesen ist, damit die Fotos im Report berücksichtigt werden.
0 Comments