fromLocalFile

Mit fromLocalFile geben Sie die lokale Quelldatei für die Dateiübertragung an.

Die Übertragungsart (Datentyp) kann aus dem Dateinamen mit autoDataSpec abgeleitet werden (siehe Abschnitt „autoDataSpec").

Dateinamen dürfen maximal 512 Zeichen lang sein. Dies wird vor der Ausführung des Ftscript überprüft. Die Länge des resultierenden Dateinamens (directory und filenames) ist durch das angesprochene Betriebssystem und die openFT-Version begrenzt. Die Länge ergibt sich aus der Anzahl der Zeichen plus 1 Zeichen, wenn directory nicht mit einem „/“ endet. Die Überprüfung findet während des Ftscript-Laufes statt.
Weitere Informationen dazu entnehmen Sie dem Abschnitt „Dateinamen-Attribute".

Einschränkungen

fromLocalFile darf nach der Dereferenzierung keine Partnerangabe besitzen.

Format

 <fromLocalFile ref?="ID" data?="auto|char|bin|user"
                recordFormat?="std|undef|var|fix"
                maxRecSize?="int" ccsname?="string" filenames>
   comment?
   directory?
   autoDataSpec?
 </fromLocalFile

Attribute

Name	Wert	Bedeutung
ref?	string	Referenz auf ein anderes Dateiobjekt. Von diesem werden partner und directory übernommen, wenn Sie die Elemente hier nicht angegeben haben (siehe Abschnitt „Referenzierung").
data?	auto | char | bin | user	Der Standardwert ist auto. Gibt den Datentyp an. Bei Angabe von char, bin oder user wird die autoDataSpec Angabe ignoriert (siehe Abschnitt „autoDataSpec").
recordFormat?	std | undef | var | fix	Der Standardwert ist std. Gibt das Satzformat an. Es gilt die Standardzuordnung von openFT (data=bin -> undef, sonst var). Bei Angabe von undef ist das Satzformat undefiniert, z.B. für Binärformate. Bei Angabe von var ist das Satzformat variabel, z.B. für Textformate (ein Datensatz entspricht einer Zeile; Zeilen sind unterschiedlich lang). Bei Angabe von fix ist das Satz-format fest, z.B. f80 (mit recordFormat=fix und maxRecSize=80).
maxRecSize?	1-65535 (openFT <= V11: 1-32756 bzw. 1-32767)	Gibt die Satzgröße an. Standardmäßig gilt der Wert von openFT (siehe Handbuch "openFT (Unix- und Windows-Systeme) - Kommandoschnittstelle"). Bei data=char gibt maxRecSize die Länge einer Zeile an (bis CR/LF). Dateien mit einer Zeilenlänge größer als 65535 Bytes müssen mit data=bin übertragen werden. Ein Ftscript, das beispielsweise einen, in openFT V11.0 unzulässigen maxRecSize-Wert verwendet, läuft mit openFT V11.0 nicht ab.
ccsname?	string max. 8 Zeichen	Angabe des Coded-Character-Set (siehe Handbuch "openFT (Unix- und Windows-Systeme) - Kommandoschnittstelle").
filenames	siehe Abschnitt „Dateinamen-Attribute".

Beispiel

 <?xml version="1.0" encoding="UTF-8"?>
 <ftscript version="1">
   <transferFile>
     <fromLocalFile name="bin.mp3">
       <directory name="W:/openFT/ftscript/Test/data/small"/>
       <autoDataSpec charPattern="*.txt" userPattern="*.tab *.dat"
            default="bin"/>
     </fromLocalFile>
     <toRemoteFile name="bin.mp3">
       <partner name="UnixP_1">
         <transferAdmission>
           <ftacAdmission ftacAdmission="FTACADM1"/>
         </transferAdmission>
       </partner>
       <directory name="frg_eis_18"/>
     </toRemoteFile>
   </transferFile>
 </ftscript>

Im Beispiel wird die lokale Datei bin.mp3 in das ferne System UnixP_1 unter dem Namen bin.mp3 übertragen. Es ist keine Übertragungsart oder autoDataSpec angegeben. Die Übertragungsart ist bin (Standardwert von autoDataSpec).