Концепцията на справките е, че всички справки в системата са къстъм, те са вътре в базата данни. Програмата първоначално е с пакет стандартни справки, като голямо предимство е, че реално те също са модифицируеми. Възможно е произволна справка, която се разпространява със системата, да се модифицира бързо и лесно, ускорява се драматично къстъмизирането на справки/скриптове.

Системата позволява да се оптимизират максимално справките, и да се използват конкретно по предназначение и по този начин драматично да се увеличи обемът данни, с който може да работи системата.

Генерално справките имат определен източник на данни, който се задава от програмист. Той настройва входните филтри, които може да има справката, като впоследствие консултантът може доста да разшири тези настройки (да се надписват колони, да се махат, скриват и т.н.).

Източникът на данни е зададен от програмист с определени параметри, а впоследствие за всеки документ могат да се създадат неопределен брой изгледи (с различни параметри) на тези данни.
Филтрите на справките могат да се подредят по какъвто начин прецени консултанта (на страници; някои да не са визуализирани, въпреки че програмистът ги е дал като възможност и т.н.).

Справката се изпълнява с бутон за „Изпълни“, като има и възможност за печат, който не се осъществява чрез report builder, тъй като информацията е представена в грид и има възможност за абсолютно произволни групирания, сумирания, графики и т.н., поради което печатът е чрез стандартен печат.

Голямо предимство е възможността резултатът от справката да може да се покаже както в обикновен грид, така и в анализ и в графика, като справките могат да имат няколко таблици (грида) едновременно. В състояние сме да направим сложна справка с няколко таблици, структурно различни, които да показват обширна информация по различен начин.

За удобство на потребителите, за да се виждат по-добре редовете в справка (или документ), особено ако се работи в touch режим, имате възможност свободно да редактирате височината на реда. Това е полезно и при ситуации, когато позициите са с изображения и трябва да се визуализират по-добре. Динамични справки могат да връщат информация за настройките на табличния изглед, например групираност по полета, ниво на разпънатост, тотали, тотали на групи (хедъра, колонтитул по групи и т.н.). Ако в справка има колони за писане, то само те да се обхождат с Enter.

В опциите за долния колонтитул на справките в табличен вид (при клик с десен бутон върху него) е опцията „Изтрий всички обобщения“. С нея имате възможност да премахвате обобщенията. Това би било полезно за избягването на грешки в справки, в следствие например на добавяне на нови колонки в стара справка в изглед, по който вече има суми по дадени колони.

В някои колони на справките потребителят може да попълва данни, също така в справките могат да се закачват скриптове, да има картинки вътре в тях (напр. мини изображенията на позициите) и др..

По подразбиране, когато за първи път се зареди изгледа на справката, наименованията на колоните идват от Data dictionary, но там не винаги могат да се настроят като наименования и като бандове кой как да се наименува в различните справки.

За това е направена възможност когато се натисне десен бутон да се преименува колоната, а за бандовете да се преименуват те (както и възможност за добави нов, изтрий и т.н.), т.е. когато се създават справките трябва да се кръщават и бандовете и колоните.

С редакция на изгледа диаграмата може да е на таб, до данните и т.н., по решение и желание на потребителя.

Справките могат да са дървовидни (пример, скрийншота по-горе със справка папки), като вляво например има дървовидно показана информация, а за всеки ред като се кликне в него може да се отваря втора справка от първата, за да се покажат вътре документите, а оттам можe да се отваря и конкретният документ. При двоен клик върху едни колони може да се случва едно нещо, а върху други - друго. Вече справките могат да обработват освен ACT$DOC_ID и ACT$DOC_CLASS_NAME и още 5 нови комплекта от параметри. Тези 5 комплекта дават възможност за до 5 отделни действия, в зависимост от колоната/ите, върху която/ито е дабъл кликнато:

• ACT$DOC_ID1, ACT$DOC_ID2… ACT$DOCID5 – определят кое ИД да се отвори;
• ACT$DOC_CLASS_NAME1 … 5 - определят кой клас да се отвори;
• ACT$DOC_COLS1… ACT$DOC_COLS5 - в тези полета се държи името на колоната или имената на колоните, за които е действието. Самите имена на колоните се разделят със точка и запетая ( ; ).

Ако се дабъл кликне върху ред от справка: Първо се проверява дали колоната, в която се намираме при дабъл клик не е изредена в ACT$DOC_COL1 или ACT$DOC_COL2 или .. и т.н. в ACT$DOC_COL5. Ако се намери в някоя от тези колони - в първата, в която се намери, например в ACT$DOC_COL2 - се отваря клас ACT$DOC_CLASS_NAME2 с ИД ACT$DOC_ID2. Ако не се намери нищо и има дефиниран параметъра използван до момента ACT$DOC_ID и ACT$DOC_CLASS_NAME класа се отваря по стандартния начин.

От Меню служебни - Справки/Скриптове (или от друг възел където е изкаран в главното меню) се достъпва Номенклатурата на Източниците на данни за справките и за Изгледите.
Има два типа източници на данни - SQL заявка и скриптове. В източника на данни е и изходния код на самата справка, който се задава от програмист.

В прозореца в лявата част са визуализирани Източниците, а в дясната Изгледите. Един Източник може да има много Изгледи.
Когато смените фокуса от едната таблица в другата, отгоре в рибона на прозореца се променя контекста на източници на данни и на изглед, защото могат да се правят редакции (Нов, редакция, експорт и импорт) и на двете.

Когато се експортират данните, те се експортират с всичките си изгледи, които са за тях (показват се в долната таблица когато курсорът е позициониран на определен ред с наименованието на източника на данни). Това предоставя възможността справката с източника на данни и изгледите да може да се постави в друга база.

Към всеки един ред от източника могат да се закачат два подизточника, които се контролират от централния. На всеки един детайл може да се извадят по още два, т.е. до трето ниво на вложеност - един master (един главен), в който може да има два детайла и на всеки един от тези детайли може да има по още два детайла.

Можете да слагате Описание на Източниците и Изгледите. Описанието е и на двете места, защото е важно да го има в източниците, но твърде често с два различни изгледа на един и същи източник може да се постигнат съвсем различни резултати, за това е полезно за тях също да се пише каква им е предназначението.
Има възможност да се „пейства“ вече готово задание вътре в Описанието.

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

Имате възможност да селектирате произволни редове от справка като редове, а не като област.

Мултиселекта на отделните редове става стандартно със задържане на клавиш „Ctrl“ от клавиатурата и кликване с мишката на конкретен ред.

Стандартно за справки, която съдържат Главен източник и Детайл, е налице функционалността при кликване на ред в Главния източник да се предава информация към Детайла и според тази информация да се зареждат данни в Детайла.
Съществува функционалност и в обратната посока – предаване на данни от Детайла към Главния източник. При двоен клик на ред в детайла се прехвърлят стойностите на всички полета от детайлната таблица в главната таблицата, като ги сравнява по имена.
При необходимост има възможност да се пренася и конкретна стойност на поле.

При стартиране на скриптове и справки за всички събития се следи настройката на връзката. Ако има посочено къде влияе (Заглавна или Детайлна част) и се върне резултат, той се прилага.
Редакцията на това поле (наличие на колона „Използвай резултата в“) е възможна и през общата форма за „Връзки на справки/скриптове“.

В таблицата със справки/скриптове, в рибона на прозореца има отделни табове, които позволяват Импорт/Експорт на източник на данни и изгледи, Дублиране на източник/източник с изглед Импорт на изглед към източник и др.

В този таб се съдържат някои главни параметри като наименование на източникът и какъв резултат да се върне на Извикващия елемент - Опресни или Приключи.

Тук се съдържа самият изходен код (източник на данни).

При писане на SQL заявка, при поставяне в кода е необходимо всички апострофи да се удвоят. Съответно обратно, ако от кода се налага да се извади отделната заявка и да се пробва в редактор, трябва да се махнат апострофите. За улеснение на този вид действия при работа със скриптове (без значение от какъв тип са), в изгледите за редакция на Източник на данни са добавени два бутона:

• Копирай в клипборда без апострофи
• Постави от клипборда с апострофи

Съдържа параметрите – филтри (когато е справка), тъй като може да е справка или скрипт са обединени под наименованието параметри (указва се кое е полето, къде да отиде, таблица, alies, тип на параметъра, възможни условия, кое е подразбиращо се условие, списък за избор и т.н.).
През редакция на източника от този таб могат да се добавят параметри.

За улеснение при създаването на параметри на източници на данни има два бутона във формата за редакция на източник - „Добави липсващи“ и „Инициализирай“. Те създават редове в таблицата с параметрите и попълват в полетата ѝ някои подразбиращи се стойности, като в „разрешени условия“ и „подразбиращо се условие“ се попълва само „=“.

С отметката Е парола, обозначавате филтрите, които са пароли.

/

При смяна на типа на параметър на Да/Не, при пост на реда, се изтриват въведените преди това стойности към него.

От този таб може да се зададе специално поведение или форматиране на определени колони, като например форматиране, показване като картинка, чекбокс, възможност за редакция, скриване и т.н. Естествено необходимо е и източника на данни да е съобразен с поведението на колоната.

В таблицата за име на колоната се поставя системното наименование, така както е дефинирано в източника на данни (пример има по-долу); както е видно, не е нужно да се указва от кой точно източник е колоната (главния или някой от детайлните) - т.е. НЕЗАВИСИМО от кой източник идва, ако има колона с посочено в тази таблица име са в сила настройките ѝ. Това разбира се може да бъде и нежелан ефект - простото решение е, ако е нужно различно поведение в някой от източниците трябва да са с различни имена.

Самият източник на данни може да зададе, че дадена колона е например изображение (самият грид, за да го покаже като изображение, трябва да разпознава като такова, т.е. да знае какво е това). Няма ограничения за размера на изображенията, но чрез Групова политика, която указва размера на мини изображенията могат да се създадат ограничения.

Когато дадена специална колона се укаже, че Е ИКОНА, тя може да покаже картинка от списъка по-долу. Колоната трябва да е число; числото отговаря на иконата:

По подобие на Търговските документи, това е таб, описващ формулите, според които действа справката.

Във формулите свързани с подразбиращи се стойности за дата има и полезни функции описани тук.

Налице е възможност за полетата от тип „Цяло число“ да се задава желан формат посредством полето „Маски за файл/директория“.
След приемане или въвеждане на стойности в полета от такъв тип, се установява посоченият формат.

В този таб може да се задават допълнителни настройки на поведението на източника. Настройките се описват като XML, като основният възел трябва да е с име AdditionalOptions

Възможни тагове:

При заместването на макроса го поставя quoted в апострофи. Необходимо ако макроса се използва в execute statement.

Пример за стойност в Допълнителните настройки:

<AdditionalOptions>
	<QuotedMacros>
		<M1/>
		<TD_EXP_INC/>
		<M2/>
	</QuotedMacros>
</AdditionalOptions>

Позволява регистрирането на Делфи клас така че да може да се достъпва в кода на скрипта през RTTI. Важи САМО за TMS/Delphi скриптове!

<AdditionalOptions>
  <ClassByRTTI>
     <C1  QualifiedClassName="TfBaseCustomDocument_DM" ClassName="TfBaseCustomDocument_DM"/>
  </ClassByRTTI>
</AdditionalOptions>

Наименование на изгледа - в полето се задава наименованието на съответния изглед.

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

ключово поле на дървовидния изглед на главния източник и родителско поле на дървовидния изглед на главния източник – С избора на тези полета се посочва кой ред, кой е. Тъй като справките са динамични, тук се определя кои две колони са ID и parent ID (свободен текст, който специалист програмист взима от SQL).

За да се нареди едно дърво, всеки един от елементите трябва да знае кой му е „родителят“, т.е. необходима е колоната, която указва кой е родителят и колоната, която указва кой е уникалният идентификатор на реда (коя е колоната, в която пише кой е родителя).

голяма икона, малка икона, шорткът - една от полезните функционалности на системата, когато направите даден изглед може да му зададете икони и съответно вече където се използва даденият изглед (където е закачен), да се използва неговата икона.

Върни резултат отпечатай на изискващия – когато този изглед се извиква в даден Търговски документ или някъде другаде, той когато се изпълни (изпълнява се, затваря се и т.н.), и указва, на който го е извикал да се отпечата (ако извикващият има настроен печат). Оттам са и настройките за подложката по подразбиране (в настройките на самите справки/скриптове).

Налични са отметки за връщане на резултат Опресни и Приключи на извикващия.

Ако е отметнат чекбокс „Позволи стартиране от външна програма“ в изгледа на справките/скриптовете, външна програма може да изпълни изгледа.

Когато желаете да покажете резултата в дърво е необходимо да настроите ID&PARENT_ID. Това може да се настрои за главния изглед и за детайлите и субдетайлите.

При работа със справките удобно би било да се вижда описание за какво служи съответната справка и как да се използва. Като такива може да се използват отделните описания за Източник и Изглед, намиращи се в таб Главни в редакцията им.
За да се реализира това визуализиране на описанията, в Изгледите са налични две отметки „Показвай описанието от източника“ и „Показвай описанието от изгледа“. Ако съответната отметка е маркирана, полето с описанието се показва в изгледа на справката.

Някои параметри може да са скрити по подразбиране (например тип на документа, може да се достъпва само от програмист).
Параметрите, които могат да се взимат (например системно име) са дефинирани от програмист в източника. В източника могат да се дефинират параметри, а в изгледа тези параметри могат да се предефинират. Това позволява програмистът предварително да дефинира определени параметри, които консултантът да промени.

Целта на изгледа е да се зададат подразбиращи се стойности, с които тръгва справката. Първоначално се започва със стойностите, параметрите, филтрите, които програмистът е задал, а върху тях консултантът има възможност да прави промени. Когато вече потребителят има своите изисквания - от наличните се правят промени – реда на прилагане е програмист, консултант, потребител/клиент.

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

Вижте още Константи и функции за параметри за Дата и час.

Оттук се определя дадения изглед къде може да бъде избран (поставен). Целта е когато желаете да закачите скрипт на определено място, да не паднат за избор абсолютно всички справки в системата.

Това също позволява и да се предефинират определени свойства към какво може да се закача.

„Достъп до евенти“ - когато сте на реда, се появява контекст за достъпа до „евенти“, като може да се добави, редактира, копира и изтрие определен достъп.

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

Използвай в събитие - избирате в кое събитие да се използва, като ако се избере символа „*“ означава и на бутон и на всички, а когато е избрано определено събитие – само на него.

Комбинацията от настройки, за да работи даден скрипт или справка (на ниво ТД или ако трябва да се стартират един от друг) е различна за различните справки и на потребителят отнема доста време докато ги настрои.
За да се оптимизира този процес от изгледите можете да задавате подразбиращи се настройки за нови Връзки справки/скриптове и директно необходимите връзки да се създават в съответните документи.

За целта се използва таб „Връзки на текущия изглед“ в редакция на „Изглед“-а. В него се съдържа таблица "Достъпен за избор към събития", както и други две таблици:

1) Подразбиращи се настройки за нови връзки – в нея задавате настройки, които се считат за подразбиращи се, при създаване на нова връзка в таблица 2.

2) Текущи връзки за дадения изглед – таблицата съдържа съществуващите връзки, като в нея вече може да създавате и нови връзки директно от текущия изглед.

В Настройките на ТД, ФД и Ревизия при създаването на Връзки към справки/скриптове важат подразбиращите се настройки спрямо съответните изгледи.
В случай, че няма посочени такива се зареждат заложените настройки от системата.

Подразбиращите се настройки за нови връзки са системни (прехвърлят се при ъпгрейд), ако изгледа, към който са направени, е системен.

Можете да предефинирате настройки на Изглед на справка/скрипт.
В процеса на работа това, че даден Източник или Изглед е системен, създава известни неудобства, тъй като в повечето случаи се налага пренастройване на параметри, връзки между справки/скриптове, главно меню и др., което от своя страна налага преобразуването на системния Източник/Изглед в несистемен.
За да се решат подобни проблеми, в Изгледите са налични допълнителни възможности за настройки - таб „Специални полета“ по подобие на Източниците, възможност директно от Параметрите на изгледа да се задава дали са задължителни или скрити, възможност за добавяне на нови параметри, които да се ползват в макроси.

В таб „Специални полета“ може да задавате формат на колона, да отбележите дали тя е редактируема, скрита, с отметка, текст, картинка или икона.

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

Настройките са подобни на познатите за справки/скриптове в Търговските документи.

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

Можете да настроите да се появява звуково и визуално предупреждение при промяна на данни в информационното табло. В изгледа задавате какво съобщение да се показва (какви са новите неща (промените)) и какъв звук да се възпроизведе.

В тази връзка в Източниците на данни, в Специални полета е налице колона „Е главен ключ в инф.табло“. Маркираните по този начин едно или повече полета, представляват главни ключове, за които се съставя списък със стойностите им и се сравнява има ли промяна между две изпълнения на справката, за която са посочени.

В Настройките на изгледите е създаден таб „Уведомление в инф.табло“, в което се задават настройките кога да се показва уведомлението.

За повече информация как се настройват условията за уведомление вижте в "Нотификация при промяна в Информационно табло".

Вижте статията от поредицата „Как да“: Как да боравим с Импорт/Експорт в справки и скриптове, където подробно са описани функциите в таб Импорт/експорт на справките/скриптове.

Допълнителна информация: Справки - експорт в Excel и печат, Основни табове и бутони, Таблична част, Моделиране на таблици, Филтриране на данни, Редакция на изгледи, Менюта, Настройки Търговски документи, Настройки финансови документи, Как да боравим с Импорт/Експорт в справки и скриптове.

За да създадете собствени справки и скриптове е необходимо да имате познания и умения на програмист.

Документация на справките и скриптовете може да бъде предоставена при поискване.

Поради зачестилото използване на ExecSMview.exe (инструмент за автоматично изпълнение на скриптове) с външни параметри и предвид това, че преписването на самите параметри е трудоемко и вероятността за грешки е голяма, е реализирана възможност за експорт на текущото състояние на всички параметри на справка/скрипт от SelmaticERP и записването им във файл, във формат подходящ за използване от ExecSMView.

За целта в изпълнена справка/скрипт е наличен нов бутон „Експорт на файл с параметри за ExecSMView” - .
Използването му улеснява конфигурирането на изпълнение на изглед чрез инструмента ExecSMView от командния ред, като генерира файл с параметрите и техните стойности на база на текущия изглед.
Бутонът не е визуализиран по подразбиране, намира се в категория „Главни“ в списъка с всички бутони на рибона.

След избор на бутона от съответния изглед потребителят задава единствено къде да се създаде файла и с какво име.
За удобство може да използвате и бързата клавишна комбинация Ctrl+Alt+X.

Експорта може да се използва в следните случаи:

1. Само за параметри, които използват 1 стойност (=, >, <, >=, ⇐, <>).
   
2. Само за параметри, които не добавят условието към стойността.
   
3. Само за параметри, в които няма специални символи.

Създаване на източник на данни

Секция с примери "Как да" се намира тук.