Persistente Daten konfigurieren
Legt einen Eintrag im persistenten Datenspeicher fest oder löscht ihn.
Optionen
-
Name ist Text, der den Namen des persistenten Dateneintrags angibt. Der Name darf nicht leer sein.
-
Instanz-ID ist ein optionaler Textausdruck, mit dem Sie die spezifische Instanz des Eintrags identifizieren können. Mehrere Einträge können denselben Namen mit unterschiedlichen Instanz-IDs haben.
-
Wert ist ein Ausdruck für die zu speichernden Daten. Der Datentyp bleibt beim Speichern des Werts erhalten.
-
Eintrag löschen löscht den angegebenen Eintrag.
Kompatibilität
| Produkt | Unterstützt |
| FileMaker Pro | Ja |
| FileMaker Go | Ja |
| FileMaker WebDirect | Ja |
| FileMaker Server | Ja |
| FileMaker Cloud | Ja |
| FileMaker Data API | Ja |
| Custom Web Publishing | Ja |
Ursprung in Version
26.0
Beschreibung
Wenn bereits ein Eintrag mit dem angegebenen Namen und der angegebenen Instanz-ID vorhanden ist, aktualisiert dieser Scriptschritt dessen Wert oder löscht den Eintrag, je nachdem, ob Wert oder Eintrag löschen ausgewählt ist. Wenn der Eintrag nicht vorhanden ist, wird durch das Angeben von Wert der Eintrag erstellt. Siehe Über den persistenten Datenspeicher.
Hinweise
-
Um den Wert eines Eintrags abzurufen, verwenden Sie die Funktion „HolePersistenteDaten“.
-
Da die Länge einer Formel begrenzt ist (siehe Technische Einschränkungen von FileMaker Pro), können Sie in der Option
Wertkeinen Textwert eingeben, der diese Grenze überschreitet. Um Textwerte anzugeben, die diesen Grenzwert überschreiten, verweisen Sie auf ein Feld oder eine Variable, die die Daten für die OptionWertenthält. Um Text zunächst in ein Feld oder eine Variable einzufügen, können Sie Scriptschritte wie Text einfügen (für Text, der im Scriptschritt selbst gespeichert ist), Aus URL einfügen (für Text, der über eine URL verfügbar ist) oder Von Datendatei lesen (für Text in einer lokalen Datei) verwenden. -
Instanz-ID kann nicht angegeben (leer) oder ein leerer String ("") sein.
-
Eine nicht angegebene (leere) Instanz-ID wird wie ein leerer String ("") behandelt.
-
Das Löschen eines Eintrags, der nicht existiert, gibt den Fehlercode 10 („Angeforderte Daten fehlen.“) zurück.
Beispiel 1
Speichert eine einfache Versionsnummer in einem Eintrag namens „AppVersion“ (ohne Instanz-ID) im persistenten Datenspeicher der aktuellen Datei.
Persistente Daten konfigurieren [ AppVersion ; Wert: "2.1.0" ]
Um diesen Eintrag zu lesen, siehe Beispiel 1 für die Funktion „HolePersistenteDaten“.
Beispiel 2
Speichert mehrere Konfigurationswerte für ein Add-on unter Verwendung der Instanz-ID des Add-ons.
Variable setzen [ $InstanzID ; Wert: "38EA3124-9CFD-4490-A634-A0A72A613145" ]
Persistente Daten konfigurieren [ com.claris.meinaddon.design ; Instanz-ID: $InstanzID ; Wert: "Dunkel" ]
Persistente Daten konfigurieren [ com.claris.meinaddon.sprache ; Instanz-ID: $InstanzID ; Wert: "de" ]
Persistente Daten konfigurieren [ com.claris.meinaddon.änderungsdatum ; Instanz-ID: $InstanzID ; Wert: Hole ( SystemZeitstempel ) ]
Beispiel 3
Löscht einen bestimmten persistenten Dateneintrag anhand seines Namens und seiner Instanz-ID.
Variable setzen [ $InstanzID ; Wert: "38EA3124-9CFD-4490-A634-A0A72A613145" ]
Persistente Daten konfigurieren [ com.claris.meinaddon.design ; Instanz-ID: $InstanzID ; Löschen ]