| Both sides previous revisionПредходна версияСледваща версия | Предходна версия |
| documenti:obsti:tabove_nastrojki_na_fin.documenti:fd_vrazki_spravki_skriptove [2018/02/13 14:12] – k.kyurkchieva | documenti:obsti:tabove_nastrojki_na_fin.documenti:fd_vrazki_spravki_skriptove [2020/08/28 12:36] (текуща) – [Прикачване на множество Връзки справки/скриптове] m.ayvazova |
|---|
| ===== Връзки със справки/скриптове ===== | ===== Връзки със справки/скриптове ===== |
| |
| В този таб се определят връзките на финансовия документ с всички справки и скриптове в системата. \\ | В този таб се определят връзките на съответния финансов документ с всички справки и скриптове в системата. \\ |
| |
| В системата всички [[spravki_new:osnovni_pol|справки и скриптове]] са съобразени с потребностите на съответните клиенти. Функционално няма разлика между справка и скрипт. | В системата всички [[spravki_new:osnovni_pol|справки и скриптове]] са съобразени с потребностите на съответните клиенти. Функционално няма разлика между справка и скрипт. |
| ==== Събитие ==== | ==== Събитие ==== |
| |
| В първата колона **Събитие** са наименованията на събития, които се избират от Фиксиран списък, дефиниран предварително на програмно ниво, потребителят не може да го определя. Тук се посочва наименованието на мястото (събитието), за което се връзва справката/скрипта. | В първата колона **Събитие** са наименованията на събития, които се избират от Фиксиран списък, дефиниран предварително на програмно ниво (потребителят не може да го определя). Тук се посочва наименованието на мястото (събитието), към което се прикачи справката/скрипта. |
| |
| {{:documenti:obsti:събития_справки_тд.jpg|}} \\ | {{:documenti:obsti:събития_справки_тд.jpg|}} \\ |
| |
| |
| <box round red|**Важно**:>**Справката/скрипт** може да бъде настроена да се пуска от: | <box round red|**Важно**:>**Справката/скрипт** може да бъде настроена да се изпълни от: |
| |
| 1. Бутон търсене {{:documenti:obsti:бутон_търсене_тд.jpg|}} \\ | 1. Бутон търсене {{:documenti:obsti:бутон_търсене_тд.jpg|}} \\ |
| |
| |
| <box round red|**Важно**:>Да се внимава справка/скрипт да се свързва към **поле видимо в изгледа** или ако не се вижда от **Редакция на изгледа** да се покаже. (Напр. търсене на контрагент източник - ако не е показано, да се визуализира от редакцията.) </box> | <box round red|**Важно**:>Трябва да се внимава справките/скриптовете да се свързват към **полета видими в изгледа** или ако не се виждат от **Редакция на изгледа** да се покаже съответното поле. (Напр. търсене на контрагент източник - ако не е видимо в изгледа, да се визуализира от редакцията.) </box> |
| |
| /* С излизането на [[vavedenie:kakvo_novo|релийз 2015.8]] е добавено ново събитие „След Анулиране“. Това ще улесни създаването на скриптове, които да сработват при промяна на статуса на документ. */ | /* С излизането на [[vavedenie:kakvo_novo|релийз 2015.8]] е добавено ново събитие „След Анулиране“. Това ще улесни създаването на скриптове, които да сработват при промяна на статуса на документ. */ |
| ====Изглед==== | ====Изглед==== |
| |
| В колона **Изглед**/Наименование се определя коя справка/скрипт се закача, т.е. за наименованието на кой изглед на справка/скрипт се отнася изборът (възможно е една справка да има повече от един изглед). \\ | В колона **Изглед**/Наименование се определя коя справка/скрипт да бъде закачена, т.е. за наименованието на кой изглед на справка/скрипт се отнася изборът (възможно е една справка да има повече от един изглед). \\ |
| За да може да избирате [[spravki_new:osnovni_pol|справки/скриптове, те предварително трябва да са дефинирани в номенклатурата]], където са посочени **Източниците на данни** за съответния изглед. | За да може да избирате [[spravki_new:osnovni_pol|справки/скриптове, те предварително трябва да са дефинирани в номенклатурата]], където са посочени **Източниците на данни** за съответния изглед. |
| |
| {{:documenti:obsti:колонанастройки_справки_тд.jpg|}} | {{:documenti:obsti:колонанастройки_справки_тд.jpg|}} |
| |
| 1. **Автоматично изпълнение** - изпълнява автоматично справката/скриптаоще с отварянето. Полезно, когато на потребителя не трябва да се задават въпроси. \\ | 1. **Автоматично изпълнение** - справката/скриптът се изпълнява автоматично още с отварянето му. Полезно е да се използва тази опция, когато на потребителя не трябва да се задават въпроси. \\ |
| |
| 2. **Показвай модално** – Модален е прозорец, който докато не се затвори, програмата не продължава изпълнението си. Тази опция трябва да е включена, когато е включено "Връщай резултат", защото докато потребителя не направи своя избор (който се връща като резултат) програмата не трябва да може да продължи. /* работи се само с активния прозорец, който е най-отпред, т.е. само със справката. Не могат да се променят, местят, редактират и т.н. останалите (задните) прозорци. */ | 2. **Показвай модално** – Модален е прозорец, който докато не бъде затворени, програмата няма да продължи изпълнението си. Тази опция трябва да е включена в комбинация с "Връщай резултат", защото докато потребителят не направи своя избор (който се връща като резултат) програмата не трябва да може да продължи. /* работи се само с активния прозорец, който е най-отпред, т.е. само със справката. Не могат да се променят, местят, редактират и т.н. останалите (задните) прозорци. */ |
| |
| Справка/скрипт, която е вързана на събитие "Търсене на ..." е винаги модална и тази настройка няма влияние за нея, защото търсеща справка/скрипт винаги трябва да връща резултат, съответно е нужно да бъде "модална". | /* Справка/скрипт, която е вързана на събитие "Търсене на ..." винаги е модална и тази настройка няма влияние за нея, защото търсеща справка/скрипт винаги трябва да връща резултат, съответно е необходимо да бъде "модална". */ |
| |
| /* <box round green|**Пример**:>По подобие на ситуацията когато е отворена **Редакция на типа на документа** при Търговски или Финансов документ.</box> \\ */ | /* <box round green|**Пример**:>По подобие на ситуацията когато е отворена **Редакция на типа на документа** при Търговски или Финансов документ.</box> \\ */ |
| Търсенето на Търговски документ, Контрагент, Позиция и т.н. по подразбиране е модално, въпреки че отметката не е поставена, т.е. модалността при него не се влияе от отметката. | Търсенето на Търговски документ, Контрагент, Позиция и т.н. по подразбиране е модално, въпреки че отметката не е поставена, т.е. модалността при него не се влияе от отметката. |
| |
| 3. **Връщай резултат** – /* връща само текущия ред, на който е курсурът или където е кликнато. Прави активен бутон "Изпълни" в справката. \\ */ дали справката/скриптът трябва да върне резултат към документа или мястото, от където е извикан. Прави активен бутон "Изпълни" в справката. Типично за търсеща справка - тя трябва да върне номера на избрания документ/контрагент/позиция. \\ | 3. **Връщай резултат** – /* връща само текущия ред, на който е курсурът или където е кликнато. Прави активен бутон "Изпълни" в справката. \\ */ указва дали справката/скриптът трябва да върне резултат към документа или мястото, от където е извикан. Прави активен бутон "Изпълни" в справката. Типично за търсеща справка - тя трябва да върне номера на избрания документ/контрагент/позиция. \\ |
| |
| 4. /* За да работи **Връщай селектираните редове**, трябва да е настроено и Връщай резултат. Връща резултат за избраните редове, т.е. за множество редове, а не само за един. По-голяма приложимост при скриптове или справка, отворено от друга справка, която трябва да върне даден резултат за обработка.\\ */ За да работи **Връщай селектираните редове**, трябва да е отметнато и Връщай резултат. Ако е включено, върнатият резултат съдържа всички селектирани редове в справката/скрипта, иначе съдържа само текущия ред (на който се намира курсора). Приложимо е при скриптове или справка, отворена от друга справка, която трябва да върне няколко реда за обработка, а не само един ред. | 4. /* За да работи **Връщай селектираните редове**, трябва да е настроено и Връщай резултат. Връща резултат за избраните редове, т.е. за множество редове, а не само за един. По-голяма приложимост при скриптове или справка, отворено от друга справка, която трябва да върне даден резултат за обработка.\\ */ **Връщай селектираните редове** - за да работи **Връщай селектираните редове**, опцията "Връщай резултат" също трябва да има отметка. Ако е включено, върнатият резултат съдържа всички селектирани редове в справката/скрипта, в противен случай резултатът съдържа само текущия ред (на който е позициониран курсорът). Опцията е приложима при скриптове или справки, отворени от друга справка, която трябва да върне няколко реда за обработка, а не само един ред. |
| |
| 5. **Затваряне на извикващия след изпълнение** – /* логично е използването и изборът на тази отметка, само ако извикващият документ е междинен (посредник, а не първоначално заредена от него справка/скрипт), в противен случай каквото и да се отметне не влияе. – затвори с /без резултат е по-скоро за скриптове. \\ */ Когато тази отметка е поставена, документът/справката, който е извикал справката/скрипта се затваря автоматично, веднага след изпълнението. | 5. **Затваряне на извикващия след изпълнение** – /* логично е използването и изборът на тази отметка, само ако извикващият документ е междинен (посредник, а не първоначално заредена от него справка/скрипт), в противен случай каквото и да се отметне не влияе. – затвори с /без резултат е по-скоро за скриптове. \\ */ Когато тази отметка е поставена, документът/справката, който/която е извикал следващата справка/скрипт се затваря автоматично, веднага след изпълнението. |
| |
| 6. **Изпращай само текущия ред** – /* Определя какви стойности **изпраща документът към** справка/скрипт, които могат да се използват като отправна база за филтри. От гледна точка на документа се взима предвид (**изпращай** е от гледна точка на Документа, **връщай** – е от гледна точка на Справка/Скрипт). \\ */ Определя кое се **изпраща към** справка/скрипт от мястото на извикване (документ/справка). Данните, които се изпращат, могат да се използват като отправна база за филтри или изчисления в справката/скрипта. | 6. **Изпращай само текущия ред** – /* Определя какви стойности **изпраща документът към** справка/скрипт, които могат да се използват като отправна база за филтри. От гледна точка на документа се взима предвид (**изпращай** е от гледна точка на Документа, **връщай** – е от гледна точка на Справка/Скрипт). \\ */ Определя кое се **изпраща към** справка/скрипт от мястото на извикване (документ/справка). Данните, които се изпращат, могат да се използват като отправна база за филтри или изчисления в справката/скрипта. |
| <box round red|**Важно**:> Стойността се използва като филтър, а не се изпълнява справка върху стойностите на реда. </box>\\ */ | <box round red|**Важно**:> Стойността се използва като филтър, а не се изпълнява справка върху стойностите на реда. </box>\\ */ |
| |
| Например, ако скрипта е извикан от документ и е избрано "Изпращай само текущия ред", на скрипта се изпраща само заглавната част на документа и текущо избраният ред от редовете на документа; когато не е отметнато, се изпращат заглавната част и всички редове на документа. | <box round green|**Пример**:> Ако скриптът е извикан от документ и е избрано "Изпращай само текущия ред", към скрипта се изпраща само заглавната част на документа и текущо избраният ред от редовете на документа; когато не е отметнато, се изпращат заглавната част и всички редове на документа.</box> |
| |
| <box round red|**Внимание!**> | <box round red|**Внимание!**> |
| Ако извикваната справка/скрипт няма нужда от редовете на документа, за да работи, не премахвайте отметката "Изпращай само текущия ред", защото изпращането на всички редове на един документ, особено когато той е дълъг, отнема време и може значително и излишно да забави стартирането на справката/скрипта | Ако извикваната справка/скрипт няма нужда от редовете на документа, за да работи, не премахвайте отметката "Изпращай само текущия ред", защото изпращането на всички редове на един документ, особено когато той е дълъг, отнема време и може значително и излишно да забави стартирането на справката/скрипта. |
| </box> | </box> |
| |
| Ако паметта не се освободи (т.е. не е сложена отметка), затварянето на справката/скрипта само скрива прозореца, а повторното ѝ извикване е много по-бързо; филтрите и съдържанието се запазват. Полезно е при търсещи справки. | Ако паметта не се освободи (т.е. не е сложена отметка), затварянето на справката/скрипта само скрива прозореца, а повторното ѝ извикване е много по-бързо; филтрите и съдържанието се запазват. Полезно е при търсещи справки. |
| |
| 8. **Запомни преди извикване** - /* предизвиква Запис на документа преди да се изпълни съответният изглед. Обозначава да се запише скриптът (не да се изпълни), скриптът е в състояние да стигне до документа преди той да е запомнен. /*Ако тази отметка не е сложена, скриптът може да получи документа с попълнените до момента данни, т.е. могат да се покажат алтернативи преди да е попълнен качествено документът до край преди изпълнение. \\ */ | 8. **Запомни преди извикване** - /* предизвиква Запис на документа преди да се изпълни съответният изглед. Обозначава да се запише скриптът (не да се изпълни), скриптът е в състояние да стигне до документа преди той да е запомнен. Ако тази отметка не е сложена, скриптът може да получи документа с попълнените до момента данни, т.е. могат да се покажат алтернативи преди да е попълнен качествено документът до край преди изпълнение. \\ |
| Използва се в случаи, в които е необходимо данните да са записани. */ предизвиква Запис на документа преди да се изпълни съответният изглед. Ако справката/скрипта, които се извикват, трябва да "виждат" или обработват данните в базата данни на документа, от който са извикани, очевидно документа преди това трябва да бъде запомнен. | Използва се в случаи, в които е необходимо данните да са записани. */ предизвиква Запис на документа преди да се изпълни съответният изглед. Ако справката/скрипта, които се извикват, трябва да "виждат" или обработват данните в базата данни на документа, от който са извикани, очевидно документът преди това трябва да бъде запомнен. |
| |
| 9. **Използвай резултата в** - ако справката/скрипта връща резултат и е свързана към събитие "Бутон" на документ, тогава този резултат може да се използва за въвеждане на данни в документа. Чрез тази настройка се указва точно къде да бъдат въведени данните - в заглавната или детайлната част на документа. | 9. **Използвай резултата в** - ако справката/скриптът връща резултат и е свързана към събитие "Бутон" на документ, тогава този резултат може да се използва за въвеждане на данни в документа. Чрез тази настройка се указва точно къде да бъдат въведени данните - в заглавната или детайлната част на документа. |
| |
| За целта справката/скрипта трябва да връща два вида полета: търсещи и резултатни. Търсещите полета определят върху кои редове в документа ще се приложат стойностите на резултатните полета. Търсещите полета задължително имат име съставено от LOCATE_ и името на полето, по което се търси. Всички други полета, чието име не започва с LOCATE_ се смятат за резултатни. | За целта справката/скриптът трябва да връща два вида полета: търсещи и резултатни. Търсещите полета определят върху кои редове в документа ще се приложат стойностите на резултатните полета. Търсещите полета задължително имат име съставено от LOCATE_ и името на полето, по което се търси. Всички други полета, чието име не започва с LOCATE_ се смятат за резултатни. |
| |
| Например скрипт връща следните полета: | Например скрипт връща следните полета: \\ |
| - LOCATE_ITEM_REF | - LOCATE_ITEM_REF \\ |
| - LOCATE_SIZE_REF | - LOCATE_SIZE_REF \\ |
| - LOCATE_COLOR_REF | - LOCATE_COLOR_REF \\ |
| - PRICE_WO_VAT_BFR_DISCNT или PRICE_WITH_VAT_BFR_DISCNT | - PRICE_WO_VAT_BFR_DISCNT или PRICE_WITH_VAT_BFR_DISCNT |
| |
| |
| <box green|**Забележка**> | <box green|**Забележка**> |
| Термините "Изпращай" и "Връщай" са от гледна точка на документа. Документа ИЗПРАЩА данни на справката/скрипта, и обратно те се ВРЪЩАТ в него от справката/скрипта. | Термините "Изпращай" и "Връщай" са от гледна точка на документа. Документът ИЗПРАЩА данни на справката/скрипта, и обратно те се ВРЪЩАТ в него от справката/скрипта. |
| </box> | </box> |
| |
| Когато на едно събитие има връзки към повече от един скрипт е удобно да може да се укаже последователността им на изпълнение. Например, ако на приключване на документ са сложени за изпълнение два скрипта (единия прави нещо и опреснява документа, а другия прави проверка и ако нещо не е изпълнено спира приключването) не може да се определи по лесен начин, коя връзка да се изпълни първа. | Когато на едно събитие има връзки към повече от един скрипт е удобно да може да се укаже последователността им на изпълнение. Например, ако на приключване на документ са сложени за изпълнение два скрипта (единия прави нещо и опреснява документа, а другия прави проверка и ако нещо не е изпълнено спира приключването) не може да се определи по лесен начин, коя връзка да се изпълни първа. |
| | |
| | За целта можете да използвате колона **Подредба**, намираща се във всички форми за настройка на връзки на справки и скриптове (Настройка на ТД, ФД, Ревизия, Атрибути серийни/партидни номера, скриптове). При наличие на една и съща подредба, скриптовете се изпълняват според ID на връзката. |
| |
| ==== Подложка ==== | ==== Подложка ==== |
| |
| С избирането на подложка указвате да се отпечата документа, когато се затвори справката закачена на документа. Функционалността има най-голяма приложимост при използване за скриптове. Наименованието избирате от падащ списък с предварително дефинирани подложки.\\ | С избирането на подложка указвате дали да се отпечата документът, когато се затвори справката закачена на документа. Функционалността има най-голяма приложимост при използване за скриптове. Наименованието избирате от падащ списък с предварително дефинирани подложки.\\ |
| |
| ==== Прикачване на множество Връзки справки/скриптове ==== | ==== Прикачване на множество Връзки справки/скриптове ==== |
| |
| При създаване на нов тип документ, по подобие на копирането на настройки е много удобно да се прехвърлят към него и настроените връзки със справки/скриптове от друг документ. | При създаване на нов тип документ, по подобие на копирането на настройки е много удобно към него да се прехвърлят и настроените връзки със справки/скриптове от друг документ. |
| |
| /* От [[vavedenie:kakvo_novo|2016.8]] е направена промяна, така че да може да извършвате **селекция на множество редове от връзки със справки и скриптове** и да ги прехвърляте наведнъж към произволен документ. */ | /* От [[vavedenie:kakvo_novo|2016.8]] е направена промяна, така че да може да извършвате **селекция на множество редове от връзки със справки и скриптове** и да ги прехвърляте наведнъж към произволен документ. */ |
| След маркиране на желаните връзки за копиране изберете бутон <key>Прикачи текущата връзка със справки/скриптове КЪМ</key>. | След маркиране на желаните връзки за копиране изберете бутон <key>Прикачи текущата връзка със справки/скриптове КЪМ</key>. |
| |
| {{:documenti:obsti:tabove_nastrojki_na_targ.documenti:buton_kopirane_na_vrazki_spravki_skriptove.png|}} | {{ :documenti:obsti:tabove_nastrojki_na_fin.documenti:фд_-вр.спр.скр_-_прикачи.png |}} |
| |
| Отваря се форма, в която да изберете желаните документи, към които да копирате селектираните преди това Връзки справки/скриптове. Може да маркирате всички или да изберете отделни документи. | Отваря се форма, в която да изберете желаните документи, към които да копирате селектираните преди това Връзки справки/скриптове. Може да маркирате всички или да изберете отделни документи. |
