Go to Home page

af

Funkcja AFnHtmlTable() / w redakcji

Alias: NIE

Odpowiednik w Usługach Sieciowych AFin Web Services: W przygotowaniu, prawdopodobna nazwa to GetHtmlTable()

Podobna funkcja w Google Sheets: IMPORTHTML

Podobna Funkcjonalność w MS Excel: Kwerenda sieci Web (stara i nowa wersja), źródło danych HTML w Power Query

Funkcja służy do pobierania całej tabli HTML z pliku HTML lokalnego lub internetowego. Jest to najszybszy sposób pobrania danych z pliku HTML, ponieważ funkcja ignoruje w zassadzie wszystkie elementy formatujące - CSS-y, a nawet tagi <b>, czy <i>. Nie pobiera danych o skryptach - tylko efekt ich działania. Podobne funkcjonalności w Excelu posiadają dużo mniejszą użyteczność - w kwerendach, również webowych, nie można podawać argumentów parametrycznie i dynamicznie - w funkcji AFnHtmlTable argument źródła jest tekstowy, czyli można z nim zrobić wszystko - pobierać z innej komórki, tworzyć formułami, parametryzować ścieżki i URL-e - jak w normalnych funkcjach Excela.

Wywołanie funkcji

(=)AFnHtmlTable(lsHtmlSource;[lsInx])

Uwaga:

Argumenty

strHtmlSource (wymagany) - Określa źródło HTML - może być podany jako:

* URL - dla danych internetowych HTML, * Ścieżka do pliku - dla danych lokalnych HTML, * URL do usługi GETVALUE AFin Web Services - wtedy możliwy jest odczyt HTML-a, będącego zmienną tablicową, wysłaną np. z innego komputera. Dowiedz się więcej o usłudze PUT-/GETVALUE w AFin Web Services.

Inx

Inx = numer tabeli w kolejności występowania w pliku HTML (nie id tabeli) Można podać Inx=NazwaTabeli - wyszukuje wtedy tabelę o atrybucie name=NazwaTabeli. Można to podglądnąć w źródle strony w przeglądarce [Ctrl+U].

strOtherArguments

Ciąg znaków w notacji (Uwaga!) podobnej do notacji ciągu połączeniowego ODBC, tj. ciąg par atrybut=wartość, rodzielany separatorem ";", np. atr1=wart1;atr2=wart2, z podobnymi zasadami. Lista obsługiwanych parametrów może ulec zmianie.

strElementContent

Informacja, co pobrać z elementu HTML: t - tekst (innerText) elementu, h - HTML wewnętrzny (innerHTML), o - HTML zewnętrzny (outerHTML), h - (href) - łącze

rgx={ciąg "rgx"}

Filtr elementów, tj. pobranych wartości, w zależności od strElementContent. Wybór elementów jest dokonywany w odniesieniu do wzorca REGEX. Np. "117" - wszystkie elementy, zawierające ciąg "117". Uwaga - w odróżnieniu od klasycznego wzorca usług REGEX, tu ciąg pusty oznacza brak filtru, czyli działa jak filtr ".*" .

rpl2={ciąg "rpl2"}

Zamiana znaków po odczycie wartości w kodzie funkcji. Patrz: lista parametrów ogólnych AF.

W redakcji /  przygotowaniu:

out=val / out=v

Pojedyncza wartość, niezależnie od rzeczywistej wartości funkcji (pierwsza wartość pierwszej kolumny). Nie zwraca nagłówka.

out=list / out=l

Lista, tj. pierwsza kolumna wartości, niezależnie od rzeczywistej wartości funkcji. Nie zwraca nagłówka.

out=table / out=t

Tabela, niezależnie od wymiarów rzeczywistej wartości funkcji (tj. czy tablica/lista/wartość). Zwraca nagłówek.

out=xml / out=x

Zwraca poprawny ciąg XML, wynikający z filtra XML (jeśli jest). Funkcja wyświetla tylko 1000 pierwszych znaków XML-a.