Reporting.bi - VS Code Extension

Doplněk pro Visual Studio Code umožňující práci s ETL transformacemi přímo z editoru. Připojte se k serveru Reporting.bi, stahujte a upravujte ETL thready a spouštějte SQL dotazy bez nutnosti přecházet do webového rozhraní.

Přihlášení k serveru

Klikněte na ikonu Reporting.bi v levém panelu (Activity Bar).
V postranním panelu Connections klikněte na tlačítko + (Login), nebo stiskněte Ctrl+Shift+P a zadejte Reporting: Login.
Zobrazí se výběr domény:
- https://reporting.bi - produkční server
- Custom domain... - zadejte vlastní URL serveru
Otevře se systémový prohlížeč s přihlašovací stránkou.
Přihlaste se svými přihlašovacími údaji.
Po úspěšném přihlášení prohlížeč zobrazí potvrzení "Login successful" - můžete ho zavřít a vrátit se do VS Code.

Přihlášení je automaticky uloženo a šifrováno (AES-256-GCM). Při dalším spuštění VS Code zůstanete přihlášeni.

Odhlášení

Konkrétní doména: Klikněte na ikonu odhlášení vedle domény v panelu Connections.
Přes Command Palette: Ctrl+Shift+P → zadejte Reporting: Logout → vyberte doménu.

Práce s accountingy

Po přihlášení k doméně je potřeba přidat accountingy (firemní databáze), se kterými chcete pracovat.

Přidání accountingu

Klikněte na ikonu + vedle domény v panelu Connections.
Zobrazí se seznam dostupných accountingů.
Vyberte požadovaný accounting.

Odebrání accountingu

Klikněte na ikonu odpadkového koše vedle accountingu v panelu Connections.

Otevření ETL workspace

Klikněte na ikonu složky vedle accountingu v panelu Connections (příkaz Open ETL).
Doplněk inicializuje lokální workspace (.rpbi/config.json) a stáhne všechny ETL thready ze serveru.
Do VS Code File Exploreru se přidá složka s názvem ETL (#<číslo> <firma>).
Přepněte se na ikonu Explorer v Activity Baru (Ctrl+Shift+E) - uvidíte přidanou ETL složku.

Struktura workspace

Soubory jsou uloženy lokálně na disku a organizovány do složek podle typu threadu:

Složka	Typ	Popis
`threads_import/`	IA	Automaticky spouštěné importní thready
`threads_import_manual/`	IM	Manuálně spouštěné importní thready
`threads_export/`	O	Exportní thready
`threads_delete/`	D	Mazací thready
`agent_config/`	AC	Konfigurace agenta
`agent_parameters/`	A	Parametry agenta
`excel_config/`	EC	Konfigurace Excelu
`scripts/`	S	Databázové skripty
`lists/`	L	Seznamy

Thready jsou organizovány do podsložek podle jejich popisu (cesty). Soubory mají příponu .sql.

Adresář .rpbi/

Konfigurace a metadata workspace jsou uloženy v adresáři .rpbi/:

Soubor / složka	Popis
`.rpbi/config.json`	Konfigurace workspace (doména, accounting)
`.rpbi/index.json`	Index stažených threadů (ID, hash, typ)
`.rpbi/context/`	Kontextové soubory pro AI (schéma databáze, moduly)
`.rpbi/parameters/`	Parametry threadů jako YAML soubory
`.rpbi/threads/`	Atributy threadů (metadata) jako YAML soubory

Tip: Můžete mít otevřeno více accountingů najednou - každý se zobrazí jako samostatná složka v Exploreru.

Editace threadů

Otevření souboru

Klikněte na soubor v Exploreru. Soubory jsou uloženy lokálně, takže se otevřou okamžitě.

Uložení změn (auto-push)

Upravte soubor a uložte přes Ctrl+S. Změny se automaticky odešlou na server (push). Stav se zobrazí ve status baru.

Pokud server detekuje konflikt (soubor byl mezitím změněn na serveru), zobrazí se dialog s možnostmi:

Force Push — přepíše serverovou verzi vaší lokální verzí.
Pull Latest — stáhne aktuální verzi ze serveru (vaše lokální změny budou přepsány).

Spuštění SQL

Doplněk umožňuje spouštět SQL dotazy přímo z editoru.

Otevřete ETL soubor (.sql).
Volitelně označte část SQL kódu, kterou chcete spustit. Pokud nic neoznačíte, spustí se celý obsah souboru.
Klikněte na tlačítko Play (▶) v pravém horním rohu editoru, nebo stiskněte Ctrl+Shift+P a zadejte Execute SQL.
Výsledky se zobrazí v panelu RPBI SQL Result (v dolní části okna).

SQL se vždy spouští z aktuálního obsahu editoru — soubor nemusí být uložen. Před spuštěním se obsah (nebo výběr) zapíše do .rpbi/current.sql a odešle na server.

Pozor: SQL se spouští v kontextu příslušného threadu a accountingu.

Kontextové soubory pro AI

Složka .rpbi/context/ obsahuje kontextové informace pro AI nástroje (GitHub Copilot, Cline apod.). Soubory se stáhnou při prvním otevření workspace nebo příkazem Pull Context (Ctrl+Shift+P → Reporting: Pull Context).

Struktura

.rpbi/context/
  README.md                          # Přehled struktury
  modules.json                       # Seznam modulů accountingu
  schema/
    db_data/
      tables/
        nazev_tabulky.json           # Schéma jedné tabulky
      procedures/
        nazev_procedury.json         # Schéma jedné procedury
      functions/
        nazev_funkce.json            # Schéma jedné funkce
    db_master/
      views/ procedures/ functions/  # Schéma master databáze
    db_super/
      views/ procedures/ functions/  # Schéma super databáze

Schéma je rozděleno do jednotlivých souborů pojmenovaných podle objektu, aby AI nástroje mohly efektivně načítat jen relevantní kontext.

AI doplňování a Copilot

ETL soubory se zobrazují s příponou .sql, takže VS Code i GitHub Copilot je automaticky rozpoznávají jako SQL. Doplněk navíc:

Injektuje zvýraznění maker ({{makro}} a {proměnná}) do standardního SQL zvýraznění.
Povoluje Copilot pro SQL — pokud máte nainstalovaný GitHub Copilot, doplňování funguje automaticky.
Poskytuje kontext — schéma databáze a instrukce ve složce .rpbi/context/ pomáhají Copilotu generovat přesnější návrhy.

Tip: Pokud AI doplňování nefunguje, zkontrolujte v nastavení VS Code, že github.copilot.enable → sql je nastaveno na true.

Syntaxe SQL a makra

ETL soubory používají T-SQL rozšířený o makra specifická pro Reporting.bi. Soubory mají příponu .sql a VS Code je zvýrazňuje jako standardní SQL s přidanou podporou maker.

Makra

Reporting.bi SQL podporuje dva typy maker, které jsou vizuálně odlišeny od běžného SQL:

Makra (dvojité složené závorky): {{nazev_makra}} - expandují se při spuštění threadu na serverové straně.
Makro proměnné (jednoduché složené závorky): {promenna} - parametry maker.

Příklad:

SELECT *
FROM {{source_table}}
WHERE datum >= '{datum_od}'
  AND datum <= '{datum_do}'

Nastavení

Doplněk nabízí následující nastavení. Otevřete je přes Ctrl+, (Settings) a vyhledejte reporting:

Nastavení	Popis
`reporting.domains`	Seznam dalších domén pro připojení (kromě výchozích)

Diagnostika

Output kanály

Doplněk poskytuje dva output kanály (panel Output, Ctrl+Shift+U):

Kanál	Popis
RPBI CLI	Log všech spouštěných CLI příkazů, jejich cwd a výsledky
RPBI SQL Result	Výsledky SQL dotazů spuštěných přes Execute SQL

Přihlášení se nedaří

Zkontrolujte, že máte přístup k dané doméně v prohlížeči.
Zkontrolujte, že prohlížeč není blokován firewallem.
Podívejte se do kanálu RPBI CLI pro detaily spouštěných příkazů.

Soubory se nenačítají

Klikněte na ikonu obnovení (Refresh) v panelu Connections.
Zkuste znovu otevřít ETL workspace (Open ETL) — provede se nový pull ze serveru.

Změny se neprojevují

Po uložení souboru (Ctrl+S) se změny automaticky pushnou na server.
Zkontrolujte kanál RPBI CLI pro případné chyby.
Pokud jste provedli změny ve webovém rozhraní, znovu otevřete ETL workspace pro stažení aktuální verze.

Reporting.bi

Reporting.cz