(04)odoo视图操作

Posted 2020-06-13

* 窗口操作
   如下一些代码
   <?xml version="1.0" encoding="utf-8" ?>
    <openerp>
       <data>
         <act_window id="action_todo_stage"
                     name="To-Do Task Stages"
                     res_model="todo.task.stage"
                     view_mode="tree,form" />

         <act_window id="todo_app.action_todo_task"
                     name="To-Do Task "
                     res_model="todo.task"
                     view_mode="tree,form,calendar,gantt,graph"
                     target="current"
                     context="{‘default_user_id‘:uid}"
                     domain="[]"
                     limit="80" />
         <act_window id="action_todo_task_stage"
                     name="To-Do Task Stages"
                     res_model="todo.task.stage"
                     src_model="todo.task"
                     multi="False" />
       </data>

    </openerp>
   
    可以用ir.action.act_window 重新其中一菜单对角
    <record id="action_todo_stage" model="ir.actions.act_window">
        <field name="name">To-Do Task Stage</field>
        <field name="res_model">todo.task.stage</field>
        <field name="view_mode">tree,form</field>
    </record>
   
    窗口的动作是存在 ir.actions.act_window 模型中的，我们可以在xml文件中用<act_window>来快捷定义
    # name 显示的标题
    # res_model 动作响应的目标模型
    # view_mode 列出动作响应对应可用的视图类型
    # target 如果设置为new 就打开新窗口，默认是 current
    # context 设置目标视图的上下文
    # domain 过滤记录按条件
    # limit 指列表视图时，一页的记录数，默认是80
   
    # src_model 指定可以启动视图的更多按钮
    # multi 设为True, 更多按钮显示在列表视图，否则显示在表单视图
   
* 菜单项   
    如下一些代码
   
         <menuitem id="menu_todo_task_main"
                     name="To-Do" parent="mail.mail_my_stuff"/>
         <menuitem id="todo_app.menu_todo_task"
                     name="To-Do Tasks"
                     parent="menu_todo_task_main"
                     sequence="10"
                     action="todo_app.action_todo_task"/>
         <menuitem id="menu_todo_task_stage"
                     name="To-Do Stages"
                     parent="menu_todo_task_main"
                     sequence="20"
                     action="action_todo_stage"/>

    在 设置-> 技术-> 用户界面-> 菜单  可以看到已定义的菜单
    菜单是存在 ir.ui.menu 模型中的，我们可以在xml文件中用<menuitem>来快捷定义
    # name 在视图中显示的名字
    # sequence 显示排序
    # parent 本菜单的父菜单，子菜单都要指定，只有顶级菜单不要指定
    # action 本菜单的连接动作
   
   
* 上下文(Context)
   # 上下文 是一个字典类型的数据，用于客户端和服务端的处理，
            可用于视图间信息传递，
      例子：{‘lang‘: ‘en_US‘, ‘tz‘: ‘Europe/Brussels‘, ‘uid‘: 1}
       {‘default_user_id‘: uid} 用当前用户作为默认用户
       {‘search_default_filter_my_tasks‘: True}
      
* Domain 表达式
        
    # 用于过滤记录数，相当于sql的where
       (‘field‘, ‘operator‘,value) 每个条件表达式是元组类型
     domain=[(‘user_id‘, ‘=‘, uid)] 当前用户做为条件过滤
    #操作符如下：
      <,>,<=,>=,!=
      =like
      like, ilike(大小写不敏感)
      child_of  找直接和间接的子对象
      in, not in       
    #条件可以用逻辑符连起来  用列表类型来组织
      & 是且的意思，是默认
      ｜是或
       ! 是非，相反的意思   
       [‘!‘,(‘user_id‘,‘=‘,uid)]  不是当前用户的记录
       [‘|‘,(‘user_id‘,‘=‘,uid),(‘user_id‘,‘=‘,False)] 不是当前用户，或没有用户的记录
       复杂一点的：
       [‘|‘, (‘message_follower_ids‘, ‘in‘, [user.partner_id.id]),‘|‘, (‘user_id‘, ‘=‘, user.id),
             (‘user_id‘, ‘=‘, False)]
       逻辑是连后面两个domain条件
      
      
* 三个主要的视图  list或 tree视图， 表单form视图， search搜索视图    对应模型 ir.ui.view  
* 表单视图
    # 添加在动作和菜单项后面 <act_window> <menuitem>
    代码如下：
           <record id="view_form_todo_task_ui" model="ir.ui.view">
               <field name="name">view_form_todo_task_ui</field>
               <field name="model">todo.task</field>
               <field name="arch" type="xml">
                   <form>
                       <header> <!-- Buttons and status widget --> </header>
                       <sheet> <!-- Form content --> </sheet>
                       <!-- History and communication: -->
                       <div class="oe_chatter">
                           <field name="message_follower_ids"
                                  widget="mail_followers"/>
                           <field name="message_ids"
                                  widget="mail_thread"/>
                       </div>
                   </form>
               </field>
           </record>
    #包含三个可视域：
       <header> 
       <sheet> 放内容的
       <bottom> 历史记录和社交部分
    # header 状态栏
        <header>
           <field name="stage_state" invisible="True"/>
           <button name="do_toggle_done" type="object"
                        attrs="{‘invisible‘:
                                [(‘stage_state‘,‘in‘,[‘done‘,‘cancel‘])]}"
                                   string="Toggle Done" class="oe_highlight"/>
                           <!-- Add stage statusbar: ... -->
        </header>   
        @ class="oe_highlight" 加高亮
        @ invisible 为可见性，还可以用到其它元素上，不仅在<botton>上
       
       
* 视图元素
    #按钮<button>，支持的属性
     icon  可用的icon在 addons/web/static/src/img/icons
     string 按钮的显示文字
     type  值可以是 workflow, object action
     name  就是要触发的方法标识
     args  传递方法的参数
     content 上下文
     confirm  针对对话框的确认
     special="cancel" 用于向导
    
     #字段<field>，支付的属性
      name 字段技术名
      string 显示名
      help 帮助提示
      placeholder 占位文字
      widget 小物件
      options 小物件对应的选项
      class 加载类名
      invisible="1" 标识不可见
      nolabel="1" 不显示标签，会用于<group>之内
      readonly="1" 标识只读
      required="1" 标识不能为空
     
      sum,avg 小计，平均值
      password="True" 密码框
      filename 文件上传用
      mode="tree"  One2many字段

     #关联字段
      options={‘no_open‘:True,‘no_create‘:True}    
      常用于 context 和 domain中
     
     # 小物件
       用于文本字段
        email  url  html
       用于数字字段
        float_time   monetary   progressbar
       用于关联和选择
         many2many_tags
         selection
         radio
         kanban_state_selection
         priority

* 事件变化
   @api.onchange(‘field1‘,‘field2‘)

* 动态视图
    # group
    # states
    增加灵活性 用 refers_to
    <field name="refers_to"
          attrs="{‘invisible‘: [(‘state‘,‘=‘,‘draft‘)]}" />
         
* 列表视图
   <record id="todo_app.view_tree_todo_task" model="ir.ui.view">
       <field name="name">To-do Task Tree</field>
       <field name="model">todo.task</field>
       <field name="arch" type="xml">
           <tree editable="bottom"
                 colors="gray:is_done==True"
                 fonts="italic: state!=‘open‘" delete="false">
               <field name="name"/>
               <field name="user_id"/>
           </tree>
       </field>
   </record>
  
   # <tree>
     editable 设置字段在列表直接可以编辑
     colors 按条件设定记录的颜色
     fonts  按条件设定记录的字体
     create,delete,edit  若设置为false 则为不可用
    
* 搜索视图
   代码如下：
      <record id="todo_app.view_filter_todo_task"
           model="ir.ui.view">
       <field name="name">To-do Task Filter</field>
       <field name="model">todo.task</field>
       <field name="arch" type="xml">
           <search>
               <field name="name" domain_filter="[‘|‘,
                  (‘name‘,‘ilike‘,self),(‘user_id‘,‘ilike‘,self)]"/>
               <field name="user_id"/>
               <filter name="filter_not_done" string="Not Done"
                       domain="[(‘is_done‘,‘=‘,False)]"/>
               <filter name="filter_done" string="Done"
                       domain="[(‘is_done‘,‘!=‘,False)]"/>
               <separator/>
               <filter name="group_user" string="By User"
                       context="{‘group_by‘: ‘user_id‘}"/>
           </search>
       </field>
   </record>
  
   # <search>
      上面显示，只有name 和 user_id 搜索
      field元素定义的属性
       name 字段标识名
       string 标签名
       operator 操作符
       domain_filter  过滤记录按条件
       groups 用于分组
      filter元素支持属性
        name 指定动作标识符
        string 标签名
        domain 过滤记录按条件
        content 上下文
        groups  分组列出

* 日历视图
   <record id="view_calendar_todo_task" model="ir.ui.view">
       <field name="name">view_calendar_todo_task</field>
       <field name="model">todo.task</field>
       <field name="arch" type="xml">
           <calendar date_start="date_deadline" color="user_id"
                     display="[name], Stage [stage_id]">
               <!-- Fields used for the text of display attribute -->
               <field name="name"/>
               <field name="stage_id"/>
           </calendar>
       </field>
   </record>
   #<calendar>
     date_start  开始日期
     date_end  结束日期
     date_delay  周期
     color  用颜色的实体
     display 显示文字
    
* 甘特视图
   <record id="view_gantt_todo_task" model="ir.ui.view">
       <field name="name">view_gantt_todo_task</field>
       <field name="model">todo.task</field>
       <field name="arch" type="xml">
           <gantt date_start="date_deadline"
                  default_group_by="user_id"/>
       </field>
   </record>    
  
   #<gantt>
     date_start  开始日期
     date_end  结束日期
     date_delay  周期
     progress  进度百分比
     default_group_by 任务分组条件
   
* 图表视图
    <record id="view_graph_todo_task" model="ir.ui.view">
       <field name="name">view_graph_todo_task</field>
       <field name="model">todo.task</field>
       <field name="arch" type="xml">
           <graph type="pivot">
               <field name="stage" type="col"/>
               <field name="user_id"/>
               <field name="date_deadline" interval="week"/>
               <field name="effort_estimate" type="measure"/>
           </graph>
       </field>
   </record>    
    #<graph>
      字段支持的属性<field>
     name 字段标识名
     type 分组方式，默认是row 行 ，设定可以是col列
     interval 时间度量 day,week,month,quarter 或 year
    
    
* Qweb模板语言