WriteTextFile

<< Fare clic per visualizzazione il sommario >>

Percorso:  I servizi di Jamio openwork > FTP Service >

WriteTextFile

Service

FTP

 

Method

WriteTextFile

 

Description

Writes text in a file on the FTP server.

If the remote file already exists, it can be overridden or the new text can be appended to the file.

 

Input

Name

Description

Type

Optional

server

Connection and login information for the server.

 

Download FTPSettings data structure.

Dataset

 

remotePath

The path of the remote file or directory.

String

 

failIfNotFound

Specifies whether to throw an exception if file not found.

Bool

 

Output

Name

Description

Type

Optional

returnValue

Information about the remote file or directory; null if no file is found and failIfNotFound argument is set to false.

Dataset

 

 

Remarks

The server parameter contains the following fields:

“ServerName” (String) -> the server address, either a hostname or a dotted string IP address

“ServerPort” (Int32) -> the server port

“SslMode” (Int32) -> the TLS/SSL security mode:

 

0 = None (unsecured connection, no TLS/SSL)

1 = Implicit (implicitly secured TLS/SSL connection)

2 = Explicit (explicitly secured TLS/SSL connection)

 

“UserName” (String) -> the username; if null, “anonymous” is used

“Password” (String) -> password for the given username; if null, “guest” is used

“Passive” (Boolean) -> the file transfer type; default is true (passive)

 

Passive mode: data transfer connections are made by the client, which connects to the server

Active mode: data transfer connections are made by the server, which connects to the client

 

Firewalls and NATs often make it impossible to use active transfers

When using HttpConnect proxy, this property is ignored and all transfers are passive

“ProxyType” (Int32) -> the proxy type:

 

0 = None (direct connection, default when no proxy is specified)

1 = Socks4 (connection through Socks4 proxy)

2 = Socks4a (connection through Socks4A proxy (capable of resolving domain names))

3 = Socks5 (connection through Socks5 proxy)

4 = HttpConnect (connection through HTTP proxy using CONNECT method)

5 = FtpSite (connection through FTP proxy using SITE command)

6 = FtpUser (connection through FTP proxy using USER command)

7 = FtpOpen (connection through FTP proxy using OPEN command)

 

“ProxyHost” (String) -> the hostname of the proxy server

“ProxyPort” (Int32) -> the port of the proxy server

“ProxyUserName” (String) -> a username to submit to the proxy server for authentication

“ProxyPassword” (String) -> a password to submit to the proxy server for authentication

“ProxyAuthenticationMethod” (Int32) -> the type of the proxy server authentication method:

 

0 = Basic (Basic authentication)

1 = Ntlm (NTLM authentication)

2 = Digest (Digest authentication)

 

“ProxyBypassProxyOnLocal” (Boolean) -> true to bypass the proxy server for local addresses, otherwise false; the default value is false

 

The returned dataset contains the following fields:

“CreationTime” (DateTime) -> the creation time of the item (if not null)

“IsDirectory” (Boolean) -> true if the item is a directory, otherwise false

“IsFile” (Boolean) -> true if the item is a file, otherwise false

“IsLink” (Boolean) -> true if the item is a link, otherwise false

“LastAccessTime” (DateTime) -> the last access time of the item (if not null)

“LastWriteTime” (DateTime) -> the last modification time of the item (if not null)

“Length” (Int64) -> the file length

“Name” (String) -> the name of the file or directory

“Path” (String) -> the relative path of the file or directory