deleteFile

Mit deleteFile löschen Sie eine Datei. Wenn Sie keinen Partner angeben, wird die Datei unter der lokalen Benutzerkennung gelöscht.

Der Name der zu löschenden Datei setzt sich aus dem mit directory angegebenen Verzeichnisnamen (siehe Abschnitt „directory") und dem mit dem Attribut filenames angegebenen Namen zusammen.

Wenn Sie alle Dateien in einem Verzeichnis löschen wollen, verwenden Sie listDirectory (siehe Abschnitt „listDirectory") in Kombination mit foreach (siehe Abschnitt „foreach").

Die Länge des Dateinamens (Länge von directory plus Länge von filenames) ist begrenzt und abhängig von der openFT-Version. Die Länge ergibt sich aus der Anzahl der Zeichen plus 1 Zeichen, wenn directory nicht mit einem „/“ endet.

Beachten Sie das Verhalten beim Wiederanlauf (siehe Abschnitt „Wiederanlauf").

Format

 <deleteFile ref?="ID" faultIfNotExists?="yes|no" filenames>

   comment?
   context?
   partner?
   directory?
 </deleteFile>

Attribute

Name	Wert	Bedeutung
ref?	string	Referenz auf ein Datei-Kontextobjekt.
faultIfNotExists?	yes | no	Der Standardwert ist no. Wenn die Datei nicht existiert, gilt dies nicht als Fehler; die Ftscript-Bearbeitung wird fortgesetzt. Bei Angabe von yes wird der Ftscript-Auftrag mit ft_notExists abgebrochen, wenn die Datei nicht existiert. Beim Wiederanlauf (siehe Abschnitt „Wiederanlauf") wird der Ftscript-Auftrag mit ft_recoveryFailed abgebrochen. Dies kann auch beim Umschalten der Instanz erfolgen.
filenames	siehe Abschnitt „Dateinamen-Attribute".

Beispiel

<?xml version="1.0" encoding="UTF-8"?> 
<ftscript version="1">
   <deleteFile name="hugo.trash">
     <partner name="UnixP_1" systemType="unix">
       <transferAdmission>
         <ftacAdmission ftacAdmission="FTACADM1"/>
       </transferAdmission>
     </partner>
     <directory name="frg_eis_05"/>
   </deleteFile>
 </ftscript>

Löscht die Datei hugo.trash im Verzeichnis frg_eis_05 für die FTAC-Zugangsberechtigung FTACADM1 auf dem Rechner UnixP_1.

Fehler werden in diesem Beispiel nicht behandelt und führen zum Abbruch des Ftscripts.