Start > Referenz > Funktionen > Hole-Funktionen

Hole-Funktionen

Verwenden Sie Statusfunktionen in Scripts zur Fehlerprüfung und -vermeidung oder zur Erfassung von Informationen über den Status einer Datenbankdatei oder darin enthaltener Elemente oder über eine Aktion, die ausgeführt wird.

Viele Statusfunktionen geben Informationen zurück, die sich regelmäßig ändern. Wenn z. B. die Funktion "Hole ( SystemUhrzeit )" in ein gespeichertes Formelfeld aufgenommen wird, wird die Zeit nur aktualisiert, wenn ein neuer Datensatz erstellt wird. Wenn die Formel andere Felder enthält, aber das Formelergebnis dennoch die Systemzeit zurückgibt, wird das gespeicherte Formelergebnis nur aktualisiert, wenn diese anderen Felder im aktuellen Datensatz geändert wurden. Wenn eine dieser Formeln ungespeichert ist, wird die Zeit bei Bedarf aktualisiert. Aus Gründen der Verarbeitungsgeschwindigkeit ist die Erstellung eines ungespeicherten Formelfelds nicht immer die beste Wahl. Statusfunktionen werden am besten in einem Script verwendet, wo die Statusinformationen aus einer Statusfunktion in dem Moment aktuell sind, in dem das Script ausgeführt wird.

Um im Dialogfeld "Formel angeben" auf die Liste der Statusfunktionen zuzugreifen, wählen Sie Alle Funktionen nach Typ oder Statusfunktionen. Wenn Sie alle Funktionen nach Name anzeigen, sehen Sie nur "Hole ( Statusmarke )".

Hinweis  Informationen darüber, wie Funktionen auf Host und Clients unterschiedlich ausgewertet werden, suchen Sie in der FileMaker Knowledge Base unter www.filemaker.com/kb.

Klicken Sie auf den Namen einer Funktion, um Details anzuzeigen.

 

Funktion	Liefert den Wert
Hole ( Kontoname )	Der authentifizierte Kontoname, der für die aktive Datenbankdatei verwendet wird
Hole ( AktivesFeldInhalt )	Inhalt des Felds, das aktiv ist
Hole ( AktivesFeldName )	Name des Felds, das aktiv ist
Hole ( AktivesFeldTabellenName )	Name der Tabelle, die das aktive Feld enthält
Hole ( AktivesLayoutobjektName )	Der Name des aktiven Layoutobjekts im aktiven Fenster der Formel
Hole ( SonderTastenGedrückt )	Nummer zur Identifizierung der Änderungstasten auf der Tastatur (z. B. Umschalttaste), die gedrückt werden
Hole ( AktivesFeldWiederholungNr )	Gibt eine Zahl zur Identifizierung der aktiven Wiederholung eines Wiederholfelds zurück (die Wiederholung, die aktiv ist).
Hole ( AktiveTextAuswahlGröße )	Zahl, die angibt, wie viele Zeichen ausgewählt sind
Hole ( AktiveTextAuswahlStart )	Nummer, die das Anfangszeichen des ausgewählten Texts identifiziert
Hole ( AnwenderAbbruchZulassenStatus )	Boolescher Wert, der den aktuellen Status des Scriptschritts AnwenderAbbruchZulassen setzen angibt
Hole ( WerkzeugleistenZulassenStatus )	Boolescher Wert, der angibt, ob die Anzeige von Werkzeugleisten zulässig ist
Hole ( ProgrammSprache )	Text, der die aktuelle Programmsprache angibt (z. B. Deutsch)
Hole ( ProgrammVersion )	Text, der die FileMaker Pro-Programmversion angibt
Hole ( FormelWiederholungNr )	Zahl, die die Wiederholung des Formelfelds angibt, die gerade berechnet wird
Hole ( SystemDatum )	Das aktuelle Datum gemäß dem Systemkalender
Hole ( HostZeitstempel )	Aktuelles Datum und Uhrzeit (sekundengenau) gemäß der Systemuhr des Hosts
Hole ( SystemUhrzeit )	Aktuelle Uhrzeit (sekundengenau) gemäß der Systemuhr
Hole ( SystemZeitstempel )	Aktuelles Datum und Uhrzeit (sekundengenau) gemäß der Systemuhr
Hole ( AngepasstenMenüsetName )	Name des aktiven angepassten Menüsets
Hole ( DesktopPfad )	Pfad zum Desktop-Ordner des aktuellen Benutzers
Hole ( DokumentenPfad )	Pfad zum Dokumente-Ordner des aktuellen Benutzers
Hole ( DokumentePfadListe )	Eine Liste aller Dateien und Ordner im Dokumente-Ordner, den die Funktion "Hole (DokumentenPfad) " zurückgibt.
Hole ( FehleraufzeichnungAktivStatus )	Boolescher Wert, der den Status des Scriptschritts Fehleraufzeichnung setzen angibt
Hole ( DateiBerechtigungenErweitert )	Liste aller Schlüsselwörter für die aktivierten erweiterten Zugriffsrechte, getrennt durch Absatzende-Zeichen
Hole ( FileMakerPfad )	Pfad zum Ordner, der die aktuell ausgeführte Kopie von FileMaker Pro enthält
Hole ( DateiName )	Name der derzeit aktiven Datenbankdatei
Hole ( DateiPfad )	Vollständiger Pfad zum Speicherort der Datei
Hole ( DateiGrößeBytes )	Größe (in Byte) der derzeit aktiven Datenbankdatei
Hole ( AnzahlGefundeneDatensätze )	Zahl, die die Anzahl der Datensätze in der aktuellen Ergebnismenge angibt
Hole ( HoherKontrastFarbe )	Name des aktuellen Standard-Farbschemas, wenn Kontrast aktivieren im Dialogfeld "Eingabehilfen" des Windows-Betriebssystems aktiviert ist
Hole ( HoherKontrastStatus )	Boolescher Wert, der den Zustand des Kontrollkästchens Kontrast aktivieren im Dialogfeld "Eingabehilfen" darstellt.
Hole ( HostAnwendungVersion )	Die Version von FileMaker Pro oder FileMaker Server, die auf dem Computer läuft, der die aktuelle Datenbank bereitstellt
Hole ( HostIPAdresse )	IP-Adresse des Host-Rechners für die aktuelle Datenbank
Hole ( HostName )	Der registrierte Name des Computers, der die Datenbankdatei bereitstellt
Hole ( LetzteFehlerNr )	Zahl, die die Nummer des Fehlers (falls vorhanden) bei der Ausführung des letzten Scriptschritts darstellt
Hole ( LetzteMeldungswahl )	Zahl, die der Schaltfläche entspricht, auf die in einer Warnmeldung geklickt wurde, die durch den Scriptschritt "Eigenes Dialogfeld anzeigen" angezeigt wurde
Hole ( LetztenODBCFehler )	Zeichenfolge, die den Fehlerstatus zeigt, der durch ODBC-Standards, basierend auf ISO/IEF-Standards, veröffentlicht wurde
Hole ( LayoutBerechtigungen )	Eine Zahl, die den Layout-Zugriffsrechten entspricht, die im Dialogfeld "Konten und Zugriffsrechte verwalten" zugewiesen wurden
Hole ( DateiLayoutanzahl )	Gesamtanzahl der Layouts in der Datenbankdatei
Hole ( LayoutName )	Name des aktuell angezeigten Layouts
Hole ( LayoutNummer )	Nummer des aktuell angezeigten Layouts, wie im Dialogfeld "Layouts verwalten" festgelegt
Hole ( LayoutTabellenname )	Name der Tabelle, aus der das Layout Datensätze anzeigt
Hole ( LayoutAnzeigeAlsStatus )	Information darüber, wie die Datenbankdatei angezeigt wird
Hole ( DateiMehrbenutzerstatus )	Zahl, die den aktuellen Mehrbenutzerstatus der Datenbankdatei angibt
Hole ( Netzwerkprotokoll )	Name des Netzwerkprotokolls, das FileMaker Pro auf diesem Rechner verwendet
Hole ( Seitennummer )	Nummer der aktuellen Seite, die gerade gedruckt oder in der Seitenansicht angezeigt wird
Hole ( AusschnittZeileNr )	Nummer der Ausschnittzeile, die aktiv ist
Hole ( EinstellungenPfad )	Pfad zum Einstellungen-Ordner (Preferences) des aktuellen Benutzers
Hole ( Druckername )	Zeichenfolge, die den Standarddruckernamen angibt
Hole ( DateiBerechtigungen )	Name der Berechtigung, die der aktuelle Benutzer verwendet
Hole ( DatensatzBerechtigungen )	Zahl, die die Zugriffsrechte des aktuellen Datensatzes angibt
Hole ( DatensatzIDNr )	Eindeutige ID des aktuellen Datensatzes
Hole ( DatensatzÄnderungenAnzahl )	Die Gesamthäufigkeit der Änderungen am aktuellen Datensatz, die geschrieben wurden
Hole ( DatensatzPositionInErgebnismenge )	Nummer des aktuellen Datensatzes in der aktuellen Ergebnismenge
Hole ( DatensatzOffenAnzahl )	Die Gesamtzahl der geöffneten Datensätze in der aktuellen Ergebnismenge, die noch nicht gespeichert wurden
Hole ( DatensatzOffenStatus )	Zahl, die den Status des aktuellen Datensatzes angibt
Hole ( AnzahlAbfrageEinträge )	Gesamtanzahl der Suchabfragen, die derzeit für die aktuelle Tabelle definiert sind
Hole ( AbfrageAusschlussStatus )	Boolescher Wert, der den Status der Option Ohne im Suchenmodus angibt
Hole ( Bildschirmtiefe )	Anzahl der Bits, die zur Darstellung der Farbe oder Graustufe eines Pixels am Hauptbildschirm erforderlich sind
Hole ( Bildschirmhöhe )	Anzahl der Pixel, die vertikal an dem Bildschirm angezeigt werden, an dem das Fenster der aktuellen Datei geöffnet ist
Hole ( Bildschirmbreite )	Anzahl der Pixel, die horizontal an dem Bildschirm angezeigt werden, an dem das Fenster der aktuellen Datei geöffnet ist
Hole ( ScriptName )	Name des Scripts, das gerade ausgeführt wird oder unterbrochen ist
Hole ( ScriptParameter )	Der Scriptparameter, der an das aktuelle Script übergeben wird
Hole ( ScriptErgebnis )	Scriptergebnis aus einem ausgeführten Teilscript
Hole ( Sortierstatus )	Zahlenwert, der den aktuellen Sortierstatus angibt
Hole ( StatusbereichSichtbarStatus )	Zahl, die angibt, ob die Statussymbolleiste ausgeblendet, sichtbar, sichtbar und fixiert oder ausgeblendet und fixiert ist
Hole ( SystemLaufwerk )	Laufwerksbuchstabe (Windows) oder Volumename (Mac OS), auf dem sich das aktuell ausgeführte Betriebssystem befindet
Hole ( SystemIPAdresse )	Die IP-Adressen aller Rechner, die mit einer NIC-Karte (Network Interface Controller) verbunden sind
Hole ( SystemSprache )	Die Sprache, die auf dem aktuellen Betriebssystem eingestellt ist
Hole ( SystemNICAdresse )	Die Hardware-Adressen aller NIC-Karten, die mit dem Rechner verbunden sind
Hole ( SystemPlattform )	Zahl, die die aktuelle Plattform angibt
Hole ( SystemVersion )	Version des Betriebssystems des Rechners, auf dem die Funktion ausgeführt wird
Hole ( TemporärerPfad )	Der Pfad zum temporären Ordner des aktuellen Benutzers, den FileMaker Pro verwendet
Hole ( TextlinealSichtbar )	Boolescher Wert, der angibt, ob das Textlineal sichtbar ist
Hole ( AnzahlDatensätzeGesamt )	Gesamtanzahl der Datensätze in der aktuellen Tabelle
Hole ( TriggerTastendruck )	Zeichenkette, bestehend aus den Zeichen, die einen Script-Trigger BeiObjektTastendruck oder BeiLayoutTastendruck ausgelöst haben
Hole ( TriggerKurztasten )	Status der Änderungstasten auf der Tastatur bei Aktivierung des Script-Triggers
Hole ( AnzahlAktiveBenutzer )	Anzahl der Benutzer, die derzeit auf die Datei zugreifen
Hole ( ProgrammBenutzername )	Der Name des FileMaker Pro-Benutzers, wie im Register Allgemein im Dialogfeld "Einstellungen" angegeben
Hole ( SystemformateVerwendenStatus )	Boolescher Wert, der den Status des Menübefehls Systemformate verwenden angibt
Hole ( FensterInhaltHöhe )	Zahl, die die Höhe des Inhaltsbereichs in Pixel angibt
Hole ( FensterInhaltBreite )	Zahl, die die Breite des Inhaltsbereichs in Pixel angibt
Hole ( FensterSchreibtischHöhe )	Zahl, die die Höhe des Desktopbereichs in Pixel angibt
Hole ( FensterSchreibtischBreite )	Zahl, die die Breite des Desktopbereichs in Pixel angibt
Hole ( Fensterhöhe )	Zahl, die die aktuelle Fensterhöhe der Datei, in der die Formel definiert ist, in Pixel angibt
Hole ( FensterLinks )	Zahl, die den horizontalen Abstand von der Außenkante des aktuellen Fensters in Relation zur linken Bildschirmkante in Pixel angibt
Hole ( Fenstermodus )	Zahl, die angibt, ob FileMaker Pro im Blätternmodus, Suchenmodus oder Seitenansichtsmodus ist oder druckt, während die Funktion berechnet wird
Hole ( Fenstername )	Name des aktuellen Fensters der Datei, in der die Formel definiert ist
Hole ( FensterOben )	Zahl, die den vertikalen Abstand von der Außenkante des aktuellen Fensters in Relation zur unteren Kante der Menüleiste in Pixel angibt
Hole ( FensterSichtbar )	Boolescher Wert, der angibt, ob das aktuelle Fenster sichtbar ist
Hole ( Fensterbreite )	Zahl, die die aktuelle Fensterbreite der Datei, in der die Formel definiert ist, in Pixel angibt
Hole ( FensterZoomStufe )	Zoomstufe des aktuellen Fensters

Beispiel für Statusfunktionen

Dieses Script überprüft mit der Funktion Hole ( SystemDatum ) jeden Datensatz in der Ergebnismenge, um festzustellen, ob ein Zahlungseingang überfällig ist. Wenn ein Zahlungseingang überfällig ist, zeigt das Script eine Meldung an und fordert den Benutzer auf, auf die Schaltfläche "Ignorieren", "Brief senden" oder "E-Mail senden" zu klicken (die mit dem Scriptschritt "Eigenes Dialogfeld anzeigen" definiert wurde). Das Script erfasst die Antwort des Benutzers mithilfe von Hole ( LetzteMeldungswahl ). Dann führt das Script abhängig von der Antwort des Benutzers eine Aktion aus: Es bricht den Rest des Scripts ab, druckt einen "Mahnbrief" oder sendet eine E-Mail an den entsprechenden Kunden.

 

Gehe zu Layout ["LayoutName"]

Gehe zu Datens./Abfrage/Seite [Erster]

Schleife (Anfang)

  Wenn [Datenbankname::Datum < Hole(SystemDatum)-30]

    Eigenes Dialogfeld anzeigen ["30 oder mehr Tage überfällig"]

    Wenn [Hole ( LetzteMeldungswahl )=1]

      Alle Scripts abbrechen

    Sonst, wenn [Hole (Letzte Meldungswahl)=2]

      Gehe zu Layout ["Mahnung"]

      Drucken []

    Sonst

      EMail senden [An: Datenbankname::Kunde; Betreff: "Erinnerung"; Mitteilung: "Sie befinden sich im Verzug."]

    Ende (wenn)

  Ende (wenn)

  Gehe zu Datens./Abfrage/Seite [Nach letztem beenden; Nächster]

Schleife (Schluss)

Gehe zu Layout [Originallayout]