Reports & Export
Feldreferenz – Freies Dokument
Bedeutung und typische Verwendung der Felder im Report eines freien Dokuments.
Referenz für Reportverantwortliche: Diese Seite erklärt technische Feldnamen. Sie ist keine Anleitung zur Datenerfassung und sollte nur bei einer gezielten Vorlagenanpassung verwendet werden.
Diese Seite erklärt die Felder, die in der DataSource eines Reports für freie Dokumente verwendet werden können. Die Feldnamen müssen im Report Designer exakt übernommen werden.
Verwendung
Ein Feld kann direkt in einer TextBox verwendet werden. Datumsfelder müssen für eine lesbare Ausgabe formatiert werden:
=BillDateOrDate.ToShortDateString()Optionale Felder können leer sein, zum Beispiel eine Zusatzadresse oder ein Rechnungsdatum bei einem Dokument, das noch keine Rechnung ist. Testen Sie deshalb immer einen vollständigen und einen unvollständigen Beispieldatensatz.
Mandanteninformationen
| Feld | Bedeutung | Typische Verwendung |
|---|---|---|
ClientName | Name des Mandanten, der Planura verwendet. | Briefkopf |
ClientAddress | Vollständige Adresse des Mandanten. | Briefkopf |
ClientStreet | Strassenname des Mandanten. | Adressblock |
ClientHouseNumber | Hausnummer des Mandanten. | Adressblock |
ClientPostalCode | Postleitzahl des Mandanten. | Adressblock |
ClientCity | Ort des Mandanten. | Adressblock |
ClientCountryCode | Ländercode, zum Beispiel CH. | Internationale Adresse |
ClientCountryCaption | Ausgeschriebener Ländername. | Internationale Adresse |
ClientVat | Mehrwertsteuer- bzw. UID-Information des Mandanten. | Fusszeile oder Rechnungsangaben |
ClientSupplierNumber | Lieferantennummer des Mandanten. | Buchhaltung oder Lieferantenangaben |
ClientEmail | E-Mail-Adresse des Mandanten. | Briefkopf oder Kontaktblock |
Objekt und Projekt
| Feld | Bedeutung | Typische Verwendung |
|---|---|---|
ObjectCode | Code bzw. Nummer des Objekts. | Referenz im Dokument |
ObjectCaption | Bezeichnung des Objekts. | Titel oder Projektkopf |
ProjectCode | Code bzw. Nummer des Projekts. | Referenz im Dokument |
ProjectCaption | Bezeichnung des Projekts. | Titel oder Projektkopf |
Dokumenttyp und Dokumentkennung
| Feld | Bedeutung | Typische Verwendung |
|---|---|---|
DocumentTypeCode | Interner Code des Dokumenttyps. | Dokumentnummer oder Dateiname |
DocumentTypeCaption | Lesbare Bezeichnung des Dokumenttyps. | Titel |
DocumentTypeAbbreviation | Abkürzung des Dokumenttyps. | Kurze Kennzeichnung |
DocumentTypeIsBill | Gibt an, ob der Dokumenttyp als Rechnung gekennzeichnet ist. | Bedingte Reportelemente |
Year | Dokumentjahr. | Dokumentnummer oder Dateiname |
Number | Laufende Dokumentnummer. | Dokumentnummer |
DocumentTypeCodeYearNumber | Zusammengesetzte Kennung aus Typ, Jahr und Nummer, zum Beispiel RE202595. | Kopfzeile |
ExterneBelegnummer | Externe Belegnummer aus dem Dokumentkopf, sofern erfasst. Sie ist unabhängig von der Planura-Dokumentnummer. | Referenz auf einen Vorgang in einem anderen System |
Dokumentdetails und Termine
| Feld | Bedeutung | Typische Verwendung |
|---|---|---|
Caption | Bezeichnung des Dokuments. | Dokumenttitel |
Date | Dokumentdatum. | Datumszeile |
ExecutionDateStart | Beginn der Ausführung. | Leistungszeitraum |
ExecutionDateFinish | Ende der Ausführung. | Leistungszeitraum |
BillDate | Rechnungsdatum, sofern vorhanden. | Rechnung |
BillDateOrDate | Rechnungsdatum, wenn vorhanden; sonst Dokumentdatum. | Einheitliches Datumsfeld |
BillReferenceNumberCode | Referenznummercode der Rechnung. | Zahlungs- oder Referenzangaben |
Gewerk, Stelle und verantwortliche Person
| Feld | Bedeutung | Typische Verwendung |
|---|---|---|
MaintenanceGroupCode | Code des Gewerks. | Projekt-/Gewerkreferenz |
MaintenanceGroupCaption | Bezeichnung des Gewerks. | Projekt-/Gewerkreferenz |
CenterCode | Code der zuständigen Stelle. | Absender- oder Organisationsblock |
CenterCaption | Bezeichnung der Stelle. | Absender- oder Organisationsblock |
CenterAddress | Adresse der Stelle. | Absenderblock |
CenterCity | Ort der Stelle. | Absenderblock |
ResponsibleCode | Code der verantwortlichen Person. | Zuständigkeit |
ResponsibleFirstName | Vorname der verantwortlichen Person. | Kontaktzeile |
ResponsibleLastName | Nachname der verantwortlichen Person. | Kontaktzeile |
VerantwortlichePersonTelefon | Telefonnummer der im Dokument gewählten verantwortlichen Person. | Kontaktblock |
VerantwortlichePersonEmail | E-Mail-Adresse dieser Person. | Kontaktblock |
CenterCode und CenterCaption stammen aus der im Dokumentkopf ausgewählten Stelle. Fehlt diese Auswahl, können die Felder leer sein. CenterAddress und CenterCity werden derzeit aus der Mandantenadresse und dem Mandantenort befüllt. Verwenden Sie sie daher nicht ungeprüft als abweichende Adresse der Stelle.
Namen und Unterschriften
Die erste Unterschrift gehört zur verantwortlichen Person im Dokumentkopf. Die zweite Person wird im Feld Unterschrift 2 ausgewählt. Name und Titel für den Unterschriftsblock stammen aus den Unterschriftsangaben der jeweiligen Person in den Stammdaten. Sie müssen deshalb nicht mit ResponsibleFirstName und ResponsibleLastName übereinstimmen.
| Feld | Bedeutung | Typische Verwendung |
|---|---|---|
VerantwortlichePersonName | Hinterlegter Unterschriftsname der verantwortlichen Person. | Name unter der ersten Unterschrift |
VerantwortlichePersonTitel | Hinterlegter Unterschriftstitel dieser Person. | Funktion oder Titel unter dem Namen |
VerantwortlichePersonMitUnterschrift | Auswahl Mit Unterschrift bei der verantwortlichen Person im Dokumentkopf. | Bild der ersten Unterschrift nur bei aktivierter Auswahl anzeigen |
VerantwortlichePersonUnterschriftPfad | Pfad zur hinterlegten Unterschriftsdatei, sofern vorhanden. | Bildquelle der ersten Unterschrift |
Unterschrift2Name | Hinterlegter Unterschriftsname der zweiten ausgewählten Person. | Name unter der zweiten Unterschrift |
Unterschrift2Titel | Hinterlegter Unterschriftstitel der zweiten Person. | Funktion oder Titel unter dem Namen |
Unterschrift2MitUnterschrift | Auswahl Mit Unterschrift bei Unterschrift 2 im Dokumentkopf. | Bild der zweiten Unterschrift nur bei aktivierter Auswahl anzeigen |
Unterschrift2UnterschriftPfad | Pfad zur hinterlegten Unterschriftsdatei der zweiten Person, sofern vorhanden. | Bildquelle der zweiten Unterschrift |
Der Standardreport verwendet für die Darstellung den Unterschrifts-Unterreport DocUnterschrift.rpx. Dort heissen die Bild- und Textfelder Unterschrift1Pfad, Unterschrift1Text, Unterschrift1Titel sowie Unterschrift2Pfad, Unterschrift2Text, Unterschrift2Titel. Die beiden Text-Felder enthalten den jeweiligen Unterschriftsnamen. Die Unterreport-Daten werden aus den oben genannten Dokumentfeldern gebildet. Tragen Sie die Dateipfade nicht als sichtbaren Text auf dem Dokument ein.
Wenn eine Person ausgewählt ist, aber kein Bild erscheint, prüfen Sie die jeweilige Auswahl Mit Unterschrift und ob bei dieser Person eine Unterschriftsdatei hinterlegt und auf dem Druckrechner verfügbar ist. Testen Sie zusätzlich eine Ausgabe ohne zweite Person und eine ohne aktiviertes Unterschriftsbild.
Empfänger- und Zusatzadressen
| Feld | Bedeutung | Typische Verwendung |
|---|---|---|
ReceiverAddressNumber | Interne Adressnummer des Empfängers. | Referenz oder interne Kontrolle |
ReceiverAddress | Vollständige Empfängeradresse. | Adressblock |
ReceiverAddressName | Name zur Empfängeradresse. | Adressblock |
ReceiverAddressZusatz1 | Erster Zusatz zur Empfängeradresse. | Adressblock |
ReceiverAddressStreet | Strasse des Empfängers. | Adressblock |
ReceiverAddressHausnummer | Hausnummer des Empfängers. | Adressblock |
ReceiverAddressPostalCode | Postleitzahl des Empfängers. | Adressblock |
ReceiverAddressCity | Ort des Empfängers. | Adressblock |
ReceiverAddressCountryCode | Ländercode des Empfängers. | Internationale Adresse |
ReceiverEmail | E-Mail-Adresse des Empfängers. | E-Mail-Versand oder Kontaktblock |
ReceiverEbill | Kennzeichen, ob elektronische Rechnung bevorzugt wird. | Bedingte Anzeige |
ReceiverEbillEmail | E-Mail-Adresse für elektronische Rechnungen. | E-Rechnungsversand |
ControllerAddressNumber | Interne Nummer der Zusatzadresse. | Zusatzadressreferenz |
ControllerAddress | Vollständige Zusatzadresse. | Adressblock |
PlanerAdresseNummer | Interne Nummer der Planeradresse. | Zusatzadressreferenz |
PlanerAdresse | Vollständige Planeradresse. | Adressblock |
BauherrAdresseNummer | Interne Nummer der Bauherrenadresse. | Zusatzadressreferenz |
BauherrAdresse | Vollständige Bauherrenadresse. | Adressblock |
Eingabe, Kategorie, Code und Status
| Feld | Bedeutung | Typische Verwendung |
|---|---|---|
EingabeDateTime | Zeitpunkt der Erfassung. | Dokumenthistorie |
EingabeDatumText | Erfassungsdatum als kurzer Text. | Dokumenthistorie |
EingabeOrt | Ort der Erfassung. | Dokumentdaten |
DocumentCategoryCode | Code der Dokumentkategorie. | Klassifikation |
DocumentCategoryCaption | Bezeichnung der Dokumentkategorie. | Klassifikation |
DocumentCodeId | Eindeutige interne Kennung des Dokumentcodes. | Technische Referenz |
DocumentCodeCode | Codewert des Dokumentcodes. | Klassifikation |
DocumentCodeCaption | Bezeichnung des Dokumentcodes. | Klassifikation |
DocumentStateCode | Code des Dokumentstatus. | Statusanzeige |
DocumentStateCaption | Lesbare Bezeichnung des Dokumentstatus. | Statusanzeige |
CrbDocumentState | CRB-spezifischer Dokumentstatus. | NPK-/CRB-bezogene Reports |
Bankinformationen
| Feld | Bedeutung | Typische Verwendung |
|---|---|---|
BankCode | Code der ausgewählten Bank. | Zahlungsangaben |
BankCaption | Bezeichnung der ausgewählten Bank. | Zahlungsangaben |
BankIban | IBAN der Bank. | Rechnung |
BankQrIban | QR-IBAN für QR-Zahlungen. | QR-Rechnung |
BankQrTnrBesr | QR-Teilnehmernummer oder BESR-Referenz. | QR-Rechnung |
BankUseTextAsBill | Gibt an, ob der Banktext als Rechnungstext verwendet wird. | Bedingte Ausgabe |
BankBillText | Hinterlegter Bank-/Rechnungstext. | Zahlungsblock |
Texte und Finanzwerte
| Feld | Bedeutung | Typische Verwendung |
|---|---|---|
StartTextRtf | Vortext im RTF-Format. | Dokumentvortext |
StartTextRtfReplaced | Vortext nach Ersetzung der Platzhalter. | Druckausgabe |
EndTextRtf | Schlusstext im RTF-Format. | Dokumentschlusstext |
EndTextRtfReplaced | Schlusstext nach Ersetzung der Platzhalter. | Druckausgabe |
Vat | Verwendete Mehrwertsteuer. | Finanzblock |
Currency | Dokumentwährung, zum Beispiel CHF. | Finanzblock |
BetragNetto | Nettobetrag vor Konditionen und Mehrwertsteuer. | Summenblock |
BetragKonditionen | Konditionenbetrag gemäss Dokumentberechnung; in der bisherigen Referenz als BetragBrutto - BetragNetto beschrieben. | Summenblock |
BetragVorMwst | Betrag vor Mehrwertsteuer. | Summenblock |
BetragMwst | Mehrwertsteuerbetrag. | Summenblock |
BetragBrutto | Bruttobetrag des Dokuments. | Summenblock |
Gläubiger und Schuldner
| Feld | Bedeutung | Typische Verwendung |
|---|---|---|
CreditorName | Name des Gläubigers. | Zahlungs- oder Buchhaltungsblock |
CreditorAddressLine1 | Erste Adresszeile des Gläubigers. | Zahlungs- oder Buchhaltungsblock |
CreditorAddressLine2 | Zweite Adresszeile des Gläubigers. | Zahlungs- oder Buchhaltungsblock |
CreditorHouseNr | Hausnummer des Gläubigers. | Adressblock |
CreditorPostalCode | Postleitzahl des Gläubigers. | Adressblock |
CreditorCity | Ort des Gläubigers. | Adressblock |
CreditorCountryCode | Ländercode des Gläubigers. | Internationale Adresse |
DebtorName | Name des Schuldners. | Zahlungs- oder Buchhaltungsblock |
DebtorAddressLine1 | Erste Adresszeile des Schuldners. | Zahlungs- oder Buchhaltungsblock |
DebtorAddressLine2 | Zweite Adresszeile des Schuldners. | Zahlungs- oder Buchhaltungsblock |
DebtorHouseNr | Hausnummer des Schuldners. | Adressblock |
DebtorPostalCode | Postleitzahl des Schuldners. | Adressblock |
DebtorCity | Ort des Schuldners. | Adressblock |
DebtorCountryCode | Ländercode des Schuldners. | Internationale Adresse |
Referenzen, Kontakt und Ausführung
| Feld | Bedeutung | Typische Verwendung |
|---|---|---|
UnserZeichenCode | Code der Person in «Unser Zeichen». | Zuständigkeit |
UnserZeichenVorname | Vorname der Person in «Unser Zeichen». | Zuständigkeitszeile |
UnserZeichenNachname | Nachname der Person in «Unser Zeichen». | Zuständigkeitszeile |
UnserZeichenTelefonVorwahl | Telefonvorwahl der Person in «Unser Zeichen». | Getrennte Telefonangabe |
UnserZeichenTelefonNummer | Telefonnummer dieser Person ohne Vorwahl. | Getrennte Telefonangabe |
UnserZeichenTelefon | Zusammengesetzte Telefonangabe aus Vorwahl und Nummer. Bleibt leer, wenn keine Nummer hinterlegt ist. | Kontaktzeile |
UnserZeichenEmail | E-Mail-Adresse der Person in «Unser Zeichen». | Kontaktzeile |
IhrZeichen | Wert des Feldes «Ihr Zeichen». | Referenzzeile |
IhrZeichenAbteilung | Abteilung zu «Ihr Zeichen». | Referenzzeile |
KontaktEmail | Kontakt-E-Mail-Adresse zum Dokument. | Kontaktzeile |
KontaktTelefon | Kontakttelefonnummer zum Dokument. | Kontaktzeile |
AuftragReferenzNummer | Auftrags- oder Referenznummer. | Referenzzeile |
AuftragDatum | Datum des Auftrags. | Auftragsinformationen |
AusfuehrungBeginnDatumZeit | Beginn der Ausführung mit Datum und Zeit. | Leistungszeitraum |
AusfuehrungEndeDatum | Ende der Ausführung. | Leistungszeitraum |
AusfuehrungOrt | Ort der Ausführung. | Auftragsinformationen |
Arbeitsbeschreibung | Beschreibung der auszuführenden Arbeit. | Leistungsbeschreibung |
Zahlungsperiode | Zahlungsfrist in Tagen. | Zahlungsbedingungen |
Häufige Auswahlfehler
DateundBillDatesind nicht dasselbe: Das Dokumentdatum ist nicht automatisch das Rechnungsdatum.ExterneBelegnummerist wederNumbernochBillReferenceNumberCodeoderAuftragReferenzNummer. Prüfen Sie, welche Referenz der Empfänger tatsächlich benötigt.BillDateOrDateist praktisch, wenn ein Report für Rechnungen und Nicht-Rechnungen verwendet wird.ReceiverAddressbeschreibt den Empfänger;Creditor*undDebtor*dienen dem jeweiligen Finanzkontext.- Die Felder mit
Replacedenthalten bereits ersetzte Textbausteine und sind für die Ausgabe meist geeigneter als die rohen RTF-Felder.
Systemeinstellungen
Formatvorlagen und Platzhalter für E-Mail-Betreff, Einzahlungsschein, Exportdateien sowie Personen-, Geräte-, Material- und Spesentexte. Zusätzlich wichtige Druckvorgaben für freie Dokumente.
NPK-Dokument: Felder
Bedeutung und typische Verwendung der Felder im Report eines NPK-Dokuments.