Funkcja AFnHtmlElement() / w redakcji

Alias: NIE

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

Podobna funkcja w Google Sheets: NIE

Wywołanie funkcji

(=)AFnHtmlElement(lsHtmlSource;[lsHtmlElementName];[lsOtherArguments])

Uwaga: Funkcja zwraca tekst HTML (32500 znaków), gdy lsHtmlElementName jest pominięty

Argumenty

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

* URL - dla danych internetowych XML,
* Ścieżka do pliku - dla danych lokalnych XML,
* URL do usługi GETVALUE AFin Web Services - wtedy możliwy jest odczyt XML-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.

strHtmlElement

t - tag HTML, c - (class) klasa CSS, i - id elementu HTML
pusty - tekst HTML, funkcja zwraca tekst HTML (32500 znaków), gdy lsHtmlElementName jest pominięty

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.