(41) Aeroo 模板设计基础教程

1.     理论基础

注：我采用libreoffice5.2设计讲解

1.1.     定义模板指令

模板指令的语法和Genshi 模板语言相兼容，可以用Libreoffice( Write, Calc)来设计

1.1.1.      文本占位字段

我们可以在odt 文件中，通过“插入”->“字段”->“更多字段”->“功能”

类型选择“占位符”，格式选择“文字”，占位符写点位字符串，引用写指令，

最后点“插入”，这时在光标处就完成文本点位字段的定义

1.1.2.      超链接

通过“插入”->“超链接”

在URL 写上模板指令 要以“python://” 开头

文本，写上显示的文字

1.1.3.      输入字段

这个是我们用的最多，通过“插入”->“字段”->“更多字段”->“功能”

类型选择“输入字段”，然后在参照写上模板指令，点“插入”，再写上标识的名称

完成输入字段的定义

1.1.4.      框架

我们有时要在文档中放入图片，比如产品图，这时就要用到框

通过“插入”->框架->框架， 然后选择“选择”标签，在“名称” 框那里输入模板指令

必须以 image: 开头 如： image: asimage(user.company_id.logo)

1.2.     取回数据

前面一节讲了如何在模板中定义容器，这时就要把真实的数据填入其中

当我胶用默认的解析器，创建任何一个模型的报表时，有些预定义的变量

l  objects :当创建报表时，它是对象的一个列表，当你想得到你所选的所有数据，你就要对这个变量做循环处理

l  o: 如查你只选择了一个对象，你就可以直接用这个变量，没必要创建循环

l  data: 来自向导的数据

l  user: 请求生成报表时的用户

l  time: 基于python库操作时间

以合作伙伴对象为例来说明

你想得到你选择第一个客户的名称

<objects[0].name>

你可以得到 erp系统中”设置”->“技术”->”数据结构”->模型  里面所有模型的数据

得到当前用户公司的币种

<user.company_id.currency_id.code>

这个获取方法和系统代码获取数据一样的方式，通过面向对象的“.”

1.3.     条件部分

在现实生活也有很多的判断，这个报表也有。

通过<if> </if> 一对一对出现

如：

<if test="objects[0].customer">

This text is being printed when partner is a customer.

</if>

如果合作伙伴是客户，就打印中间那段话

因为要成对出现，可以看出，至少要定义两个独立的容器

当多重判断时，我们用choose 来定义

<choose>

<when test="objects[0].customer">

This text is being printed when partner is a customer.

</when>

<when test="objects[0].supplier">

This text is being printed when partner is a supplier.

</when>

<otherwise>

This text is being printed in all the other occasions.

</otherwise>

</choose>

如果是客户，就打印客户那段话，若是供应商，就打印供应商那段话，那两个都不是，就打印 otherwise 中间那段话

1.4.     循环部分

这个在系统中还是用的很，当你选择了多个对象时。或你在一个订单里面加入多个产品时，

这些数据要呈现出来都要用到循环。

通过成对的<for> </for>来实现

 <for each="one_partner in objects">

<if test="one_partner.customer">

<one_partner.name>

</if>

</for>

上面用了for来循环，同时中间还有一个条件语句

上面功能是把你所选的合作伙伴，只会是客户类型的，才会打印出来

one_partner 这个面对不同的对象，自己可以取一个对应的名字，用来在内部循环用

1.5.     附加方法

为了方便操作，定义一系列的方法

1.5.1.      语言相关的方法

l  getLang:  为模板设定默认语言

l  gettext:  为给定的文件获得译文

l  _: 功能和gettext一样

l  getLang: 得到当前影响 模板的语言

l  currency_to_text: 转换货币浮点格式

1.5.2.      数学相关的方法

l  sum_field:得到列表中对象的命名字段的和

l  sumif: 得到所选择的列表中对象指定条件的命名字段的和

1.5.3.      统计方法

l  average: 得到所有列表对象字段的平均数

l  count:得到列表中对象的总数

l  count_blank: 得到字段命名为空的列表中对象的数目

l  countif: 得到指定条件的列表中对象的数目

l  larger:得到列表对象最大值 k-th

l  max_field: 得到列表对象最大值

l  min_field: 得到列表对象最小值

l  small: 得到列表对象最小值 k-th

1.5.4.      时间相关方法

l  dec_to_time: 把时间转换为 hh:min 格式

l  time: 得到操作时间

1.5.5.      条形码相关方法

l  barcode: 转换数字为条形码

1.5.6.      帮助方法

l  asarray: 得到所有对象的命名字段为一个列表

l  asimages: 转换二进制数据为图片

l  bool_as_icon: 翻译布尔值 为 文本

l  browse: 得到对象列表

l  chunks: 把对象列表拆分成组

l  debugit: 帮助调试模板

l  erp2_gw: 插入EPL v2’gw’ 命令

l  field_accuracy: 得到对象字段的精度

l  field_size: 得到对象字段的最大范围

l  get_attachments:得到对象的附件

l  get_label:得到字段名称的译文

l  get_name: 得到对象的表术文

l  get_selection_item: 得到下接人工设定的字符

l  html_embed_image：得到html文档中插入的图片

l  html_escape: 过滤html文档中不安全的字符

l  html_builduri: 从字典中组合成uri字符串

l  html_prettyuri: 转换成安全的uri字符串

l  insert-subreport: 插入字报表

l  itemize:

l  safe:得到安全的表达式

l  search:在对象列表中做搜索

l  search_ids:  只在列表对象的id中做搜索