In 4D View Pro können Sie 4D Projektmethoden innerhalb Ihrer Formeln aufrufen und so die Möglichkeiten für Ihre 4D View Pro Dokumente erweitern. 4D Methoden können Parameter aus dem 4D View Pro Bereich empfangen und Werte zurückgeben. Aus Sicherheitsgründen lassen sich nur explizit zugelassene Methoden vom Benutzer aufrufen.

Damit sich eine Projektmethode in einer 4D View Pro Formel aufrufen lässt, muss sie folgende Anforderungen erfüllen:

• Referenziert: Sie muss explizit mit dem Befehl VP SET CUSTOM FUNCTIONS (empfohlen) oder VP SET ALLOWED METHODS deklariert sein.
• Ausführbar: Sie gehört zur Host Datenbank oder einer geladenen Komponente, für die die Option "Gemeinsam von Komponenten und Host benutzt" markiert ist (siehe Projektmethoden gemeinsam nutzen).
• Kein Konflikt mit einer vorhandenen 4D View Pro Funktion: Rufen Sie eine Projektmethode mit dem gleichen Namen wie eine Funktion in 4D View Pro auf, wird die Funktion aufgerufen.

Hinweis: Wurde weder VP SET CUSTOM FUNCTIONS noch VP SET ALLOWED METHODS während der Sitzung ausgeführt, beruhen die 4D View Pro eigenen Funktionen auf Methoden, die über den generischen 4D Befehl SET ALLOWED METHODS erlaubt sind. In diesem Fall müssen Namen der Projektmethoden die Regeln der JavaScript Identifier Grammar berücksichtigen (siehe ECMA Script standard). Die Option zum globalen Filtern auf der Seite "Sicherheit" der Datenbank-Eigenschaften wird in allen Fällen ignoriert. Weitere Informationen dazu finden Sie unter Zugriffskontrolle.

Über eine 4D Projektmethode "Hello World" in einer Zelle des 4D View Pro Bereichs drucken:

1. Die Projektmethode "myMethod" mit folgendem Code erstellen:
   
    #DECLARE->$hw Text
 $hw:="Hello World"
   
   
   
2. In der Formularmethode des Formulars mit dem 4D View Pro Bereich schreiben Sie:
   
    Case of
    :(Form event code=On Load)
       var $o : Object
       $o:=New object
  // Define "vpHello" function from the "myMethod" method
       $o.vpHello:=New object
       $o.vpHello.formula:=Formula(myMethod)
       VP SET CUSTOM FUNCTIONS("ViewProArea";$o)
 End case
   
   
   
3. Den Inhalt einer Zelle in einem 4D View Pro Bereich bearbeiten und eingeben:
   
   "myMethod" wird dann von 4D aufgerufen und die Zelle zeigt an:
   

Parameter lassen sich in 4D Projektmethoden mit folgender Syntax übergeben:

Diese Parameter werden in METHODNAME in $1, $2...$N empfangen.

Beachten Sie, dass ( ) zwingend sind, selbst wenn kein Parameter übergeben ist:

Sie können Name, Typ und Anzahl der Parameter über die Collection parameters der Funktion deklarieren, die mit dem Befehl VP SET CUSTOM FUNCTIONS oder VP SET ALLOWED METHODS angegeben ist. Optional können Sie über die Eigenschaften minParams und maxParams auch die Anzahl der vom Benutzer übergebenen Parameter steuern.

Deklarieren Sie keine Parameter, lassen sich Werte sequentiell an Methoden übergeben (sie werden in $1, $2... empfangen) und ihr Typ wird automatisch konvertiert. Datumsangaben in jstype werden als C_OBJECT in 4D Methoden mit zwei Eigenschaften übergeben:

4D Projektmethoden können via $0 auch Werte in der Formel innerhalb der 4D View Pro Zelle zurückgeben. Für zurückgegebene Parameter werden folgende Datentypen unterstützt:

• C_TEXT (wird in 4D View Pro in String umgewandelt)
• C_REAL/C_LONGINT (wird in 4D View Pro in Zahl umgewandelt)
• C_DATE (wird in 4D View Pro in JS Datumstyp umgewandelt - Stunde, Minute, Sek = 0)
• C_TIME (wird in 4D View Pro in JS Datumstyp umgewandelt - Datum als Basisdatum, z.B. 12/30/1899)
• C_BOOLEAN (wird in 4D View Pro in bool umgewandelt)
• C_PICTURE (jpg,png,gif,bmp,svg, andere Typen werden in png umgewandelt) erstellt uri (data:image/png;base64,xxxx) und nutzt es dann als Hintergrund in der Zelle in 4D View Pro, wo die Formel ausgeführt wird
• C_OBJECT mit den beiden folgenden Eigenschaften (zur Übergabe von Datum und Zeit):
  
  

  Eigenschaft	Typ	Beschreibung
  value	Datum	Wert für Datum
  time	Zahl	Zeit in Sekunden

Gibt die 4D Methode nichts zurück, wird automatisch ein leerer String zurückgegeben.

In der 4D View Pro Zelle wird ein Fehler zurückgegeben, wenn:

• die 4D Methode einen Typ zurückgibt, der nicht in obiger Liste angegeben ist,
• während Ausführen der 4D Methode ein Fehler auftritt (bei Benutzerklick auf die Schaltfläche "Abbrechen").