REFLEX Standard-Report Angebot/Auftrag

1 Allgemeines

Der Report "AngebotAuftrag_Standard_Vxx.fr3" wird für den Druck eines Angebots oder einer Auftragsbestätigung verwendet. Er unterscheidet im Design zwischen Miete und Verkauf.

Der Report befindet sich im Formular-Verzeichnis "Formular\Auftrag".

Der Report verwendet als Basis für den Kopf- und Fuss-Bereich den Basis-Report "BasisReport_01.fr3". Dieser muss im Verzeichnis "Formular" liegen.

Das Desgin des Reports kann über Auftragskennzeichen gesteuert werden. Folgende Kennzeichen werden verwendet:

Kennzeichen	Parameter-Text	Mögliche Werte	Auswirkung
<AuftragsKopf."KENNZ1">	Einzelpreise	Ja, Nein, Leer	Bei Nein werden die Einzelpreise unterdrückt, bei allen anderen Werten werden die Einzelpreise gedruckt.
<AuftragsKopf."KENNZ2">	Logo drucken	Ja, Nein, Leer	Bei Nein wird das Logo unterdrückt, bei allen anderen Werten wird das Logo gedruckt.
<AuftragsKopf."KENNZ3">	Rabatt drucken	Ja, Nein, Leer	Bei Nein wird der Rabatt in den Positionen und im Fuss unterdrückt, bei allen anderen Werten wird er gedruckt.
<AuftragsKopf."KENNZ4">	Bezeichn.drucken	Ja, Nein, Leer	Bei Nein wird die Artikel-Bezeichnung in den Positionen, bei allen anderen Werten wird sie gedruckt.
<AuftragsKopf."KENNZ5">	Kapitelpreise drucken	Ja, Nein, Leer	Bei Nein werden die Kapitel-Preise in den Positionen unterdrückt, bei allen anderen Werten werden sie gedruckt.

Hinweis: "Gedruckt" heißt natürlich auch angezeigt, exportiert usw.

Siehe auch:

FastReport: Steuerung des Report mit Auftragskennzeichen.

REFLEX Standard-Basis-Report

2 Vorschau

In der Vorschau sieht das Formular so aus:

3 Bereiche

3.1 Seitenkopf, Seitenfuss

Diese Bereiche kommen aus dem Basis-Report. Änderungen sollten immer im Basis-Report vorgenommen werden, weil diese sich auf alle anderen Reports auswirken, die den Basis-Report verwenden.

3.1.1 Der Bereich

3.1.2 Code dazu

Im Ereignis OnBeforePrint des Bild-Objektes 'pictureBasisKopf wird das Logo ausgeschaltet, wenn das Auftragskennzeichen 1 auf "Nein" steht:

procedure pictureBasisKopfLogoOnBeforePrint_inherited(Sender: TfrxComponent);
begin
  if <AuftragsKopf."KENNZ1"> = 'Nein' then
    pictureBasisKopfLogo.Visible := False;
end;

Hinweis: Das "_inherited" ("ererbt") im Prozedur-Namen kommt daher, weil das Objekt ursprünglich aus dem Basis-Report kommt.

Siehe auch: FastReport: Steuerung des Report mit Auftragskennzeichen.

3.2 Kunden-Adresse

Die Kunden-Adresse incl. Ansprechpartner liegt im BasisSeitenkopfChild aus dem Basis-Report.

Man kann also auch Felde in einen Bereich legen, der eigentlich nicht zum eigentlichen Report gehört. Die sind dort aber nur in dem Haupt-Report, nicht im Basis-Report!

Die Felder haben die Eigenschaften (rechte Maustaste und Option wählen)

Dehnen: Das Feld wird automatisch an die Höhe des Inhalts angepasst.
Verschieben wenn Überlappung: Das Feld wir nach unten verschoben, wenn sich ein Feld darüber ausdehnt.

Hinweis: Das Ansprechpartnerfeld wird derzeit vorausgesetzt! Es ist noch kein Mechanismus eingebaut, der die unteren Felder nach oben schiebt, wenn es keinen Ansprechpartner gibt. Die Schwierigkeit ist, dass die Felder die Option Verschieben wenn Überlappung haben, damit sie sich nach unten verschieben, wenn der Firmenname mehrzeilig ist. Dadurch verwaltet der Report die Positionen automatisch, ein Code, der die Position manuell anpasst

(z.B. if <Ansprechpartner."Briefanrede"> = then AuftragsKopfStr.Top := AnsprechpartnerBriefanrede.Top;) hat dadurch keine Wirkung!

3.3 Der Auftagskopf

Die folgenden Bereiche gehören alle zum Auftragskopf.

Die Bänder haben alle das Dataset AuftragsKopf. Sie gehören zum Band-Typ MasterData, werden also nur ein mal ausgegeben!

Der Kopf ist in verschiedene Bereiche eingeteilt, die teilweise unter bestimmten Umständen unterdrückt werden.

3.3.1 Erste Seite: Formular-Titel, Datum, Seiten-Nummer

Der Bereich MasterAuftragskopf beinhaltet den Formulartitel und die Seitennummer für die erste Seite. (Die Schrift ist etwas größer als der Titel für die Folgeseiten)

Das Feld für den Formular-Titel hat folgenden Inhalt:

[Titel] Nr. [AuftragsKopf."AuftrNr"].[AuftrStatistik."AuftrVersion"] vom [Date]

Feld	Beschreibung
`[Titel]`	Diese Variable wird vom Programm an den Report übergeben. Der Text dazu kommt aus den Programm-Parametern. Weitere Informationen dazu
`[AuftragsKopf."AuftrNr"].[AuftrStatistik."AuftrVersion"]`	Hier wird die Auftragsnummer ausgegeben, gefolgt von einem Punkt und der Versionsnummer des Auftrags. Modul "Auftragsversionen" Dieses Zusatzmodul ermöglicht es, von einem Angebot/Auftrag beliebig viele Versionen abzuspeichern. Das hier beschriebene Formular kann auch von den Auftragsversionen zum Drucken benutzt werden (das geht mit CrystalReports nicht!) Wenn Sie das Modul "Auftragsversionen" von REFLEX nicht nutzen, können Sie dieses Feld und den Punkt löschen.
`[Date]`	In dieser Systemvariable steht das aktuelle Tagesdatum. Alternativ dazu könnte man auch das gespeichert Druckdatum benutzen. Das Feld würde dann so aussehen: [Titel] Nr. [AuftragsKopf."AuftrNr"].[AuftrStatistik."AuftrVersion"] vom [AuftragsKopf."DruckDat"]

Hinweis: Der Titel für die Folgeseiten wird über den Header der Positionen HeaderPositionen ausgegeben.

3.3.2 Ab zweiter Seite: Formular-Titel, Datum, Seiten-Nummer

Der Titel für die Seiten 2 - Ende wird über den Header der Positionen HeaderPositionen ausgegeben.

Damit dieser Bereich auf der ersten unterdrückt wird, gibt es diesen Code in HeaderPositionenOnBeforePrint:


procedure HeaderPositionenOnBeforePrint(Sender: TfrxComponent);
begin
  // Auf der 1. Seite unterdrücken:
  if <Page#> = 1 then
  begin
    MemoAuftrNrTitelHeaderPositionen.Visible := False;
    HeaderSeitenNummer.Visible := False;
    HeaderPositionen.Visible := False;
  end
  else
  begin
    MemoAuftrNrTitelHeaderPositionen.Visible := True;
    HeaderSeitenNummer.Visible := True;
    HeaderPositionen.Visible := True;
  end;
end;

(Eigentlich gehört dieser Bereich nicht zum Kopf sondern zum Header über den Positionen)

3.3.3 Auftragsdaten im Kopf

3.3.3.1 MasterDataKopfMiete

In diesem Bereich stehen die Kopfdaten für einen Miet-Auftrag.

Deshalb muss dieser Bereich ausgeblendet werden, wenn es um einen Verkaufs-Auftrag geht. Außerdem sollen die Aufbau, Abbau, Probe-Felder ausgeblendet werden, wenn dort kein Text eingegeben wurde.

Dazu gibt es diesen Code in MasterDataKopfMieteOnBeforePrint:


procedure MasterDataKopfMieteOnBeforePrint(Sender: TfrxComponent);
begin
  if <AuftragsKopf."Bereich_1Verkauf_2Miete_3Mietverkauf"> <> 2 then
    MasterDataKopfMiete.Visible := False  // Es ist Verkauf, also Bereich ausschalten!
  else
  begin
    MasterDataKopfMiete.Visible := True;  // Es ist Miete, also Bereich einschalten!  

    // Bei Miete: Datumsfelder im Kopf nur sichtbar, wenn Text drin steht:
    if <AuftragsKopf."AufbauText"> =  then
    begin
      AuftragsKopfAufbauDatum.Visible := False;
      AuftragsKopfAufbauText.Visible := False;
      AuftragsKopfAufbauZeit.Visible := False;
    end;

    if <AuftragsKopf."AbbauText"> =  then
    begin
      AuftragsKopfAbbauDatum.Visible := False;
      AuftragsKopfAbbauText.Visible := False;
      AuftragsKopfAbbauZeit.Visible := False;
    end;

    if <AuftragsKopf."ProbeText"> =  then
    begin
      AuftragsKopfProbeDatum.Visible := False;
      AuftragsKopfProbeText.Visible := False;
      AuftragsKopfProbeZeit.Visible := False;
    end;
  end;
end;

Wenn im Feld <AuftragsKopf."Bereich_1Verkauf_2Miete_3Mietverkauf"> (es heißt wirklich so!) 1 steht, ist es ein Verkaufs-Auftrag, bei 2 ein Miet-Auftrag, bei 3 ein Mietartikel-Verkaufen-Auftrag.

3.3.3.2 MasterDataKopfVerkauf

In diesem Bereich stehen die Kopfdaten für einen Verkaufs-Auftrag.

Deshalb muss dieser Bereich ausgeblendet werden, wenn es um einen Miet-Auftrag geht. Dazu gibt es den Code in MasterDataKopfMieteOnBeforePrint, wie oben beschrieben.

3.3.3.3 MasterDataVARaum

In diesem Bereich stehen die Veranstaltungs-Raum und -VA-Ort (Kurzname) für einen Miet-Auftrag.

Dieser Bereich soll nur gedruckt werden, wenn es einen Raum oder VA-Ort-Namen gibt. Deshalb gibt es diesen Code in MasterDataVARaumOnBeforePrint:


procedure MasterDataVARaumOnBeforePrint(Sender: TfrxComponent);
begin
  // Wenn beide Felder leer sind: Ausblenden!
  if ( <AuftragsKopf."VA-OrtKurzname"> =  ) and ( <AuftragsKopf."VA-Raum"> =  ) then
    MasterDataVARaum.Visible := False;
end;

Hinweis: Der VA-Ort-Name wird im Auftragskopf unter dem VA-Ort optional angegeben.

3.3.3.4 MasterKoptext

In diesem Bereich stehen die Ansprechpartner-Daten des Kopfes.

Er wird immer ausgegeben und hat keine Ereignisse.

Ansprechnpartner Kunde: Die Daten kommen aus den Kontakt-Stammdaten des Kunden bzw. Ansprechpartners. Weitere Informationen.

Ansprechnpartner Auftrag: Die Daten kommen aus den Personen-Stammdaten des Auftragsbearbeiters. Weitere Informationen.

3.3.4 Standardtext, Text aus Kopf

Im Bereich MasterDataStandardTextKopf steht der Standard-Text, der in den Programmparametern für dieses Formular festgelegt wurde. Weitere Informationen.

Darunter, im Bereich MasterDataKopftext steht der Text, der im Auftragskopf eingegeben wurde. Dieser Text ist also eine Ergänzung des Standard-Textes. Weitere Informationen.

3.4 Positionen

Zentrales Band der Positionen ist das Band DetailPositionen. Es gehört zum Band-Typ DetailData mit den Daten aus der Tabelle Positionen. Das bedeutet, dass dieser Bereich wiederholt ausgegeben wird, bis es keine Positionsdaten mehr gibt!

Um, dieses Band herum wurden andere Bänder gelegt:

Ein Header ("HeaderPositionen"), der den Titel über die Positionen beinhaltet. Dieser wird oben im Kopf beschrieben.
Ein GroupHeader ("GroupHeaderKapitel"), der die Kapitel-Bezeichnungen beinhaltet. Das bedeutet, dass in dem Report die Gruppierungs-Funktion benutzt wird. Gruppieren bedeutet, dass die Positionen nach der Kapitel-Nummer getrennt werden. Die Kapitel-Überschrift steht im GroupHeader, die eigentlichen Positionen im Band DetailPositionen.
Ein Child-Band ("ChildGroupHeader1") für den Text der Positionen. Ein Child-Band deshalb, weil das Band ausgeblendet wird, wenn gar kein Text angegeben wurde.
Ein Footer ("FussPositionen"), in dem die Summen, Zahlungskonditionen usw. stehen. Dieser Bereich wird unten unter "Fuss" behandelt.

3.4.1 HeaderPositionen, Überschrift über die Positionen

Dieser Bereich beinhaltet den Titel über die Positionen. Dieser wird oben im Kopf beschrieben.

Wichtig ist die Eigenschaft (rechte Maustaste auf dem Bereich) Auf neuer Seite wiederholen. Diese legt fest, dass der Header auf jeder neuen Seite oben gedruckt wird!

Der Bereich hat ein Child (Kind) mit dem Namen "ChildHeaderPositionen", in den die Überschrift über den Positionen liegt.

Weil die Überschrift nicht gedruckt werden soll, wenn es auf der neuen Seite gar keine Positionen mehr gibt, wird dieser Code in ChildHeaderPositionenOnBeforePrint verwendet:


procedure ChildHeaderPositionenOnBeforePrint(Sender: TfrxComponent);
begin
  // Überschriftszeile unterdrücken, wenn keine Positionen mehr kommen:
  if DetailPositionen.DataSet.EOF then
    ChildHeaderPositionen.Visible := False
  else
    ChildHeaderPositionen.Visible := True;
end;

Weitere Hinweise dazu

3.4.2 GroupHeaderKapitel

Beinhaltet die Kapitel-Bezeichnungen. Das bedeutet, dass in dem Report die Gruppierungs-Funktion benutzt wird. Gruppieren bedeutet, dass die Positionen nach der Kapitel-Nummer getrennt werden. Die Kapitel-Überschrift steht im GroupHeader, die eigentlichen Positionen im Band DetailPositionen.

Es gibt diese Besonderheiten:

Wenn in der Auftragsposition das Kennzeichen "Neue Seite vorher" gesetzt wurde, soll ein Seitenwechsel durchgeführt werden, bevor dieser Bereich gedruckt wird.
Wenn im Kennzeichen 4 "Nein" steht, soll der Bereich unterdrückt werden.

Deshalb gibt es im Ereignis GroupHeaderKapitelOnBeforePrint diesen Code:


procedure GroupHeaderKapitelOnBeforePrint(Sender: TfrxComponent);
begin
  // Dieser Code wird ausgeführt, BEVOR das Positionen-Gruppenkopf-Band (die Kapitel-Überschrift) ausgegeben wird.
  // Wenn das Kennzeichen "Seitenwechsel Vorher" gesetzt ist:
  if <Positionen."Seitenwechsel_0Nein_1Vorher_2Nachher"> = 1 then
    Engine.NewPage;                                   // Neue Seite, Seitenkopf usw. drucken

  // Kennzeichen 4 = Kapitelpreise Ja/Nein
  if <AuftragsKopf."KENNZ4"> = 'Nein' then
  begin
    memoKapitelBetrag.Visible         := False;
  end;
end;

3.4.3 ChildGroupHeader1

für den Text der Positionen. Ein Child-Band deshalb, weil das Band ausgeblendet wird, wenn gar kein Text angegeben wurde. Deshalb gibt es im Ereignis ChildGroupHeader1OnBeforePrint diesen Code:


procedure ChildGroupHeader1OnBeforePrint(Sender: TfrxComponent);
begin
  // Unterdrücken, wenn kein Zusatztext vorhanden ist:
  if <Positionen."TextPosition"> =  then
    ChildGroupHeader1.Visible := False
  else
    ChildGroupHeader1.Visible := True;
end;