Reporting – Freies Dokument
Reportvorlagen für freie Dokumente benennen und Datenfelder im Report Designer verwenden.
Für Reportverantwortliche
Diese Seite beschreibt Vorlagendateien und Report Designer. Ändern Sie Vorlagen nur mit einer Kopie und testen Sie sie mit fiktiven Daten, Vorschau und PDF-Export.
Diese Seite richtet sich an Personen, die Reportvorlagen pflegen. Sie beschreibt die Benennung der Vorlagendateien und die wichtigsten Regeln für Felder und Ausdrücke. Für die Bedeutung einzelner Felder ist die Feldreferenz für freie Dokumente massgebend.
Vorlagen zuerst kopieren
Ändern Sie die Standardvorlage nicht direkt. Arbeiten Sie mit einer Kopie und testen Sie die Ausgabe mit realistischen Dokumenten, bevor Sie die Vorlage in den produktiven Systemordner übernehmen.
Standardvorlage
Die Standardvorlage für freie Dokumente befindet sich im Systemverzeichnis und heisst:
DocumentReport.rpxDie Vorlage kann mit einer spezifischeren Datei überschrieben werden. Planura berücksichtigt dafür den Dokumenttyp-Code, den Code der im Dokumentkopf gewählten Stelle und die Dokumentsprache.
Spezifische Vorlagendateien
DocumentReport.rpxDiese Datei ist die allgemeine Vorlage für freie Dokumente.
Die Suche bevorzugt eine passende Kombination aus Dokumenttyp, Stelle und Sprache. Danach folgen weniger spezifische Varianten, zuletzt DocumentReport.rpx. Prüfen Sie bei einer Anpassung immer ein Dokument mit genau der betreffenden Stelle, dem Dokumenttyp und der Sprache. Die Stelle im Report selbst steht unter CenterCode und CenterCaption zur Verfügung.
Felder im Report Designer
Die Reportvorlage verwendet die verfügbaren Felder der Dokumentdaten als DataSource. Wenn ein Feld nicht speziell formatiert wird, kann es in eine TextBox eingefügt werden.
Die vollständige Erklärung der Feldnamen befindet sich in der Feldreferenz für freie Dokumente. Dort wird nicht nur der Name, sondern auch die Bedeutung und die typische Verwendung jedes Feldes beschrieben.
Datumsfelder formatieren
Felder vom Typ Date oder DateTime müssen für die Anzeige in einen Text umgewandelt werden:
=BillDateOrDate.ToLongDateString()
=BillDateOrDate.ToShortDateString()
=BillDateOrDate.ToLongTimeString()
=BillDateOrDate.ToShortTimeString()Beispiel:
=BillDateOrDate.ToShortDateString()Verwenden Sie die Formatierung passend zum Inhalt. Eine Uhrzeit ist bei einem Rechnungsdatum in der Regel nicht erforderlich, bei einem Ausführungszeitpunkt kann sie jedoch relevant sein.
Mehrere Felder kombinieren
Mehrere Felder und feste Texte werden mit + verbunden:
=ResponsibleFirstName + " " + ResponsibleLastNamePrüfen Sie dabei leere Werte. Wenn nur ein Vorname oder nur ein Nachname vorhanden ist, kann der Ausdruck je nach Report Designer ein zusätzliches Leerzeichen ausgeben.
Wichtige Feldgruppen
Die wichtigsten verfügbaren Feldgruppen sind:
| Feldgruppe | Beispiele | Typische Verwendung |
|---|---|---|
| Mandant | ClientName, ClientAddress, ClientVat, ClientEmail | Absender, Firmenadresse und Mehrwertsteuerangaben |
| Objekt | ObjectCode, ObjectCaption | Objektbezug im Dokumentkopf |
| Projekt | ProjectCode, ProjectCaption | Projektbezug und Zuordnung |
| Dokumenttyp | DocumentTypeCode, DocumentTypeCaption, DocumentTypeAbbreviation, DocumentTypeIsBill | Dokumentart, Kurzbezeichnung und Rechnungslogik |
| Dokumentkennung | Year, Number, DocumentTypeCodeYearNumber | Dokumentnummer und eindeutige Referenz |
| Externe Referenz | ExterneBelegnummer | Externe Belegnummer aus dem Dokumentkopf |
| Dokumentdaten | Caption, Date, ExecutionDateStart, ExecutionDateFinish, BillDate, BillDateOrDate | Titel, Datumswerte und Ausführungszeitraum |
| Gewerk und Stelle | MaintenanceGroupCode, MaintenanceGroupCaption, CenterCode, CenterCaption, CenterAddress, CenterCity | Fachliche Einordnung und Firmenstelle |
| Verantwortliche Person | ResponsibleCode, ResponsibleFirstName, ResponsibleLastName | Zuständigkeit und Kontaktangabe |
| Unser Zeichen | UnserZeichenTelefon, UnserZeichenEmail | Telefon und E-Mail der unter «Unser Zeichen» gewählten Person |
| Unterschriften | VerantwortlichePersonName, VerantwortlichePersonTitel, VerantwortlichePersonMitUnterschrift, Unterschrift2Name, Unterschrift2Titel, Unterschrift2MitUnterschrift | Namen und optionale Unterschriftsbilder der ausgewählten Personen |
| Empfängeradresse | ReceiverAddressNumber, ReceiverAddress, ReceiverAddressName, ReceiverAddressStreet, ReceiverAddressHausnummer, ReceiverAddressPostalCode, ReceiverAddressCity, ReceiverEmail | Mehrzeilige Empfängeradresse und Kontakt |
| Zusatzadressen | ControllerAddress, PlanerAdresse, BauherrAdresse | Weitere Rollen im Dokument |
| Dokumentklassifikation | DocumentCategoryCode, DocumentCategoryCaption, DocumentCodeCode, DocumentCodeCaption, DocumentStateCode, DocumentStateCaption | Kategorie, Code und Status |
| Bank | BankCode, BankCaption, BankIban, BankQrIban, BankBillText | Zahlungsinformationen und Bankangaben |
| Finanzwerte | Vat, Currency, BetragNetto, BetragKonditionen, BetragVorMwst, BetragMwst, BetragBrutto | Summen, Währung, Konditionen und Mehrwertsteuer |
| Referenzen und Ausführung | IhrZeichen, KontaktEmail, KontaktTelefon, AuftragReferenzNummer, AuftragDatum, AusfuehrungBeginnDatumZeit, AusfuehrungEndeDatum, AusfuehrungOrt, Arbeitsbeschreibung | Kommunikation, Auftrag und Ausführung |
Die Tabelle dient nur der Orientierung. Für die Verwendung im Report Designer ist die vollständige Feldreferenz massgebend.
Unterschriftsblock anpassen
Der Standardreport bindet den Unterreport DocUnterschrift.rpx ein. Dessen Bildfelder heissen Unterschrift1Pfad und Unterschrift2Pfad, die Namen stehen in Unterschrift1Text und Unterschrift2Text. Die Daten kommen aus den im Dokument gewählten Personen und deren Unterschriftsangaben in den Stammdaten. Die Option Mit Unterschrift im Dokumentkopf steuert, ob das jeweilige Bild verwendet wird. Testen Sie eine Ausgabe mit zwei Personen sowie eine ohne Bild oder zweite Person. Die Feldreferenz erklärt die zugehörigen Hauptreportfelder.
Vorgehen bei einer Reportanpassung
Kopie erstellen
Kopieren Sie die Standardvorlage oder eine bestehende kundenspezifische Vorlage. Bewahren Sie die unveränderte Ausgangsdatei auf.
Datei korrekt benennen
Benennen Sie die Kopie gemäss Dokumenttyp und/oder Sprache. Prüfen Sie den Dokumenttyp-Code direkt in Planura, statt ihn aus einer Vermutung abzuleiten.
Vorlage bearbeiten
Öffnen Sie die Vorlage im Report Designer und prüfen Sie DataSource, Feldnamen und Datumsformatierung.
Varianten testen
Testen Sie mindestens ein Dokument pro Dokumenttyp und Sprache. Berücksichtigen Sie auch leere optionale Adressen und unterschiedliche Positionenmengen.
Ausgabe freigeben
Prüfen Sie Vorschau, PDF-Export und – falls relevant – den Ausdruck. Übernehmen Sie die Vorlage erst danach in den vorgesehenen Systemordner.
Freigabekriterium
Eine Reportänderung ist erst bereit, wenn Daten, leere Werte, Seitenumbrüche und die korrekte Vorlagenauswahl geprüft wurden.