Start > 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.

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)	Eine Liste von Schlüsselwörtern basierend auf dem zum Öffnen der Datei verwendeten Konto für die aktivierten erweiterten Zugriffsrechte
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(AktivesFeldInhalt)	Der Inhalt des Felds, das aktiv ist
Hole(AktivesFeldName)	Der Name des Felds, das aktiv ist
Hole(AktivesFeldTabellenName)	Der Name der Tabelle, die 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(AktiveAusschnittZeilenNr)	Die Nummer der Ausschnittzeile, die aktiv ist
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)	Text, der das FileMaker-Produkt und die Version angibt
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 Uhrzeit (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 Uhrzeit (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)	Pfad zum Ordner, der die aktuell ausgeführte Kopie von FileMaker Pro 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)	Version von FileMaker Pro bzw. FileMaker Server, die auf dem Computer läuft, der die aktuelle Datei bereitstellt
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(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)	Text, der den Fehlerstatus zeigt, der durch ODBC-Standards, basierend auf ISO/IEF-Standards, veröffentlicht 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 der Tabelle, aus der 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(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)	Nummer auf der Basis der Zugriffsrechte für den aktuellen Datensatz zurück, 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)	Nummer des aktuellen Datensatzes in der aktuellen Ergebnismenge
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(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 (OS X), 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)	Der Pfad des temporären Ordners, den FileMaker Pro für den aktuellen Benutzer verwendet, bzw. der Pfad, den FileMaker Server auf dem System verwendet
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 BeiLayoutTastendruck aktiviert haben
Hole(TriggerKurztasten)	Der Status der Änderungstasten auf der Tastatur, wenn der Script-Trigger BeiObjektTastendruck bzw. BeiLayoutTastendruck aktiviert wurde
Hole(TriggerZielbereich)	Indexnummer und Objektname des Registerbereichs, in das 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(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 von der Außenkante des aktuellen Fensters in Punkt, das das Script beeinflusst, in Relation zur linken Bildschirmkante
Hole(Fenstermodus)	Eine Zahl für den FileMaker Pro-Modus, der bei der Berechnung der Funktion aktiv ist
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 Abstand von der Außenkante des aktuellen Fensters in Punkt, das das Script beeinflusst, in Relation zur unteren Kante der Menüleiste
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 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