Ein virtuelles Feld definieren

Referenz: Verwendungshinweise für die Erstellung von virtuellen Feldern

Wenn ein JOIN ausgegeben wird, werden alle bereits vorhandenen virtuellen Felder für diese Datenquelle gelöscht, außer denen, die in der Masterdatei definiert sind.
Um Strukturen mit einem virtuellen Feld mit der Quelle zu verbinden, stellen Sie sicher, dass Define auf Join folgt. Ändernfalls entfernt Join das Temporärfeld. Eine genauere Beschreibung über das Verbinden von Datenquellen finden Sie unter Datenquellen verbinden und kombinieren.
Wenn Sie einen DEFINE bearbeiten und den Namen ändern, sehen Sie weiter den ursprünglichen DEFINE, zusätzlich zum neuen benannten DEFINE.
Falls Sie den KEEPDEFINES-Parameter nicht verwenden, werden alle bereits bestehenden virtuellen Felder dieser Datenquelle beim Einstellen eines JOIN geleert (außer denen, die in einer Masterdatei definiert wurden).
Um Strukturen mit einem virtuellen Feld mit der Quelle zu verbinden, stellen Sie sicher, dass der Befehl DEFINE auf den Befehl JOIN folgt. Ändernfalls entfernt der Befehl JOIN das Temporärfeld. Eine genauere Beschreibung über das Verbinden von Datenquellen finden Sie unter Datenquellen verbinden.
Wenn kein Feld in der Formel sich in der Masterdatei befindet oder definiert wurde, verwenden Sie den Befehl WITH, um die logische Position der definierten Berechnung zu identifizieren. Siehe Eine Segment-Speicherstelle für ein virtuelles Feld festlegen.
WITH kann verwendet werden, um die logische Position des virtuellen Feldes in ein Segment zu verschieben, das niedriger ist, als das, dem es andernfalls zugewiesen würde (z. B. um Instanzen in einem niedrigeren Segment zu zählen).
Sie können Felder simultan definieren (zusätzlich zu Feldern, die in der Masterdatei definiert sind) für so viele Datenquellen, wie Sie wünschen. Die Gesamtlänge aller virtuellen Felder und realen Felder darf 32.000 Zeichen nicht überschreiten.
Wenn Sie virtuelle Felder in einer Anfrage angeben, werden diese mitgezählt, wenn es um die Anzeigefeldbeschränkung geht. Genauere Informationen über das Bestimmen der maximalen Anzahl für Anzeigefelder, die in einer Anfrage verwendet werden können, siehe Reportdaten anzeigen.
Virtuelle Felder sind nur dann verwendbar, wenn eine Datenquelle zum Reporting verwendet wird. Virtuelle Felder können nicht mit MODIFY verwendet werden.
Ein DEFINE-Befehl kann keine qualifizierten Feldnamen auf der linken Seite der Formel enthalten. Wenn derselbe Feldname in mehr als einem Segment vorhanden ist, und dieses Feld erneut definiert oder berechnet werden muss, verwenden Sie den Befehl REDEFINES.
Wenn Sie einen DEFINE verwenden, der auf sich selbst verweist, wie x=x+1, wird AUTOPATH deaktiviert (Informationen hierzu finden Sie im Handbuch Reportanwendungen entwickeln ).
Feldnamen, die in der Formel verwendet werden, die das virtuelle Feld definiert, können nicht in einfache oder doppelte Anführungszeichen gesetzt werden. Alle Zeichenfolgen in Anführungszeichen werden als literale Zeichenfolgen und nicht als Feldverweise behandelt.
Ein DEFINE FILE-Befehl überschreibt einen DEFINE in der Masterdatei mit demselben Namen, wenn Sie das Format nicht neu definieren (was nicht erlaubt ist).

Syntax: Ein virtuelles Feld erstellen

Bevor Sie eine Reportanfrage anfangen, nehmen Sie Folgendes auf

DEFINE FILE filename[.view_fieldname] [CLEAR|ADD]  
fieldname[/format] [TITLE 'line1[,line2 ...']
 [DESCRIPTION 'description']=expression; 
fieldname[/format][WITH realfield]=expression; 
fieldname[/format] REDEFINES qualifier.fieldname=expression;
.
.
.
END

Hierbei gilt:

filename

Ist der Name der Datenquelle, für die Sie das virtuelle Feld definieren.

Falls die Reportanfrage eine alternative Ansicht hat, verwenden Sie filename mit view_fieldname.

Alle Felder, die verwendet werden, um das virtuelle Feld zu definieren, müssen sich auf nur einem Pfad in der Datenquelle befinden. Wenn dies nicht der Fall ist, können Sie die alternative Ansicht verwenden, welche DEFINE-Befehle für die alternative Ansicht erfordert. Für eine alternative Ansicht können virtuelle Felder keine qualifizierten Feldnamen haben. Weitere Informationen über alternative Ansichten finden Sie unter Eine Datenstruktur für verbesserten Abruf rotieren.

Die Befehlszeile DEFINE FILE muss sich auf einer anderen Zeile befinden als ihre virtuellen Felddefinitionen.

view_fieldname

Ist das Feld, auf dem eine alternative Ansicht in der entsprechenden Anfrage basiert. Es kann sein, dass Sie eine alternative Ansicht verwenden müssen, wenn sich die verwendeten Felder nicht auf nur einem Pfad in der normalen Ansicht befinden.

CLEAR

Löscht zuvor definierte virtuelle Felder, die mit der angegebenen Datenquelle assoziiert sind. CLEAR ist der Defaultwert.

ADD

Ermöglicht es Ihnen, zusätzliche virtuelle Felder für eine Datenquelle anzugeben, ohne bereits vorhandene virtuelle Felder freizugeben. Wenn Sie ADD weglassen, führt dies zu denselben Ergebnissen wie die Option CLEAR.

fieldname

Ist ein Name, der die WebFOCUS-Regeln für die Benennung von Feldern einhält. Indizierte Feldnamen in FOCUS-Datenquellen müssen kleiner oder gleich 12 Zeichen sein. Es kann der Name eines neuen virtuellen Feldes sein, das Sie definieren, oder ein vorhandenes in der Masterdatei festgelegtes Feld, das Sie neu definieren möchten.

Der Name kann eine beliebige Kombination aus Buchstaben, Ziffern und Unterstrichen (_) sein, und sollte mit einem Buchstaben anfangen.

Verwenden Sie keine Feldnamen des Typs Cn, En oder Xn (wobei n jede Sequenz aus zwei Ziffern ist), da diese für andere Verwendungen vorgesehen sind.

Format

Ist das Format des Feldes. Der Defaultwert ist D12.2. Informationen über Feldformate finden Sie im Handbuch Daten mit der WebFOCUS-Sprache beschreiben .

WITH realfield

Assoziiert ein virtuelles Feld mit einem Datenquellensegment, das ein reales Feld enthält. Details finden Sie in Verwendungshinweise für die Erstellung von virtuellen Feldern.

line1, line2...

Sind die Default-Spaltentitelzeilen, die für ein virtuelles Feld angezeigt werden sollen, es sei denn dies wird von einer AS-Phrase überschrieben.

description

Ist die Beschreibung, die mit dem virtuellen Feld assoziiert werden soll. Die Beschreibung wird in den Tools angezeigt, die Masterdateien durchsuchen.

REDEFINES qualifier.fieldname

Ermöglicht es Ihnen, ein Feld neu zu definieren oder ein Feld, dessen Name bereits in mehr als einem Segment besteht, neu zu berechnen. Wenn Sie das Format des Feldes ändern, wenn Sie es neu definieren, muss die Länge im neuen Format identisch oder kürzer sein als das Original. Zusätzlich wird die Umwandlung zwischen alphanumerischen und numerischen Datentypen nicht unterstützt.

expression

Kann eine arithmetische oder logische Formel oder Funktion sein, die verwendet wird, um den Wert von fieldname auszuwerten (siehe auch Formeln verwenden). Sie müssen jede Formel mit einem Semikolon beenden, außer der letzten, bei der das Semikolon optional ist.

Felder in der Formel können reale Datenfelder sein, Datenfelder in Datenquellen, die querverwiesen oder verbunden sind, oder zuvor definierte virtuelle Felder. Details finden Sie in Verwendungshinweise für die Erstellung von virtuellen Feldern.

END

Ist erforderlich, um den Befehl DEFINE FILE zu beenden. END muss sich in einer separaten Zeile in der Prozedur befinden.

Hinweis: Informationen über fehlende Attribute finden Sie unter Das MISSING-Attribut in einem DEFINE- oder COMPUTE-Befehl.