Versions Compared

Old Version 19

changes.mady.by.user Kamil Rogowski

Saved on

compared with

New Version 20

changes.mady.by.user Kamil Rogowski

Saved on

Key

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

Polish
Panel
titleInformacje ogólne

Kategoria: Pliki płaskie

Pobierz: >>LINK<<

Panel
titleOpis

Wtyczka zawiera implementację źródeł danych operujących na plikach XML.

Za pomocą opisywanych źródeł danych można odczytywać jak i zapisywać dane do plików XML. Dodatkowo dzięki szablonom możliwe jest tworzenie nowych plików XML.

Panel
titleKonfiguracja
Expand
titleOdczyt
Nazwa parametruOpis parametruWymagalność
Ścieżka do pliku

Parametryzowana absolutna ścieżka do pliku na dysku

Info
titleDostępne znaczniki od wersji 1.0.5
  • {PWFL_HOME} - wstawia automatycznie ścieżkę do katalogu domowego
  • {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
KodowanieFormat kodowania znaków w plikuWymagany
Id parametru ścieżkiUnikalne id parametru ścieżkiOpcjonalny
Nazwa parametru ścieżkiNazwa parametru ścieżki wyświetlana w systemieOpcjonalny
Id parametru wyjściowegoUnikalne id parametru wyjściowegoWymagany
Nazwa parametru wyjściowegoNazwa parametru wyjściowego wyświetlana w systemieWymagany
XPath

Ścieżka typu 'XPath' do node'a, którego wartość ma zostać odczytana.

XPath tutorial

Wymagany
Nazwa elementu w XPath

Nazwa elementu z podanej ścieżki XPath z której zostanie pobrana wartość. W przypadku gdy wskazanego elementu nie ma, zostanie zwrócona wartość pusta.

Parametr nie może wskazywać na element, który zawiera w sobie kolejnego noda z elementami.

Info

Parametr dostępny od wersji 1.03

Opcjonalny

View file
nameXML Datasource example.json
height250
View file
nameDSXML_example.xml
height250

 

Expand
titleUsunięcie
Nazwa parametruOpis parametruWymagalność
Ścieżka do pliku

Parametryzowana absolutna ścieżka do pliku na dysku

Info
titleDostępne znaczniki od wersji 1.0.1
  • {PWFL_HOME} - wstawia automatycznie ścieżkę do katalogu domowego
  • {WORKING_DIRECTORY} - wstawia automatycznie ścieżkę do katalogu tymczasowego ustawionego w parametrach systemowych("WorkingDirectory")
Wymagany
KodowanieFormat kodowania znaków w plikuWymagany
XPath

Parametryzowana ścieżka typu 'XPath' do node'a(-ów), który(-e) mają zostać usunięte z pliku. W przypadku, gdy XPath będzie wskazywał na więcej niż jeden node, wszystkie wskazane node'y zostaną usunięte.

XPath tutorial

Wymagany
Id parametru ścieżkiUnikalne id parametru ścieżkiOpcjonalny
Nazwa parametru ścieżkiNazwa parametru ścieżki wyświetlana w systemieOpcjonalny
Id parametru XPathUnikalne id parametru ścieżki typu XPathOpcjonalny
Nazwa parametru XPathNazwa parametru ścieżki typu XPath wyświetlana w systemieOpcjonalny
Expand
titleWstawienie
Nazwa parametruOpis parametruWymagalność
Ścieżka do pliku

Parametryzowana absolutna ścieżka do pliku na dysku

Info
titleDostępne znaczniki od wersji 1.0.1
  • {PWFL_HOME} - wstawia automatycznie ścieżkę do katalogu domowego
  • {WORKING_DIRECTORY} - wstawia automatycznie ścieżkę do katalogu tymczasowego ustawionego w parametrach systemowych("WorkingDirectory")
Wymagany
KodowanieFormat kodowania znaków w plikuWymagany
Szablon

Szablon pliku XML, służący do stworzenia nowego pliku w podanej lokalizacji.

Więcej o szablonach przeczytasz >>TUTAJ<<

Opcjonalny
Obsługa istniejącego pliku

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

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
Wymagany
Pomiń deklarację XML

Decyduje czy wynikowy plik ma zawierać deklarację XML.

Czym jest deklaracja XML?

Wymagany
Id parametru ścieżkiUnikalne id parametru ścieżkiOpcjonalny
Nazwa parametru ścieżkiNazwa parametru ścieżki wyświetlana w systemieOpcjonalny
Id atrybutuUnikalne id atrybutu. Id nie może zawierać spacji.Opcjonalny
Nazwa atrybutuNazwa atrybutu wyświetlana w systemieOpcjonalny
Czy dodać pustyOkreśla czy node ma zostać dodany do pliku wynikowego pomimo pustej wartościOpcjonalny
Id parametruUnikalne id parametruWymagany
Nazwa taguNazwa tagu dodawanego node'aWymagany
XPath

Ścieżka typu 'XPath' do node'a-rodzica (kontenera) dla dodawanego node'a

XPath tutorial

Wymagany
Atrybuty node'aDodatkowe atrybuty node'a (id atrybutów z sekcji rozdzielone średnikami). Wszystkie zadeklarowane node'y w sekcji atrybutów muszą zostać wykorzystane w tym parametrze.Wymagany
Typ node'a

Określa czy dodawany node jest kontenerem, czy zawiera wartość. Możliwe wartości: Root, Emptiable, Nonempty


Root - oznacza, że dany node jest kontenerem na inne nody:

Code Block
languagexml
<root>
    <children>some value</children>
    <children>another value</children>
</root>

Emptiable - oznacza, iż dany node zostanie dodany do pliku nawet w przypadku, gdy zostanie do niego przekazana pusta wartość:

Code Block
languagexml
<root>
    <emptiable></emptiable>
</root>

Nonempty - oznacza, iż dany node nie zostanie dodany do pliku, gdy zostanie do niego przekazana pusta wartość.

 
Wymagany
Panel
titleParametry ścieżki

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

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\plik_{filename}.xml

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

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

English