Versions Compared

Old Version 5

changes.mady.by.user Arkadiusz Kołodyński

Saved on

compared with

New Version 6

changes.mady.by.user Arkadiusz Kołodyński

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.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
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
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 atrybutuOpcjonalny
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)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 arkusza danych pliku 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 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\arkuszplik_{datafilename}.xlsxml

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

Image RemovedImage Added

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

English