Versions Compared

Old Version 7

changes.mady.by.user Kamil Rogowski

Saved on

compared with

New Version Current

changes.mady.by.user Joanna Jankowiak

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Image Added

 

Polish

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

Info

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

Panel
titlePodstawowe informacje

Kategoria: Tools

Dostępne od wersji: 1.0.

X

26

Panel
titleOpis

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

Panel
titleParametry konfiguracyjne
Nazwa parametruOd wersjiOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Źródło pobierania plików*1.0.X26

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
Dokumenty ze wszystkich klas dokumentów*

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

Klasa dokumentów [Proces]1.0.X26Decyduje, czy pobieranie dokumentów podpiętych do procesu ma być zawężone przez określoną klasę dokumentów. Gdy parametr jest ustawiony na Tak, pod uwagę będą brane wszystkie dokumenty bez względu na to do jakiej klasy dokumentów należą.Logiczny TakPole edytowalneParametr jest dostępny po wyborze opcji Proces w parametrze Źródło pobierania plików.Klasa dokumentówNazwy 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.X26Nazwa klasy dokumentów, z której pobierane są pobierane dokumenty.Tekst Lista wartości 

Nazwa indeksu

1.0.X26Opcjonalne 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.X26Opcjonalne filtrowanie po indeksach wybranej klasy dokumentów. W tym parametrze określana jest wartość indeksu.Tekst Pole edytowalne Pobierz najnowszą wersję1.0.XPobiera najnowszą wersję dokumentu w przypadku, gdy dokument posiada więcej niż jedną wersję.LogicznyTak
Pole edytowalneParametr jest dostępny po wyborze opcji Identyfikatory plików z archiwum w parametrze Źródło pobierania plików.Identyfikatory plików1.0.X26Identyfikatory plików do pobrania z archiwum.Tablica liczb całkowitych Pole edytowalne 
Katalog*1.0.2326Ścieżka

Bezwzględna ścieżka zapisu pliku na

dysku. 

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 dołączone do procesu lub z archiwum

zapisane  dokumenty.

Tekst Pole edytowalne 
Nazwa pliku1.0.2326Nazwa 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

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).

 

Znaki specjalne, które należy poprzedzić backslashem:

. + * ? ^ $ ( ) [ ] { } | \

Parametr*- pole wymagane

Warning

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.

Panel
titleZmienne kontekstowe
Nazwa zmiennej kontekstowejOd wersjiOpisTyp parametru
Nazwa pliku z rozszerzeniem1.0.X26Przechowuje nazwę pliku z rozszerzeniem aktualnie przetwarzanego dokumentu.
Tekst
Nazwa pliku bez rozszerzenia1.0.X26Przechowuje nazwę pliku bez rozszerzeniem aktualnie przetwarzanego dokumentu.Tekst
Rozszerzenie pliku1.0.X26Przechowuje rozszerzenie pliku aktualnie przetwarzanego dokumentu.Tekst
Panel
titlePrzykładowa konfiguracja

 Image Removed

Expand
titleŹródło pobierania plików - proces

Image Added

Expand
titleŹródło pobierania plików - archiwum

Image Added

Expand
titleŹródło pobierania plików - identyfikatory plików z archiwum

Image Added

Panel
titleChange log

 1.0.X26

  • Dodanie komponentu

 

 

1.0.X

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

 ← Return to the list of applications

Info

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

Panel
titleBasic information

Category:

Attachment

Tools

Available from version: 1.0.

23

26

Panel
titleDescription

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

Panel
titleConfiguration parameters

Parameter name

From version

Description

Paremeter type

Default value

Field type

Comments and restrictions

Files download source* 

1.0.X26

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
Documents from all classes of documents*Document class [Process]1.0.X26Decides whether downloading of documents attached to a process should be narrowed down by selecting a specific class of documents. When the parameter is set to Yes, all documents will be taken into account, no matter what class of documents they belong to.LogicYesEditable fieldThe parameter is available after selecting the Process option in Files download source parameter.Document classNames 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.X26The name of the document class from which documents will be retrieved.Text Uneditable drop-down list 
Index name1.0.X26Optional 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.X26Optional filtering by indexes of the selected document class. This parameter specifies the value of the index.Text Editable field Download the newest version1.0.XDownloads the latest version of the document in case the document has more than one version.LogicYesEditable field
The parameter is available after selecting File identifiers from the archive option in Files download source parameter.File identifiers1.0.X26Document identifiers to download from the archive.Integer values table Editable field 
Directory*1.0.X26The

Absolute path to save

the file

files on the

disk.

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.X26The 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

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

 

Special characters that need to be escaped with a backslash:

. + * ? ^ $ ( ) [ ] { } | \

Parameter*- mandatory field

Warning

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.

Panel
titleContext variables
Context variable nameFrom versionDescriptionParameter type
File name with extension1.0.X26Stores the file name with extension of the currently processed document.Text
File name without extension1.0.X26Stores the file name without extension of the currently processed document.Text
File extension1.0.X26Stores the file extension of the currently processed document.Text
Panel
titleConfiguration example
Image Removed
Expand
titleFiles download source - process

Image Added

Expand
titleFiles download source - archive

Image Added

Expand
titleFiles download source - file identifiers from the archive

Image Added

Panel
titleChange log

1.0.X26

  • Component adding

1.0.X

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