4D Doc Center : PV FIELD TO CELLS

Home

4D View v14

PV FIELD TO CELLS


PV FIELD TO CELLS ( Bereich ; Ausrichtung ; Spalte ; Zeile ; Umwandlung ; Haupttabelle ; Tabellennr ; Feldnr )

Parameter	Typ	Beschreibung
Bereich	Lange Ganzzahl	4D View Bereich
Ausrichtung	Ganzzahl	0 = Zeile; 1 = Spalte
Spalte	Lange Ganzzahl	Spaltennummer Startzelle
Zeile	Lange Ganzzahl	Zeilennummer Startzelle
Umwandlung	Ganzzahl	0 = Originaltyp; 1 = Setze in Text
Haupttabelle	Ganzzahl	Nummer Haupttabelle
Tabellennr	Ganzzahl	Tabellennummer
Feldnr	Ganzzahl	Feldnummer

Beschreibung

Der Befehl PV FIELD TO CELLS fügt in Bereich die Werte des Datenfeldes ein aus der aktuellen Auswahl der Tabelle Haupttabelle. Das Einfügen startet mit der Zelle, definiert durch Spalte und Zeile mit dem in Ausrichtung angegebenen Verlauf.

Hinweis: Der Parameter Ausrichtung arbeitet hier anders als für die Befehle PV GOTO NEXT CELL und PV GET NEXT FREE CELL, wo jede Richtung möglich ist. Für PV CELLS TO ARRAY läuft Ausrichtung entweder nach rechts (0 = Zeile) oder nach unten (1 = Spalte).

Mit dem Parameter Umwandlung können Sie den Datentyp des Zelleninhalts in Text konvertieren. Der ursprüngliche Typ muss natürlich kompatibel sein. Eine Zelle vom Typ BLOB oder Bild lässt sich nicht in Text konvertieren.

Sie können den Befehl für eine Tabelle verwenden, die mit einer Haupttabelle verknüpft ist. Die Verknüpfung muss automatisch sein und von der in Haupttabelle definierten Tabelle zur in Tabellennr definierten Tabelle mit Feldnr für die Anzeige führen. So können Sie im gängigen Beispiel mit Rechnungen und Rechnungszeilen den Inhalt eines Feldes aus einer Tabelle mit Zeilen entnehmen, aber auch ebenso aus einer Tabelle [Rechnungen], die mit einer Auswahl aus der Haupttabelle Rechnungszeilen verknüpft ist.

Befehle wie PV SET CELL FIELD erhalten eine dynamische Verknüpfung mit der Datenbank, d.h. Änderungen werden übernommen. Dagegen werden im 4D View Bereich geänderte Werte, die über den Befehl PV FIELD TO CELLS entnommen werden, nicht im Datensatz übernommen.

Beispiel

Im Beispiel zum Befehl PV CELLS TO ARRAY haben wir die Tabelle [Contacts] aktualisiert, nachdem sie in einem eingebundenen 4D View in eine Eingabemaske eingegeben wurde. Hier aktualisieren wir den eingebundenen Bereich während dem Ereignis On Load, d.h. während das Eingabeformular geändert wird.
Im Kundeneingabeformular zeigen wir im 4D View Bereich eine Liste der Mitarbeiter der Tabelle [Contacts] und ihrer Funktion der Tabelle [Titles]. Über eine automatische Verknüpfung von der Mastertabelle [Contacts] zur Tabelle [Titles] (Direktor, Sekretärin, Entwickler) können wir in einem dynamischen Feld die Bezeichnung der Funktion für jeden Kunden über ihren Code erhalten, welcher im Startfeld der Verknüpfung als Ganzzahl gesichert ist. Name und Funktion des Mitarbeiters werden in zwei Spalten angezeigt.

 C_INTEGER($Master) `NummerHaupttabelle

 C_INTEGER($Table) `Tabellennummer

 C_INTEGER($Field) `Feldnummer

 C_LONGINT($Column;$Row) `Koordinaten der Startzelle

 

 $Master:=Table(->[Contacts]) `Nummer Haupttabelle: Contacts (für beide Spalten)

 PV GET CURRENT CELL(Bereich;$Column;$Row)

 

  `Aktualisiere 4D View Bereich für Namen

 $Table:=Table(->[Contacts]) `Nummer der Tabelle Contacts

 $Field:=Field(->[Contacts]NameContact)

  `Nummer des Feldes, dessen Inhalt entnommen wird

  `Keine Umwandlung, da Feld für Entnahme alphanumerisch ist.

 PV FIELD TO CELLS(Bereich;1;$Column;$Row;0;$Master;$Table;$Field)

 

  `Aktualisiere 4D View Bereich für Funktion

 $Table:=Table(->[Titles]) `Nummer des Titeltyps (verknüpft) von Tabelle

 $Field:=Field(->[Titles]Name) `Name des Feldes, dessen Inhalt entnommen wird

 PV FIELD TO CELLS(Bereich;1;$Column+1;$Row;0;$Master;$Table;$Field)