Word-Vorlage erstellen
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.
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.
Die Tabelle …
Muss einen Titel mit einer eindeutigen Bezeichnung enthalten.
Muss in der Beschreibung den Eintrag EntityType mit der ID des Objekttyps enthalten (z. B. "EntityType=1034").
Muss in der Beschreibung den Eintrag StartRow mit der ersten Zeile, welche Werte enthalten soll, enthalten (z. B. “StartRow=2”)
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 weiter:
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" enthalten.
Kann in der Beschreibung den minimalen Massstab MinScale enthalten: "MinScale=5000” (Standardwert=1000).
Kann in der Beschreibung den Faktor Stretch enthalten, um welchen der Kartenbereich um das gewählte Objekt vergrössert wird. Dies ist hilfreich, wenn ein Report für Objekte mit sehr unterschiedlichen Grössen ausgegeben werden soll und der minimale Masstab nicht die gewünschten Ergebnisse liefert. Ein Faktor “Stretch=2“ bedeutet, dass um die Bounding Box des Objektes nochmals ein gleich grosser Bereich der Karte angezeigt wird. Der Standardwert für Stretch ist 1.1 (10% zusätzliche Karte).
Kann in der Beschreibung die Angabe MapRow für die Zeile enthalten, in der die Karte ausgegeben wird: “MapRow=2” (Standardwert=1)
Kann in der Beschreibung die Angabe MapCol für die Spalte enthalten, in der die Karte ausgegeben wird:“MapCol=2” (Standardwert=1)
Kann in der Beschreibung die Angabe WithBorder enthalten, um der Karte einen Rand zu geben: “WithBorder=False” (Standardwert=True)
Ab Version 12.19. können auch mehrere Karten eingefügt werden.
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: