Dostupné nástroje a informace

K zjednodušení následných úprav, které se musí již provádět ručně, máme k dispozici několik nástrojů, které buď pomohou s přepisem, nebo poskytnout potřebné informace.

Našeptávač změn v editoru skriptu

Některé části ve zdrojových souborech nelze při konverzi převést, protože není znám datový kontext, podle kterého by mohla proběhnout náhrada identifikátorů. Jedná se o metody, které mají jako parametr název identifikátoru v podobě textového řetězce.

Přímo v editoru skriptu je implementován nástroj, který umožní nahradit původní identifikátory za nové. Jednoduše můžete kliknout myší na slovo, které chcete nahradit, tak aby na něm svítil kurzor, a následně zmáčknete klávesovou zkratku Ctrl+Shift+R, nebo Ctrl+F8. Zobrazí se našeptávač, který zobrazí varianty, kde u každé možné náhrady je vidět z jaké pochází databázové tabulky. Při výběru a stisku klávesy Enter je slovo nahrazeno. Další výskyt pak automaticky nastavuje v našeptávači kurzor na ten identifikátor, který odpovídá poslední vybrané tabulce z našeptávače, což usnadní práci při opravě dat, která pracují nad stejnou tabulkou. Aby vše fungovalo, musí být k dispozici soubor, který popisuje změny. Soubor se jmenuje OldNamesMap.2023 a je uložen v adresáři SupportedFiles v adresáři K2. Soubor je distribuován s instalací.

Zobrazení našeptávače nad klíčovým slovem, které představuje původní název konstanty hrAno, nabízí nový název mbrYes.

Obr. Našeptávač změn v editor skriptu – náhrada

Veřejná webová stránka s informacemi o změnách identifikátorů

Všechny změny identifikátorů jsou dostupné ve webové stránce, která je dostupná na adrese https://help.k2.cz/k2iris/01/cs/identifierchanges. Stránka je rozdělená na tři části.

První z nich - Databáze, popisuje pouze změny identifikátorů databázových tabulek a jejich polí.

Druhá část – Moduly popisuje i změny logických struktur, tedy změny názvů, přidaná a smazaná pole apod. Následující text popisuje použití a dostupné informace jednotlivých částí webu.

Třetí část - Metody popisuje změny identifikátorů metod (procedury, funkce, property a metody).

Hledání v editoru skriptů napříč všemi zákaznickými úpravami

Aby bylo jednodušší dohledat všechna místa ve zdrojových souborech zákaznických úprav, kde se nepodařilo konvertovat identifikátory jako parametry metod, viz kapitola Konverze zákaznických AM sestav a K2 skriptů, je k dispozici funkce pokročilého hledání, pomocí které lze prohledat všechny zákaznické úpravy. V tomto konkrétním případě můžeme prohledat všechny výskyty konstant, které doplní kompilátor na místa, která se nepovedlo při konverzi opravit a je nutné je zkontrolovat, případně opravit ručně. Možné konstanty popisuje tabulka ve zmíněné kapitole.

Funkci je možné spustit z editoru skriptu pomocí klávesové zkratky Shift+Ctrl+F - Find in files. Nebo v menu Hledat a volba Find in files. Po spuštění se zobrazí formulář, kde vložíme požadovaný text, který se má hledat. Pomocí různých nastavení můžete prohledávat celou K2, pouze databázové nebo souborové úložiště, případně můžete blíže specifikovat podmínku pro hledání.

Obr. Vstupní formulář pro hledání napříč zákaznickými úpravami

Po spuštění hledání se zobrazí výsledek v podobě okna v editoru skriptu. Výstup může být seskupen dle souborů, ve kterých byl výskyt nalezen, dle nastavení hledání. Po kliknutí na jednotlivé výsledky, se v editoru skriptu otevře skript na řádku, ve kterém byl text nalezen. Můžeme tak pohodlně vyřešit hledaný problém.

Obr. Výsledek hledání napříč zákaznickými úpravami

Poznámka

Funkci pokročilého hledání samozřejmě můžete využít k libovolnému prohledávání zdrojových souborů.