用途:在 Salesforce B2C Commerce 中按 SFRA 模式创建带校验的店面表单,如结账、注册等场景。
主要能力:表单由三部分组成——XML 表单定义(字段、校验、动作)、控制器逻辑(服务端处理)、ISML 模板(渲染 HTML)。XML 定义放在 cartridge 的 forms 目录,可按语言分目录(如 default、de_DE)。字段类型包括 string、integer、number、boolean、date;字段属性含 formid、label、type、mandatory、max-length、min-length、regexp 等。校验错误消息属性有 missing-error、parse-error、range-error、value-error。
使用方式:控制器用 server.forms.getForm('profile') 获取表单,form.clear() 重置,res.render 渲染;提交时用 csrfProtection.validateAjaxRequest 校验,检查 form.valid,读取 form.email.value 等值,数据库操作放在 route:BeforeComplete 中,AJAX 返回 JSON。模板用 ISML 渲染,包含 CSRF 隐藏字段,用 Resource.msg 读取资源键实现本地化。
最佳实践:始终使用 CSRF 防护;显示前清空表单;标签与错误用资源键;即使有客户端校验也要服务端校验;数据库操作使用 route:BeforeComplete;AJAX 提交返回 JSON。
限制:资料未提供安装命令、收费、平台版本要求等具体信息。