Page History

Polish

Panel

bgColor	white
titleBGColor	light
title	Podstawowe informacje

Pakiet: com.suncode.plugin.ftp.task.DownloadFilesFromFTPTask

Kategoria: FTP

Dostępna od wersji: 1.0.1

Panel

bgColor	white
titleBGColor	light
title	Wymagania

Poprawna konfiguracja połączenia z serwerem FTP. W zakładce Konfiguracja wtyczek

Panel

bgColor	white
titleBGColor	light
title	Opis

Zadanie pobiera najnowsze pliki z serwera FTP do katalogu lokalnego. Pliki mogą być nadpisywane lub dodane jako nowe ze zmienioną nazwą. Zadanie umożliwia także skasowanie pobranych plików z serwera FTP pod warunkiem, że użytkownik (którym się logujemy) posiada do tego uprawnienia. Pobierane są tylko pliki z danego katalogu na serwerze (nie są przeszukiwane ani pobierane katalogi). Zadanie po pobraniu plików zapisuję w bazie lokalnej najnowszą datę zmodyfikowanego pliku na serwerze FTP i następne odpalenie zadania pobiera nowsze pliki od tej daty. Aby pobrać pliki z wcześniejszą datą, należy zmodyfikować wpis w tabeli w bazie danych przed uruchomieniem tego zadania.

Panel

bgColor	white
titleBGColor	ligth
title	Parametry konfiguracyjne

Nazwa parametru	od wersji	Opis	Typ parametru	Uwagi i ograniczenia
Plik konfiguracyjny	1.0.1	Nazwa pliku konfiguracyjnego pochodząca z panelu wtyczki zarządzania konfiguracjami wtyczek, w którym znajdują się informacje konfiguracyjne dotyczące połączenia z serwerem. UWAGA: Zmiana nazwy pliku konfiguracyjnego wpływa na datę od której będą pobierane dokumenty. W przypadku nowej konfiguracji, zostaną pobrane wszystkie pliki z serwera. W przypadku konfiguracji, którą wcześniej była używana w tym zadaniu, zostaną pobrane pliki od daty ostatniego uruchomienia w ramach wskazanej konfiguracji. Drugim kluczem wpływającym na datę jest id zadania zaplanowanego (każde zadanie posiada swój osobny kalendarz)	Tekst	Opis Wtyczki i konfiguracji połączenia FTP
Ścieżka do katalogu	1.0.1	Ścieżka do katalogu na serwerze, z którego będą pobierane pliki. Podkatalogi są ignorowane.	Tekst
Katalog lokalny	1.0.1	Ścieżka do katalogu lokalnego, do którego będą zapisywane pobrane dokumenty z serwera FTP.	Tekst
Usuń pobrane pliki z serwera FTP	1.0.1	true - Usuwa pliki na serwerze FTP po ich pobraniu. Jeżeli użytkownik ma takie uprawnienia. false - pliki zostają na serwerze FTP.	Logiczny	Usuwa gdy plik zostanie poprawnie pobrany, oraz użytkownik ma uprawnienia do usuwania dokumentów na serwerze FTP.
Nadpisz istniejące pliki	1.0.1	true - Nadpisuje istniejące pliki na dysku lokalnym. false- Jeżeli dany plik znajduję się na dysku, to dopisuję cyfrę na końcu w nazwie pliku.	Logiczny	W sytuacji, gdy pobieramy dokumenty które już znajdują się w katalogu lokalnym, to (jeżeli parametr "Nadpisz istniejące pliki" ustawiony jest na false) zostaną one zapisane z kolejnymi numerami w nazwie np. plik.txt, plik (1).txt, plik (2).txt, plik (3).txt.

Panel

bgColor	white
titleBGColor	ligth
title	Tabela w bazie danych : "pm_plusftp_modification_time"

Kolumna	od wersji	Opis	Typ kolumny	Uwagi i ograniczenia
id	1.0.1	Klucz główny tabeli	Liczbowy	Automatyczne generowanie wartości
task_id	1.0.1	Identyfikator zadania zaplanowanego	Liczbowy	Wartość unikalna, brak nuli
task_name	1.0.1	Nazwa zadania zaplanowanego	Tekstowy	Aktualizowana wraz z aktualizacją daty
last_modification_time	1.0.1	Data modyfikacji najnowszego pliku pobranego na serwer lokalny	timestamp	Pobierane będą wszystkie pliki serwera ftp które mają późniejszą datę od tej
config_id	1.0.X	Nazwa pliku konfiguracyjnego	Tekstowy

Panel

bgColor	white
titleBGColor	ligth
title	Przykładowa konfiguracja

Przykład Zadania zaplanowanego

Przykład tabeli pm_plusftp_modification_time w bazie danych

Panel

bgColor	white
titleBGColor	light
title	Change log

1.0.1 (obowiązująca dokumentacja)

Utworzenie zadania zaplanowanego

1.0.6

Dodatnie asercji sprawdzającej istnienie katalogu na serwerze

1.0.7 (obowiązująca dokumentacja)

Dodatnie kolumny config_id do tabeli w bazie danych

1.0.8 (obowiązująca dokumentacja)

Usunięcie wymagalności NOT NULL z kolumny config_id w tabeli pm_plusftp_modification_time.

English

Panel

bgColor	white
titleBGColor	light
title	Basic information

Package: com.suncode.plugin.ftp.task.DownloadFilesFromFTPTask

Category: FTP

Available from version: 1.0.1

Panel

bgColor	white
titleBGColor	light
title	Requirements

Correct configuration of the connection with the FTP server. On the Plug-in configuration tab

Panel

bgColor	white
titleBGColor	light
title	Description

The job downloads the latest files from the FTP server to a local directory. Files can be overwritten or added as new files with a changed name. Tasks also allows you to delete downloaded files from the FTP server, provided that the user (which you are logging in to) has the right to do so. Only files in a given directory on the server are downloaded (directories are not searched or downloaded). After downloading the files, the task saves the latest date of the modified file on the FTP server in the local database and the next task firing downloads newer files from that date. If you want to retrieve files with an earlier date, you must edit the table entry in the database before running this task.

Panel

bgColor	white
titleBGColor	ligth
title	Configuration parameters

Parameter name	from version	Description	The type of the parameter	Notes and Restrictions
Configuration file	1.0.1	The name of the configuration file from the plug-in configuration management plug-in panel, which contains configuration information regarding the connection to the server.	String	Description of the Plug and FTP connection configuration
Path to directory	1.0.1	Path to the directory on the server from which the files will be downloaded. Subdirectories are ignored.	String
Local directory	1.0.1	Path to the local directory where documents downloaded from the FTP server will be saved.	String
Delete the downloaded files from the FTP server	1.0.1	true - Deletes files on the FTP server after downloading them. If the user has such rights. false - files remain on the FTP server.	Boolean	Deletes when the file is successfully downloaded and the user has permission to delete documents on the FTP server.
Overwrite existing files	1.0.1	true - Overwrite existing files on local disk. false- If the given file is on the disk, I add a number to the end in the name of the file.	Boolean	When we download documents that are already in the local directory, then (if the "Overwrite existing files" parameter is set to false) they will be saved with consecutive numbers in the name, e.g. file.txt, file (1) .txt, file (2) .txt, (3) .txt file.

Panel

bgColor	white
titleBGColor	ligth
title	Tablea in the database: "pm_plus_ftp_modification_time"

Column	from version	Description	Column type	Notes and Restrictions
id	1.0.1	The primary key of the table	Liczbowy	Automatic value generation
task_id	1.0.1	Scheduled task ID	Liczbowy	Unique value, no nulls
task_name	1.0.1	Scheduled task name	Tekstowy	Updated with the date update
last_modification_time	1.0.1	Modified date of the most recent file downloaded to the local server	timestamp	All ftp server files that have a later date than this will be downloaded

Panel

title	Sample configuration

An example of a Scheduled Task

Example of pm_plusftp_modification_time table in database

Panel

bgColor	white
titleBGColor	light
title	Change log

1.0.1 (applicable documentation)

Create a scheduled task

1.0.6

adding an assertion to check the existence of a directory on the server

1.0.7 (applicable documentation)

Adding a config_id column in pm_plusftp_modification_time table.

1.0.8 (applicable documentation)

Removing NOT NULL constraint from config_id column in pm_plusftp_modification_time table.

Versions Compared

Old Version 20

New Version 21

Key