Mit diesem Kommando kann der Inhalt einer Resource aus der Datenbank geholt und in einer Datei und/oder in einer Variable geladen werden. Eine Fehlermeldung kommt dann vor, wenn sowohl der Parameter „Zielvariable“, als auch der Parameter „Dateipfad“ leer gelassen wurden. In diesem Fall wurde kein Objekt definiert, wo der Datenbankinhalt geladen werden kann.
Der Parameter „Dateipfad“ kann in den folgenden Fällen leer sein:
- Es wurde weder eine Variable (Feld), noch einen Inhalt (Pfad, Dateiname) zugewiesen.
- Es wurde eine Variable (Feld) zugewiesen, diese ist aber mit keinem Inhalt versehen worden.
- Es wurde eine Variable zugewiesen, die identisch mit der „Variable für den vordefinierten Pfad“ (s. Parameter unten) ist, der vordefinierte Pfad hat aber keinen Inhalt.
Eine Liste aller verfügbaren Resourcen befindet sich in der DLE-Administration unter dem Reiter Paketdaten beim Punkt ToDo-Definitionen > Paket-Resourcen.
Parameter:
- Paket: Ein bereits hinterlegtes Paket. Es können auch Felder eingefügt werden.
- Alternativpaket: (optional) Ein bereits hinterlegtes Paket. Es können auch Felder eingefügt werden.
- Resource: (optional) Bereits hinterlegte Resourcen, die zum Paket gehören. Es können auch Felder eingefügt werden.
- Gruppe: (optional) Alternativ zu Resource können die Parameter Gruppe und Name für die Lokalisierung der Resource in der Datenbank verwendet werden. Diese identifizieren gemeinsam mit dem Paket/Alternativpaket einen Resourceneintrag eindeutig.
- Name: (optional) Alternativ zu Resource können die Parameter Gruppe und Name für die Lokalisierung der Resource in der Datenbank verwendet werden. Diese identifizieren gemeinsam mit dem Paket/Alternativpaket einen Resourceneintrag eindeutig.
- Zielvariable: (optional) Ein Feld, wo der Inhalt der Resource geladen wird. Der Inhalt wird nicht Base64 entschlüsselt.
- Variable für den vordefinierten Pfad: (optional) Ein Feld, wo der Pfad der Datei im jeweiligen Betriebssystem geladen werden kann.
- Dateipfad: (optional) Der Pfad im jeweiligen Betriebssystem, wo der Inhalt der Resource als Datei geladen wird. Der Inhalt wird Base64 entschlüsselt in die Datei geschrieben. Der Parameter kann die folgenden Inhalte haben:
- Eine Variable, die identisch mit der Variable für den vordefinierten Pfad ist – in diesem Fall wird in der Datei je nach „Aktualisiere wenn neu“ geschrieben, welche im Resourcendatensatz (DLE-Administration/Paketdaten/Todo-definitionen/Paket-Resourcen/Feld „Dateiname“) festgelegt wurde.
- Ein Pfad, der direkt eingegeben oder in einer Variable vorgespeichert wurde – in diesem Fall wird dort geschrieben. Ist der Pfad ungültig, kommt keine Fehlermeldung – es entsteht einfach keine Datei.
- Ein Dateiname, der direkt eingegeben oder in einer Variable vorgespeichert wurde – in diesem Fall wird der Dateiname mit dem Standardpfad ($DLE_HOME/temp) versehen.
- Aktualisiere wenn neuer: (optional) Wenn Ja, dann wird die eventuell vorhandene Datei nur dann überschrieben, wenn der Datenbankinhalt aktueller ist. Wenn Nein, dann wird die eventuell vorhandene Datei bedingungslos überschrieben.