Referenz > Funktionen > Statusfunktionen
 

Statusfunktionen

Statusfunktionen überwachen Fehler in Scripts oder erfassen Informationen über den Dateistatus bzw. ausgeführte Aktionen.

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.

 

Funktion

Ergebnis

Hole ( KontoErweiterteZugriffsrechte )

Eine Liste von Schlüsselwörtern basierend auf dem zum Öffnen der Datei verwendeten Konto für die aktivierten erweiterten Zugriffsrechte.

Hole ( Kontogruppenname )

Gruppenname des aktuellen Kontos.

Hole ( Kontoname )

Der authentifizierte Kontoname, der vom aktuellen Benutzer der Datei verwendet wird.

Hole ( KontoBerechtigungenName )

Der Name der Berechtigung, die das zum Öffnen der Datei verwendete Konto nutzt.

Hole ( KontoTyp )

Authentifizierungstyp des aktuellen Kontos.

Hole ( AktivesFeldInhalt )

Der Inhalt des Felds, das ausgewählt ist.

Hole ( AktivesFeldName )

Name des Felds, das aktiv ist.

Hole ( AktivesFeldTabellenName )

Der Name des Tabellenauftretens, das das aktive Feld enthält.

Hole ( AktivesLayoutobjektName )

Der Name des Layoutobjekts, das im aktuellen Fenster der Formel aktiv ist.

Hole ( SonderTastenGedrückt )

Eine Zahl für die gedrückten Änderungstasten der Tastatur

Hole ( AktiveAusschnittZeileNr )

Gibt die Nummer der Ausschnittreihe zurück, die aktiv ist.

Hole ( AktiveDatensatznummer )

Eine Zahl, die die Position des aktiven Datensatzes in der Ergebnismenge repräsentiert.

Hole ( AktivesFeldWiederholungNr )

Eine Zahl, die die aktive Wiederholung in einem Wiederholfeld repräsentiert.

Hole ( AktiveTextAuswahlGröße )

Eine Zahl, die angibt, wie viele Zeichen ausgewählt sind.

Hole ( AktiveTextAuswahlStart )

Eine Nummer, die das Anfangszeichen des ausgewählten Texts identifiziert.

Hole ( AnwenderAbbruchZulassenStatus )

1 (wahr), wenn der Scriptschritt „AnwenderAbbruchZulassen setzen“ auf „Ein“ gesetzt ist, ansonsten 0 (falsch)

Hole ( FormatierungsleisteZulassenStatus )

1 (wahr), wenn die Formatierungsleiste sichtbar ist, ansonsten 0 (falsch)

Hole ( AnwendungArchitektur )

Die aktuelle Anwendungsarchitektur

Hole ( ProgrammSprache )

Text, der die aktuelle Programmsprache angibt.

Hole ( ProgrammVersion )

Produktname und Version eines FileMaker-Clients.

Hole ( FormelWiederholungNr )

Eine Zahl, die die Wiederholung des Formelfelds angibt, die gerade berechnet wird.

Hole ( VerbindungsAttribute )

Der Name des Hosts der aktuellen Datei und 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 )

Eine Liste von Schlüsselwörtern basierend auf dem zur Auswertung der Formel verwendeten Konto für die aktivierten erweiterten Zugriffsrechte

Hole ( HostZeitstempel )

Aktuelles Datum und Zeit (sekundengenau) gemäß der Systemuhr des Hosts

Hole ( AktuelleBerechtigungenName )

Name der Berechtigung, die zum Berechnen dieser Formel in der Datei verwendet wird.

Hole ( SystemUhrzeit )

Aktuelle Uhrzeit (sekundengenau) gemäß der Systemuhr

Hole ( SystemZeitstempel )

Aktuelles Datum und Zeit (sekundengenau) gemäß der Systemuhr

Hole ( SystemUhrzeitUTCMillisekunden )

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 )

Zahl, die dem Computertyp oder mobilen Gerät entspricht, auf dem das 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 )

1 (wahr), wenn der Scriptschritt „Fehleraufzeichnung setzen“ auf „Ein“ gesetzt ist, ansonsten 0 (falsch)

Hole ( FileMakerPfad )

Gibt den Pfad zum Ordner zurück, der die aktuell ausgeführte Kopie eines FileMaker-Produkts enthält.

Hole ( DateiName )

Name der aktuell aktiven Datei ohne Dateinamenerweiterung

Hole ( DateiPfad )

Der vollständige Pfad zum Speicherort der aktuell aktiven Datei

Hole ( DateiGrößeBytes )

Größe (in Byte) der derzeit aktiven Datei

Hole ( AnzahlGefundeneDatensätze )

Anzahl der Datensätze in der aktuellen Ergebnismenge

Hole ( HoherKontrastFarbe )

Name des aktuellen Standard-Farbschemas

Hole ( HoherKontrastStatus )

1 (wahr), wenn hoher Kontrast verfügbar und aktiv ist, ansonsten 0 (falsch)

Hole ( HostAnwendungVersion )

Produktname und Version des FileMaker-Hosts.

Hole ( HostIPAdresse )

IP-Adresse des Host-Rechners für die aktuelle Datei

Hole ( HostName )

Der registrierte Name des Computers, der die Datei bereitstellt.

Hole ( InstallierteFMPlugins )

Der Name, die Versionsnummer und der aktivierte Zustand installierter Plugins

Hole ( LetzteFehlerNr )

Zahl, die die Nummer des Fehlers bei der Ausführung des letzten Scriptschritts darstellt.

Hole ( LetzteExterneFehlerNrDetail )

Text zu FileMaker-externen Fehlern, die von Hole ( LetzteFehlerNr ) zurückgegeben wurden.

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 ( LayoutBerechtigungen )

Zahl auf der Basis von Zugriffsrechten für Datensätze, die über das aktuelle Layout zur Verfügung stehen.

Hole ( DateiLayoutanzahl )

Gesamtanzahl der Layouts in der Datei

Hole ( LayoutName )

Name des aktuell angezeigten Layouts

Hole ( LayoutNummer )

Zahl des Layouts (aus dem Dialogfeld „Layouts verwalten“), das aktuell angezeigt wird.

Hole ( LayoutTabellenname )

Name des Tabellenauftretens zurück, aus dem die Datensätze im aktuellen Layout angezeigt werden.

Hole ( LayoutAnzeigeAlsStatus )

Nummer für die derzeit aktive Ansicht der Datei

Hole ( MenüleisteStatus )

Zahl für den aktuellen Status der Menüleiste

Hole ( GeänderteFelder )

Liste der Felder, die im aktuellen Datensatz der aktuellen Tabelle geändert wurden.

Hole ( DateiMehrbenutzerstatus )

Zahl, die die Ebene der gemeinsamen Nutzung für die Datei mit FileMaker-Netzwerk angibt.

Hole ( Netzwerkprotokoll )

Name des Netzwerkprotokolls (TCP/IP), das FileMaker auf diesem Rechner verwendet.

Hole ( Netzwerktyp )

Zahl, die den Typ des verwendeten Netzwerks angibt, über das der Zugriff auf die aktuelle Datei erfolgt.

Hole ( OffeneDatenDateiInfo )

DateiID und Pfad jeder offenen Datendatei

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 )

Der Pfad zum Einstellungen- und Standardoptionen-Ordner des aktuellen Benutzers

Hole ( Druckername )

Text, der den Standarddruckernamen angibt.

Hole ( SchnellsucheText )

Der Text, der in das Feld „Schnellsuche“ eingegeben wurde.

Hole ( DatensatzBerechtigungen )

Eine Zahl, die die Zugriffsrechte für den aktuellen Datensatz angibt, die im Dialogfeld „Eigene Berechtigungen für Datensätze“ zugewiesen wurden.

Hole ( DatensatzIDNr )

Eindeutige ID des aktuellen Datensatzes

Hole ( DatensatzÄnderungenAnzahl )

Die Gesamthäufigkeit der Änderungen am aktuellen Datensatz, die geschrieben wurden.

Hole ( DatensatzPositionInErgebnismenge )

Eine Nummer, die die Datensatzposition in der Ergebnismenge angibt.

Hole ( DatensatzOffenAnzahl )

Gesamtzahl der geöffneten Datensätze in der aktuellen Ergebnismenge, die nicht gespeichert wurden.

Hole ( DatensatzOffenStatus )

Zahl, die den Status des aktuellen Datensatzes angibt.

Hole ( RegionsmonitorEvents )

Ereignisse, die dazu geführt haben, dass das im Scriptschritt „Regionsmonitor-Script konfigurieren“ angegebene Script ausgeführt wurde.

Hole ( AnzahlAbfrageEinträge )

Gesamtanzahl der Suchabfragen, die für die aktuelle Tabelle definiert sind.

Hole ( AbfrageAusschlussStatus )

1 (wahr), wenn „Ausschließen“ in der aktuellen Suchabfrage ausgewählt wurde, ansonsten 0 (falsch)

Hole ( Bildschirmtiefe )

Anzahl der Bits, die zur Darstellung der Farbe oder Graustufe eines Pixels am Hauptbildschirm erforderlich sind.

Hole ( Bildschirmhöhe )

Höhe des Bildschirms in Punkten, an dem das Fenster der aktuellen Datei geöffnet ist.

Hole ( DisplayAnzeigeFaktor )

Skalenfaktor des Bildschirms, an dem das Fenster der aktuellen Datei geöffnet ist.

Hole ( Bildschirmbreite )

Breite des Bildschirms in Punkten, an dem das Fenster der aktuellen Datei geöffnet ist.

Hole ( ScriptAnimationStatus )

1 (wahr), wenn Animationen für das aktuelle Script aktiviert sind, ansonsten 0 (falsch)

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 )

Wert, der den aktuellen Sortierstatus angibt.

Hole ( StatusbereichSichtbarStatus )

Zahl für den aktuellen Status der Statussymbolleiste

Hole ( SystemLaufwerk )

Der Laufwerksbuchstabe (Windows) oder Volumename (macOS), auf dem sich das aktuell ausgeführte Betriebssystem befindet.

Hole ( SystemIPAdresse )

Liste der IP-Adressen aller Rechner, die mit einer aktiven 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 der aktuellen Plattform entspricht.

Hole ( SystemVersion )

Version des aktuellen Betriebssystems

Hole ( TemporärerPfad )

Gibt den Pfad zum aktuellen temporären FileMaker-Ordner zurück.

Hole ( TextlinealSichtbar )

1 (wahr), wenn das Textlineal angezeigt wird, ansonsten 0 (falsch)

Hole ( AnzahlDatensätzeGesamt )

Gesamtanzahl der Datensätze in der aktuellen Tabelle

Hole ( TouchTastaturStatus )

1 (wahr), wenn die Touch-Tastatur so eingestellt ist, dass sie bei Bedarf automatisch angezeigt wird, ansonsten 0 (falsch)

Hole ( TriggerAktuellerBereich )

Indexnummer und Objektname des Registerbereichs, von dem aus bei aktiviertem Script-Trigger „BeiBereichswechsel“ umgeschaltet wird.

Hole ( TriggerExternesEreignis )

Zahl, die dem Ereignis entspricht, das den Script-Trigger „BeiExternerBefehlErhalten“ aktiviert hat.

Hole ( TriggerGestenInfo )

Details über die Geste, die den Script-Trigger „BeiGesteTippen“ aktiviert hat.

Hole ( TriggerTastendruck )

Zeichen, die den Script-Trigger „BeiObjektTastendruck“ oder Script-Trigger „BeiLayoutTastendruck“ aktiviert haben.

Hole ( TriggerKurztasten )

Der Status der Änderungstasten auf der Tastatur, wenn der Script-Trigger „BeiObjektTastendruck“ bzw. Script-Trigger „BeiLayoutTastendruck“ aktiviert wurde.

Hole ( TriggerZielbereich )

Indexnummer und Objektname des Registerbereichs, in den bei aktiviertem Script-Trigger „BeiBereichswechsel“ umgeschaltet wird.

Hole ( AnzahlAktiveBenutzer )

Anzahl der Clients, die aktuell auf die Datei zugreifen.

Hole ( ProgrammBenutzername )

Der Name des FileMaker-Benutzers, wie im Register Allgemein im Dialogfeld „Einstellungen“ angegeben.

Hole ( SystemformateVerwendenStatus )

1 (wahr) zurück, wenn „Systemformate verwenden“ im Menü „Format“ ausgewählt ist, ansonsten 0 (falsch)

Hole ( UUID )

Text, der einen Universally Unique Identifier (UUID) angibt.

Hole ( UUIDNummer )

Eine Zahl, die einen sehr großen Universally Unique Identifier (UUID) Wert darstellt.

Hole ( FensterInhaltHöhe )

Höhe des Fensterinhaltsbereichs in Punkt

Hole ( FensterInhaltBreite )

Breite des Fensterinhaltsbereichs in Punkt

Hole ( FensterSchreibtischHöhe )

Höhe des Desktopbereichs in Punkt

Hole ( FensterSchreibtischBreite )

Breite des Desktopbereichs in Punkt

Hole ( Fensterhöhe )

Die Höhe des Fensters in Punkt, das vom Script beeinflusst wird.

Hole ( FensterLinks )

Der horizontale Abstand in Punkt von der Außenkante des aktuellen Fensters, das das Script beeinflusst, in Relation zur linken Bildschirmkante.

Hole ( Fenstermodus )

Eine Zahl, die den Modus angibt, in dem sich das FileMaker-Produkt befindet, wenn die Funktion ausgewertet wird.

Hole ( Fenstername )

Der Name des Fensters, das vom Script beeinflusst wird.

Hole ( Fensterausrichtung )

Ein Wert, der die Ausrichtung des Fensters angibt, das vom Script beeinflusst wird.

Hole ( Fensterstil )

Der Stil des Fensters, das vom Script beeinflusst wird.

Hole ( FensterOben )

Der vertikale Punktabstand von der Außenkante des aktuellen Fensters, das das Script beeinflusst, in Relation zur oberen Bildschirmkante von Windows bzw. zur Unterkante der Menüleiste in macOS.

Hole ( FensterSichtbar )

1 (wahr), wenn das Fenster sichtbar ist, ansonsten 0 (falsch), wenn das Fenster über „Fenster ausblenden“ ausgeblendet ist.

Hole ( Fensterbreite )

Die Breite des Fensters in Punkt, das vom Script beeinflusst wird.

Hole ( FensterZoomStufe )

Zoomstufe des aktuellen Fensters

Beispiel 1 

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 ( LetzteMeldungswahl )=2]
      Gehe zu Layout ["Mahnung"]
      Drucken []
    Sonst
      E-Mail senden [Über E-Mail-Client senden; Mit Dialog: Aus; An: Datenbankname::Kunde; Betreff: "Erinnerung"; Mitteilung: "Sie befinden sich im Verzug."]
    Ende (wenn)
  Ende (wenn)
  Gehe zu Datens./Abfrage/Seite [Nächster; Nach letztem beenden: Ein]
Schleife (Ende)
Gehe zu Layout [Originallayout]

Weiterführende Themen 

Erläuterung von Funktionen

Über Formeln

Einfügen von Datum, Seitennummer oder anderen Variablen in ein Layout