Eigenschaften für Projektmethoden

Nachdem Sie eine Projektmethode erstellt haben, können Sie diese umbenennen und ihre Eigenschaften ändern. Das sind hauptsächlich Zugriffsrechte und Sicherheitsbedingungen: Benutzerzugriff sowie Zugriff über den Web Server und Web Services.

Die anderen Methodenarten haben keine spezifischen Eigenschaften. Ihre Eigenschaften sind mit denen der dazugehörigen Objekte verbunden.

Um die Eigenschaften einer Projektmethode zu ändern:

1. Wählen Sie im Methodeneditor im Menü Methode den Befehl Methoden-Eigenschaften
   ODER
   Klicken Sie im 4D Explorer auf der Seite Methoden mit der rechten Maustaste auf eine Projektmethode und wählen dann im Kontextmenü den Eintrag Methodenauswahl-Eigenschaften. Sie können diesen Eintrag auch im Menü Optionen am unteren Rand aufrufen. Auf dem Bildschirm erscheint folgendes Dialogfenster:
   

Hinweis: Über die Funktion Methodenauswahl-Eigenschaften können Sie eine Eigenschaft auch für alle oder Teile von Projektmethoden der Datenbank in einer Operation ändern (siehe Methodeneigenschaften als Gruppe bearbeiten).

Sie können den Namen einer Projektmethode im Bereich "Name" des Fensters Methode-Eigenschaften oder im Explorer ändern.

Der neue Name muss die 4D Namensregeln beachten (siehe Handbuch 4D Programmiersprache unter Konventionen). Wenn bereits eine Methode mit gleichem Namen besteht, zeigt 4D eine Meldung, dass dieser Methodenname bereits verwendet wurde. 4D sortiert bei Bedarf die Liste der Methoden neu.

Warnung: Ändern Sie den Namen einer Methode, die in der Datenbank bereits verwendet wird, kann das sämtliche Methoden oder Formeln ungültig machen, die den alten Methodennamen verwenden, was zu einer Störung in der Funktionsweise der Anwendung führen kann. Sie können die Methode manuell umbenennen, wir raten aber dringend, die Funktion zum Umbenennen für Projektmethoden zu verwenden. Weitere Informationen dazu finden Sie im Abschnitt Umbenennen. Auf diese Weise können Sie den Namen überall da, wo die Methode in der Designumgebung aufgerufen wird, automatisch aktualisieren.

Hinweis zu 4D Server: Der Name der Methode wird auf dem Server geändert, sobald Sie die Bearbeitung des Namens abgeschlossen haben. Wenn mehr als ein Benutzer gleichzeitig den Methodennamen ändern, wird der vom letzten Benutzer bearbeitete Name der neue Name.
Sie können Benutzer für Methoden festlegen, damit nur diese Benutzer den Namen der Methode ändern können.

Hinweis: Datenbank-Methoden können Sie nicht umbenennen. Dasselbe gilt für Trigger, Formularmethoden und Objektmethoden, denn sie sind an Objekte gebunden und erhalten ihre Namen vom Objekt.

Sie können den Zugang zu Methoden regeln, indem Sie Zugriffs- und Eigentumsrechte für Benutzergruppen festlegen. Weitere Informationen dazu finden Sie im Kapitel Benutzer und Gruppen.

• Die Dropdown-Liste für Zugriff regelt, welche Gruppe die Methode im Anwendungsmodus ausführen kann. Versucht ein Benutzer, der nicht zu dieser Gruppe gehört, die Methode auszuführen, zeigt 4D eine Meldung, dass das Kennwort des Benutzers die Ausführung der Methode nicht zulässt.
• Die Dropdown-Liste der Benutzer regelt, welche Gruppe die Methode im Designmodus bearbeiten kann. Versucht ein Benutzer, der nicht zu dieser Gruppe gehört, die Methode im Designmodus zu bearbeiten, zeigt 4D eine Meldung, dass der Benutzer nicht berechtigt ist, diese Methode zu bearbeiten.

Benutzer, die zu beiden Gruppen gehören, können die Methode ohne Einschränkung verwenden und ändern.

Über Eigenschaften können Sie steuern, wie Projektmethoden verwendet bzw. in verschiedenen Kontexten aufgerufen werden. Über den Explorer können Sie Eigenschaften auch für die gesamte Auswahl von Projektmethoden setzen (siehe nächster Abschnitt).

Über den Menübefehl Start > Methode können Benutzer Projektmethoden auslösen. Um das zu verhindern, markieren Sie im Dialogfenster Methode-Eigenschaften die Eigenschaft Unsichtbar. Eine ausgeblendete Methode erscheint nicht mehr im Dialogfenster Methode Ausführen (siehe Abschnitt Über das Fenster Methode ausführen). 

Wenn Sie eine Projektmethode ausblenden, steht sie für Programmierer der Datenbank weiterhin zur Verfügung. Sie verbleibt in der Liste auf der Seite Formulare des Explorer und in der Routinenliste des Methodeneditors.

Diese Option verstärkt die Sicherheit des 4D Web Server: Ist sie inaktiv, kann die Projektmethode nicht über eine HTTP Anfrage ausgeführt werden, wenn sie das spezielle URL 4DACTION, (sowie das frühere URL 4DMETHOD) zum Aufrufen von 4D Methoden enthält, bzw. die speziellen Tags 4DSCRIPT, 4DTEXT und 4DHTML. Weitere Informationen dazu finden Sie im Handbuch 4D Programmiersprache unter URLs und Form Actions und 4D HTML Tags.

Im Explorer sind Projektmethoden mIt diesem Attribut mit dem Icon gekennzeichnet.

Aus Sicherheitsgründen ist diese Option standardmäßig inaktiv. Sie müssen Methoden, die über spezielle Web URLs oder Tags ausführbar sind, einzeln angeben.

Mit dieser Option können Sie die aktuelle Methode über eine SOAP Anfrage als Web Service veröffentlichen. Weitere Informationen dazu finden Sie im Kapitel Web Services publizieren und einsetzen. Ist diese Option markiert, ist auch die Option Anbieten per WSDL aktiv.

Im Explorer sind Projektmethoden, die als Web Service angeboten werden, mit dem Icon gekennzeichnet.

Hinweis: Sie können eine Methode nicht als Web Service veröffentlichen, wenn ihr Name Zeichen enthält, die nicht mit der XML Nomenklatur kompatibel sind (z.B. Leerzeichen). In diesem Fall weist 4D die Eigenschaft nicht zu.

Dieses Attribut ist nur verfügbar, wenn die Option "Zugang per Web Service" markiert ist. Damit können Sie die aktuelle Methode in die WSDL-Datei von 4D einfügen. Weitere Informationen dazu finden Sie im Abschnitt WSDL erzeugen. 

Im Explorer sind Projektmethoden, die als Web Service und im WSDL angeboten werden, mit dem Icon gekennzeichnet. 

Diese Option wird im Rahmen von Komponenten verwendet. Ist sie markiert, gibt sie an, dass die Methode für Komponenten verfügbar ist, wenn die Anwendung als Host Datenbank verwendet wird und umgekehrt für Host Datenbanken, wenn die Anwendung als Komponente verwendet wird.

Weitere Informationen zu Komponenten finden Sie im Kapitel 4D Komponenten entwickeln und installieren.

Mit dieser Option lässt sich die Projektmethode mit der SQL Engine von 4D ausführen. Sie ist standardmäßig nicht gewählt, d.h. 4D Projektmethoden sind geschützt und können nicht von der SQL Engine von 4D aufgerufen werden - außer sie wurden explizit autorisiert.

Diese Eigenschaft gilt für alle internen und externen SQL Anfragen - ausgeführt über den ODBC Treiber, zwischen den 4D Tags Begin SQL/End SQL oder den 4D Befehl QUERY BY SQL.

Hinweise:

• Auch wenn eine Methode das Attribut „Zugang per SQL“ hat, werden zum Ausführen der Methode die Zugriffsrechte, die in den Datenbank-Eigenschaften und Methodeneigenschaften gesetzt sind, berücksichtigt.
• Die ODBC-Funktion SQLProcedure gibt nur Projektmethoden mit dem Attribut „Zugang per SQL“ zurück.

Weitere Informationen dazu finden Sie im Handbuch 4D SQL Reference unter Principles for integrating 4D and the 4D SQL engine.

Diese Eigenschaft wird nur für eine 4D Anwendung im Client/Server Modus berücksichtigt. Ist die Option markiert, wird die Projektmethode immer auf dem Server ausgeführt, unabhängig wie sie aufgerufen wird.
Weitere Informationen dazu finden Sie im 4D Server Handbuch im Abschnitt Attribut Auf Server ausführen.

Diese Option definiert, dass die Methode als Teil eines 4D Mobile Links mit einem Wakanda Server verfügbar und gültig ist.

Weitere Informationen dazu finden Sie im Abschnitt Die 4D Datenbank konfigurieren des Handbuchs 4D Mobile.

Über das Dialogfenster "Eigenschaften für Methoden" können Sie Eigenschaften, wie Unsichtbar, Zugang per Web Service, etc., für alle oder Teile der Projektmethoden in der Datenbank in einer einzigen Operation zuweisen. Das ist besonders hilfreich, um Eigenschaften in einer großen Anzahl Projektmethoden zu ändern. Die Funktionalität eignet sich auch, um in der Entwicklungsphase rasch gängige Eigenschaften auf Gruppen mit ähnlichen Methoden anzuwenden.

Um Methoden-Eigenschaften zu setzen:

1. Klicken Sie im Explorer auf der Seite Methoden mit der rechten Maustaste auf eine Projektmethode und wählen dann im Kontextmenü den Befehl Methodenauswahl-Eigenschaften.
   
   
   Auf dem Bildschirm erscheint folgendes Dialogfenster:
   
2. Geben Sie im Bereich “Ändere Eigenschaften für Methoden” eine Zeichenfolge ein, um die Methoden zu bestimmen, die Sie als Gruppe ändern wollen. Diese Zeichenfolge dient als Suchkriterium für Methodennamen. Zur Unterstützung können Sie den Joker @ verwenden:
   
   • Setzen Sie für Methodennamen, die beginnen mit… den Joker @ an das Ende der Zeichenfolge, zum Beispiel web@
   • Setzen Sie für Methodennamen, die enthalten..., den Joker @ innerhalb der Zeichenfolge, z.B. web@write
   • Setzen Sie für Methodennamen, die enden mit..., den Joker @ an den Anfang der Zeichenkette, z.B. @write
   • Setzen Sie für alle Methoden allein den Joker @ in den Bereich.
     Hinweise:
     
     • Die Suche achtet nicht auf Klein- und Großschreibung.
     • Sie können auch mehrere Joker @ in der Zeichenfolge eingeben, z.B. dtro_@web@pro.@
3. Wählen Sie im Bereich “Bearbeite Eigenschaften” eine Eigenschaft aus der DropDown-Liste und markieren dann das Optionsfeld Wahr bzw. Falsch.
   Hinweis: Hat die Eigenschaft “Anbieten als WSDL” den Wert Wahr, wird sie nur auf die Projektmethoden angewandt, die bereits die Eigenschaft “Zugang per Web Service” enthalten.
4. Klicken Sie auf die Schaltfläche Anwenden.
   Die Änderung wird sofort für alle Projektmethoden ausgeführt, die mit der definierten Zeichenfolge beginnen.