Verwenden Sie das FileTransfer-Objekt, um Dateien aufzulisten und zwischen dem Hostsystem und dem Client zu übertragen.
Die Dateiübertragungs-API von Host Access for the Cloud abstrahiert die in verschiedenen Hostdateiimplementierungen verwendeten Benennungskonventionen für Dateipfade. Verwenden Sie das Format für URL- oder Linux-Dateisystempfade, wenn Sie die von der API verwendeten Pfade formatieren. Beispiel: /root/directory/file. Alle spezifischen Regeln in den jeweiligen Hostsystemen müssen berücksichtigt werden, z. B. zulässige Zeichen oder Namenlängen.
HINWEIS:Browser enthalten erhebliche Sicherheitseinschränkungen in Bezug auf die Möglichkeit der Interaktion zwischen JavaScript und Clientdateisystemen.
Tabelle 5-23 FileTransfer
|
Methode |
|
|---|---|
|
getHostFileListing(remotePath) |
Fordert eine Liste der Hostdateien an. Wenn remotePath nicht angegeben ist, wird eine Dateiliste für das aktuelle Remotearbeitsverzeichnis angezeigt. Parameter {String} (optional) Wenn dieser Wert angegeben ist, wird die Dateiliste für den angegebenen Remotepfad abgerufen. Wenn er nicht angegeben ist, wird die Dateiliste für das aktuelle Remotearbeitsverzeichnis abgerufen. Ausgabe {Promise} Wird in einem Array von HostFile-Objekten aufgelöst, die in remoteName enthalten sind. Wird abgelehnt, wenn der Remotepfad nicht gelesen werden kann. |
|
sendFile(localFile, remoteName) |
Sendet die angegebene Datei an den Host. Parameter {File} JavaScript-Dateiobjekt, das auf die zu sendende lokale Datei verweist. {String} Vollqualifizierter Remotedateiname entsprechend der Zulässigkeit im Remotesystem (Unix, Windows, MVS, VAX). Ausgabe {Promise} Wird mit einem HostFile-Objekt ausgeführt, das die erfolgreich gesendete Datei darstellt. Wird abgelehnt, wenn beim Senden der Datei ein Fehler aufgetreten ist. |
|
getDownloadURL(remoteName) |
Erstellt einen Link zum Herunterladen einer Datei von einem Hostsystem. Parameter {String} Vollqualifizierter Remotedateiname entsprechend der Zulässigkeit im Remotesystem (Unix, Windows, MVS, VAX). Ausgabe {URL}, die zum Abrufen der Datei vom Host Access for the Cloud-Sitzungsserver verwendet werden kann. |
|
setTransferOptions(options) |
Legt Übertragungsoptionen für die aktuelle FileTransfer-Sitzung fest. Die Übertragungsoptionen werden auf alle zukünftigen Übertragungen angewendet, bis die Sitzung entweder beendet oder durch einen anderen Aufruf von setTransferOptions überschrieben wird. Parameter {JSON} siehe FileTransferOptions für zulässige Namen und Werte. Ausgabe {Promise} Wird ausgeführt, wenn der Aufruf abgeschlossen wird. Wird abgelehnt, wenn beim Festlegen der Optionen ein Fehler aufgetreten ist. |
|
cancel() |
Bricht die aktuelle laufende Übertragung ab. Ausgabe {Promise} Wird ausgeführt, wenn der Aufruf abgeschlossen wird. Wird abgelehnt, wenn während des Abbruchs der Übertragung ein Fehler aufgetreten ist. |