← Powrót do listy dostępnych zadań automatycznych

 Jeśli masz problem ze zrozumieniem jak działa zadanie automatyczne, sprawdź opisy: Zadanie automatyczne, Wykonanie warunkowe, Parametry komponentów

Kategoria: Tools

Dostępne od wersji: 1.0.26

Komponent pobiera dokumenty podpięte do procesu lub z archiwum i zapisuje je pod wskazaną lokalizacją na dysku.

Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Źródło pobierania plików*1.0.26

Określa z jakiego źródła mają być pobierane pliki. Dostępne są 3 opcje:

  1. Proces - pobierane są dokumenty podpięte do procesu.
  2. Archiwum - pobierane są dokumenty z archiwum, z określonej klasy dokumentów.
  3. Identyfikatory plików z archiwum - pobierane są z archiwum wyszczególnione pliki po identyfikatorze.
Tekst Lista wartości
Wartość wyświetlanaWartość przekazywana
ProcesPROCESS
ArchiwumARCHIVE
Identyfikatory plików z archiwumFILEIDS

W przypadku wybrania opcji Proces lub Archiwum aplikacja pobiera tylko najwyższe wersje dokumentów.

Klasa dokumentów [Proces]1.0.26Nazwy klas dokumentów, z których pobierane są dokumenty. W przypadku pustej tablicy nazw klas dokumentów (nieuzupełnienia parametru), zostaną pobrane wszystkie dokumenty podłączone do procesu.Tablica wartości tekstowych Lista wartości 
Klasa dokumentów [Archiwum]*1.0.26Nazwa klasy dokumentów, z której pobierane są dokumenty.Tekst Lista wartości 

Nazwa indeksu

1.0.26Opcjonalne filtrowanie po indeksach wybranej klasy dokumentów. W tym parametrze określana jest nazwa indeksu.Tekst Lista wyboru / pole edytowalneLista indeksów po wybraniu klasy dokumentów z listy. Jeśli w parametrze Klasa dokumentów zostanie użyta zmienna lub funkcja to parametr ten z listy stanie się polem edytowalnym.
Wartość indeksu1.0.26Opcjonalne filtrowanie po indeksach wybranej klasy dokumentów. W tym parametrze określana jest wartość indeksu.Tekst Pole edytowalne 
Identyfikatory plików1.0.26Identyfikatory plików do pobrania z archiwum.Tablica liczb całkowitych Pole edytowalne 
Katalog*1.0.26

Bezwzględna ścieżka zapisu pliku na serwerze lub ścieżka wynikająca z jednego z dostępnych tagów.

Dostępne tagi:

  • {PWFL_HOME} - ścieżka do katalogu domowego systemu Plus Workflow
  • {WORKING_DIRECTORY} - ścieżka do katalogu tymczasowego ustawionego w parametrach systemowych ("WorkingDirectory")

Parametr wskazuje pod jaką lokalizacją mają zostać zapisane  dokumenty.

Tekst Pole edytowalne 
Nazwa pliku1.0.26Nazwa pliku zapisywanego na dysku. Za pomocą zmiennych kontekstowych: Nazwa pliku z rozszerzeniem, Nazwa pliku bez rozszerzenia, Rozszerzenie pliku można zmienić docelową nazwę pliku.Funkcja Pole edytowalne

Pole jest opcjonalne. W przypadku braku wprowadzenia jakiejkolwiek wartości, pole zostanie uzupełnione oryginalną nazwą pliku.

Filtr dla nazwy pliku1.0.XFiltr w formacie regex pozwalający na filtrowanie nazw plików źródłowych.Tekst Pole edytowalne 

Parametr*- pole wymagane

W sytuacji, gdy zapisuje się kilka dokumentów o takiej samej nazwie, to zostaną one zapisane z kolejnymi numerami w nazwie np. plik.txt, plik (1).txt, plik (2).txt. Jeśli zapisuje się plik w katalogu, w którym istnieje już plik o takiej samej nazwie, to zostanie on nadpisany.

Filtrując nazwę pliku za pomocą filtra regex należy pamiętać o znakach specjalnych, czyli jeśli chcemy np. wyszukać pliki z rozszerzeniem .docx to filtr przyjmie wartość: .*\.docx (backslash przed znakiem kropki).

 

 

Nazwa zmiennej kontekstowejOd wersjiOpisTyp parametru
Nazwa pliku z rozszerzeniem1.0.26Przechowuje nazwę pliku z rozszerzeniem aktualnie przetwarzanego dokumentu.
Tekst
Nazwa pliku bez rozszerzenia1.0.26Przechowuje nazwę pliku bez rozszerzeniem aktualnie przetwarzanego dokumentu.Tekst
Rozszerzenie pliku1.0.26Przechowuje rozszerzenie pliku aktualnie przetwarzanego dokumentu.Tekst

1.0.26

  • Dodanie komponentu

1.0.X

  • Dodanie możliwości filtrowania z wykorzystaniem regex
  • Dodanie możliwości użycia tagów w parametrze "katalog"

 ← Return to the list of applications

If you have a problem understanding how the action works, check: Automatic tasks, Conditional execution, Components params

Category: Tools

Available from version: 1.0.26

The component downloads documents attached to the process or from the archive and saves them to the indicated location on the disk.

Parameter name

From version

Description

Paremeter type

Default value

Field type

Comments and restrictions

Files download source* 

1.0.26

Specifies the source from which files should be downloaded. There are 3 options:

  1. Process - documents attached to the process are downloaded.
  2. Archive - documents are downloaded from the archive from a specified class of documents.
  3. File identifiers from the archive - specified files by identifier are downloaded from the archive.

Text

 

Editable field

Displayed valuePassed value
ProcessPROCESS
ArchiveARCHIVE
File identifiers from the archiveFILEIDS
Document class [Process]1.0.26Names of the document Classes from which documents will be retrieved. In case of an empty document class names array (parameter not completed), all documents attached to the process will be downloaded.Text values array Uneditable drop-down list 
Document class [Archive]*1.0.26The name of the document class from which documents will be retrieved.Text Uneditable drop-down list 
Index name1.0.26Optional filtering by indexes of the selected document class. This parameter specifies the name of the index.Text Uneditable drop-down list / editable field

Index list after selecting a document class from the list. If a variable or function is used in the Document class parameter, this parameter becomes an editable field.

Index value1.0.26Optional filtering by indexes of the selected document class. This parameter specifies the value of the index.Text Editable field 
File identifiers1.0.26Document identifiers to download from the archive.Integer values table Editable field 
Directory*1.0.26

Absolute path to save files on the server or path resolved by using one of the followed tags.

Available tags:

  • {PWFL_HOME} - path to Plus Workflow home directory
  • {WORKING_DIRECTORY} - path to temporary directory specified in system parameters ("WorkingDirectory")

The parameter indicates the location under which the documents attached to the process or from the archive will be saved.

Text Editable field 
File name1.0.26The name of the file saved on the disk. With the help of context variables: File name with extension, File name without extension, File extension, the target file name can be changed.Function Editable fieldThe field is optional. If no value is entered, the field will be completed with the original file name.
Filename filter1.0.XRegex filter for source filenames.Text Editable field 

Parameter*- mandatory field

In a situation where several documents with the same name will be saved, they would be saved with consecutive numbers in the name, e.g. file.txt, file (1).txt, file (2).txt. If a file is uploaded to a directory where a file with the same name already exists, it is overwritten.

Remember to escape special regex characters when using filename filter. Example searching for .docx files only - filter value: .*\.docx (backslash before literal dot character).

 

 

Context variable nameFrom versionDescriptionParameter type
File name with extension1.0.26Stores the file name with extension of the currently processed document.Text
File name without extension1.0.26Stores the file name without extension of the currently processed document.Text
File extension1.0.26Stores the file extension of the currently processed document.Text

1.0.26

  • Component adding

1.0.X

  • Add regex filename filter
  • Add tag support in "directory" parameter