====== Настройки на Финансови документи ======
===== Връзки със справки/скриптове =====
В този таб се определят връзките на съответния финансов документ с всички справки и скриптове в системата. \\
В системата всички [[spravki_new:osnovni_pol|справки и скриптове]] са съобразени с потребностите на съответните клиенти. Функционално няма разлика между справка и скрипт.
{{:documenti:obsti:tabove_nastrojki_na_fin.documenti:фд_връзки_справки_скриптове.png?800|}}
Вижте още [[spravki_new:create|създаване на нова справка]], [[spravki_new:vruzki_spravki_scriptove|свързване]] и [[spravki_new:obsht_izgled_i_butoni|колони и филтри]].
==== Събитие ====
В първата колона **Събитие** са наименованията на събития, които се избират от Фиксиран списък, дефиниран предварително на програмно ниво (потребителят не може да го определя). Тук се посочва наименованието на мястото (събитието), към което се прикачи справката/скрипта.
{{:documenti:obsti:събития_справки_тд.jpg|}} \\
**Справката/скрипт** може да бъде настроена да се изпълни от:
1. Бутон търсене {{:documenti:obsti:бутон_търсене_тд.jpg|}} \\
2. Бутон за разширено търсене {{:documenti:obsti:бутон_разширено_търсене_тд.jpg|}} \\
3. Новосъздаден бутон с наименованието на изгледа на справката/скрипта {{:documenti:obsti:бутон_справки_скриптове_1.jpg|}} \\
4. Или с двоен клик на реда (за отваряне на баланс например). \\
Трябва да се внимава справките/скриптовете да се свързват към **полета видими в изгледа** или ако не се виждат от **Редакция на изгледа** да се покаже съответното поле. (Напр. търсене на контрагент източник - ако не е видимо в изгледа, да се визуализира от редакцията.)
/* С излизането на [[vavedenie:kakvo_novo|релийз 2015.8]] е добавено ново събитие „След Анулиране“. Това ще улесни създаването на скриптове, които да сработват при промяна на статуса на документ. */
/* {{:documenti:obsti:tabove_nastrojki_na_targ.documenti:sled_anulirane.png|}} */
====Изглед====
В колона **Изглед**/Наименование се определя коя справка/скрипт да бъде закачена, т.е. за наименованието на кой изглед на справка/скрипт се отнася изборът (възможно е една справка да има повече от един изглед). \\
За да може да избирате [[spravki_new:osnovni_pol|справки/скриптове, те предварително трябва да са дефинирани в номенклатурата]], където са посочени **Източниците на данни** за съответния изглед.
{{:documenti:obsti:изглед_справки_тд.jpg|}}
====Настройки====
Настройва се поведението на справките.\\
{{:documenti:obsti:колонанастройки_справки_тд.jpg|}}
1. **Автоматично изпълнение** - справката/скриптът се изпълнява автоматично още с отварянето му. Полезно е да се използва тази опция, когато на потребителя не трябва да се задават въпроси. \\
2. **Показвай модално** – Модален е прозорец, който докато не бъде затворени, програмата няма да продължи изпълнението си. Тази опция трябва да е включена в комбинация с "Връщай резултат", защото докато потребителят не направи своя избор (който се връща като резултат) програмата не трябва да може да продължи. /* работи се само с активния прозорец, който е най-отпред, т.е. само със справката. Не могат да се променят, местят, редактират и т.н. останалите (задните) прозорци. */
/* Справка/скрипт, която е вързана на събитие "Търсене на ..." винаги е модална и тази настройка няма влияние за нея, защото търсеща справка/скрипт винаги трябва да връща резултат, съответно е необходимо да бъде "модална". */
/* По подобие на ситуацията когато е отворена **Редакция на типа на документа** при Търговски или Финансов документ. \\ */
Търсенето на Търговски документ, Контрагент, Позиция и т.н. по подразбиране е модално, въпреки че отметката не е поставена, т.е. модалността при него не се влияе от отметката.
3. **Връщай резултат** – /* връща само текущия ред, на който е курсурът или където е кликнато. Прави активен бутон "Изпълни" в справката. \\ */ указва дали справката/скриптът трябва да върне резултат към документа или мястото, от където е извикан. Прави активен бутон "Изпълни" в справката. Типично за търсеща справка - тя трябва да върне номера на избрания документ/контрагент/позиция. \\
4. /* За да работи **Връщай селектираните редове**, трябва да е настроено и Връщай резултат. Връща резултат за избраните редове, т.е. за множество редове, а не само за един. По-голяма приложимост при скриптове или справка, отворено от друга справка, която трябва да върне даден резултат за обработка.\\ */ **Връщай селектираните редове** - за да работи **Връщай селектираните редове**, опцията "Връщай резултат" също трябва да има отметка. Ако е включено, върнатият резултат съдържа всички селектирани редове в справката/скрипта, в противен случай резултатът съдържа само текущия ред (на който е позициониран курсорът). Опцията е приложима при скриптове или справки, отворени от друга справка, която трябва да върне няколко реда за обработка, а не само един ред.
5. **Затваряне на извикващия след изпълнение** – /* логично е използването и изборът на тази отметка, само ако извикващият документ е междинен (посредник, а не първоначално заредена от него справка/скрипт), в противен случай каквото и да се отметне не влияе. – затвори с /без резултат е по-скоро за скриптове. \\ */ Когато тази отметка е поставена, документът/справката, който/която е извикал следващата справка/скрипт се затваря автоматично, веднага след изпълнението.
6. **Изпращай само текущия ред** – /* Определя какви стойности **изпраща документът към** справка/скрипт, които могат да се използват като отправна база за филтри. От гледна точка на документа се взима предвид (**изпращай** е от гледна точка на Документа, **връщай** – е от гледна точка на Справка/Скрипт). \\ */ Определя кое се **изпраща към** справка/скрипт от мястото на извикване (документ/справка). Данните, които се изпращат, могат да се използват като отправна база за филтри или изчисления в справката/скрипта.
/* Цената в реда на документ е 2 лв. Стойността (2) се взима и в последствие в справката/скрипт може да се зададе филтър за цена по-малка или по-голяма от 2.
Стойността се използва като филтър, а не се изпълнява справка върху стойностите на реда. \\ */
Ако скриптът е извикан от документ и е избрано "Изпращай само текущия ред", към скрипта се изпраща само заглавната част на документа и текущо избраният ред от редовете на документа; когато не е отметнато, се изпращат заглавната част и всички редове на документа.
Ако извикваната справка/скрипт няма нужда от редовете на документа, за да работи, не премахвайте отметката "Изпращай само текущия ред", защото изпращането на всички редове на един документ, особено когато той е дълъг, отнема време и може значително и излишно да забави стартирането на справката/скрипта.
7. **Унищожи при затваряне** – /* ако е отбелязано "Освободи", справката при затварянето си освобождава настройването на филтри. Ако е отбелязано "Не освобождавай", помни състоянието на филтрите. */ ако е отбелязана **отметка Освободи**, паметта, която се заема от справката/скрипта се освобождава. Резултатът от освобождаването на паметта е, че при последващо извикване справката ще се зареди тепърва наново, т.е. всички ще се инициализира от начало (филтри/съдържание и т.н.).
Ако паметта не се освободи (т.е. не е сложена отметка), затварянето на справката/скрипта само скрива прозореца, а повторното ѝ извикване е много по-бързо; филтрите и съдържанието се запазват. Полезно е при търсещи справки.
8. **Запомни преди извикване** - /* предизвиква Запис на документа преди да се изпълни съответният изглед. Обозначава да се запише скриптът (не да се изпълни), скриптът е в състояние да стигне до документа преди той да е запомнен. Ако тази отметка не е сложена, скриптът може да получи документа с попълнените до момента данни, т.е. могат да се покажат алтернативи преди да е попълнен качествено документът до край преди изпълнение. \\
Използва се в случаи, в които е необходимо данните да са записани. */ предизвиква Запис на документа преди да се изпълни съответният изглед. Ако справката/скрипта, които се извикват, трябва да "виждат" или обработват данните в базата данни на документа, от който са извикани, очевидно документът преди това трябва да бъде запомнен.
9. **Използвай резултата в** - ако справката/скриптът връща резултат и е свързана към събитие "Бутон" на документ, тогава този резултат може да се използва за въвеждане на данни в документа. Чрез тази настройка се указва точно къде да бъдат въведени данните - в заглавната или детайлната част на документа.
За целта справката/скриптът трябва да връща два вида полета: търсещи и резултатни. Търсещите полета определят върху кои редове в документа ще се приложат стойностите на резултатните полета. Търсещите полета задължително имат име съставено от LOCATE_ и името на полето, по което се търси. Всички други полета, чието име не започва с LOCATE_ се смятат за резултатни.
Например скрипт връща следните полета: \\
- LOCATE_ITEM_REF \\
- LOCATE_SIZE_REF \\
- LOCATE_COLOR_REF \\
- PRICE_WO_VAT_BFR_DISCNT или PRICE_WITH_VAT_BFR_DISCNT
Термините "Изпращай" и "Връщай" са от гледна точка на документа. Документът ИЗПРАЩА данни на справката/скрипта, и обратно те се ВРЪЩАТ в него от справката/скрипта.
Когато на едно събитие има връзки към повече от един скрипт е удобно да може да се укаже последователността им на изпълнение. Например, ако на приключване на документ са сложени за изпълнение два скрипта (единия прави нещо и опреснява документа, а другия прави проверка и ако нещо не е изпълнено спира приключването) не може да се определи по лесен начин, коя връзка да се изпълни първа.
За целта можете да използвате колона **Подредба**, намираща се във всички форми за настройка на връзки на справки и скриптове (Настройка на ТД, ФД, Ревизия, Атрибути серийни/партидни номера, скриптове). При наличие на една и съща подредба, скриптовете се изпълняват според ID на връзката.
==== Подложка ====
С избирането на подложка указвате дали да се отпечата документът, когато се затвори справката закачена на документа. Функционалността има най-голяма приложимост при използване за скриптове. Наименованието избирате от падащ списък с предварително дефинирани подложки.\\
==== Прикачване на множество Връзки справки/скриптове ====
При създаване на нов тип документ, по подобие на копирането на настройки е много удобно към него да се прехвърлят и настроените връзки със справки/скриптове от друг документ.
/* От [[vavedenie:kakvo_novo|2016.8]] е направена промяна, така че да може да извършвате **селекция на множество редове от връзки със справки и скриптове** и да ги прехвърляте наведнъж към произволен документ. */
За целта може да извършвате **селекция на множество редове от връзки със справки и скриптове** и да ги прехвърляте наведнъж към произволен документ.
След маркиране на желаните връзки за копиране изберете бутон Прикачи текущата връзка със справки/скриптове КЪМ.
{{ :documenti:obsti:tabove_nastrojki_na_fin.documenti:фд_-вр.спр.скр_-_прикачи.png |}}
Отваря се форма, в която да изберете желаните документи, към които да копирате селектираните преди това Връзки справки/скриптове. Може да маркирате всички или да изберете отделни документи.
{{:documenti:obsti:tabove_nastrojki_na_targ.documenti:forma_za_izbor_na_dok._kopirane_na_vrazki.png?550|}}
/* От [[vavedenie:kakvo_novo|2016.8]] при **редакция на събитие промените влизат в сила** **без** да се налага **повторно влизане в системата**. Единствено при създаването и изтриването на бутони, за да се визуализират или скрият, се налага рестартиране на системата. */
При **редакция на събитие промените влизат в сила** **без** да се налага **повторно влизане в системата**. Единствено при създаването и изтриването на бутони, за да се визуализират или скрият, се налага рестартиране на системата.
/* С излизане на [[vavedenie:kakvo_novo|релийз 2017.06]] е реализирана възможност, за изгледите да се задават **подразбиращи се настройки** за нови [[spravki_new:osnovni_pol#Връзки на текущия изглед|Връзки справки/скриптове]]. По този начин вече можете необходимите връзки за съответните документи директно да ги създавате в самия Изглед. */
За изгледите може да се задават и **подразбиращи се настройки** за нови [[spravki_new:osnovni_pol#Връзки на текущия изглед|Връзки справки/скриптове]]. По този начин можете директно в самия Изглед да създавате необходимите връзки за съответните документи.
**Допълнителна информация:** \\
[[documenti:obsti:nastrojki_na_fin.documenti|Редакция на типа на Финансовия документ - Общи положения]]