Page History

...

Polish

Table Filter

id	1688026084039_-187725289

Panel

title	Informacje ogólne

Kategoria: Arkusze danych

Pobierz: >>LINK<<

Panel

title	Opis

Wtyczka zawiera implementację źródeł danych operujących na arkuszach danych. Obsługiwane typy plików: .xls, .xlsx i pochodne.

Za pomocą opisywanych źródeł danych można odczytywać jak i zapisywać dane do arkuszy danych w formatach marki Microsoft.

Info
Obsługiwany arkusz musi w pierwszym wierszu zawierać nagłówki kolumn.

Przykładowy obsługiwany arkusz:

View file

name	file_example_XLS_100.xls
height	150

Wszystkie przykłady konfiguracji w dalszej części dokumentacji operują na powyższym pliku.

Info
Od wersji systemu 4.0.38 wyświetlane są komunikaty informacyjne w przypadku wystąpienia problemów z konfiguracją (np. nie znaleziono pliku).

Panel

title	Konfiguracja

Expand

title	Odczyt

Nazwa parametru

Opis parametru

Wymagalność

Uwagi

Źródło pliku

Źródło, na którym znajduje się plik wskazany w ścieżce.

Wymagany

Opcja "Google Drive" do prawidłowego działania wymaga zainstalowanej wtyczki Plus Google Cloud Integrator

Id konfiguracji połączenia z GoogleCloud

Konfiguracje połączeń realizowane są w zakładce "Konfiguracja wtyczek" (PCM).

Opcjonalny

Parametr związany z opcją "Źródło pliku" = "Google Drive"

Id pliku w google drive

Identyfikator pliku na Dysku Google. Identyfikator pliku można znaleźć w adresie URL pliku otwieranego na Dysku Google. Jest to kombinacja liter i cyfr występujących po „d/” w linku: https://docs.google.com/spreadsheets/d/***ThisIsFileID***/edit#gid=123456789.

Opcjonalny

Parametr związany z opcją "Źródło pliku" = "Google Drive"

Ścieżka do pliku

Absolutna ścieżka do pliku na dysku.

Info

title	Znaczniki dostępne od wersji 1.0.6

{PWFL_HOME} - wstawia automatycznie ścieżkę do katalogu domowego systemu PlusWorkflow.
{WORKING_DIRECTORY} - wstawia automatycznie ścieżkę do katalogu tymczasowego ustawionego w parametrach systemowych ("WorkingDirectory").
FILEID:{<id_pliku>} - wstawia automatycznie ścieżkę do pliku znajdującego się w systemie o wskazanym id. Słowo kluczowe <id_pliku> należy zastąpić konkretnym identyfikatorem pliku z systemu.

Wymagany

Nazwa arkusza

Nazwa konkretnego arkusza w pliku.

Wymagany

Domyślne formatowanie liczb

Domyślne formatowanie liczb zwraca wartości "widziane" jak w dokumencie. Po odznaczeniu parametru formatowanie nie jest stosowane.

Wymagany

Domyślna wartość: TAK

Domyślne formatowanie ma wpływ na:

wartości liczbowe odczytane z pliku Excel, np. w pliku Excel wartość w komórce typu liczbowego wynosząca np. 2002,9632 zostanie odczytana jako 2,002.9632

Po wyłączeniu opcji formatowania wartość liczbowa zostanie odczytana jako 2002,9632

[Parametry ścieżki] Id

Id parametru ścieżki, podstawiany do ścieżki.

Opcjonalny

[Parametry ścieżki] Nazwa

Nazwa parametru ścieżki wyświetlana w systemie.

Opcjonalny

[Definicja parametrów wyjściowych arkusza] Id parametrów wyjściowych

Id parametru wyjściowego arkusza.

Wymagany

[Definicja parametrów wyjściowych arkusza] Nazwa parametrów wyjściowych

Nazwa parametru wyjściowego arkusza wyświetlana w systemie.

Wymagany

[Definicja parametrów wyjściowych arkusza] Nagłówek

Nagłówek kolumny arkusza, której wartości zostaną zamapowane na zdefiniowany parametr.

Wymagany

Wynik powyższej konfiguracji:

Expand

title	Aktualizacja

Nazwa parametru

Opis parametru

Wymagalność

Uwagi

Źródło pliku

Źródło, na którym znajduje się plik wskazany w ścieżce.

Wymagany

Opcja "Google Drive" do prawidłowego działania wymaga zainstalowanej wtyczki Plus Google Cloud Integrator

Id konfiguracji połączenia z GoogleCloud

Konfiguracje połączeń realizowane są w zakładce "Konfiguracja wtyczek" (PCM).

Opcjonalny

Parametr związany z opcją "Źródło pliku" = "Google Drive"

Id pliku w google drive

Identyfikator pliku na Dysku Google. Identyfikator pliku można znaleźć w adresie URL pliku otwieranego na Dysku Google. Jest to kombinacja liter i cyfr występujących po „d/” w linku: https://docs.google.com/spreadsheets/d/***ThisIsFileID***/edit#gid=123456789.

Opcjonalny

Parametr związany z opcją "Źródło pliku" = "Google Drive"

Ścieżka do pliku

Absolutna ścieżka do pliku na dysku.

Info

title	Znaczniki dostępne od wersji 1.0.6

{PWFL_HOME} - wstawia automatycznie ścieżkę do katalogu domowego systemu PlusWorkflow.
{WORKING_DIRECTORY} - wstawia automatycznie ścieżkę do katalogu tymczasowego ustawionego w parametrach systemowych ("WorkingDirectory").

Wymagany

Nazwa arkusza

Nazwa konkretnego arkusza w pliku.

Wymagany

Obsługa nowych wartości

Obsługa przypadku, gdy w arkuszu nie istnieje rekord z podanym kluczem głównym.

Dostępne wartości:

Dodaj wiersz - rekord z kluczem głównym nieistniejącym w arkuszu zostanie dodany na końcu arkusza
Blokuj - aktualizacja zostanie zablokowana, a w logach systemu pojawi się odpowiednia informacja o błędzie
Przepuść - aktualizacja nie doda nowego rekordu z nieistniejącym kluczem głównym do arkusza, lecz pozwoli na przetwarzanie ewentualnych kolejnych wierszy jeśli aktualizacja dotyczy wielu rekordów

Wymagany

[Parametry ścieżki] Id

Id parametru ścieżki, podstawiany do ścieżki.

Opcjonalny

[Parametry ścieżki] Nazwa

Nazwa parametru ścieżki wyświetlana w systemie.

Opcjonalny

Nagłówki

Nagłówki arkusza będące albo kluczem głównym, albo parametrem podlegającym aktualizacji.

Wymagany

Typy parametrów

Określa czy dany nagłówek jest kluczem głównym na podstawie którego wybrane wiersze będą aktualizowane, czy parametrem podlegającym aktualizacji.

Wymagany

Powyższa konfiguracja spowoduje zmianę wartości w kolumnie Last Name na "Ebby" we wszystkich rekordach, zawierających w kolumnie First Name wartość "Abby".

Expand

title	Usunięcie

Nazwa parametru

Opis parametru

Wymagalność

Uwagi

Źródło pliku

Źródło, na którym znajduje się plik wskazany w ścieżce.

Wymagany

Opcja "Google Drive" do prawidłowego działania wymaga zainstalowanej wtyczki Plus Google Cloud Integrator

Id konfiguracji połączenia z GoogleCloud

Konfiguracje połączeń realizowane są w zakładce "Konfiguracja wtyczek" (PCM).

Opcjonalny

Parametr związany z opcją "Źródło pliku" = "Google Drive"

Id pliku w google drive

Identyfikator pliku na Dysku Google. Identyfikator pliku można znaleźć w adresie URL pliku otwieranego na Dysku Google. Jest to kombinacja liter i cyfr występujących po „d/” w linku: https://docs.google.com/spreadsheets/d/***ThisIsFileID***/edit#gid=123456789.

Opcjonalny

Parametr związany z opcją "Źródło pliku" = "Google Drive"

Ścieżka do pliku

Absolutna ścieżka do pliku na dysku.

Info

title	Znaczniki dostępne od wersji 1.0.6

{PWFL_HOME} - wstawia automatycznie ścieżkę do katalogu domowego systemu PlusWorkflow.
{WORKING_DIRECTORY} - wstawia automatycznie ścieżkę do katalogu tymczasowego ustawionego w parametrach systemowych ("WorkingDirectory").

Wymagany

Nazwa arkusza

Nazwa konkretnego arkusza w pliku.

Wymagany

[Parametry ścieżki] Id

Id parametru ścieżki, podstawiany do ścieżki.

Opcjonalny

[Parametry ścieżki] Nazwa

Nazwa parametru ścieżki wyświetlana w systemie.

Opcjonalny

Nagłówki

Nagłówki kolumn z arkusza, na podstawie wartości których, usunięte zostaną rekordy z arkusza.

Wymagany

Powyższa konfiguracja spowoduje usunięcie z arkusza wszystkich rekordów zawierających wartość "Abby" w kolumnie First Name.

Expand

title	Wstawienie

Nazwa parametru

Opis parametru

Wartość domyślna

Wymagalność

Ścieżka do pliku

Absolutna ścieżka do pliku na dysku.

Info

title	Znaczniki dostępne od wersji 1.0.6

{PWFL_HOME} - wstawia automatycznie ścieżkę do katalogu domowego systemu PlusWorkflow.
{WORKING_DIRECTORY} - wstawia automatycznie ścieżkę do katalogu tymczasowego ustawionego w parametrach systemowych ("WorkingDirectory").

Wymagany

Nazwa arkusza

Nazwa konkretnego arkusza w pliku.

Wymagany

Obsługa istniejącego pliku

Określa czynność, która zostanie wykonana w przypadku, gdy w lokalizacji wskazanej w parametrze 'Ścieżka do pliku' plik już istnieje.

Możliwe wartości:

Dopisz - dopisze wartości do istniejącego pliku lub stworzy nowy, gdy plik nie istnieje
Nadpisz - nadpisze wszystkie wartości w istniejącym pliku lub stworzy nowy, gdy plik nie istnieje

Dopisz

Wymagany

[Parametry ścieżki] Id

Id parametru ścieżki, podstawiany do ścieżki.

Opcjonalny

[Parametry ścieżki] Nazwa

Nazwa parametru ścieżki wyświetlana w systemie.

Opcjonalny

Nagłówki

Nagłówki kolumn z arkusza, do których dopisane zostaną dane.

Wymagany

Powyższa konfiguracja spowoduje dodanie do arkusza dwóch rekordów:

Imię	Nazwisko	Nr	Płeć
Karolina	Kamińska	111	Kobieta
Jan	Graczyk	112	Mężczyzna

Panel

title	Parametry ścieżki

Źródło danych pozwala na sparametryzowanie ścieżki do arkusza danych na dysku. Dzięki temu możliwe jest m.in. tworzenie nowych plików z arkuszami danych na podstawie wartości zmiennej/zmiennych z procesu.

Aby tego dokonać należy w parametrze Ścieżka do pliku w konfiguracji źródła danych osadzić Id parametru ścieżki w specjalnych znacznikach - { } - np. C:\folder\arkusz_{data}.xls

Następnie w sekcji Parametry ścieżki w konfiguracji źródła danych należy dodać parametr o Id "data".

Dzięki temu możliwe będzie dynamiczne przekazywanie wartości parametru o Id "data" przy wywoływaniu źródła danych do ścieżki.

English

Panel

title	General info

Category: Spreadsheets

Download: >>LINK<<

Panel

title	Description

The plugin includes the implementation of data sources running on spreadsheets. Supported file types: .xls, .xlsx and derivatives.

By means of the described data sources, it is possible to read and write data to spreadsheets in Microsoft's formats.

Info
Supported spreadsheets must contain column headings in the first row.

Supported sheet sample:

View file

name	file_example_XLS_100.xls
height	250

All configuration examples in the further part of the documentation operate on the above file.

Info
Starting from Plusworkflow System version 4.0.38 - datasource informs user about configuration errors (ex. file not found).

Panel

title	Configuration

Expand

title	Read

Parameter name

Parameter description

Required

Remarks

File source

The source on which the file indicated in the path is located.

True

The "Google Drive" option requires the Plus Google Cloud Integrator plug-in to be installed to function properly.

Google Cloud connection configuration ID

Connection configurations are carried out in the "Plugins configuration" (PCM) tab.

False

Parameter related to the "File source" option = "Google Drive"

Google file Id

The Google Drive File ID. The File ID can be found in the URL of the file when it is opened on Google Drive. It is the combination of letters and numbers that appear after "d/" in the link: https://docs.google.com/spreadsheets/d/***ThisIsFileID***/edit#gid=123456789.

False

Parameter related to the "File source" option = "Google Drive"

Filepath

An absolute path to a file on disk.

Info

title	Tags available from version 1.0.6

{PWFL_HOME} - automatically inserts the path to the Plusworkflow home directory.
{WORKING_DIRECTORY} - automatically inserts the path to the temporary directory set in the system parameters ("WorkingDirectory").
FILEID:{<file_id>} - automatically inserts the path to the file on the system with the given id. The <file_id> keyword should be replaced with the specific file ID from your system.

True

Sheet name

The name of a specific sheet in the file.

True

Default numeric format

Default numeric format gets values "as seen" in document. No formatting applied when unchecked.

True

Default value: True

Default data formatter have an effect in:

number datatype defined in Excel file. For example: Excel number formatted cell value 2002,9632 will be read as 2,002.9632

With data formatter option turned off, numeric value wil be read as 2002.9632

[Path parameters] Id

Path parameter id substituted to the filepath.

False

[Path parameters] Name

The name of the path parameter shown in the PWFL system.

False

[Spreadsheet output parameters definition] Output parameter id

Spreadsheet output parameter id.

True

[Spreadsheet output parameters definition] Output parameter name

The name of the spreadsheet output parameter shown in the PWFL system.

True

[Spreadsheet output parameters definition] Headers

The headings of the spreadsheet columns whose values will be mapped to the defined parameter.

True

The result of the above configuration:

Expand

title	Update

Parameter name

Parameter description

Required

Filepath

An absolute path to a file on disk.

Info

title	Tags available from version 1.0.6

{PWFL_HOME} - automatically inserts the path to the Plusworkflow home directory.
{WORKING_DIRECTORY} - automatically inserts the path to the temporary directory set in the system parameters ("WorkingDirectory").

True

Sheet name

The name of a specific sheet in the file.

True

Handle unexisting data

Handling the case when no record with the given primary key exists in the spreadsheet.

Available values:

Add - a record with a primary key that does not exist in the sheet will be added to the end of the sheet
Block - the update will be blocked, and appropriate information about the error will appear in the system logs
Pass - the update will not add a new record with a non-existent master key to the sheet, but it will allow the processing of any subsequent lines if the update concerns many records

True

[Path parameters] Id

Path parameter id substituted to the filepath.

False

[Path parameters] Name

The name of the path parameter shown in the PWFL system.

False

Headers

Spreadsheet headers that are either a primary key or an updateable parameter.

True

Parameter types

Determines whether the given header is a primary key based on which selected rows will be updated, or a parameter that should be updated.

True

The above configuration will change the value in the Last Name column to "Ebby" in all records containing the value "Abby" in the First Name column.

Expand

title	Delete

Parameter name

Parameter description

Required

Filepath

An absolute path to a file on disk.

Info

title	Tags available from version 1.0.6

{PWFL_HOME} - automatically inserts the path to the Plusworkflow home directory.
{WORKING_DIRECTORY} - automatically inserts the path to the temporary directory set in the system parameters ("WorkingDirectory").

True

Sheet name

The name of a specific sheet in the file.

True

[Path parameters] Id

Path parameter id substituted to the filepath.

False

[Path parameters] Name

The name of the path parameter shown in the PWFL system.

False

Headers

The column headings from the spreadsheet, based on the values of which, the records will be deleted from the sheet.

True

The above configuration will remove all records containing "Abby" in the First Name column from the spreadsheet.

Expand

title	Insert

Parameter name

Parameter description

Default Value

Required

Filepath

An absolute path to a file on disk.

Info

title	Tags available from version 1.0.6

{PWFL_HOME} - automatically inserts the path to the Plusworkflow home directory.
{WORKING_DIRECTORY} - automatically inserts the path to the temporary directory set in the system parameters ("WorkingDirectory").

True

Sheet name

The name of a specific sheet in the file.

True

Handle existing file

Specifies the action that will be performed if a file already exists in the location specified in the 'Filepath' parameter.

Available values:

Extend - will add values to an existing file or create a new one when the file does not exist
Overwrite - will overwrite all values in an existing file or create a new one when the file does not exist

Extend

True

[Path parameters] Id

Path parameter id substituted to the filepath.

False

[Path parameters] Name

The name of the path parameter shown in the PWFL system.

False

Headers

The headings of the columns from the spreadsheet to which the data will be added.

True

The above configuration will add two records to the sheet:

First Name	Last Name	Nr	Gender
Jenny	Champ	111	Female
John	Doe	112	Male

Panel

title	Path parameters

The data source allows you to parameterize the path to the spreadsheet on the disk. Thanks to this, it is possible, among others creating new spreadsheet files based on the variable/variables from the process.

To do this, you should embed the Id of the path parameter in special tags - { } - in the Filepath parameter in the data source configuration eg. C:\folder\arkusz_{data}.xls

Then, in the Path parameters section in the data source configuration, add the parameter with Id "data".

This will enable dynamic passing a value of the path's parameter with Id "data" when calling the data source.

Hide If

JIRA

server	192.168.1.52 JIRA
columns	key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId	2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
key	DSXLS-1

JIRA

server	192.168.1.52 JIRA
columns	key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId	2e6b42a8-62e1-3c71-bfe9-dbf183b33dc1
key	DSXLS-3

Versions Compared

Old Version 19

New Version 20

Key

Wtyczka zawiera implementację źródeł danych operujących na arkuszach danych. Obsługiwane typy plików: .xls, .xlsx i pochodne.

The plugin includes the implementation of data sources running on spreadsheets. Supported file types: .xls, .xlsx and derivatives.