Berichte registrieren

So werden Office-Berichte in Vertec registriert

Produktlinie

Standard

|

Expert

Betriebsart

CLOUD ABO

|

ON-PREMISES

Module

Leistung & CRM

Budget & Teilprojekt

Fremdkosten

Ressourcenplanung

Business Intelligence

Erstellt: 23.04.2007
Aktualisiert: 31.07.2024 | Link korrigiert und Screenshots erneuert.

In diesem Artikel wird das Registrieren von Office-Berichten (Word, Excel, PDF) erklärt.

Damit ein Bericht in Vertec über das Drucken-Menü aufgerufen werden kann, muss er registriert werden. Um einen Bericht zu registrieren, gehen Sie in den Ordner Einstellungen > Berichte & Scripts > Berichtsvorlagen und wählen Sie Neu > Office-Bericht:

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.

Outlook App E-Mail-Vorlage Ab Vertec 6.7. Gibt an, ob der Bericht als E-Mail Vorlage in der Outlook App verwendet werden kann.
Automatisches Speichern
Dateiname

Feld bei Systemeinstellung Dokumentspeicherung = Intern (ab Version 6.7)

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 (ab Version 6.7)

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.

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 Standardbericht 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