Extension:External Data
External Data Stav rozšíření: stabilní |
|
---|---|
Implementace | Funkce analyzátoru , Speciální stránka |
Popis | Umožňuje používat a zobrazovat hodnoty získané z různých zdrojů: Externí URL a SOAP služby, lokální wiki stránky a lokální soubory (v CSV, JSON, XML a dalších formátech), databázové tabulky, LDAP servery a výstup lokálních programů. |
Autoři | Yaron Koren, Alexander Mashin a další |
Nejnovější verze | 3.3 (listopadu 2023) |
Zásady kompatibility | Větev master zachovává zpětnou kompatibilitu. |
MediaWiki | 1.37+ |
Změny v databázi | Ano |
Tabulky | ed_url_cache |
Licence | GNU General Public License 2.0 nebo novější |
Stáhnout | Viz Stažení a instalace |
Příklad | Stránka obsahující informace získané z externího souboru CSV |
|
|
Přeložte rozšíření External Data, používá-li lokalizaci z translatewiki.net | |
Problémy | Otevřené úkoly · Nahlásit chybu |
Rozšíření External Data umožňuje stránkám MediaWiki načítat, filtrovat a formátovat strukturovaná data z jednoho nebo více zdrojů. Tyto zdroje mohou zahrnovat externí adresy URL a služby SOAP, běžné wiki stránky, nahrané soubory, soubory na místním serveru, databáze, adresáře LDAP a výstup lokálních programů.
Rozšíření definuje následující parser functions :
- Funkce načítání a zpracování dat, které nastavují místní proměnné a poté je zobrazují nebo ukládají:
- #external_value - zobrazí hodnotu jakékoli takové proměnné.
- #for_external_table - cyklicky prochází všechny hodnoty načtené pro sadu proměnných, přičemž pro každou z nich zobrazuje stejný "kontejnerový" text.
- #display_external_table - cyklicky prochází všechny hodnoty načtené pro sadu proměnných a zobrazuje každý "řádek" pomocí šablony.
- #format_external_table - k dispozici pouze v případě, že je nainstalováno Cargo. Formátuje načtená externí data stejným způsobem jako #dotaz na náklad.
- #store_external_table - cyklicky prochází tabulkou hodnot a ukládá je jako sémantická data prostřednictvím rozšíření Semantic MediaWiki napodobováním volání funkce #subobject SMW pro každý řádek.
- V Legacy mode rozšíření také definuje funkce načítání dat, které nastavují místní proměnné dostupné s rozsahem wikistránky, které lze později zobrazit pomocí výše uvedeného funkce:
- #get_external_data - načítá data z různých zdrojů, čímž nahrazuje kteroukoli z níže uvedených funkcí analyzátoru a přiřazuje je proměnným, ke kterým lze na stránce přistupovat.
- #get_web_data - načte CSV, GFF, JSON, YAML, XML, HTML, INI nebo data ve volném formátu z adresy URL a přiřadí je proměnným, ke kterým lze přistupovat na stránce.
- #get_soap_data - načte data z adresy URL pomocí SOAP protokolu
- #get_file_data - načte data ze souboru na místním serveru ve stejných formátech jako #get_web_data.
- #get_db_data - získává data z databáze.
- #get_ldap_data - načítá data ze serveru LDAP.
- #get_program_data - načte data vrácená spuštěným programem na straně serveru.
- #get_inline_data - analyzuje data, která mu byla předána, ve stejných formátech jako #get_web_data.
- a též #clear_external_data která vymaže aktuální sadu načtených dat nebo pouze některé proměnné.
Také definuje Lua funkci mw.ext.externalData.getExternalData
, která získává data a vrací je jako tabulku Lua.
V Legacy režimu jsou také definovány následující dodatečné funkce Lua (mezi funkcemi analyzátoru načítajícími data a funkcemi Lua je z jejich názvů patrná shoda jedna ku jedné):
mw.ext.externalData.getWebData
mw.ext.externalData.getFileData
mw.ext.externalData.getDbData
mw.ext.externalData.getSoapData
mw.ext.externalData.getLdapData
mw.ext.externalData.getProgramData
mw.ext.externalData.getInlineData
V režim emulace značek může administrátor wiki stránky definovat další značky analyzátoru.
Tato verze rozšíření Externí data vyžaduje MediaWiki 1.37+.
Kliknutím na stránky v navigační liště výše se dozvíte více o externích datech, jak fungují, jak je používat a jak je nainstalovat.
Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích: Toto není autoritativní seznam. Některé wiki farmy/hostitelé a/nebo balíčky mohou toto rozšíření obsahovat, i když zde nejsou uvedeny. Pro potvrzení se vždy obraťte na své wiki farmy/hostitele nebo balíček. |