Здесь описаны правила оформления объектов [[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. В нем мы делаем ссылку: [[http://erpkb.com/AxHierarchy/Class/Object.html Иерархия]] в http://erpkb.com/AxHierarchy/Class/Object.html содаржатся ссылки обратно на wiki можно сделать wiki-action для автоматизации ссылок на иерархию по образу и подобию j.php ---- тогда зачем нам вики? [[:MazzyMazzy]] /20.01.2005 14:06/ ---- Есть два вида информации - та, которую имеет смысол менять, и та, которую менять смысла нет. Иерархия относится ко второму типу. К первому типу относится описательная информация о классе, его предназначение, особенности и т.д. Т.к. иерархию нет смысла менять, к тому же она будет мешаться в поиске, я предлагаю вынести ее в статический HTML. Например так: *Страница ~Класс/[[ИмяКласса]] содержит ссылку "Иерархия" *При нажатии на нее открывается новое окно в котором представлено дерево наследования, при нажатии на ссылку в дереве наследования открывается окно с нажатым классом Таким образом пользователи смогут менять описание классов и не смогут менять иерархию - да им это и не нужно.