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 Wert keinen 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 Option Wert enthä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.

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

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

Kopieren
Variable setzen [ $InstanzID ; Wert: "38EA3124-9CFD-4490-A634-A0A72A613145" ]
Persistente Daten konfigurieren [ com.claris.meinaddon.design ; Instanz-ID: $InstanzID  ; Löschen ]