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 Zweck

Hole ( KontoErweiterteZugriffsrechte )

Gibt eine Liste von Schlüsselwörtern basierend auf dem zum Öffnen der Datei verwendeten Kontos für die aktivierten erweiterten Zugriffsrechte zurück.

Hole ( Kontogruppenname )

Gibt den Gruppennamen des aktuellen Kontos zurück.

Hole ( Kontoname )

Gibt den authentifizierten Kontonamen zurück, der vom aktuellen Benutzer der Datei verwendet wird.

Hole ( KontoBerechtigungenName )

Gibt den Namen der Berechtigung zurück, die das zum Öffnen der Datei verwendete Konto nutzt.

Hole ( KontoTyp )

Gibt den Authentifizierungstyp des aktuellen Kontos zurück.

Hole ( AktivesFeldInhalt )

Gibt den Inhalt des Felds zurück, das aktiv ist.

Hole ( AktivesFeldName )

Gibt den Namen des Felds zurück, das aktiv ist.

Hole ( AktivesFeldTabellenName )

Gibt den Namen des Tabellenauftretens zurück, in dem sich das aktive Feld befindet.

Hole ( AktivesLayoutobjektName )

Gibt den Namen des Layoutobjekts zurück, das im aktuellen Fenster der Formel aktiv ist.

Hole ( SonderTastenGedrückt )

Gibt eine Zahl für die gedrückten Änderungstasten der Tastatur zurück.

Hole ( AktiveAusschnittZeileNr )

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

Hole ( AktiveDatensatznummer )

Gibt die Position des Datensatzes mit dem Fokus in der Ergebnismenge als Zahl zurück.

Hole ( AktivesFeldWiederholungNr )

Gibt eine Zahl zurück, die die aktive Wiederholung in einem Wiederholfeld repräsentiert.

Hole ( AktiveTextAuswahlGröße )

Gibt eine Zahl zurück, die angibt, wie viele Zeichen ausgewählt sind.

Hole ( AktiveTextAuswahlStart )

Gibt eine Zahl zurück, die das Anfangszeichen des ausgewählten Texts identifiziert.

Hole ( AnwenderAbbruchZulassenStatus )

Gibt 1 (wahr) zurück, wenn der Scriptschritt „AnwenderAbbruchZulassen setzen“ auf „Ein“ gesetzt ist, ansonsten 0 (falsch).

Hole ( FormatierungsleisteZulassenStatus )

Gibt 1 (wahr) zurück, wenn die Formatierungsleiste sichtbar ist, ansonsten 0 (falsch).

Hole ( AnwendungArchitektur )

Gibt die aktuelle Anwendungsarchitektur zurück.

Hole ( ProgrammSprache )

Gibt Text zurück, der die aktuelle Programmsprache angibt.

Hole ( ProgrammVersion )

Gibt Produktname und Version eines FileMaker-Client zurück.

Hole ( CacheDateiname )

Gibt den Namen der Cachedatei der aktuell aktiven Datei zurück.

Hole ( CacheDateipfad )

Gibt den Pfad der Cachedatei der aktuell aktiven Datei zurück.

Hole ( FormelWiederholungNr )

Gibt eine Zahl zurück, die die Wiederholung des Formelfelds angibt, die gerade berechnet wird.

Hole ( VerbindungsAttribute )

Gibt den Namen des Hosts der aktuellen Datei und den Namen der Zertifizierungsstelle zurück, die das verwendete SSL-Zertifikat zur Sicherung der Verbindung ausgestellt hat.

Hole ( Verbindungsstatus )

Gibt eine Zahl zurück, die den Sicherheitsstatus der Netzwerkverbindung für die aktuelle Datei anzeigt.

Hole ( SystemDatum )

Gibt das aktuelle Datum gemäß dem Systemkalender zurück.

Hole ( AktuelleErweiterteZugriffsrechte )

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

Hole ( HostZeitstempel )

Gibt das aktuelle Datum und die aktuelle Uhrzeit des Hosts (sekundengenau) gemäß der Systemuhr zurück.

Hole ( AktuelleBerechtigungenName )

Gibt den Namen der Berechtigung zurück, die zum Berechnen dieser Formel in der Datei verwendet wird.

Hole ( SystemUhrzeit )

Gibt die aktuelle Uhrzeit (sekundengenau) gemäß der Systemuhr zurück.

Hole ( SystemZeitstempel )

Gibt das aktuelle Datum und die aktuelle Uhrzeit (sekundengenau) gemäß der Systemuhr zurück.

Hole ( SystemUhrzeitUTCMikrosekunden )

Gibt die aktuelle Uhrzeit in UTC (Coordinated Universal Time) bis auf die nächste Mikrosekunde zurück.

Hole ( SystemUhrzeitUTCMillisekunden )

Gibt die aktuelle Uhrzeit in UTC (Coordinated Universal Time) bis auf die nächste Millisekunde zurück.

Hole ( AngepasstenMenüsetName )

Gibt den Namen des aktiven angepassten Menüsets zurück.

Hole ( DesktopPfad )

Gibt den Pfad zum Desktop-Ordner des aktuellen Benutzers zurück.

Hole ( Gerät )

Gibt eine Zahl zurück, die dem Computertyp oder mobilen Gerät entspricht, auf dem das FileMaker-Produkt ausgeführt wird.

Hole ( DokumentenPfad )

Gibt den Pfad zum Dokumente-Ordner des aktuellen Benutzers zurück.

Hole ( DokumentePfadListe )

Gibt eine Liste aller Dateien und Ordner im Dokumente-Ordner zurück, den die Funktion „Hole ( DokumentenPfad )“ zurückgibt.

Hole ( Verschlüsselungsstatus )

Gibt einen Wert zurück, der den aktuellen Verschlüsselungsstatus der Datei angibt.

Hole ( FehleraufzeichnungAktivStatus )

Gibt 1 (wahr) zurück, wenn der Scriptschritt „Fehleraufzeichnung setzen“ auf „Ein“ gesetzt ist, ansonsten 0 (falsch).

Hole ( DateiGebietsschemaElemente ) Gibt ein JSON-Objekt mit Informationen zum Gebietsschema der aktuellen Datei zurück.

Hole ( FileMakerPfad )

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

Hole ( DateiName )

Gibt den Namen der aktuell aktiven Datei ohne Dateinamenerweiterung zurück.

Hole ( DateiPfad )

Gibt den vollständigen Pfad zum Speicherort der aktuell aktiven Datei zurück.

Hole ( DateiGrößeBytes )

Gibt die Größe (in Byte) der aktuell aktiven Datei zurück.

Hole ( AnzahlGefundeneDatensätze )

Gibt die Anzahl der Datensätze in der Ergebnismenge zurück.

Hole ( HoherKontrastStatus )

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

Hole ( HostAnwendungVersion )

Gibt Produktname und Version des FileMaker-Hosts zurück.

Hole ( HostIPAdresse )

Gibt die IP-Adresse des Host-Rechners für die aktuelle Datei zurück.

Hole ( HostName )

Gibt den Namen des aktuellen Hosts zurück.

Hole ( InstallierteFMPlugins )

Gibt den Namen, die Versionsnummer und den aktivierten Zustand installierter Plugins zurück.

Hole ( InstallierteFMPluginsAlsJSON ) Gibt ein JSON-Objekt mit den Attributen der installierten Plugins zurück.

Hole ( LetzteFehlerNr )

Gibt eine Zahl zurück, die die Nummer des Fehlers bei der Ausführung des letzten Scriptschritts darstellt.

Hole ( LetzteFehlerNrDetail )

Gibt Text über Fehler zurück, die von „Hole ( LetzteFehlerNr )“ zurückgegeben werden.

Hole ( LetzteFehlerNrPosition )

Gibt den Scriptnamen, den Schrittnamen und die Zeilennummer der Fehler zurück, die von „Hole ( LetzteFehlerNr )“ zurückgegeben werden.

Hole ( LetzteMeldungswahl )

Gibt eine Zahl für die in einer Warnmeldung angeklickte Schaltfläche wieder, die durch den Scriptschritt „Eigenes Dialogfeld anzeigen“ angezeigt wurde.

Hole ( LayoutBerechtigungen )

Gibt eine Zahl zurück auf der Basis von Zugriffsrechten, die über das aktuelle Layout zur Verfügung stehen.

Hole ( DateiLayoutanzahl )

Gibt die Gesamtanzahl der Layouts in der Datei zurück.

Hole ( LayoutName )

Gibt den Namen des aktuell angezeigten Layouts zurück.

Hole ( LayoutNummer )

Gibt die Zahl des Layouts (aus dem Dialogfeld „Layouts verwalten“) zurück, das aktuell angezeigt wird.

Hole ( LayoutTabellenname )

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

Hole ( LayoutAnzeigeAlsStatus )

Gibt die Nummer für die derzeit aktive Ansicht der Datei zurück.

Hole ( MenüleisteStatus )

Gibt eine Zahl für den aktuellen Status der Menüleiste zurück.

Hole ( GeänderteFelder )

Gibt eine Liste der Felder zurück, die im aktuellen Datensatz der aktuellen Tabelle geändert wurden.

Hole ( DateiMehrbenutzerstatus )

Gibt eine Zahl zurück, die die Ebene der gemeinsamen Nutzung für die Datei im FileMaker-Netzwerk angibt.

Hole ( Netzwerkprotokoll )

Gibt den Namen des Netzwerkprotokolls (TCP/IP) zurück, das ein FileMaker-Client auf diesem Rechner verwendet.

Hole ( Netzwerktyp )

Gibt in FileMaker Go eine Zahl zurück, die den Typ des verwendeten Netzwerks angibt, über das der Zugriff auf die aktuelle Datei erfolgt.

Hole ( OffeneDatenDateiInfo )

Gibt die DateiID und den Pfad jeder offenen Datendatei zurück.

Hole ( Seitenanzahl )

Gibt eine Zahl zurück, die die Gesamtseitenanzahl im aktuellen Druckauftrag während des Druckvorgangs angibt.

Hole ( Seitennummer )

Gibt die Nummer der aktuellen Seite zurück, die gerade gedruckt oder in der Seitenansicht angezeigt wird.

Hole ( PersistentID )

Gibt Text zurück, der einen eindeutigen Bezeichner des Computers oder Geräts darstellt, auf dem ein FileMaker-Client ausgeführt wird.

Hole ( EinstellungenPfad )

Gibt den Pfad zum Einstellungen- und Standardoptionen-Ordner des aktuellen Benutzers zurück.

Hole ( Druckername )

Gibt eine Zeichenfolge zurück, die den Standarddruckernamen angibt.

Hole ( SchnellsucheText )

Gibt den Text zurück, der in das Feld „Schnellsuche“ eingegeben wurde.

Hole ( DatensatzBerechtigungen )

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

Hole ( DatensatzIDNr )

Gibt die eindeutige ID des aktuellen Datensatzes zurück.

Hole ( DatensatzÄnderungenAnzahl )

Gibt zurück, wie häufig insgesamt Änderungen am aktuellen Datensatz geschrieben wurden.

Hole ( DatensatzPositionInErgebnismenge )

Gibt die Nummer einer Datensatzposition in der Ergebnismenge zurück.

Hole ( DatensatzOffenAnzahl )

Gibt die Gesamtzahl der geöffneten Datensätze in der aktuellen Ergebnismenge, die noch nicht gespeichert wurden, zurück.

Hole ( DatensatzOffenStatus )

Gibt eine Zahl zurück, die den Status des aktuellen Datensatzes angibt.

Hole ( RegionsmonitorEvents )

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

Hole ( AnzahlAbfrageEinträge )

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

Hole ( AbfrageAusschlussStatus )

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

Hole ( Bildschirmtiefe )

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

Hole ( Bildschirmhöhe )

Gibt die Höhe des Bildschirms in Punkten zurück, an dem das Fenster der aktuellen Datei geöffnet ist.

Hole ( DisplayAnzeigeFaktor )

Gibt den Skalenfaktor des Bildschirms zurück, an dem das Fenster der aktuellen Datei geöffnet ist.

Hole ( Bildschirmbreite )

Gibt die Breite des Bildschirms in Punkten zurück, an dem das Fenster der aktuellen Datei geöffnet ist.

Hole ( ScriptAnimationStatus )

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

Hole ( ScriptName )

Gibt den Namen des Scripts zurück, das gerade ausgeführt wird oder unterbrochen ist.

Hole ( ScriptParameter )

Gibt den Scriptparameter zurück, der an das aktuelle Script übergeben wird.

Hole ( ScriptErgebnis )

Gibt das Scriptergebnis aus einem ausgeführten Teilscript zurück.

Hole ( SitzungsID )

Gibt den Wert zurück, der durch den Scriptschritt „Sitzungs-ID festlegen“ festgelegt wurde.

Hole ( Sortierstatus )

Gibt einen Wert zurück, der den aktuellen Sortierstatus angibt.

Hole ( StatusbereichSichtbarStatus )

Gibt eine Zahl für den aktuellen Status der Statussymbolleiste zurück.

Hole ( SystemDarstellung )

Gibt den Namen der aktuellen Betriebssystemdarstellung zurück.

Hole ( SystemLaufwerk )

Gibt den Laufwerksbuchstaben (Windows) oder den Volumenamen (macOS) zurück, auf dem sich das aktuell ausgeführte Betriebssystem befindet.

Hole ( SystemIPAdresse )

Gibt eine Liste der IP-Adressen aller Rechner zurück, die mit einer aktiven NIC-Karte (Network Interface Controller) verbunden sind.

Hole ( SystemSprache )

Gibt die Sprache zurück, die auf dem aktuellen System eingestellt ist.

Hole ( SystemGebietsschemaElemente ) Gibt ein JSON-Objekt mit Informationen zum Gebietsschema des Client-Systems zurück.

Hole ( SystemNICAdresse )

Gibt die Hardware-Adressen aller NIC-Karten zurück, die mit dem Rechner verbunden sind.

Hole ( SystemPlattform )

Gibt eine Zahl zurück, die die aktuelle Plattform identifiziert.

Hole ( SystemVersion )

Gibt die Version des aktuellen Betriebssystems zurück.

Hole ( TemporärerPfad )

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

Hole ( TextlinealSichtbar )

Gibt 1 (wahr) zurück, wenn das Textlineal angezeigt wird, ansonsten 0 (falsch).

Hole ( AnzahlDatensätzeGesamt )

Gibt die Gesamtanzahl der Datensätze in der Tabelle zurück.

Hole ( TouchTastaturStatus )

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

Hole ( TransaktionOffenStatus )

Gibt 1 (wahr) zurück, wenn die Transaktion geöffnet wird, ansonsten 0 (falsch).

Hole ( TriggerAktuellerBereich )

Gibt Indexnummer und Objektnamen des Bereichs zurück, von dem aus bei aktiviertem Script-Trigger BeiBereichswechsel gewechselt wird.

Hole ( TriggerExternesEreignis )

Gibt in FileMaker Go eine Zahl zurück, die für das Ereignis steht, das einen Script-Trigger „BeiExternerBefehlErhalten“ aktiviert hat.

Hole ( TriggerGestenInfo )

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

Hole ( TriggerTastendruck )

Gibt die Zeichen zurück, die einen Script-Trigger „BeiObjektTastendruck“ bzw. „BeiLayoutTastendruck“ aktiviert haben.

Hole ( TriggerKurztasten )

Gibt den Status der Änderungstasten auf der Tastatur zurück, wenn ein Script-Trigger „BeiObjektTastendruck“ bzw. „BeiLayoutTastendruck“ aktiviert wurde.

Hole ( TriggerZielbereich )

Gibt Indexnummer und Objektnamen des Bereichs zurück, zu dem bei aktiviertem Script-Trigger „BeiBereichswechsel“ gewechselt wird.

Hole ( AnzahlAktiveBenutzer )

Gibt die Anzahl der Clients zurück, die aktuell auf die Datei zugreifen.

Hole ( ProgrammBenutzername )

Gibt den Namen des FileMaker-Benutzers zurück, wie im Register „Allgemein“ im Dialogfeld „Einstellungen“ angegeben.

Hole ( SystemformateVerwendenStatus )

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

Hole ( UUID )

Gibt Text zurück, der einen Universally Unique Identifier (UUID) angibt.

Hole ( UUIDNummer )

Gibt eine Zahl zurück, die einen sehr großen Universally Unique Identifier (UUID) Wert darstellt.

Hole ( FensterInhaltHöhe )

Gibt die Höhe des Fensterinhaltsbereichs in Punkt zurück.

Hole ( FensterInhaltBreite )

Gibt die Breite des Fensterinhaltsbereichs in Punkt zurück.

Hole ( FensterSchreibtischHöhe )

Gibt die Höhe des Desktopbereichs in Punkt zurück.

Hole ( FensterSchreibtischBreite )

Gibt die Breite des Desktopbereichs in Punkt zurück.

Hole ( Fensterhöhe )

Gibt die Höhe des Fensters in Punkt zurück, das vom Script beeinflusst wird.

Hole ( FensterLinks )

Gibt den horizontalen Abstand von der Außenkante des aktuellen Fensters in Punkt zurück, das das Script beeinflusst, in Relation zur linken Bildschirmkante.

Hole ( Fenstermodus )

Gibt eine Zahl zurück, die den Modus angibt, in dem sich das FileMaker-Produkt befindet, wenn die Funktion ausgewertet wird.

Hole ( Fenstername )

Gibt den Namen des Fensters zurück, das vom Script beeinflusst wird.

Hole ( Fensterausrichtung )

Gibt einen Wert zurück, der die Ausrichtung des Fensters angibt, das vom Script beeinflusst wird.

Hole ( Fensterstil )

Gibt den Stil des Fensters zurück, das vom Script beeinflusst wird.

Hole ( FensterOben )

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

Hole ( FensterSichtbar )

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

Hole ( Fensterbreite )

Gibt die Breite des Fensters in Punkt zurück, das vom Script beeinflusst wird.

Hole ( FensterZoomStufe )

Gibt die Zoomstufe des aktuellen Fensters zurück.

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.

Kopieren
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 in Verzug"]
    Wenn [Hole ( LetzteMeldungswahl ) = 1]
      Alle Scripts abbrechen
    Sonst, wenn [Hole ( LetzteMeldungswahl ) = 2]
      Gehe zu Layout ["Erinnerung"]
      Drucken []
    Sonst
      E-Mail senden [Über E-Mail-Client senden; Mit Dialog: Aus ; An: Datenbankname::Client; Betreff: "Erinnerung"; Mitteilung: "Ihr Konto ist in Verzug."]
    Ende (wenn)
  Ende (wenn)
  Gehe zu Datens./Abfrage/Seite [Nächster; Nach letztem beenden: Ein]
Schleife (Ende)
Gehe zu Layout [Originallayout]