Załączniki - UploadFile

Komponent załączania plików do wniosku

Właściwości komponentu

Właściwość Eximee Designer	Nazwa atrybutu w Źródle	Opis
Maksymalna liczba załączonych plików (sekcja Podstawowe właściwości)	numberOfUploadingFiles	Liczba plików, jaką można załadować w komponencie, domyślnie 1.
Liczba wymaganych załączników (sekcja Jakość danych)	requiredCount	Wymagana liczba plików do załączenia - domyślnie 0. Jeśli 0, to można nie załączyć żadnego pliku, jeśli więcej to zależnie od danej liczby.
Tekst wyświetlany na brak wymaganych załączników (sekcja Jakość danych)	requiredCountError	Komunikat wymagalności, wymagany jeśli zdefiniowana jest właściwość Liczba wymaganych załączników (requiredCount).
Maksymalny rozmiar pliku (sekcja Jakość danych)	maxFileSize	Maksymalny rozmiar pliku w KB. Domyślnie 1024 KB.
Maksymalny sumaryczny rozmiar wszystkich plików (sekcja Jakość danych)	maxTotalFilesSize	Maksymalny rozmiar wszystkich załączonych plików w KB. Domyślnie 10240 KB.
Pokaż listę dostępnych rozszerzeń (sekcja Interakcje)	showExtensionList	Włączenie opcji wyświetlania informacji o dopuszczalnych formatach oraz maksymalnym rozmiarze załączanego pliku (domyślnie opcja jest wyłączona). Przykładowa informacja: "Dopuszczalne formaty załączników: pdf (max. 1 MB)"
Włączenie kompresji obrazów (sekcja Interakcje)	imageCompressionEnabled	Możliwość kompresji obrazów (domyślna wartość "false").
Maksymalna szerokość zdjęcia z kamery (sekcja Interakcje)	maxWebcamWidth	Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach. Maksymalna szerokość zdjęcia z kamery w pikselach.
Maksymalna wysokość zdjęcia z kamery (sekcja Interakcje)	maxWebcamHeight	Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach. Maksymalna wysokość zdjęcia z kamery w pikselach.
Możliwość dołączenia zdjęcia wykonanego kamerą (sekcja Interakcje)	webcamEnabledCondition	Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach. Warunek włączający/wyłączający możliwość uploadu zdjęcia wykonanego kamerą wbudowaną w urządzenie.
Lista dozwolonych rozszerzeń plików (sekcja Bezpieczeństwo)	validExtensionList	Formaty dopuszczalnych rozszerzeń plików, wymieniane po przecinku, np.: jpg, jpeg, png, pdf.
Dodatkowa walidacja plików PDF (sekcja Bezpieczeństwo)	validateContent	Dodatkowa walidacja pliku pod kątem FORMATU pdf, a nie samego rozszerzenia.
Wyrażenie regularne do walidacji nazwy pliku (sekcja Bezpieczeństwo)	allowedFilenameRegexp	Wyrażenie regularne sprawdzające dopuszczalne nazwy pliku. Możliwe jest nadpisanie domyślnego komunikatu błędu walidacyjnego poprzez dopisanie do tłumaczeń wnioskowych klucza iew.gwtupload.invalid_filename i ustalenie nowej wartości tłumaczenia.
Możliwość dołączania opisów do załączonych plików (sekcja Pozostałe)	attachmentWithDescription	Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach. Wyświetlanie pola opisu dla każdego dodanego załącznika. Domyślnie właściwość wyłączona (ustawione na "false").
Maksymalna liczba znaków opisów do załączonych plików (sekcja Pozostałe)	attachmentDescriptionMaxLength	Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach. Maksymalna długość opisu, jaki można wprowadzić dla dodawanego załącznika. Domyślnie 120 znaków.
Etykieta przycisku (sekcja Pozostałe)	buttonLabel	Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach. Tekst wyświetlany na przycisku dodawania pliku.
Opis pola (sekcja Pozostałe)	description	Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach. Tekst opisu.
Włączenie kompresji obrazów (sekcja Pozostałe)		Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach. Właściwość pozwalająca na zmniejszanie załączanych obrazów.
Typ dokumentu - zaawansowana integracja (sekcja Pozostałe)	documentType	Pole techniczne używane przy zaawansowanej integracji (wymaga dodatkowej implementacji). Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach.
Numer kontaktowy - zaawansowana integracja (sekcja Pozostałe)	contractNumber	Pole techniczne używane przy zaawansowanej integracji (wymaga dodatkowej implementacji). Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach.
Typ procesu (sekcja Pozostałe)	processType	Nazwa procesu przekazywana do usługi zapisującej załączany plik w zasobie zewnętrznym. Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach.
Wywołanie walidatora zewnętrznego dla dodanego pliku	singleFileValidator	Wywołanie walidatora zewnętrznego dla dodanego pliku. Walidator wołany jest przy próbie dodania każdego pliku (jeśli załącznik nie przejdzie walidacji, to jest odrzucany). Właściwość należy dodać z poziomu Źródła xml.

Więcej informacji o właściwościach komponentu: Wspólne właściwości komponentów

Użycie komponentu

1

Dodanie pliku

Aby zaimportować plik za pomocą komponentu Załączniki, należy kliknąć przycisk Dodaj plik. Otworzy się wtedy systemowe okno wyboru pliku. Po wybraniu pliku zostanie on zaimportowany. Po zakończeniu importu nazwa pliku pojawi się na liście.

2

Usuwanie pliku

Zaimportowane pliki można usunąć, klikając przycisk Usuń widoczny przy nazwie pliku.

Ilustracja 1. Przykładowy wygląd komponentu na wniosku

Ilustracja 2. Przykładowy wygląd komponentu z przesłanym załącznikiem

Opis do załączonych plików

Dostępność funkcjonalności zależy od licencji i może nie być dostępna we wszystkich wdrożeniach.

Do załączonego pliku można dodać jego opis. W tym celu należy zaznaczyć pole Możliwość dołączania opisów do załączonych plików (attachmentWithDescription) (domyślnie pole jest wyłączone). Długość dodanego opisu można ustawić w polu Maksymalna liczba znaków opisów do załączonych plików (attachmentDescriptionMaxLength).

Parametry wejściowe komponentu

Właściwość	Opis
maxFileSize	Maksymalny rozmiar pliku w bajtach
validExtensionList	Lista dopuszczalnych rozszerzeń (jedno rozszerzenie per wiersz)
maxWebcamWidth	Maksymalna szerokość zdjęcia z kamery w pikselach
maxWebcamHeight	Maksymalna wysokość zdjęcia z kamery w pikselach

Parametry wyjściowe komponentu

Właściwość	Opis
totalFilesSize	Suma rozmiarów wszystkich plików dodanych za pomocą komponentu uploader'a
fileNames	Pobranie nazwy plików dodanych do kontrolki. Dane zwracane są w formacie JSON: ["nazwaPliku1", "nazwaPliku2", ...]
externalIds	Identyfikatory plików z zewnętrznej usługi, podobnie jak powyżej są zwracane w formacie JSON.

Jeśli chcemy w komponencie np. Polu tekstowym wyświetlić sumę rozmiarów wszystkich plików, możemy to zrobić z użyciem właściwości ŹRÓDŁO DANYCH Z INNEGO POLA (valueSourceId) komponentu, który ma wyświetlać wartość. W tym celu właściwość ŹRÓDŁO DANYCH Z INNEGO POLA przypisujemy następującą wartość: GesUploadFile1$totalFilesSize gdzie GesUploadFile1 jest identyfikatorem komponentu załącznika, natomiast totalFilesSize jest właściwością tego komponentu, której wartość zostanie wpisana. Przepisywanie wartości wymaga dodatkowo nasłuchiwania na komponent załącznika.

Definiowanie akcji czyszczenia komponentu

Dla komponentu możliwe jest zdefiniowanie na głównym szablonie wniosku akcji czyszczącej komponent z załączonego pliku. Więcej informacji w Akcje.

Wniosek demo: demoUploadFile

♿WCAG: Dobre praktyki WCAG dla low-code dev