Support vertec.com

Berichte registrieren

So werden Office-Berichte in Vertec registriert

Standard

|

Expert

CLOUD ABO

|

ON-PREMISES

Leistung & CRM

Budget & Teilprojekt

Fremdkosten

Ressourcen & Projektplanung

Business Intelligence

Erstellt: 23.04.2007
Aktualisiert: 01.12.2022 | An Vertec Version 6.6 angepasst. Registrierung von Legacy Office-Berichten in separaten Artikel ausgelagert.

Hier wird das Registrieren von Office-Berichten erklärt. Das Registrieren von Legacy Office-Berichten finden Sie im Artikel Legacy Office-Berichte registrieren beschrieben.

Damit ein Bericht in Vertec über das Drucken-Menü aufgerufen werden kann, muss er registriert werden.

Um einen Bericht zu registrieren, klicken Sie mit der rechten Maustaste auf den Ordner Einstellungen > Berichtsvorlagen und wählen Sie:

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.

Automatisches Speichern
Pfad

Pfad zum Speichern des Bericht-Dokumentes. Der Wert %dokpfad% setzt dafür den Dokumentenpfad (Wert des "dokpfad" Attributes) des Objekts, auf dem der Report 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

Hier kann ein Betreff angegeben werden, welcher im Bericht und auch im Speicherpfad eingesetzt werden kann (%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).

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, die je nach Einstellung mit folgendem Objekt verknüpft wird:
  • 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ätstyp zuweisen.
Dokumentvorlagen

Unter Dokumentvorlagen 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.

Da sich die Excel- und die Word-Vorlagen die Code-Basis teilen, kann in derselben Registrierung auch beides gleichzeitig registriert werden:

Download Um eine Vorlage zu bearbeiten, können Sie sie über den Button Download herunterladen.
Upload

Mit Upload kann eine angepasste Vorlage in Vertec geladen werden.

Bei diesem Vorgang wird ab Vertec 6.6 auch der eingebaute Bericht-Code kopiert und in den Reiter Anpassung kopiert, falls dieser noch leer ist (siehe Abschnitt Bericht-Definition weiter unten).

Zurücksetzen / Löschen

Wird mit der kundenspezifischen Vorlage eine bestehende Vertec Ressource überschrieben (also ein Vertec Standardreport kundenspezifisch angepasst), dann lautet der Button Zurücksetzen. Damit kann die kundenspezifische Vorlage wieder entfernt und der Vertec Standard wiederhergestellt werden.

Mit dem Zurücksetzen wird nicht nur die Vorlage auf den Standard zurückgesetzt, sondern ab Vertec 6.6 auch der zugehörige Bericht-Code aus dem Reiter Anpassung entfernt. Falls Sie also den Code angepasst haben und später noch benötigen, kopieren Sie ihn zuerst raus, bevor Sie auf Zurücksetzen klicken.

Wird eine kundenspezifische Vorlage von Grund auf neu registriert, dann lautet der Button Löschen. Damit kann eine kundenspezifische 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.
Übersetzung in Projektsprache aktivieren

Wenn aktiviert, hat das folgende Auswirkungen:

  • Berichte, die auf einzelnen Objekten ausgeführt werden, welche eine definierte Beziehung zu einem Projekt haben (z.B. Rechnungen oder Projektauswertungen), werden in diese Projektsprache übersetzt (bzw. alle mit Translation versehenen Labels).
  • Berichte, die auf mehreren Objekten ausgeführt werden (Listenberichte), werden in die aktuelle Vertec Oberflächensprache übersetzt.

Die Übersetzungen der Berichte in die verschiedenen Sprachen erfolgen durch den Vertec Übersetzungsmechanismus.

Bericht-Definition

Office-Berichte bestehen aus der Kombination einer Word- oder Excel-Vorlage für das Layout sowie einer Bericht-Definition in Form von Python Code für den Inhalt. Alle Informationen dazu finden Sie im Artikel über die Office-Berichte (Word, Excel, PDF).

Auf der Seite Bericht-Definition ist der Python-Code für die angegebene Vorlage hinterlegt.

Der interne Name bezeichnet den von Vertec mitgelieferten Code. Dieser wird unter dem Reiter Eingebaut angezeigt.

Unter dem Reiter Anpassung kann der mitgelieferte Code überschrieben werden. Sobald unter Anpassung Code vorhanden ist, gilt nur noch dieser. Um etwas zu ändern, muss also der komplette Code aus Eingebaut kopiert und dann unter Anpassung geändert werden.

Vom Kunden selbst oder auf Auftrag erstellte Office-Berichte enthalten keinen eingebauten Code und keinen internen Namen, sondern der Code wird direkt im Feld Anpassung eingefügt.

Falls es im Python Code erweiterte Berechtigungen braucht, z.B. für einen SQL-Zugriff, muss das Häkchen Erweiterte Berechtigungen unterhalb der Bericht-Definition gesetzt werden.

Bitte wählen Sie Ihren Standort