{\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}我需要表态 -nano {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}

这个 neeto-form-nano 允许我们在需要的应用程序中构建表格。 这个 纳米出口 @bigbinary/neeto-form-frontend 国家防范机制一揽子计划 neeto-form-engine 铁路发动机.

见 此页面 要使用此纳米查找主机应用程序 。 纳米的改变应该是 向所有人推广,尤其是移民...

目录

1. 用主机应用程序开发
   • 发动机
   • 前端软件包
     • 安装
     • 发展指示
     • 使用量
2. 出版指令

用主机应用程序开发

发动机

引擎在后端添加窗体设置, 并允许我们在任意 型号。 它还储存提交材料.

安装

1. 将此行添加到您的应用程序的 Gemfile 中 :

   source "NEETO_GEM_SERVER_URL" do
     # ...existing gems
   
     gem 'neeto-form-engine'
   
     # Use this for development:
     # gem 'neeto-form-engine', path: "../neeto-form-nano"
   end
   

2. 然后执行:

   bundle install
   

3. 安装迁移

   bundle exec rails neeto_form_engine:install:migrations
   

4. 运行迁移

   bundle exec rails db:migrate
   

5. 将此行添加到您的应用程序 config/routes.rb 文档.

   mount NeetoFormEngine::Engine, at: "/neeto_form"
   

6. 创建文件 neeto_form_engine.rb 下级 config/initializers 提供 owner_class 资料

   NeetoFormEngine.owner_class = "Organization"
   

7. 配置要在下面添加到提供的所有者类的模型

   has_many :forms, class_name: "::NeetoFormEngine::Form", as: :owner
   

8. 配置在范围提交记录中添加以下关联的模型 (可选)

   has_one :submission, class_name: "::NeetoFormEngine::Submission", as: :record
   

9. 配置将添加到关联后附加窗体的模型( 可选)

   has_one :form, class_name: "::NeetoFormEngine::Form", as: :attachable
   

自定义

NeetoFormEngine::Customizable::Forms::Createable

引擎支持自定义默认行为 Forms::CreateService 将支持的方法置于这一关切之上.

可用方法:

1. create_default_questions!: 如果你想使用自定义逻辑来创建 默认问题,您可以使用这种方法指定它们. owner, (中文(简体) ), form 财务报告和审定财务报表 params 将在全球范围内提供.
2. additional_form_params: 如果您想要包含附加属性, 请在 创建窗体,您可以使用这种方法指定。 这需要一个论据 params 它将是从前端传出的形式参数.

NeetoFormEngine::Customizable::Questions::Createable

引擎支持自定义默认行为 Questions::CreateService 将支持的方法置于这一关切之上.

可用方法:

1. create_question!: 此方法收到一个参数 params 包含 从前端传出的问题参数.
2. additional_question_params:如果想要包含附加属性 在创建问题时,您可以使用这种方法指定问题。 这需要 一个论据 params 该参数将是从 前端,请说.

NeetoFormEngine::Customizable::Questions::Updateable

引擎支持自定义默认行为 Questions::UpdateService 以压倒此中支持的常数 关心.

可用常数 :

1. EXCLUDED_UPDATE_PARAMS:如果您包括了除 kind 用于非有效实体属性的额外用途,它们 需要指定为 EXCLUDED_UPDATE_PARAMS。 。 。 .

NeetoFormEngine::Customizable::QuestionResponses::Createable

引擎支持自定义默认行为 QuestionResponses::CreateService 将支持的方法放在首位 关心.

可用方法:

1. additional_initialization_logic: 如果您想要初始化额外内容 变量,您可以使用这种方法指定它们.
2. additional_process_actions: 如果您想要执行任何附加动作 在交易块外,您可以覆盖此方法.
3. additional_create_submission_actions: 您可以使用这种方法指定 创建提交文件后需要执行的任何附加逻辑.
4. additional_create_response_actions: 如果您想要执行一些附加 对于每个响应,您可以使用这种方法指定它们. 此方法收到 question 财务报告和审定财务报表 response_param 从 前端作为参数.

设置谷歌 reCAPTCHA

1. 注册一个 API 密钥对 官方网站 (简体中文)。 。 。 .

2. 配置以下内容 environment variables 财务报告和审定财务报表 secrets 带合适的 数值

   • 下 .env 文件 :

     FORM_NANO_RECAPTCHA_V2_SITE_KEY=# Value from Google cloud console
     FORM_NANO_RECAPTCHA_V2_SECRET_KEY=# Value from Google cloud console
     

   • 下 secrets.yml 文件 :

     form_nano:
       recaptcha_v2:
         site_key: <%= ENV["FORM_NANO_RECAPTCHA_V2_SITE_KEY"] %>
         secret_key: <%= ENV["FORM_NANO_RECAPTCHA_V2_SECRET_KEY"] %>
     

3. 将站点密钥包含在 global_props

   module ApplicationHelper
     def get_client_props
       # other variables
       custom_props = {
         # other props
         form_nano_recaptcha_v2_site_key: Rails.application.vault.form_nano.dig(:recaptcha_v2, :site_key)
       }
     end
   end
   

前端软件包

前端软件包允许我们创建 横跨neto产品的形式.

安装

1. 安装国家预防机制软件包

   yarn add @bigbinary/neeto-form-frontend
   

2. 前端软件包有几种对等依赖关系,这些依赖关系是: 软件包的正常运作。 使用 : 以下命令:

   yarn add @bigbinary/neetoui @bigbinary/neeto-icons ramda@^0.28.0 classnames@^2.3.1 [email protected] @bigbinary/neeto-commons-frontend react-google-recaptcha
   

3. 从以下位置导入样式表 :

   @import "@bigbinary/neeto-form-frontend/dist/main.css";
   

发展指示

检查 前端软件包开发指南 用于开发前端软件包的分步指令.

使用量

您可以在这里了解更多关于用法:

1. 构成部分
2. 钩子
3. 电子邮件验证

出版指令

咨询 构建和释放软件包 关于如何出版的详细指南.