Balíčky skriptů - záložka Detail

Príznak, či aktuálny balíček skriptov obsahuje zdrojové texty. Hodnoty:

• Áno - balíček obsahuje zdrojové texty. Tie môžu byť zakódované, viď funkcia Zakódovať. (Potom sa balíček správa, ako keby zdroj. texty neobsahoval, ale obsahuje ich.) Táto hodnota korešponduje s hodnotami "Je" alebo "Zaheslovaný" v položke Zdr.kód v záložke Zoznam.
• Nie - zdrojové texty boli odstránené. Viď funkcia Bez zdrojového kódu.

Príznak, či bol už daný balíček skompilovaný. Skompilovanie je jednou z podmienok pre spúšťanie skriptov prihlásenému užívateľovi.

Balíček je skompilovaný vtedy, pokiaľ sú úspešne skompilované všetky v ňom obsiahnuté skripty. Nastaví sa automaticky, pokiaľ sú úspešne skompilované všetky skripty v balíčku obsiahnuté a naopak sa automaticky zruší v okamihu, keď je aspoň jeden z obsiahnutých skriptov neskompilovaný (napr. po zásahu do niektorého skriptu).

Možnosti vyvolania kompilácie:

• funkciou Skompilovať v záložke Detail, subzáložke Projekt v priebehu editácie práve editovaného skriptu - len pre editovaný skript
• funkciou Skompilovať v záložke Detail, subzáložke Zdrojový kód v priebehu editácie práve editovaného skriptu - len pre editovaný skript
• pri uložení skriptu, ak je začiarknuté Skompilovať - len pre editovaný skript
• funkciou Skompilovať v záložke Zoznam - pre celý balíček

Operácia kompilovania podlieha licencovaniu, viď Čo je potrebné na prevádzku skriptovania.

Pokiaľ si teda vytvoríte vlastný balíček so skriptami alebo si naimportujete nejaký hotový (napr. vytvorený na zákazku) so zdrojovými textami, musíte ho najskôr skompilovať. A naopak, pokiaľ nemáte licenciu ku kompilovaniu, tak môžete používať len už hotové skompilované balíčky (či už so zdrojovými textami alebo bez nich).

Kompilovať nie je možné balíček, ktorého zdrojové texty sú aktuálne zaheslované, viď hodnota v položke Zdr.kód v záložke Zoznam, alebo ktorý zdrojové texty neobsahuje vôbec.

Názov balíčku. Ide o unikátnu identifikáciu balíčka skriptov. Položka môže byť až 200 znakov dlhá. Nie je k dispozícii na editáciu, pokiaľ sa na balíček odkazujú skripty z iných balíčkov.

Pozor! Názvy balíčka, knižnice a metódy nesmú obsahovať diakritiku, medzery a niektoré ďalšie špeciálne ASCII znaky. Povolené sú písmená A-Z a číslice. Názvy v skriptovaní totiž nesmú obsahovať medzery ani iné špeciálne znaky.

Názov nie je case sensitive Ak je nejaká položka case insensitive, znamená to, že nie je citlivá na veľké a malé písmená, inými slovami, že nerozlišuje veľké a malé písmená. Tzn., že nie je rozdiel, ak je napísané napr. "Abc" alebo "abc". Opak je case sensitive., tzn. nerozlišuje veľké a malé písmená.

Možnosť nastaviť použitie skriptov daného balíčka:

• Používať - Jedna z podmienok pre spúšťanie skriptov prihlásenému užívateľovi.
• Ladiť - Jedna z podmienok pre spúšťanie skriptov prihlásenému užívateľovi, samozrejme ak má privilégium Ladiť skripty. Ďalej viď Ladenie, ošetrenie chýb.
• Nepoužívať - Jedna z možností, ako vypnúť skriptovanie podľa skriptov z daného balíčka.

Možnost nastavit nespouštění daného balíčku skriptů v testovacím spojení:

• Stejný jako v produkci - výchozí nastavení
• Nepoužívat - Nepoužívat - Jedna z možností, jak vypnout skriptování podle skriptů z daného balíčku.
• Ladiť - Jedna z podmienok pre spúšťanie skriptov prihlásenému užívateľovi, samozrejme ak má privilégium Ladiť skripty. Ďalej viď Ladenie, ošetrenie chýb.
• Používat - Jedna z podmínek pro spouštění skriptů přihlášenému uživateli.

Pokiaľ je položka začiarknutá, bude pri exporte skriptu zobrazené dialógové okno Kódovanie zdrojových kódov pre zadanie hesla, pod ktorým zakódovanie realizuje a ktoré bude nutné po prípadnom importe skriptu pre jeho následné odkódovanie. Pokiaľ bude pri exporte označených viacero záznamov s týmto začiarknutým parametrom, bude vložené heslo platné pre všetky.

Položka typu skrytý zoznam, kde vyberiete, o aký druh skriptu pôjde:

• Knižnica
• Business objekt - pre skripty do Business objektov
• Agenda - pre skripty do agend
• Číselník - pre skripty do nevizuálnych číselníkov
• Importovací manager - pre skripty do importovacích managerov. Vďaka skriptom tohto druhu je potom možné vyvolať vlastné metódy v rámci importov jedného dokladu do druhého (napr. pred vyplnením hlavičky cieľového dokladu, po vyplnení hlavičky, pred vyplnením riadkov atď.).
• Aplikačný modul - pre skripty aplikačných modulov. Každý aplikačný modul má dva háčiky: BeforeLoad a AfterLoad, špecifické moduly majú ešte ďalšie. Pre skriptovanie sú dostupné nasledujúce aplikačné moduly:
  • aplikačné moduly pokladní - tie majú špecifické háčiky typu "po pridání tovaru do účtenky", "pred uzavretím účtenky" a pod.
  • aplikačný modul Systémové udalosti - s háčikmi typu "po prihlásení", "pred resp. po spustení výkonnej časti aplikačného modulu", "pred spustením zástupcu z okna na spúšťanie agend" a pod.
  • aplikačný modul Spúšťania agend (SiteDesk) - ten má všetky háčiky zatiaľ dostupné pre agendové skripty typu "po vytvorení agendy", "po zobrazení agendy" a pod. Vďaka nemu je možné okrem iného vytvoriť globálne háčiky agend a skriptovať tak všetky agendy z jedného skriptu.

    Oproti agendovým háčikom má skriptovanie SiteDesk jednu veľkú výhodu: umožňuje implementovať jeden háčik, napr. "pred zatvorením agendy" do SiteDesk modulu a ten sa potom vyvoláva pred zavretím ľubovoľnej agendy v systéme ABRA.

    Ako bolo povedané v kap. Často kladené otázky, týmto spôsobom je možné vyriešiť častú požiadavku na výrazné grafické odlíšenie dvoch bežiacich systémov ABRA: v skriptovaní po vytvorení agendy sa v skripte výrazne "zafarbí" nejaká spoločná časť agendy.

    Skriptovaním SiteDesk je možné zaháčikovať iba všeobecné háčiky dostupné vo všetkých agendách. (FSite ako predok všetkých agend definuje základné háčiky, ktoré sú spoločné všetkým agendám (napr. spomínané "po vytvorení agendy" a pod., jeho potomkovia sú špecifické agendy typu fDynSite (dokladová) či fRollSite (číselníková), tie definujú ďalšie háčiky špecifické pre svoju oblasť. Skriptovanie SiteDesk ale nemôže podporiť tieto špeciálne háčiky potomkov fSite.)

Pri skripte typu Knižnica tu zadáte ľubovoľný názov pre daný skript. Meno knižnice musí byť unikátne v rámci definície balíčka. Názov nie je case sensitive Ak je nejaká položka case insensitive, znamená to, že nie je citlivá na veľké a malé písmená, inými slovami, že nerozlišuje veľké a malé písmená. Tzn., že nie je rozdiel, ak je napísané napr. "Abc" alebo "abc". Opak je case sensitive., tzn. nerozlišuje veľké a malé písmená.

Pozor! Názvy balíčka, knižnice a metódy nesmú obsahovať diakritiku, medzery a niektoré ďalšie špeciálne ASCII znaky. Povolené sú písmená A-Z a číslice. Názvy v skriptovaní totiž nesmú obsahovať medzery ani iné špeciálne znaky.

Pre ostatné druhy ide o položku typu skrytý zoznam, kde vyberiete názov triedy objektu príslušného typu. Opäť sa kontroluje unikátnosť v rámci definície balíčka.

Informatívna položka. Príznak informuje, aká je verzia aktuálneho riadka balíčka skriptov vzhľadom k verzii programu. Pokiaľ v rámci prechodu na nejakú novšiu verziu systému ABRA Gen dôjde k zásadným zmenám v skriptovaní, ktoré si vyžiadajú kontrolu a prekompilovanie balíčkov skriptov na strane užívateľa, update verziu nastaví automaticky na hodnotu Zastaralá (aby nebolo možné neprevedené skripty omylom používať). Hodnoty:

• Aktuálna - potom je možné skript používať.

• Zastaralá - potom je potrebné skript skompilovať pod novou verziou, overiť funkčnosť príp. upraviť. Je zamedzené ich spúšťaniu. Pokus o spustenie zastaralých skriptov skončí chybou (ála "verzia kompilácie je zastaralá...", "balíček už nie je platný..." príp. "tohto zástupcu už nie je možné spustiť...").

  Príkladom bola zmena prostredia, kódovania, komponentov atď., ku ktorej došlo napr. vo verzii 14.51 v rámci prechodu na nové vývojové prostredie a ktorá sa pochopiteľne dotýká i skriptovania.

Položka typu skrytý zoznam, kde je možné vybrať jeden z háčikov dostupných pre vybraný objekt (tzn. metódu, do ktorej by chcel užívateľ zasiahnuť). Kvôli prehľadnosti sú metódy v skripte už použité zvýraznené v zozname tučne. Po vybraní metódy sa metóda vyhľadá v texte skriptu. Ak v skripte ešte nie je, vloží sa kvôli uľahčeniu editácie jej kostra (mustra) - to samozrejme len v režime editácie daného skriptu.

Ak ide o balíček bez zdrojových kódov, tak položka Metóda nie je k dispozícii na výber.

ctrl+Shift+F

Funkcia je určená na vyhľadanie zadaného textu v zdrojovom programe aktuálne zobrazeného skriptu. Po vyvolaní funkcie zobrazí dialógové okno na zadanie údajov pre hľadaný text. Vzhľad tohto dialógového okna je podobný ako pri hľadaní v iných Windows aplikáciách. Dialógové okno je možné vyvolať len vtedy, keď fókus má vlastný editor.

Další možností , jak vyhledávat, nejen v jednom skriptu, jako v případě výše, ale napříč všemi skripty z balíčku. Pro vyhledávání napříč všemi skripty je potřeba použít klávesovou zkratku ctrl+Shift+F. Vyhledané výsledky se otevřou dole v okně. Okno lze i osamostatnit do vlastního okna tlačítkem, viz obrázek. Případně jej vrátit zpět do hlavního okna

Na obrázku je vyznačena ikona, kterou lze okno odpojit a osamostatnit.

Vyhledané výsledky jsou zobrazeny pod sebou s možností otevření výsledků. Po otevření detailu lze na výsledek dvakrát poklepat myší, což přesune fokus na místo, kde byl výsledek nalezen.

Možnosť upraviť správanie editora zdrojových textov. Nastavenie sa pamätá na agendu a užívateľa. Voľba Východiskové nastavenie z menu Nastavenie nastaví východiskové nastavenie aj pre editor zdrojových kódov.

Možnosť nastaviť farebné sady editora zdrojových textov. Nastavenie sa pamätá na agendu a užívateľa. Voľba Východiskové nastavenie z menu Nastavenie nastaví východiskové nastavenie aj pre nastavenie farebnej sady.

Možnosť zapnúť/vypnúť nápovedu iSense dostupnú pri písaní zdrojového kódu a nastaviť jej správanie. Nastavenie sa pamätá na agendu a užívateľa. Voľba Východiskové nastavenie z menu Nastavenie nastaví východiskové nastavenie i pre nastavenie vlastností iSense.

K voľbe "Filtrovať podľa reťazca i kdekoľvek v názve" - ak je začiarknuté, umožňuje fulltextové Hľadanie. Tzn. je napr. možné napísať akúkoľvek časť názvu, napríklad "nsi" a ponúkne sa všetko, v čom je tento reťazec obsiahnutý, tzn. napr. "Ansi...".

Možnosť ukladania nastavenia prostredia skriptovania (farebnú schému editora skriptov, nastavenie editora a iSense) do XML súboru a následná možnosť načítania niektorého z uložených nastavení.

Predvyplní šablónu pre hlavičku procedúry alebo funkcie pre špecializované použitie, napr. pre vyvolanie z tlačových zostáv a pod. Funkcia je k dispozícii len v editácii a len pre skript druhu Knižnica.

Funkcia pracuje rovnako ako funkcia Vygenerovať hlavičku - Vyvolanie QR funkcie.

Zobrazí alebo skryje okno Class Explorera (strom objektov, ktoré je možné využiť v skriptovaní.). Ak je Class Explorer vyvolaný, tak sa zobrazí v pravej časti subzáložky Zdrojový kód:

Zobrazenie Class Explorera

Slúži na prehľadné zobrazenie (vo forme hierarchického stromu) existujúcich tried, funkcií, typov, premenných, konštánt a GUID identifikátorov BO s podporou filtrovania pre rýchle vyhľadávanie. Význam a použitie jednotlivých prvkov je pre implementátora skriptovania znalého Delphi zrejmý.

Zobrazuje k jednotlivým entitám príslušný dopĺňajúci popis, v ktorom fungujú odkazy, ktoré automaticky vyhľadajú danú triedu/typ/... v strome.

Ak je začiarknuté, tak pri uložení spôsobí znovunačítanie skriptov, rovnako ako funkcia Znovu načítať skripty. Ide o jednu z možností, ako vyvolať znovunačítanie skriptov do pamäte.

Ak je začiarknuté, tak pri uložení prebehne skompilovanie aktuálneho skriptu alebo všetkých skriptov v balíčku. Jedna z možností vyvolania kompilácie. Ak skript nie je možné bezchybne skompilovať, uloženie sa neuskutoční.

Ak je začiarknuté, tak sa pri použití funkcie Uložiť rýchlo otvorí agenda zodpovedajúca editovanému skriptu.

• Pokiaľ je aktuálne editovaný skript druhu Agenda, otvorí sa pri ukladaní príslušná agenda.
• Pokiaľ aktuálne editovaný skript nie je druhu Agenda, vykoná sa pokus o dohľadanie prvého skriptu druhu Agenda v balíčku (prvého podľa poradia skriptov na záložke Projekt) a otvorí sa agenda podľa tohto skriptu.
• Pokiaľ v balíčku žiadny skript druhu Agenda neexistuje, začiarknutie položky nevyvolá žiadnu akciu.

Je k dispozícii len na subzáložke Zdrojový kód v režime editácie a aktívny len v kombinácii s voľbou Znovu načítať skripty.