Powrót do spisu komponentów: Plus Attachments

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

Kategoria: Attachment

Umiejscowienie akcji: Tabela

Dostępna od wersji: 1.0.5

Akcja dodaje w wybranej kolumnie zestaw opcji do zarządzania dokumentami w procesie. Dostępnych jest 6 opcji, które pełnią rolę podglądu, dodawania, odłączania, pobierania do zmiany, zapisywania zmiany i anulowania zmiany. Wyświetlane są w formie przycisków lub rozwijanego menu kontekstowego pod postacią ikony. Konfiguracja akcji pozwala na zdefiniowanie, które przyciski mają pojawiać się w każdym wierszu tabeli. Komponent posiada zmienną kontekstową Wybrany wiersz przechowującą numer zaznaczonego wiersza. Dzięki tej zmiennej można np. ustawić inną klasę dokumentów lub nazwę przycisku w zależności od wybranego wiersza. W historii zadania wyświetlany jest tylko przycisk podglądu dokumentu o ile nie został ukryty. 

Nazwa parametruOpisTyp parametruWartość domyślnaRodzaj polaUwagi i ograniczenia
Sposób wyświetlania*Określa w jakiej formie mają prezentować się funkcje do zarządzania dokumentami w tabeli. Wybranie menu kontekstowego spowoduje zbudowanie ikony z rozwijanym menu kontekstowym zawierającym opcje, które zostały zdefiniowane w kolejnych parametrach. Wybranie przycisków spowoduje, że zostaną utworzone przyciski zamiast ikony z menu.TekstPrzyciskiNieedytowalna lista rozwijalna
Wartość wyświetlanaWartość przekazywana
Menu kontekstoweCONTEXT-MENU
PrzyciskiBUTTONS
Kolumna na ikonę lub przyciski*Kolumna w tabeli, w której ma pojawić się ikona z menu kontekstowym lub przyciski.Zmienna Pole edytowalneZmienna w tabeli, w której ma być wyświetlana akcja. Należy ustawić zmienną tabelaryczną tylko do odczytu.
Kolumna dla id pliku*Kolumna dla informacji zwrotnej o podłączonym pliku. Kolumna w której przechowywany jest identyfikator pliku.Zmienna Pole edytowalneZmienna tabelaryczna musi być typu tekstowego
Kolumna dla id dokumentuKolumna dla informacji zwrotnej o podłączonym dokumencie. Wartość jest zwracana podczas dodawania dokumentu.Zmienna Pole edytowalneZmienna tabelaryczna musi być typu tekstowego
Kolumna dla nazwy plikuKolumna dla informacji zwrotnej o podłączonym dokumencie. Wartość jest zwracana podczas dodawania dokumentu.Zmienna Pole edytowalne 
Kolumna dla daty wgraniaKolumna dla informacji zwrotnej o podłączonym dokumencie. Wartość jest zwracana podczas dodawania dokumentu.Zmienna Pole edytowalne 
Kolumna dla opisuKolumna dla informacji zwrotnej o podłączonym dokumencie. Wartość jest zwracana podczas dodawania dokumentu.Zmienna Pole edytowalne 
Kolumna dla klasy dokumentuKolumna dla informacji zwrotnej o podłączonym dokumencie. Wartość jest zwracana podczas dodawania dokumentu.Zmienna Pole edytowalne 
Ukryj przycisk podglądu*Pole ustawione na tak powoduje ukrycie przycisku i konfiguracji z nim związanej. Podgląd umożliwia przejrzenie załączonego pliku w nowym oknie. Jeśli format pliku uniemożliwia odczytanie zawartości pliku to zostanie on pobrany na dysk lokalny.LogicznyNiePole edytowalne 
Nazwa przycisku podgląduNazwa przycisku podglądu dokumentu.TekstPokaż załącznikPole edytowalneW przypadku wybrania w parametrze Sposób wyświetlania przycisków zamiast menu kontekstowego, to tekst wyświetlany będzie w formie tooltip'u.
Ikona przycisku PodgląduNazwa ikony, która wyświetla się w obrębie elementu przycisku.TekstzoomNieedytowalna lista rozwijalnaNazwa ikony wybieranej z listy rozwijanej.
Ukryj przycisk podłączania*Pole ustawione na tak powoduje ukrycie przycisku i konfiguracji z nim związanej. Dodawanie umożliwia załączenie dokumentu do procesu.LogicznyNieNieedytowalna lista rozwijalna 
Nazwa przycisku podłączaniaNazwa przycisku dodawania dokumentu.TekstDodaj załącznikPole edytowalneW przypadku wybrania w parametrze Sposób wyświetlania przycisków zamiast menu kontekstowego, to tekst wyświetlany będzie w formie tooltip'u.
Ikona przycisku podłączaniaNazwa ikony, która wyświetla się w obrębie elementu przycisku.TekstaddNieedytowalna lista rozwijalnaNazwa ikony wybieranej z listy rozwijanej.
Nazwy klasNazwy klas dokumentów, które pojawią się na liście w oknie dodawania dokumentów.Tablica wartości tekstowych Nieedytowalna lista rozwijalnaKonfiguracja okna dodawania pliku. Gdy nie ma wartości to w oknie dodawania będą wyświetlane wszystkie klasy dokumentów.
Pokaż indeksy*Wyświetla okno konfiguracji indeksów klasy dokumentów w oknie dodawania dokumentu.LogicznyNieNieedytowalna lista rozwijalnaKonfiguracja okna dodawania pliku.
Sprawdź uprawnienia do dodawania*Sprawdza uprawnienia użytkownika do klasy dokumentów podczas dodawania dokumentu.LogicznyTakNieedytowalna lista rozwijalnaKonfiguracja okna dodawania pliku.
Wybierz pierwszą klasę*Wybiera pierwsza klasę z listy klas w oknie dodawania dokumentu.LogicznyTakNieedytowalna lista rozwijalnaKonfiguracja okna dodawania pliku.
Opis plikuWypełnienie wartości Opis pliku w oknie dodawania dokumentówTekst Pole edytowalneKonfiguracja okna dodawania pliku.
Komunikat udanego dołączenia dokumentu*Treść komunikatu który zostanie wyświetlony w chmurce, po poprawnym dołączeniu dokumentu do procesu. Tekst może być zapisany za pomocą tagów HTML.TekstDodano nowy dokumentPole edytowalne 
Ukryj przycisk odłączania*Pole ustawione na tak powoduje ukrycie przycisku i konfiguracji z nim związanej. Odłączanie polega na usunięciu dokumentu z archiwum lub odłączeniu dokumentu z procesu w zależności od konfiguracji pozostałych parametrów w tej sekcji.LogicznyNieNieedytowalna lista rozwijalna 
Nazwa przycisku odłączaniaNazwa przycisku usuwania dokumentu.TekstOdłącz załącznikPole edytowalneW przypadku wybrania w parametrze Sposób wyświetlania przycisków zamiast menu kontekstowego, to tekst wyświetlany będzie w formie tooltip'u.
Ikona przycisku odłączaniaNazwa ikony, która wyświetla się w obrębie elementu przycisku.TekstdeleteNieedytowalna lista rozwijalnaNazwa ikony wybieranej z listy rozwijanej.
Usuwanie z archiwum*Ustawienie na tak, spowoduje przy operacji odłączania usunięcie pliku z archiwum. Z kolei opcja ustawiona na nie, spowoduje odłączenie pliku z procesu. LogicznyNieNieedytowalna lista rozwijalna

Warto mieć na uwadze, że w zależności jak zostanie ustawiony ten parametr, to w inny sposób będą sprawdzane uprawnienia dla przycisku odłączania.

Parametr ustawiony na Tak:

  • sprawdzanie, czy użytkownik jest właścicielem pliku i jego nowszych wersji,
  • sprawdzanie uprawnień usuwania użytkownika do klasy dokumentów.

Parametr ustawiony na Nie:

  • sprawdzanie, czy użytkownik jest właścicielem pliku i jego nowszych wersji.
Usuwanie wiersza*Ustawienie na tak spowoduje usunięcie wiersza wraz z odłączeniem dokumentu. Ustawienie na nie sprawia, że wiersz pozostaje, a informacje o dokumencie są kasowane w danym wierszu.LogicznyNieNieedytowalna lista rozwijalna 
Ostrzegaj przed odłączeniem*Ustawienie na tak spowoduje, że przed odłączeniem dokumentu wyświetlane jest okno potwierdzające daną czynność. Z kolei ustawienie na nie sprawia, że dokumenty są natychmiast odłączane.LogicznyTakNieedytowalna lista rozwijalna 
Tytuł oknaTytuł okna potwierdzeniaTekstOdłączanie załącznikaPole edytowalne 
Treść oknaTreść jaka pojawi się w oknie potwierdzenia. Wciśniecie TAK spowoduje wykonanie akcji (odłączenie dokumentu)TekstCzy na pewno chcesz odłączyć dokument?Pole edytowalne 
Ukryj przycisk pobierania do zmiany*W przypadku zaznaczanie na tak, powoduje ukrycie przycisku i konfiguracji z nim związanej. Ustawienie na nie sprawi, że wraz z przyciskiem pobierania do zmiany zostaną wyświetlone przyciski do zapisywania zmiany i cofania zmiany. Wszystkie trzy razem zapewniają możliwość tworzenia nowych wersji plików określonego dokumentu.LogicznyTakNieedytowalna lista rozwijalna 
Nazwa przycisku Pobierania do zmianyNazwa przycisku pobierania do zmiany dokumentu.TekstPobierz do zmianyPole edytowalneW przypadku wybrania w parametrze Sposób wyświetlania przycisków zamiast menu kontekstowego, to tekst wyświetlany będzie w formie tooltip'u.
Ikona przycisku pobierania do zmianyNazwa ikony, która wyświetla się w obrębie elementu przycisku.Tekstarrow-downNieedytowalna lista rozwijalnaNazwa ikony wybieranej z listy rozwijanej
Nazwa przycisku zapisywania zmianyNazwa przycisku do zapisywania zmiany dokumentu.TekstWyślij zmianyPole edytowalneW przypadku wybrania w parametrze Sposób wyświetlania przycisków zamiast menu kontekstowego, to tekst wyświetlany będzie w formie tooltip'u.
Ikona przycisku zapisywania zmianyNazwa ikony, która wyświetla się w obrębie elementu przycisku.Tekstarrow-upNieedytowalna lista rozwijalnaNazwa ikony wybieranej z listy rozwijanej
Nazwa przycisku anulowania zmianyNazwa przycisku anulowania zmiany dokumentu.TekstAnuluj zmianyPole edytowalneW przypadku wybrania w parametrze Sposób wyświetlania przycisków zamiast menu kontekstowego, to tekst wyświetlany będzie w formie tooltip'u.
Ikona przycisku anulowania zmianyNazwa ikony, która wyświetla się w obrębie elementu przycisku.TekstcancelNieedytowalna lista rozwijalnaNazwa ikony wybieranej z listy rozwijanej

Parametr*- pole wymagane

Akcja uwzględnia systemowe uprawnienia użytkowników do klas dokumentów. W związku z tym, jeśli użytkownik nie posiada odpowiednich uprawnień do wykonania określonych czynności, na jakie pozwala ta akcja, to nie pojawią się w procesie przyciski dotyczące tych czynności.

Nazwa zmiennej kontekstowejOd wersjiOpisTyp parametru
Wybrany wiersz1.0.10Przechowuje informacje o indeksie obecnie ustawianego wiersza.
Całkowita

W przypadku przycisku odłączania, czyli czynności usuwania lub odłączania dokumentu z procesu, sprawdza się, czy użytkownik jest właścicielem danego pliku i jego nowszych wersji. Jeśli przy próbie odłączenia lub usunięcia użytkownik nie jest właścicielem pliku (nie dodał pliku do procesu) lub jego nowszych wersji, operacja nie będzie mogła zakończyć się pomyślnie, ponieważ przycisk nie zostanie wyświetlony. Przykładowo jeśli w tabeli dynamicznej występują 3 wersje dokumentu, przy czym pierwsze dwie zostały dodane przez użytkownika X, a trzecia przez użytkownika Y, to nie będzie możliwe odłączenie wersji drugiej przez użytkownika X.

  1. Akcja z parametrem Sposób wyświetlania ustawionym na przyciski

  1. Akcja z parametrem Sposób wyświetlania ustawionym na przyciski
  • Tabela przed dodaniem dokumentu
  • Tabela po dodaniu dokumentu
  • Tabela po pobraniu pliku do zmiany
  • Tabela po wysłaniu zmienionego pliku

  • Tabela po odłączeniu dokumentu

1.0.5

  • Dodanie komponentu

1.0.10

  • Ukrywanie przycisków

1.0.16

  • Dodanie opcji pobierania i wysyłania zmiany pliku

 AttchmentExample.zip 

  ← Return to the list of available actions

If you have a problem understanding how the action works, check: Action, Conditional execution, Components parameters

Category: Attachment

Action location: Table

Available from version: 1.0.5

Action adds a set of options for managing documents in the process in selected column. There are 6 options for preview, adding, detaching, checking out, saving change and canceling change. They are displayed in the form of buttons or a drop-down context menu in the form of an icon. Action configuration allows to define which buttons will appear in each row of the table. Component has a context variable called Selected row that stores selected row number. Thanks to this variable it is possible e.g. to set a different document class or button name depending on the selected row. In the activity history only document preview button is displayed, unless hidden.

Parameter name

Description

Paremeter type

Default value

Field type

Comments and restrictions

Display method*Defines the form in which the document management functions should be presented in the table. Selecting the context menu will build an icon with a drop-down context menu containing the options that have been defined in the following parameters. When buttons are selected, buttons will be created instead of the menu icon.TextButtons

Uneditable drop-down list

Displayed valuePassed values
Context menuCONTEXT-MENU
ButtonsBUTTONS
Column for icon or buttons*Column in the table where the context menu or buttons should appear.Variable Editable fieldVariable in the table where the actions have to be displayed. Tabular variable has to be read-only.
Column for file id*Feedback column for the attached file.Variable Editable fieldTabular variable must have defined text type instead of integer.

Column for document id

Feedback column for the attached document. Value is returned when adding a document.

Variable

 

Editable field

Tabular variable must have defined text type instead of integer.

Column for file nameFeedback column for the attached document. Value is returned when adding a document.Variable Editable field 
Column for upload dateFeedback column for the attached document. Value is returned when adding a document.Variable Editable field 
Column for descriptionFeedback column for the attached document. Value is returned when adding a document.Variable Editable field 
Column for document classFeedback column for the attached document. Value is returned when adding a document.Variable Editable field 
Hide show button*Field set to yes hides the button and related configuration. Show button allows to view attached file in a new window. If the file format makes it impossible to read contents of the file, it will be downloaded to local disk instead.LogicNoEditable field 
Show button nameName of the document show button.TextPokaż załącznikEditable fieldIn case of choosing in Display method parameter buttons instead of context menu, then text will be displayed as a tooltip.
Show button iconName of the icon that is displayed within the button element.TextzoomUneditable drop-down listName of the icon selected from the drop-down list.
Hide add button*Field set to yes hides the button and related configuration. Adding allows to attach a document to the process.LogicNoUneditable drop-down list 
Add button nameName of the document add button.TextDodaj załącznikEditable fieldIn case of choosing in Display method parameter buttons instead of context menu, then text will be displayed as a tooltip.
Add button iconName of the icon that is displayed within the button element.TextaddUneditable drop-down listName of the icon selected from the drop-down list.
Class namesNames of document classes that will appear on the list in the document add window.Text values table Uneditable drop-down listIf there is no any typed value, all document classes will be displayed in the document add window.
Show indexes*Displays the document class index configuration window in the add Document window.LogicNoUneditable drop-down listFile adding window configuration.
Check adding permissions*Checks the user's permissions to the document class while adding a document.LogicYesUneditable drop-down listFile adding window configuration.
Choose the first class*Selects the first class from the list of classes in the add document window.LogicYesUneditable drop-down listFile adding window configuration.
Description of the fileFilling in description of the file value in the window for adding documents.Text Editable fieldFile adding window configuration.
Message of successful attachment of the document*Content of the message that will be displayed in the tooltip after the document has been correctly attached to the process. Text can be saved using HTML tags.TextDodano nowy dokumentEditable field 
Hide detach button*Field set to yes hides the button and related configuration. Detaching removes the document from the archive or detaches the document from the process, depending on the configuration of the other parameters in this section.LogicNoUneditable drop-down list 
Detach button nameName of the document detach button.TextOdłącz załącznikEditable fieldIn case of choosing in Display method parameter buttons instead of context menu, then text will be displayed as a tooltip.
Detach button iconName of the icon that is displayed within the button element.TextdeleteUneditable drop-down listName of the icon selected from the drop-down list.
Deleting from the archive*If set to yes, the file is removed from the archive during detach operation. However, an option set to no will detach the file from the process.LogicNoUneditable drop-down list

Note that depending on how this parameter is set, the permissions for detach button will be checked in a different way.

Parameter set to Yes:

  • checking, if user is the owner of the file and its newer versions,
  • checking user delete permission to document class.

Parameter set to No:

  • checking, if user is the owner of the file and its newer versions.

 

Delete a row*If set to yes, the row will be deleted and the document will be detached. If set to no, the row remains, and the document information is deleted in that row.LogicNoUneditable drop-down list 
Warn against detach*If set to yes, the confirmation window will be displayed before the document is detached. However, setting it to no causes that documents are immediately detached.LogicYesUneditable drop-down list 
Window titleConfirmation window title.TextOdłączanie załącznikaEditable field 
Content of the windowContent that will appear in the confirmation window. Pressing YES will perform the action (detach the document).TextCzy na pewno chcesz odłączyć dokument?Editable field 
Hide check out button*Field set to yes hides the button and related configuration. Setting to yes causes that check out and cancel buttons will be displayed along with the check out button. All three together provide an ability to create new versions of files for a specific document.LogicYesUneditable drop-down list 
Check out button nameName of the document check out button.Text Editable fieldIn case of choosing in Display method parameter buttons instead of context menu, then text will be displayed as a tooltip.
Check out button iconName of the icon that is displayed within the button element.Text Uneditable drop-down listName of the icon selected from the drop-down list.
Check in button nameName of the document check in button.Text Editable fieldIn case of choosing in Display method parameter buttons instead of context menu, then text will be displayed as a tooltip.
Check in button iconName of the icon that is displayed within the button element.Text Uneditable drop-down listName of the icon selected from the drop-down list.
Cancel change button nameName of the document cancel change button.Text Editable fieldIn case of choosing in Display method parameter buttons instead of context menu, then text will be displayed as a tooltip.
Cancel change button iconName of the icon that is displayed within the button element.Text Uneditable drop-down listName of the icon selected from the drop-down list.

Parameter*- mandatory field

Action takes into account system users' rights to document classes. Therefore, if the user does not have the appropriate permissions to perform specific actions allowed by this action, buttons related to these actions will not appear in the process.

Context variable nameFrom versionDescriptionParameter type
Selected row1.0.10Stores the index information of the currently set row.Integer

In case of detach button, that is, the action of removing or detaching a document from a process, it is checked whether the user is the owner of the file and its newer versions. If the user does not own the file (did not add the file to the process) or its newer versions when trying to detach or delete, the operation will not be successful because the button will not be displayed. For example, if there are 3 versions of a document in a dynamic table, with the first two added by user X and the third by user Y, it will not be possible to detach the second version by user X.

  1. Action with parameter Display method set to buttons



  1. Action with parameter Display method set to buttons
  • Table before adding the document
  • Table after adding the document
  • Table after checking out the docucment
  • Table after checking in the document

  • Table after detaching the document

1.0.5

  • Adding a component

1.0.10

  • Hiding buttons

1.0.16

  • Adding check out and check buttons