Berichte registrieren

Name

Name, unter dem der Bericht im Drucken Menü erscheint.

Aktiv

Nur aktive Berichte erscheinen in den Menüs. Wenn Sie also einen Bericht nicht verwenden wollen, können Sie ihn hier einfach deaktivieren.

Gruppierung / Einzelindex

Bei vielen verschiedenen Berichten kann das Drucken-Menü für einen bestimmten Eintrag schnell einmal unübersichtlich werden. Um dem abzuhelfen, können Berichte bei der Registrierung gruppiert und sortiert werden. So lassen sich mehrere Berichte zu einer Gruppe zusammenfassen, welche jeweils dann durch einen Trennstrich von den übrigen Berichten abgetrennt werden.

Die Gruppierung wird aktiviert, indem auf dem Bericht im Feld Gruppierung eine Gruppennummer eingetragen wird. Alle Berichte mit derselben Gruppennummer werden im Menü zu einer Gruppe zusammengefasst. Die verschiedenen Gruppen werden in der Reihenfolge ihrer Gruppennummer dargestellt.

Standardmässig sind die Berichte innerhalb einer Gruppe wiederum alphabetisch sortiert. Falls eine andere Sortierung gewünscht wird, lässt sich dies durch Einsetzen von Zahlen im Feld Einzelindex erreichen.

Klassen

Angabe, für welche Objekte in Vertec der Bericht registriert ist (z.B. Projekte oder Adressen). Dort erscheint der Bericht dann im Drucken Menü.

Bedingung

Es kann eine Anzeigebedingung angegeben werden, wann der Bericht im Menü Drucken angezeigt werden soll und wann nicht.
Dies erfolgt via OCL Expression. Durch Klick auf den Button mit den drei Punkten öffnet sich der OCL Expression Editor.

Das Resultat dieser Expression muss einen Ja-/Nein Wert (Boolean) zurückliefern. Ist die Bedingung erfüllt, erscheint der Bericht im Drucken-Menü, sonst nicht. Bei Listenberichten wird der Bericht nur angezeigt, wenn die Bedingung für alle Einträge der Liste erfüllt ist.

Ausgabeformat

Als Ausgabeformat kann gewählt werden zwischen Word, Excel und PDF.

• Word und PDF verwenden immer die Word-Vorlage
• Excel verwendet immer die Excel-Vorlage

Passt das eingestellte Ausgabeformat nicht zu den registrierten Vorlagen – wird z.B. Excel gewählt, wenn nur eine Word-Vorlage hinterlegt ist – erscheint eine Fehlermeldung.

Einzelreport / Listenreport

Gibt an, ob der Bericht auf einem einzelnen Objekt oder auf einer Liste von Objekten des angegebenen Datentyps (Klasse) ausgeführt werden kann.

Dateiname

Feld bei Systemeinstellung Dokumentspeicherung = Intern

Es muss ein Dateiname eingetragen werden, damit auf einer Aktivität gespeicherte Dokumente geöffnet, bearbeitet und gespeichert werden können (siehe weiter unten).

Pfad

Feld bei Systemeinstellung Dokumentspeicherung  = Dateisystem oder DMS

Pfad zum Speichern des Bericht-Dokumentes. Der Wert %dokpfad% setzt dafür den Dokumentenpfad (Wert des "dokpfad" Attributes) des Objekts, auf dem der Bericht ausgeführt wird, ein.

Neben fixen Texten können OCL-Expressions verwendet werden (mit % eingefasst), die beim Drucken des Berichts verwendet werden. Innerhalb der Platzhalter können beliebige OCL Expression verwendet werden, ausgehend vom aktuellen Objekt des Berichts, z.B. %dokpfad%\%nummer% auf einem Rechnungsbericht.

Ist in der Konfigurationsdatei Vertec.ini die Option Restrict Filesystem Access aktiviert (Standard bei Cloud Abo Kunden), verhalten sich die Berichte wie folgt:

• Die Berichte werden clientseitig abgespeichert
• Keine Speicherung von Berichten in der Web App
• Fehlermeldung, wenn ein Bericht mit konfiguriertem Speicherpfad via Web App ausgeführt wird. Es kann dann kein Dokument gespeichert und keine Aktivität erstellt werden.

Betreff

Dokument-Betreff. Auch hier kann OCL angegeben werden, mit % eingefasst.

Der Betreff kann auf dem Druckdialog noch angepasst werden, falls dieser angezeigt wird (siehe nächsten Punkt).

Im Dokument steht der Betreff als Context-Variable subject zur Verfügung.

Der Betreff kann auch im Pfad (siehe oben) verwendet werden. Die Expression lautet %betreff%.

Ausserdem wird der Betreff als Titel der Aktivität verwendet, falls eine solche erzeugt wird (siehe unten).

Dialog zeigen

Wenn Ja, wird vor dem Ausführen des Berichts ein Druckdialog angezeigt, in welchem Speicherpfad, Bemerkung und andere Optionen noch verändert werden können.

Aktivität erzeugen

Wenn Ja, wird beim Ausführen des Berichts eine Aktivität erzeugt, auf der das Dokument gespeichert wird. Es wird im entsprechenden Editor geöffnet und kann direkt bearbeitet werden.

Bei Systemeinstellung Intern wird die angelegte Aktivität automatisch in einem neuen Tab angezeigt. Das geöffnete Dokument wird im entsprechenden Editor angezeigt, kann direkt weiter bearbeitet werden, und der Button unterhalb der Dokumentenvorschau heisst Bearbeiten beenden. Dafür muss zwingend ein Dateiname eingetragen sein. Alle Informationen zu Dokumenten auf Aktivitäten finden Sie hier. Mit Vertec 6.7.0.7 wurde dieses Verhalten für PDFs angepasst: Diese werden nur angezeigt, befinden sich aber nicht in Bearbeitung.

Verknüpfung auf Hauptobjekt

Die Aktivität wird mit dem Objekt, von wo aus es gestartet wird, verknüpft.

Verknüpfung auf Adresse

Die Aktivität wird mit der Adresse, an die das Dokument gesandt wird, verknüpft.

Aktivitätstyp

Hier können Sie der erzeugten Aktivität einen Aktivitätstypen zuweisen.

Checkboxen

Mit Aktivierung der Checkbox Übersetzung in Projektsprache aktivieren:

• werden Berichte, die auf einzelnen Objekten ausgeführt werden und eine definierte Beziehung zu einem Projekt haben (z.B. Rechnungen oder Projektauswertungen), in diese Projektsprache übersetzt (bzw. alle mit Translation versehenen Labels).
• werden Berichte, die auf mehreren Objekten ausgeführt werden (Listenberichte), in die aktuelle Vertec Oberflächensprache übersetzt. Die Übersetzungen der Berichte in die verschiedenen Sprachen erfolgen durch den Vertec Übersetzungsmechanismus.

Mit Aktivierung der Checkbox Eigene Vorlage pro Sprache verwenden können Vorlagen in mehreren Sprachen hinterlegt werden. Siehe weiter unten.

Download

Über den Button Download können Vorlagen heruntergeladen und bearbeitet werden.

Upload

Über den Button Upload kann eine angepasste Vorlage hochgeladen werden.

Bei diesem Vorgang wird auch der eingebaute Bericht-Code kopiert und in den Reiter Anpassung eingefügt, falls dieser noch leer ist (siehe Abschnitt Bericht-Definition).

Zurücksetzen / Löschen

Wird mit der kundenspezifischen Vorlage ein bestehender Vertec Standardbericht überschrieben bzw. kundenspezifisch angepasst, lautet der Button Zurücksetzen. Damit kann die kundenspezifische Vorlage entfernt und der Standardbericht wiederhergestellt werden.

Mit dem Zurücksetzen wird nicht nur die Vorlage auf den Standard zurückgesetzt, sondern auch der zugehörige Bericht-Code aus dem Reiter Anpassung entfernt. Falls angepasster Code noch benötigt wird, sollte er daher vor dem Zurücksetzen rauskopiert werden.

Wird eine neue, kundenspezifische Vorlage registriert, wird sie in schwarzer Schrift angezeigt. Mit dem Button Löschen kann die Vorlage wieder entfernt werden.

• Die Schrift ist schwarz, wenn es sich um eine von Vertec mitgelieferte Standard-Vorlage handelt.
• Die Schrift ist grün, wenn es sich um eine kundenspezifische Vorlage handelt.

Vorlage

Hier wird das entsprechende Vorlagendokument ausgewählt. Bei Word-Berichten ist dieses ein Word-Dokument mit der Dateiendung .docx, bei Excel-Berichten ein Excel-Dokument mit der Dateiendung .xlsx.

Sprache

• Die Sprache des zugehörigen Projekts.
• Spezialfall Aktivität: Falls kein Projekt zugeordnet ist, so wird die Sprache des zugeordneten Adresseintrages berücksichtigt.
• Für Einträge, welchen kein Projekt zugeordnet werden kann, wird versucht, das Member Sprache des Eintrags zu verwenden.
• Falls mit all diesen Varianten keine Sprache gefunden werden konnte, wird die Sprache der Oberfläche verwendet.

Ist für eine Sprache keine Vorlage definiert, wird die erste Vorlage in der Liste genommen.

Jargon

Projekt, Mandat, Alle.

Hier können Sie angeben, für welchen Jargon (Mandats- oder Projektsprache) die Vorlage verwendet werden soll.

Ist Alle ausgewählt, wird nur die Sprache berücksichtigt, unabhängig vom Jargon.

Name für automatisches Speichern

Falls die Systemeinstellung auf Dateisystem oder DMS eingestellt ist, werden Speicherpfad und Dokumentnamen werden wie folgt zusammengestellt:

Das Feld Pfad auf der Hauptseite der Berichtregistrierung wird für alle Vorlagen verwendet, falls dort etwas angegeben ist. Es kann sowohl einen Pfad als auch einen Dateinamen enthalten:

• Daran wird nun der Name für automatisches Speichern der einzelnen Vorlage angehängt, falls dort etwas angegeben ist. Auch dieser kann sowohl Pfad als auch Dateiname enthalten.
• So können die beiden Felder kombiniert werden. Wichtig ist einfach, darauf zu achten, dass die beiden Felder zusammen einen gültigen Pfad und Dateinamen ergeben.

Bei interner Dokumentspeicherung:

• Das Feld Dateiname auf der Hauptseite der Berichtregistrierung wird für alle Vorlagen verwendet, falls dort etwas angegeben ist. Falls ein Pfad angegeben ist, wird dieser bei interner Dokumentspeicherung einfach rausgefiltert.
• Daran wird nun der Name für automatisches Speichern der einzelnen Vorlage angehängt, falls dort etwas angegeben ist.
• Die beiden Felder werden zusammengehängt. Es muss darauf geachtet werden, dass die Kombination einen gültigen Dateinamen ergibt.

Das bedeutet:

• Falls alle Berichte gleich gespeichert werden sollen (z.B. mit einer dynamischen OCL Expression, siehe unten), reicht das Feld Dateiname.
• Sollen die Dokumente in den verschiedenen Sprachen unterschiedlich gespeichert werden, wird dies auf der Vorlage bei Name für automatisches Speichern hinterlegt.

Neben fixen Texten können auch OCL Expressions verwendet werden (mit % eingefasst), die beim Erstellen des Berichts ausgewertet werden.

Innerhalb der Platzhalter können beliebige OCL Expression verwendet werden, ausgehend vom aktuellen Objekt, auf welchem das Dokument erstellt wird.

Zusätzlich stehen auf Berichten folgende OCL Variablen zur Verfügung:

• %dokpfad%: Dokumentenpfad des Objekts ein, auf dem der Bericht ausgeführt wird. Bei interner Speicherung wird der Pfad rausgefiltert.
• %betreff%: Enthält den Betreff, der entweder im Feld Betreff auf der Berichtregistrierung hinterlegt ist oder im Berichtdialog (Dialog zeigen ist angehakt) ad hoc eingegeben wird.

Beispiele für OCL-Expressions:

• Auf einer Rechnung die Rechnungsnummer: %nummer%.
• Das Datum im Format JJMMTT: %date.formatdatetime('yymmdd')%.