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

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


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

Различия

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

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

axapta:компонентыввики [2018/04/13 22:43]
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 (внешнее изменение)