Plus FTP Client jest wtyczką pozwalającą na zintegrowanie systemu PlusWorkflow z serwerem FTP. Obsługiwane protokoły komunikacyjne to:

-FTP – nieszyfrowany protokół przesyłania plików. Pliki przesyłane za pośrednictwem FTP mogą zostać „podsłuchane” przez osoby niepowołane (wraz z loginem i hasłem do serwera FTP). Z tego powodu używanie protokołu FTP nie jest zalecane z uwagi na niebezpieczeństwo wycieku danych dostępowych do serwera FTP.
-FTPS – Protokół działa bardzo podobnie jak FTP, a jego główną różnicą jest szyfrowanie przesyłanych danych dostępowych podczas połączenia z serwerem FTP.
-SFTP - Połączenie przez SFTP zapewnia szyfrowanie zarówno przesyłanych plików oraz danych dostępowych (loginu i hasła dostępu) do serwera FTP. Natomiast tradycyjne połączenie FTP nie zapewnia szyfrowania plików i danych dostępowych do serwera. Z tego względu połączenie przez SFTP jest uznawane za najbezpieczniejszą metodę przesyłania plików i katalogów na hosting.

Wymagana wersja systemu PWFL: 3.2.149

Wymagana wersja wtyczki PWE: 2.3.50

Wymagana wersja wtyczki Plugin Configuration Manager: 1.0.1

Konfiguracja połączenia z serwerem musi znajdować się w pliku konfiguracyjnym wtyczki Plugin Configuration Manager (PCM) w zakładce Plus FTP Client. Domyślnie, po wgraniu wtyczki, nie jest utworzony żaden plik konfiguracyjny, więc należy utworzyć i skonfigurować nowy. Plik konfiguracyjny przechowuje dane w formacie JSON.

Nazwa parametruOd wersjiOpisTyp parametru

Uwagi i ograniczenia

protocol*1.0.0

Określa sposób połączenia klienta z serwerem. Do wyboru są następujące protokoły:

  • FTP - przesyłane pliki, login i hasło nie są szyfrowane.
  • FTPS - zapewnia szyfrowanie przesyłanych danych dostępowych (login i hasło) podczas połączenia z serwerem. Nie szyfruje plików. Stanowi rozszerzenie standardowego protokołu FTP i wykorzystuje protokół SSL/TLS zapewniający poufność i integralność transmisji danych. Aby klient mógł korzystać z FTPS, na serwerze musi być skonfigurowany certyfikat SSL.
  • SFTP - zapewnia szyfrowanie zarówno przesyłanych plików, jak i danych dostępowych do serwera. Jego działanie opiera się na standardzie protokołu SSH.
TekstWielkość liter w polu nie ma znaczenia (case insensitive).
serverAddress*1.0.0Parametr wskazuje na adres serwera. Wartością może być nazwa domeny (np. websiteaddress.com) lub adres IP (np. 5.249.140.95).Tekst 
portNumber*1.0.0Numer portu protokołu.Całkowity 
userName*1.0.0Nazwa użytkownika skonfigurowanego na serwerze, który w zależności od nadanych mu uprawnień może operować na plikach na serwerze.Tekst 
password*1.0.0Hasło użytkownika.Tekst 
initDirectory1.0.XWskazuje lokalizację zapisu plików na serwerze. Podana ścieżka do katalogu może być absolutna lub względna. Ścieżka absolutna zaczyna się od ukośnika "/" i nie bierze pod uwagę bieżącej lokalizacji, w przeciwieństwie do ścieżki względnej, dla której bieżąca lokalizacja musi być znana, gdyż podajemy ścieżkę do katalogu względem tej lokalizacji. Tekst 

Parametr*- pole wymagane

Niektóre znaki i sposoby zapisywania nazw katalogów i plików w systemach Windows i Linux są zabronione. Aby pomyślnie wykorzystywać komponenty tej wtyczki, należy unikać znaków przedstawionych w poniższej tabeli.

WindowsLinux
  • " / \ < > ? : * |
  • Wszystkie znaki wpisywane przy użyciu klawisza Ctrl
  • Wszystkie nazwy kończące się spacją lub kropką
  • Maksymalna długość nazwy 260 znaków
  • /
  • Maksymalna długość nazwy 256 znaków

{
	"protocol":"ftp",
	"serverAddress":"192.168.0.240",
	"portNumber":21,
	"userName":"anowak",
	"password":"Workflow-u1F%H",
	"initDirectory":"/web/documents/"
}

Klasy ustawiające zmienne / Zadania automatyczne

NazwaWersjaKategoriaID przyciskuOpisSzczegóły
Wysyłanie dokumentów na serwer FTP1.0.0FTP Komponent pozwala na wysłanie wszystkich dokumentów danej klasy podpiętych do procesu na serwer FTP.Więcej...

Zadania zaplanowane

NazwaWersjaKategoriaID przyciskuOpisSzczegóły
Pobieranie dokumentów z serwera FTP1.0.1FTP Zadanie pobiera najnowsze pliki z serwera FTP do katalogu lokalnegoWięcej...

1.0.0 (obowiązująca dokumentacja)

  • Dodanie wtyczki

1.0.4(dokumentacja)

  • Obsługa protokołu SFTP

1.0.X

  • Dodanie nowego parametru initDirectory
 

System version required PWFL: 3.2.149

Plugin version required PWE: 2.3.50

Plugin version required PCM (Plugin Configuration Manager): 1.0.1

The server connection configuration must be in the Plugin Configuration Manager (PCM) configuration file on the Plus FTP Client tab. By default, after uploading a plugin, no configuration file is created, so new one needs to be created and configured. The configuration file stores data in JSON format.

Name of the parameterFrom versionDescriptionParameter typeNotes and restrictions
protocol*1.0.0

Specifies how the client connects to the server. The following protocols can be selected:

  • FTP - transferred files, login and password are not encrypted.
  • FTPS - provides encryption of transmitted access data when connected to the server. It is an extension of the standard FTP protocol and uses SSL/TLS protocol to ensure confidentiality and integrity of data transmission. An SSL certificate must be set up on the server for the client to use FTPS.
  • SFTP - provides encryption of both transmitted files and access data to the server. Its operation is based on the SSH protocol standard.
TextThe field is case-insensitive.
serverAddress*1.0.0The parameter indicates the server address. The value can be a domain name (e.g. websiteaddress.com) or an IP address (e.g. 5.249.140.95).Text 
portNumber*1.0.0Port number.Integer 
userName*1.0.0The name of the user configured on the server, which, depending on the privileges granted to him, can operate on files on the serverText 
password*1.0.0User password.Text 
initDirectory1.0.X
Indicates the location where the files are saved on the server. The directory path specified can be absolute or relative. An absolute path starts with a forward slash "/" and does not take the current location into account, 
unlike a relative path for which the current location must be known since we are specifying a directory path relative to that location.
Text 

Parameter*- required field

Certain characters and ways of writing directory and file names are prohibited in Windows and Linux. To use the components of this plugin successfully, avoid the characters shown in the table below.

WindowsLinux
  • " / \ < > ? : * |
  • All characters typed using the Ctrl key
  • All names ending with a space or a period
  • The maximum length of the name is 260 characters
  • /
  • The maximum length of the name is 256 characters

 

 


 

{
	"protocol":"ftp",
	"serverAddress":"192.168.0.240",
	"portNumber":21,
	"userName":"anowak",
	"password":"Workflow-u1F%H",
	"initDirectory":"/web/documents/"
}

Setters / Automatic tasks

NameVersionCategoryButton IDDescriptionDetails
Sending documents to an FTP server1.0.0FTP Sends all documents of a given class attached to the process to the FTP server.More...

Scheduled tasks

NameVersionCategoryButton IDDescriptionSzczegóły
Pobieranie dokumentów z serwera FTP1.0.1FTP Downloads the latest files from the FTP server to a local directoryMore...

1.0.0 (applicable documentation)

  • A plugin adding

1.0.4 (documentation)

  • Supprot for SFTP protocol

1.0.X

  • Adding new parameter initDirectory