odoo9-addon-cms-form 9.0.1.0.0

创建/编辑表单

只需继承自cms.form，为您的模型添加表单。以下是一个针对合作伙伴的快速示例

class PartnerForm(models.AbstractModel):

    _name = 'cms.form.res.partner'
    _inherit = 'cms.form'
    _form_model = 'res.partner'
    _form_model_fields = ('name', 'country_id')
    _form_required_fields = ('name', 'country_id')

在这种情况下，您将拥有以下特征的表单

• 与res.partner模型一起工作

• 只有name和country_id字段

• 两个字段都是必需的（没有这些值之一就无法提交表单）

这就是结果

表单将在以下路由上自动可用

• /cms/form/create/res.partner 用于创建新合作伙伴

• /cms/form/edit/res.partner/1 编辑现有合作伙伴（本例中合作伙伴ID为1）

注意：如果表单的名称为 cms.form. + 模型名称，如 cms.form.res.partner，则默认通用路由将正常工作。如果您愿意，可以轻松定义自己的控制器，并给表单一个不同的名称，并拥有更优雅的路由，如 `/partner/edit/partner-slug-1`。请参阅 cms_form_example。

默认情况下，表单以水平Twitter Bootstrap表单的形式渲染，但当然您可以提供自己的模板。默认情况下，字段按模型架构中的顺序排序。您可以使用 _form_fields_order 进行调整。

具有额外控制字段的表单

想象一下，您想在合作伙伴创建后通知合作伙伴，但仅当您真的需要时。

上述表单可以扩展，添加不是 _form_model 架构部分的额外字段

class PartnerForm(models.AbstractModel):

    _name = 'cms.form.res.partner'
    _inherit = 'cms.form'
    _form_model = 'res.partner'
    _form_model_fields = ('name', 'country_id', 'email')
    _form_required_fields = ('name', 'country_id', 'email')

    notify_partner = fields.Boolean()

    def form_after_create_or_update(self, values, extra_values):
        if extra_values.get('notify_partner'):
            # do what you want here...

notify_partner 将包含在表单中，但在创建和写入时会将其丢弃。尽管如此，您可以使用钩子 form_after_create_or_update 在记录创建或更新前后将其用作控制标志，就像在这个示例中看到的那样。

搜索表单

只需从 cms.form.search 继承即可为您自己的模型添加表单。以下是对合作伙伴的快速示例

class PartnerSearchForm(models.AbstractModel):
    """Partner model search form."""

    _name = 'cms.form.search.res.partner'
    _inherit = 'cms.form.search'
    _form_model = 'res.partner'
    _form_model_fields = ('name', 'country_id', )
    _form_fields_order = ('country_id', 'name', )

表单将在以下位置自动可用：/cms/form/search/res.partner。

注意：如果表单的名称为 `cms.form.search + 模型名称，如 cms.form.search.res.partner，则默认通用路由将正常工作。如果您愿意，可以轻松定义自己的控制器，并给表单一个不同的名称，并拥有更优雅的路由，如 /partners。请参阅 cms_form_example。

主/从字段

现在的典型用例：您想根据其他字段的值显示/隐藏字段。对于最简单的情况，您不需要写一行JS。您可以这样做

class PartnerForm(models.AbstractModel):

    _name = 'cms.form.res.partner'
    _inherit = 'cms.form'
    _form_model = 'res.partner'
    _form_model_fields = ('name', 'type', 'foo')

    def _form_master_slave_info(self):
        info = self._super._form_master_slave_info()
        info.update({
            # master field
            'type':{
                # actions
                'hide': {
                    # slave field: action values
                    'foo': ('contact', ),
                },
                'show': {
                    'foo': ('address', 'invoice', ),
                }
            },
        })
        return info

在这里，我们声明了

• 当 type 字段等于 contact 时 -> 隐藏 foo 字段

• 当 type 字段等于 address 或 invoice 时 -> 显示 foo 字段

赞助商

• Fluxdock.io.

贡献者

• Simone Orsi <simone.orsi@camptocamp.com>

维护者

本模块由OCA维护。

OCA，或Odoo社区协会，是一个非营利组织，其使命是支持Odoo功能的协作开发并推广其广泛使用。

为贡献此模块，请访问 https://odoo-community.org。