Инструменты пользователя

Инструменты сайта


axapta:компонентыввики

Различия

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

Ссылка на это сравнение

axapta:компонентыввики [2018/04/13 22:43] (текущий)
Строка 1: Строка 1:
 +Здесь описаны правила оформления объектов [[AOT | ]] в Базе Знаний
 +
 +===Предварительные условия===
 +  *вы должны знать о wiki в рамках введения [[:​ДляНовыхПользователей]]
 +  *необходимо знать, что такое [[WackoWiki:​WackoДокументация/​Кластеры]] и как с ними работать
 +  *необходимо хотя бы поверхностное знание [[AOT | ]]
 +  *желательно знать про [[:​ИспользованиеМаркеров]]
 +
 +===Наименование,​ адресация===
 +Компоненты именуются как в АОТ, и помещаются в кластер,​ по названию совпадающий с названием типа объекта. Например:​
 +  *[[Класс/​Оbject | ]]
 +  *Форма/​SysSetupForm
 +  *Таблица/​InventDimParm
 +  *Edt/ItemId
 +  *Тип/​AnyType
 +
 +//Так сделано во-первых,​ для того чтобы различать одноименные компоненты разных типов, во-вторых чтобы не делать слишком вложенных кластеров и не затруднять этим адресацию. Русские названия -- исходя из естественности упоминания в русском тексте:​ "​Таблица\InventJournalTrans также отвечает за..."​ "​Форма\InventJournalTable содержит пример использования того-то"//​
 +
 +Методы классов -- это страницы в кластере класса. Например:​
 +  *Класс/​Object/​ToString
 +
 +===Представление наследования===
 +
 +Для того, чтобы представить наследование класса X от класса Y надо добавить на страницу класса X [[:​маркер]] "​~/​Axapta/​Extends/​X"​ -- тогда перечень наследников появится в классе X автоматически. ​
 +
 +Класс/​Object содержит пример того, как этого добиться.
 +
 +====кластеры [[ИерархияХХХ]]====
 +
 +кластеры содержат описания иерархий наследования для компонентов ​
 +
 +предполагается,​ что компоненты должны включать соответствующие страницы иерархии,​ например Класс/​Object должна включать [[ИерархияКлассов]]/​Object ​
 +
 +**вопрос** как должна осуществляться навигация по иерархии?​
 +----
 +
 +//что имеешь в виду? [[:​MazzyMazzy]] /17.01.2005 22:20///
 +----
 +
 +//​каким образом тыкая по классу во включенной странице иерархии произойдет переход на, например,​ родительсий класс?//​ -- [[:​MaxBelugin]]
 +----
 +
 +//хм... родительский класс ведь всегда один. См. /​Axapta/​[[ИерархияТипов]]/​recId Или я не понимаю чего? [[:​MazzyMazzy]] /18.01.2005 15:33///
 +----
 +
 +//как из [[ИерархияТипов]]/​recId ​ перейти на EDT/recID? на EDT/​RefRecID (а не на [[ИерархияТипов]]/​RefRecID)?​ // -- [[:​MaxBelugin]]
 +----
 +а... теперь понял. в EDT/recID будет include из иерархии. Вообще говоря,​ я хотел упорядочить и стандартизировать список разделов для каждого объекта. Так для каждого объекта должно быть:
 +  *Раздел 1: Общая информация
 +    *название объекта
 +    *название пользовательское на русском языке
 +    *модуль,​ к которому принадлежит объект (лицензионный ключ)
 +    *конфигурационный ключ
 +  *Раздел 2: Для пользователя
 +    *описание из пользовательского хелпа
 +    *дополнительные сведения и ссылки на статьи по темам
 +    *ссылки на альтернативные переводы
 +    *...
 +  *Раздел 3: Для администратора
 +    *...
 +  *Раздел 4: Для программиста
 +    *иерархия
 +    *информация о родителе
 +    *информация о семестве
 +    *описание из хелпа разработчика
 +    *описание из системного хелпа
 +    *дополнительные сведения
 +    *дополнительные ссылки
 +    *...
 +  *Раздел 5: Перекрестные ссылки
 +    *текст из add-ins\Анализатор кода
 +
 +Что-нибудь в этом духе.
 +[[:​MazzyMazzy]] /18.01.2005 17:08/
 +----
 +//"​а... теперь понял. в EDT/recID будет include из иерархии."​ -- это обратная задача:​ как из EDT/... перейти в [[ИерархияТипов]]/​... а я спрашивал про наоборот. Вообще,​ можешь сделать пример?//​ -- [[:​MaxBelugin]]
 +
 +----
 +вот /​Axapta/​Класс/​FormRun
 +обратного перехода предусматривать не стоит, на мой взгляд. //​почему?​ разве это не будетудобнее?//​ -- //​MaxBelugin
 +обрати внимание на параметр nomark="​2"​ в инклюде. Попробуй зайти на эту страницу под собой и под гостем.
 +----
 +я пробовал. попробуй и ты.
 +добавь в иерархию переход на описание класса.
 +вставь иерархию в описание.
 +посмотри описание с иерархией с обратным переходом. особенно под гостем.
 +вот /​Axapta/​Класс/​FormRun
 +
 +кстати,​ только сейчас заметил,​ что я неправильно права расставил в иерархии.
 +там доступ на редактирование всем дан... надо будет исправить...
 +
 +а!!! ты хочешь из иерархии ссылки сделать на описания,​ а не в иерархию!
 +так? Тогда ты прав, так действительно будет лучше....
 +я то думал про дополнительный маркер...
 +[[:​MazzyMazzy]] /19.01.2005 18:41/
 +----
 +//Не стоит ли подубами о том чтоб сделать иерархию отдельно от wiki? -- не будет перегружаться вики, а вики-возможности не нужны...//​ -- [[:​MaxBelugin]]
 +
 +----
 +а как это сделать?​
 +----
 +[[:​MaxBelugin]]:​
 +
 +я вижу два варианта:​
 +  * статический HTML  - сгенерировать все страницы статически и выгрузить их
 +  * отдельное PHP приложение:​ запихать наследование в БД и оттуда генерить странички
 +в обоих случаях вместо включения делать ссылку на иерархию:​ например,​ у нас есть Класс/​Object. В нем мы делаем ссылку:​
 +<​code>​
 +[[http://​erpkb.com/​AxHierarchy/​Class/​Object.html Иерархия]]
 +</​code>​
 +в http://​erpkb.com/​AxHierarchy/​Class/​Object.html содаржатся ссылки обратно на wiki
 +можно сделать wiki-action для автоматизации ссылок на иерархию по образу и подобию j.php
 +----
 +тогда зачем нам вики? [[:​MazzyMazzy]] /20.01.2005 14:06/
 +----
 +Есть два вида информации - та, которую имеет смысол менять,​ и та, которую менять смысла нет. Иерархия относится ко второму типу. К первому типу относится описательная информация о классе,​ его предназначение,​ особенности и т.д. Т.к. иерархию нет смысла менять,​ к тому же она будет мешаться в поиске,​ я предлагаю вынести ее в статический HTML. Например так:
 +  *Страница ~Класс/​[[ИмяКласса]] содержит ссылку "​Иерархия"​
 +  *При нажатии на нее открывается новое окно в котором представлено дерево наследования,​ при нажатии на ссылку в дереве наследования открывается окно с нажатым классом
 +
 +Таким образом пользователи смогут менять описание классов и не смогут менять иерархию - да им это и не нужно.
  
axapta/компонентыввики.txt · Последние изменения: 2018/04/13 22:43 (внешнее изменение)