====== Създаване на справки ======

Създаването на справки преминава през 3 етапа.

Етап 1 - **Създаване на Източник на данни**

Етап 2 - **Създаване на Изглед**

Етап 3 - **Свързване на справката**

Създаването на справки минава през използването на прозореца за Справки/Скриптове

{{:spravki_new:spravki_1.jpg?350|}}

Когато сме на таблицата с Източници на данни ни се появява контекст със следните възможности:
  - Нов източник - Създава нов източник в зависимост от избора на потребителя.
  - Редакция на източник - показва се форма за редакция на основните характеристики на източника
  - Импорт - Импортира от предварително създаден файл с определена структура
  - Експорт - експортира източника/ селектираните източници с всикчи изгледи към тях

{{:spravki_new:spravki_2.jpg?350|}}

Като се намираме в таблицата за изгледи ще се появи контекст с аналогични възможности на източника - Нов. редкация/експорт/импорт


Този прозорец е добре да е недостъпен и да бъде обслужван от Селматик ЕООД
===== Създаване на Източник на данни =====

Източника на данни е основна заявка, която се създава от програмиста и се използва за последващо докъстъмизиране.

Източниците на данни биват 2 типа
  * SQL заявка
  * IBE Скрипт

Създаването на източника от своя страна преминава през няколко етапа:
  - Създаване на DataSource - това е същинският код.
  - Настройка на параметри - ако е скрипт трябва да се инициализират всички параметри, ако е заявка може да има входни параметри, които да се добавят автоматично и да се добавят други допълнителни
  - Настройка на формули
  - Настройка на редактируеми полета и полета които са чек бокс.

Самото създаване на източник на данни е застъпено в [[spravki_new:datasource:create|Създаване на Източник на данни ]]

===== Създаване на Изглед =====

След като имаме източник на данни следва да си добавим нов изглед.

Създаването на изгледа си преминава през своите етапи.

  - Избираме възможните начини на визуализация. Имаме възможност да избираме измежду 3 варианта в случай че източника е от тип СПРАВКА (не е модификация на данни, а връща резултат в дейтасет):
    - Табличен изглед - показва всички колони в таблицата
    - Дървовиден изглед - показва информацията в дърво, като за този случай трябва да се настроят колоните за ID и PARENT_ID
    - Анализ - Pivot - 
  - Настройка на параметри - тук ние можем да:
    - променим името под което се търси параметъра
    - променим дефолтното условие
    - променим дефолтните стойности
    - променим възможните условия
  - Настройка на достъпност - всеки изглед може да се извика освен от Менюто, може да се извика от определен документ (Клас) от Бутон или от някое събитие (Например - търсене на документ в документ Търговски документ). Тук само споменаваме КЪДЕ МОЖЕМ ДА ЗАКАЧАМЕ СКРИПТА/СПРАВКАТА
  - Настройка на справки и скриптове които се стартират от този изглед. 

/* Самото създаване на Изглед е застъпено в [[spravki_new:view:create|Създаване на Изглед ]] */


====== Параметри при извикване с Easycall (примерно от главното меню или друг скрипт) ====== 

При създаването на изгледа ние сме определили къде може да бъде закачан. 

Всяка справка при закачането си е възможно да изиска следните параметри (става дума за параметри на Easycall):
  - ShowModal - ако във входните параметри имаме подобен ред, то справката ще се покаже модално (няма да има възможност да се работи с други функции)
  - <Params>...</Params> - Параметри в XML формат. В параметрите могат да се подават както дейтасетове (от които се инициализират входни те параметри), така и допълнителни опции
    - <AutoExecute/> - пояснява на Изгледа че автоматично при отварянето си трябва да се отвори / изпълни
    - <ReturnResult/> - Връща резултат - това означава че ще се появи бутон за Избор, както и при двоен клик на някоя таблица / грид ще се натисне автоматично избери
    - <ReturnMultiSelect/> - Това означава че при избор ще се вземат всички селектирани редове и ще се върне информация за тях под формата на дейтасет. Много е важно да го поставяме само там където знаем че обработваме и очакваме да имаме мултиселект!
    - <DataSets>...</DataSets> - тук се подават дейтасетове които служат за настройка на входните параметри.

Примери (в случая това са примерни стойности на колона Параметри в номенклатура Менюта, където Цел е Справка/скрипт):

===== Автоматично стартиране на справка =====
  View=49 <Params> <AutoExecute/> </Params>
  
===== Показване на справка модално ===== 
  View=1 ShowModal
====== Закачане в главното меню ======

За да закачите някой изглед е необходимо само да се добави нов ред в менюто по следния начин:

{{:spravki_new:spravki_3.jpg?700|}}

Целта : Справка/скрипт

Параметри : View=6

Това означава че ще пуснем изглед с номер 6 без никакви други параметри

Можем да пожелаем да го пуснем и при стартиране автоматично да се отвори

При този случай ще подадем следните параметри

View=6

<Params><AutoExecute/></Params>
====== Закачане в документи ======

Засега само в Търговските документи, Финансовите документи и в Изгледите е реализирано да можем да закачаме спавките/скриптовете. 

Т.е. само в настройките на тези документи имаме функционалност, която ни помага за по-лесно закачане на Бутон или на събитие.

За да закачим към всички останали можем да използваме номенклатурата за закачане на изгледи към класове...

За пример използваме закачането в търговски документ 

{{:spravki_new:spravki_4.jpg?800|}}

Кое какво означава:
  * Събитие - в някой документи са предварително зададени събития на които могат да се закачат скправки/скриптове, които, се извикват по подразбиране с някой определени опции (например Търсенето на документ твърдо е модално, изисква резултат, ...), като когато се извиква от бутон се влияе от всички настройки описани по-нататък
  * Изглед - кой изглед закачаме към съответното събитие
  * Настройки
    * Автоматично изпълнение - при отварянето да се изпълни/отвори автоматично справката/скрипта. Това е в случай че параметрите сме ги настроили предварително добре
    * Показвай модално - желаем да заключим продукта да не може да пипа нищо друго ако сме показали справката/скрипта
    * Връщай резултат - означава че ще имаме бутон избор и ще върнем резултат
    * Връщай селектираните редове - това има смисъл само там където е възможно да очакваме множествена селекция
    * Затваряне на извикващия след изпълнение на справката - това се анализира само ако сме настроили на евент - БУТОН и при затваряне на справката ще се затовори документа
      * Не затваряй - няма да се затвроти
      * Затвори без резултат - просто се затваря
      * Затвори с резултат ОК - ако е модално ще върне резултат - ОК
    * Изпращай само текущият ред - в случай че не желаем да се препредава цялата информация ще изпрати към справката само текушият ред по всички таблици, които са предадени за експорт
    * Подложка - ако е упоменато в източника че желаем да отпечатаме документа след неговото затваряне - тук можем да определим специална подложка към документа или ако е празно да се отпечата Подложката по подразбиране.
    * FREE VIEW WHEN CLOSE - дали да запази Изгледа или да го освободи след затварянето. По дефолт е ОСВОБОЖДАВАНЕ. Използва се за търсене на документи/или позиции, като след избора при ново влизане да имаме същата информация която сме филтрирали допреди да изберем
====== Закaчане в произволен прозорец ======

Аналогично е на описанието на закачане към документ, като в този случай ще се покаже цялата номенклатура от всички възможно документи, както и за всеки документ всички възможни събития на които да се закачи

{{:spravki_new:spravki_5.jpg|}}