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.

Ü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.

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.

Spezielle Platzhalter für Adressfelder

Für Attribute, bei denen man den Eintrag aus den hinterlegten Adressen auswählt, kann man über spezielle Platzhalter zusätzlich auf die detaillierten Werte aus der Adressverwaltung zugreifen.

Personenspezifische Platzhalter

Diese Platzhalter werden nur für Mitarbeiter und Personen abgefüllt. Sie bleiben bei Firmen immer leer.

• .AA Anrede

• .AT Titel

• .AN1 Vornamen

• .AN2 Nachnamen

• .AM Mobile

• .AY Kürzel

• .AX Funktion

Generelle Platzhalter

Diese Platzhalter werden dynamisch aus Firma (für Firmen und Mitarbeiter) und Privatperson (wenn dort vorhanden) gelesen. Ob ein Wert tatsächlich abgefüllt ist, spielt hierbei keine Rolle.

• .AB Firmennamen (B für business)

• .AD Abteilung (D für department)

• .AS Strasse und Hausnummer

• .AO Postfach (O aus post office box)

• .AZ Postleitzahl (zip code)

• .AC Stadt (city)

• .AL Land

• .AP Telefonnummer (phone)

• .AE E-Mail

• .AF Fax

Beispiele:

• Die Telefonnummer ist sowohl bei Firma, als auch bei Mitarbeitern definiert. Bei einem Mitarbeiter wird deshalb immer die Telefonnummer der Person abgefüllt. Es wird aber momentan nicht überprüft, ob ein Wert abgefüllt ist. D.h. es wird nicht die Telefonnummer der Firma abgefüllt, wenn die Telefonnummer des Mitarbeiters leer ist. Es wäre aber möglich, dies noch zu implementieren.

• Für Fax wird bei Mitarbeitern die Faxnummer der Firma eingetragen, da diese beim Mitarbeiter nicht angegeben werden kann. Bei Privatpersonen ist die Angabe immer leer.

Spezieller Platzhalter

Da Firmen keine Vor- und Nachnamen haben und Privatpersonen keine Angaben zur Firma beinhalten, ist es schwierig, mit den obigen Platzhaltern eine allgemeingültige formatierte Adresse z.B. für einen Brief zu definieren, ohne leere Zeilen zu erhalten. Siehe auch Beispiele Ar - Bauwerk mit Adressen.dotx/dotx.

Deshalb habe ich einen “Header“-Platzhalter .AH definiert. Dieser wird so, inkl. Zeilenumbrüchen abgefüllt:

Für Firma:

Name1
Name2
Abteilung

Für Mitarbeiter:

Name1
Name2
Abteilung
Titel Vorname Nachname

Für Privatperson:

Titel Vorname Nachname

So kann man bspw. einfach eine Adresse mit Platzhaltern definieren, ohne Leerzeilen zu erhalten:

<xxxx-yyyy.AH>
<xxxx-yyyy.AS>
<xxxx-yyyy.AZ> <xxxx-yyyy.AC>

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)

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: