11.40 saveprofile()

Diese Funktion schreibt die aktuellen Werte aller konfigurierbaren Record-Instanzen (.configurable = true) und globalen Variablen (deklariert mit config) eines Dialogs oder Moduls in eine Konfigurationsdatei (profile), aus der sie mit der Funktion loadprofile() wieder geladen werden können.

Bei Records werden standardmäßig nur Werte, die nicht geerbt sind, in die Datei geschrieben. Um auch die geerbten Werte in die Datei zu schreiben ist der Parameter All auf true zu setzen.

Es werden nur Werte aus dem angegebenen Dialog oder Modul gespeichert. Aus anderen Modulen importierte Records und Variablen werden nicht berücksichtigt.

Definition

boolean saveprofile
(
      string  Filename   input
  { , object  Module  := null input }
  { , string  Comment := ""   input }
  { , boolean All :=  false   input }
)

Parameter

string Filename input
Dieser Parameter definiert den Dateinamen der Konfigurationsdatei. Es kann ein Dateipfad angegeben werden, der auch eine Umgebungsvariable enthalten darf.
object Module := null input

Dieser optionale Parameter enthält den Identifikator des Dialogs oder Moduls, dessen Record- und Variablenwerte in die Datei geschrieben werden sollen.

Bei Module = null wird die Modul-ID der aktuellen Regel verwendet.

string Comment := "" input
In diesem optionalen Parameter kann ein Text angegeben werden, der als Kommentar in die Konfigurationsdatei geschrieben wird.
boolean All := false input
Wird dieser optionale Parameter auf true gesetzt, werden zusätzlich die geerbten Werte in die Konfigurationsdatei geschrieben. Beim Standardwert false werden nur nicht geerbte Werte gespeichert.

Rückgabewert

true
Das Speichern der Werte in der Konfigurationsdatei war erfolgreich.
false

Die Werte konnten nicht gespeichert werden.

Dies kann an Fehlern beim Zugriff auf die Datei oder einer ungültigen Modul-ID liegen.

Verfügbarkeit

Ab IDM-Version A.06.02.g

Siehe auch

Eingebaute Funktion loadprofile()

C-Funktion DM_SaveProfile