Различия

Здесь показаны различия между двумя версиями данной страницы.

--- документация_в_программе [23.04.2020 05:49]
Анисютин
+++ документация_в_программе [17.07.2022 13:17] (текущий)
@@ Строка 1: / Строка 1: @@
-====== Документация в программе ======
+====== Помощь в программе ======
-Рассматривается стандартный механизм подключения контекстно зависимой справки назначенной на кнопку **Помощь** или к пункту **Документация**.\\
+===== Содержание =====
+  * [[#Общая информация|Общая информация]]
+    * [[#1. Общая помощь по всей системе|1. Общая помощь по всей системе]]
+    * [[#2. Помощь в журналах|2. Помощь в журналах]]
+    * [[#3. Помощь в карточках|3. Помощь в карточках]]
+  * [[#Настройка помощи|Настройка помощи]]
+    * [[#1. Задать персональные ссылки для определенной карточки/журнала|1. Задать персональные ссылки для определенной карточки/журнала]]
+    * [[#2. Закрепить ссылки за определенными мета-объектами|2. Закрепить ссылки за определенными мета-объектами]]
+  * [[#Дополнительная информация|Дополнительная информация]]
-**Задача**\\
+----
-Обеспечить доступ к справочным документам, размещенным на сайтах компании непосредственно из программного модуля.
+====== Общая информация ======
+Помощь в программе разделена на три части: \\
+. Общая помощь по всей системе\\
+. Помощь в журналах\\
+. Помощь в карточках\\
+===== 1. Общая помощь по всей системе =====
+Доступ к общей помощи по всей системе находится в главном меню "//Справка -> Документация//"
+{{:pasted:20220717-120443.png}}
-**На первом этапе** справочная информация привязывается к приложению в целом единым блоком.\\
 В зависимости от прав пользователя открывается одна из двух страниц, которые созданы на на сайте www.agbis.ru/laundry/school/:
-для администраторов открывается "Административная документация", для всех остальных пользователей - "Пользовательская документация".\\
+для администраторов открывается "//**Административная документация**//", для всех остальных пользователей - "//**Пользовательская документация**//".\\
-Для вызова используется пункт **Документация** главного меню на главной форме приложения.\\
-{{:pasted:20191223-131145.png}}\\
-**На втором этапе** планируется сделать контекстно-зависимую помощь.\\
+{{:pasted:20191223-131145.png}}
-Для вызова используется пункт кнопка **Помощь**.\\
-Кнопка **Помощь** появляется автоматически при подключении справочных материалов к форме.\\
-Для примера можно посмотреть справочники "Фирмы" и "Склады\отделы".\\
-{{:pasted:20191223-131227.png}}\\
-С формой можно связать несколько документов, в этом случае слева появится список справочных документов.\\
+===== 2. Помощь в журналах =====
+Кнопка помощь во всех журналах, наследниках от "TUniDblListForm" или "TUniListFrame" и находится в главном меню журнала, отображается если на нее назначена какая-нибудь ссылка.
+Например журнал "//**Фирмы**//"
+{{:pasted:20220717-123002.png}}
+Журнал "Регистрация сотрудников"
+{{:pasted:20220717-123036.png}}
+С журналом может быть связано несколько ссылок на документацию, в этом случае слева появится список ссылок на помощь\\
 {{:pasted:20191223-130731.png}}
-При загрузке данных открывается нижняя панель статуса, не которой отображается сообщение "Идет загрузка данных ...".\\
-Эта панель закрывается после завершения загрузки документа.\\
-{{:wiki:him_lrxymzlbky.png}}\\
-Если при загрузке данных возникает ошибка, то открывается окно с сообщением об ошибке.\\
+===== 3. Помощь в карточках =====
-{{:wiki:pasted:20191231-090530.png}}\\
-Ошибка так же отображается на панели статуса и записывается в лог программы.\\
+Кнопка "//**Помощь**//" находится во всех формах, наследниках от "//**UniForm**//" (если на нее назначена какая-нибудь ссылка)
-{{:wiki:pasted:20191231-090836.png}}\\
+{{:pasted:20220717-124607.png}}
 <ifauth @programmers>
-Список ссылок на документы хранится в объекте T_Help
+====== Настройка помощи ======
-===== Составление списка документов справки непосредственно в описании формы =====
+Класс описывающий работу помощи - "//**T_Help**//"
-В списке модулей должны быть указаны **rHelp**, **fHelp**
+**Настроить отображение помощь можно двумя способами:** \\
+. Задать персональные ссылки для определенной карточки/журнала\\
+. Закрепить ссылки за определенными мета-объектами\\
+===== 1. Задать персональные ссылки для определенной карточки/журнала =====
+В списке модулей должны быть указаны
   uses ... rHelp, fHelp ...
 Для использования T_Help должна быть задана директива компилятора **CHROM**.\\
-Пример функции, которая вызывает справку состоящую из трех документов:\\
+Пример функции, которая вызывает помощь состоящую из трех ссылок:\\
-первый - это явно заданный HTML-текст, второй и третий являются ссылками на страницы WEB-сайта с документацией. \\
+первая - это явно заданный HTML-текст, второй и третий являются ссылками на страницы WEB-сайта с документацией. \\
 При формировании элемента списка в **rlHelp.Add("Заголовок","URL","HTML","Показывать по умолчанию","Уровень доступа")** указываются параметры:\\
 **"Заголовок"**, который будет отображаться в списке документов;\\
@@ Строка 71: / Строка 103: @@
 </sxh>
-На формах наследниках TUniForm, TUniListForm уже есть кнопка **"Помощь"** с которой связан action ActHelp в TActionList.
+На формах наследниках TUniForm, TUniListForm уже есть кнопка **"Помощь"** с которой связан action ActHelp в TActionList.\\
-В этом случае достаточно добавить в обработчик ActHelp вызов справки и выставить свойства ActHelp.Visible и ActHelp.Enable в обработчик активации формы.
+В этом случае достаточно добавить в обработчик ActHelp вызов справки и выставить свойства ActHelp.Visible и ActHelp.Enable в обработчик активации формы.\\
 Можно просто добавить новую кнопку с вызовом справки
@@ Строка 99: / Строка 131: @@
 </sxh>
-===== Составление списка документов справки через код метакласса формы =====
+==== 2. Закрепить ссылки за определенными мета-объектами ====
-Сопоставление форм и WEB-страниц выполняется функцией T_Help.InitByAgbisRu\\
+Сопоставление форм и WEB-страниц выполняется функцией T_Help.InitByAgbisRu. В "//**case ifMetaTag of**//" нужно добавить "**//tag//**" необходимого мета-объекта и добавить ссылку\\
 <sxh Delphi>
 class function T_Help.InitByAgbisRu(rfHelp:T_Help; lfIsAgbis, lfIsAdmin:Boolean;
@@ Строка 135: / Строка 167: @@
 </ifauth>
-==== Дополнительная информация ====
+====== Дополнительная информация ======
 [[FormHelp|Помощь]]

Инструменты

меню и быстрый поиск

быстрый поиск

статус сайта

«хлебные крошки»

Инструменты страницы

мета-данные страницы

Различия