Start > Referenz > Funktionen > Statusfunktionen

Statusfunktionen

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 dazu, wie Funktionen auf Host und Client unterschiedlich ausgewertet werden, suchen Sie in der FileMaker Knowledge Base unter http://filemaker-de.custhelp.com.

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

 

Funktion	Ergebnis
Hole ( KontoErweiterteZugriffsrechte )	Liste aller Schlüsselwörter für die aktivierten erweiterten Zugriffsrechte, getrennt durch Absatzende-Zeichen. Die zurückgegebene Liste basiert auf dem Konto, das zum Öffnen der Datenbankdatei verwendet wurde.
Hole ( Kontoname )	Der authentifizierte Kontoname, der für die aktive Datenbankdatei verwendet wird
Hole ( KontoBerechtigungenName )	Name der Berechtigung, die das aktuelle Konto zum Öffnen der Datenbankdatei verwendet
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 ( AktiveAusschnittZeilenNr )	Nummer der Ausschnittzeile, die aktiv ist
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 ( FormatierungsleisteZulassenStatus )	Boolescher Wert, der angibt, ob die Anzeige der Formatierungsleiste zulässig ist
Hole ( ProgrammSprache )	Text, der die aktuelle Programmsprache angibt (z. B. Deutsch)
Hole ( ProgrammVersion )	Text, der die FileMaker-Programmversion angibt
Hole ( FormelWiederholungNr )	Zahl, die die Wiederholung des Formelfelds angibt, die gerade berechnet wird
Hole ( VerbindungsAttribute )	Der Name des Hosts der aktuellen Datei und der Name der Zertifizierungsstelle, die das verwendete SSL-Zertifikat zur Sicherung der Verbindung ausgestellt hat
Hole ( Verbindungsstatus )	Zahl, die den Sicherheitsstatus der Netzwerkverbindung für die aktuelle Datei anzeigt
Hole ( SystemDatum )	Das aktuelle Datum gemäß dem Systemkalender
Hole ( AktuelleErweiterteZugriffsrechte )	Liste der Schlüsselwörter für die aktivierten erweiterten Zugriffsrechte des Kontos, das zum Berechnen der Formel verwendet wird
Hole ( HostZeitstempel )	Aktuelles Datum und Uhrzeit (sekundengenau) gemäß der Systemuhr des Hosts
Hole ( AktuelleBerechtigungenName )	Name der Berechtigung, die zum Berechnen dieser Formel in der Datenbank verwendet wird
Hole ( SystemUhrzeit )	Aktuelle Uhrzeit (sekundengenau) gemäß der Systemuhr
Hole ( SystemZeitstempel )	Aktuelles Datum und Uhrzeit (sekundengenau) gemäß der Systemuhr
Hole ( SystemUhrzeitUTCMillisekunden )	Die aktuelle Uhrzeit in UTC (Coordinated Universal Time) bis auf die nächste Millisekunde
Hole ( AngepasstenMenüsetName )	Name des aktiven angepassten Menüsets
Hole ( DesktopPfad )	Pfad zum Desktop-Ordner des aktuellen Benutzers
Hole ( Gerät )	Eine Nummer, die den Computertyp oder den iOS-Gerätetyp identifiziert, auf dem aktuell ein FileMaker-Produkt ausgeführt wird
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 ( Verschlüsselungsstatus )	Wert, der den aktuellen Verschlüsselungsstatus angibt
Hole ( FehleraufzeichnungAktivStatus )	Boolescher Wert, der den Status des Scriptschritts Fehleraufzeichnung setzen angibt
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 ( InstallierteFMPlugins )	Der Anzeigename, die Versionsnummer (sofern vorhanden) und der aktivierte Zustand installierter Plugins
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 "Sicherheit 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 ( GeänderteFelder )	Liste der Felder, die im aktuellen Datensatz der aktuellen Tabelle geändert wurden
Hole ( DateiMehrbenutzerstatus )	Zahl, die den aktuellen Mehrbenutzerstatus der Datenbankdatei angibt
Hole ( Netzwerkprotokoll )	Name des Netzwerkprotokolls, das FileMaker Pro auf diesem Rechner verwendet
Hole ( Netzwerktyp )	Eine Zahl, die den Netzwerktyp angibt, über das FileMaker Pro auf die Datei zugreift, die das aktuelle Script ausführt.
Hole ( Seitennummer )	Nummer der aktuellen Seite, die gerade gedruckt oder in der Seitenansicht angezeigt wird
Hole ( PersistentID )	Text, der einen eindeutigen Bezeichner des Computers oder Geräts anzeigt, auf dem FileMaker ausgeführt wird
Hole ( EinstellungenPfad )	Pfad zum Einstellungen-Ordner (Preferences) des aktuellen Benutzers
Hole ( Druckername )	Zeichenfolge, die den Standarddruckernamen angibt
Hole ( SchnellsucheText )	Der Text, der in das Feld "Schnellsuche" eingegeben wurde
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 Punkte, die vertikal an dem Bildschirm angezeigt werden, an dem das Fenster der aktuellen Datei geöffnet ist
Hole ( Bildschirmbreite )	Anzahl der Punkte, die horizontal an dem Bildschirm angezeigt werden, an dem das Fenster der aktuellen Datei geöffnet ist
Hole ( ScriptAnimationStatus )	Zahl, die angibt, ob Animationen für das aktuell ausgeführte Script aktiviert sind
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 (OS X), 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 ( TriggerAktuellerBereich )	Die Indexnummer und der Objektname des Registerfelds oder Seitenbereichs, von dem aus bei aktiviertem Script-Trigger BeiBereichswechsel umgeschaltet wird
Hole ( TriggerGestenInfo )	Details über die Geste, die den Script-Trigger BeiGesteTippen aktiviert hat
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 ( TriggerZielbereich )	Die Indexnummer und der Objektname des Registerfelds oder Seitenbereichs, zu dem bei aktiviertem Script-Trigger BeiBereichswechsel umgeschaltet wird
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 ( UUID )	Text, der einen Universally Unique Identifier (UUID) angibt
Hole ( FensterInhaltHöhe )	Höhe des FileMaker Pro-Inhaltsbereichs in Punkt
Hole ( FensterInhaltBreite )	Breite des FileMaker Pro-Inhaltsbereichs in Punkt
Hole ( FensterSchreibtischHöhe )	Höhe des Desktopbereichs in Punkt
Hole ( FensterSchreibtischBreite )	Breite des Desktopbereichs in Punkt
Hole ( Fensterhöhe )	Höhe in Punkt für das Fenster, das vom Script beeinflusst wird (nicht notwendigerweise das Vordergrundfenster).
Hole ( FensterLinks )	Horizontaler Abstand von der Außenkante des aktuellen Fensters, das das Script beeinflusst, in Relation zur linken Bildschirmkante (nicht notwendigerweise das Vordergrundfenster)
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 ( Fensterausrichtung )	Zahl, die die Ausrichtung des Fensters angibt, das vom aktuellen Script beeinflusst wird.
Hole ( Fensterstil )	Zahl, die angibt, ob das oberste geöffnete Fenster ein Dokumentfenster, ein schwebendes Dokumentfenster oder ein Dialogfenster ist
Hole ( FensterOben )	Vertikaler Abstand von der Außenkante des aktuellen Fensters, das das Script beeinflusst, in Relation zur unteren Kante der Menüleiste (nicht notwendigerweise das Vordergrundfenster).
Hole ( FensterSichtbar )	Boolescher Wert, der angibt, ob das aktuelle Fenster sichtbar ist
Hole ( Fensterbreite )	Breite in Punkt für das Fenster, das vom Script beeinflusst wird (nicht notwendigerweise das Vordergrundfenster).
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 ( Letzte Meldungswahl )=1]

      Alle Scripts abbrechen

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

      Gehe zu Layout ["Mahnung"]

      Drucken []

    Sonst

      E-Mail 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 (Ende)

Gehe zu Layout [Originallayout]

Weiterführende Themen 

Erläuterung von Funktionen

Über Formeln