ftp_adaptor [TAST DokuWiki ]

User Tools

Site Tools


Sidebar

First steps in TAST

What is UML

Computer setup for TAST use

FAQ

Recognized Issues

TAST tool Menu

TAST Adaptors

Adaptors examples

TAST Integrations

Interesting features

Documentation of technical administration

Modeling recommendations

Training in the TAST tool

ftp_adaptor

This is an old revision of the document!


FTP Adaptor

Introduction

This Adaptor is used to do connections with FTP or SFTP servers and this adaptor is used as a client in a TAST diagram.

Setup

In the initialization process, it's necessary to provide the information to connect with the server.

Initialization Parameters

  • Host: Name or IP address of the FTP server we want to connect.
  • Port: Port number on which the FTP server listens.
  • User: Username we want to use to make the connection.
  • Password: Password of the user we want to use to make the connection.
  • Secure: Checkbox that indicates whether the connection will be secure or not.

Functions

The predefined functions provided by this adapter can be classified into several groups:

Directory management functions

  • createLocalDirectory: Creates a directory on the local computer. Receives as parameters:
    • DirectoryName: As a value you have to give a name to the directory to be created on the local machine.

  • createRemoteDirectory: Creates a directory in the remote FTP. Receive as parameters:
    • DirectoryName: As a value you have to give a name to the directory to be created on the remote computer.

  • currentLocalDirectory: Gives you information about the local directory you are in. No parameters are required.

  • currentRemoteDirectory: Gives you information about the FTP directory you are in. No parameters are required.

  • changeLocalDirectory: Changes from the directory you are in to another directory on your local computer. Receive as input parameters:
    • Directory: As value, the name of the directory we want to move to on the local computer or disk C.

  • changeRemoteDirectory: Changes from the directory you are in to another directory in the FTP. Receive as input parameter:
    • Directory: As a value, the name of the directory we want to move to on the remote machine.

  • deleteLocalDirectory: Deletes a directory on your local computer. Receive as input parameters:
    • DirectoryName: As value, the name of the directory to be deleted on the local computer.

  • deleteRemoteDirectory: Deletes a directory on the remote FTP. Receives as input parameters:
    • DirectoryName: As a value, the name of the directory to be deleted on the remote machine.

Remote FTP file management functions

  • deleteFile: Allows to delete a file from the server. It receives as parameter:
    • RemoteFilePath: Specifies the path and name of the FTP file to be deleted.

  • dirLocalFiles: Displays files in the directory of the current local computer. No input parameters are required.

  • dirRemoteFiles: Displays files in the current FTP directory. No input parameters required.

  • getFile: Downloads a file from the remote FTP to the local computer where the diagram is executed. Receives as input parameters:
    • RemoteFilePath: Indicates the path and name of the remote file to be downloaded.
    • LocalFilePath: Indicates the path and name of the local file where it will be saved.
    • BinaryFile: Indicates the type of transfer. Binary when checked or text if unchecked.

  • putFile: Uploads a file from the local computer to the remote FTP. Receives as parameters:
    • LocalFilePath: Specifies the path and name of the local file to be uploaded.
    • RemoteFilePath: Indicates the path and file name of the file to be uploaded.
    • BinaryFile: Indicates the type of transfer. Binary when checked or text if unchecked.

Functions for connection to different FTP server

  • connect: Allows you to make a connection to another FTP server, different from the one configured in the adapter setup. If the previous connection is open, it closes it. Receives as parameters, the same initialization parameters of the Adapter:

    • Host: IP address or host name to which we want to connect.
    • Port: Port number on which the server is listening, if not reported the adapter will use the default port for the protocol.
    • User: Username used to establish the connection.
    • Password: Password of the user used in the previous step.
    • Secure: Indicates if the connection is secure (SFTP) or not (FTP).
  • disconnect: Allows you to close the connection to the FTP server. This function does not require input parameters.
ftp_adaptor.1634137476.txt.gz · Last modified: 2021/10/13 15:04 by montse