如何使用邮件服务模块

更新时间: 2023-05-10 18:12:18

简介

魔笔平台提供邮件服务模块,支持在电子邮件服务器上发送,本文介绍如何使用邮件服务模块。

适用场景

在搭建应用时,如需在自己的电子邮件服务器上发送邮件,可直接引用魔笔平台物料市场提供的邮件服务模块。可通过引用邮件服务模块的自定义逻辑流操作邮件发送,填充发送方信息和收件方信息,完成邮件的发送。

模块介绍

邮件服务模块包含两个模型,数据模型和页面模型。

  • 数据模型:用于储存邮件发送方信息。

  • 页面模型:用于访问页面并进行连接的初始化配置。

数据模型

数据模型的发送方邮件配置用于储存邮件发送方信息,具体介绍如下:

image.png
  • 配置名称:唯一约束。

  • 邮箱:必填,为发件人邮箱账号,例如:a***@aliyun.com。

  • 密钥:必填,对于需要手动开启smtp协议的邮箱,为16位密钥密码,例如:qq邮箱,163邮箱无需手动开启的,即为邮箱密码。

  • 邮箱Host:必填,例如:qq邮箱为:smtp.qq.com 阿里云邮箱为:smtp.aliyun.com。

  • 发送协议:必填,例如:smtp协议。

  • 发送端口:必填,例如:SSL协议端口为456。

页面模型

页面模型包含两个页面:发送方邮件配置-列表页和发送方邮件配置-编辑页。

  • 发送方邮件配置-列表页:用于展示、删除发送方邮件配置信息的列表页。

  • 发送方邮件配置-编辑页:用于新增、编辑发送方邮件配置的编辑页。

说明

页面模型通常情况下只有该应用的管理员可以访问此页面,并进行连接的初始化配置,开发者可根据需要为该页面添加权限控制,详情请参见权限管理

  • 发送方邮件配置-列表页。

    lQLPJxopXgaQct7NA2LNB4CwycnLWY_ZrVEEHgZEmYAuAA_1920_866
  • 发送方邮件配置-编辑页。

    image

操作步骤

本文操作步骤以与阿里云邮件服务建立连接为例。

前提条件

与外部系统的邮件服务建立连接,需要提前获取如下信息,以便对对连接进行初始化配置:

邮箱账号、密钥、邮箱Host地址、发送协议、发送端口号,更多配置参数及解释请参见:模块介绍

步骤一、引入邮件服务模块

  1. 物料市场收藏邮件服务模块,具体操作请参见收藏应用模板和模块

  2. 登录魔笔

  3. 在顶部菜单栏选择应用管理,在右上角搜索框中输入目标应用,例如TEST

  4. 在指定的应用卡片中单击进入设计器,进入应用开发页面。

  5. 在左侧功能区单击image > 添加引用模块 > 物料市场,在邮件服务模块操作列,单击引用

    image

步骤二、对发送方邮件进行初始化配置

对发送方邮件进行初始化配置的方式推荐两种:一种是使用邮件服务模块的页面模型,搭建一个后端管理应用,进行初始化配置。一种是通过管理后台,进行初始化配置。

以获取阿里云邮件服务的相关信息为例,如邮箱、密钥、邮箱Host等信息,详细信息请参见:模块介绍

image
  • 使用邮件服务模块的页面模型,搭建一个后端管理应用,进行初始化配置。

    1. 发送方邮件配置-列表页配置路由,并根据需要为该页面添加权限控制,具体请参见权限管理

      说明

      通常只有该应用的管理员可以访问此页面进行连接的初始化设置。

      1. 在左侧功能区单击image > 页面路由 > 添加页面路由

        lQLPJyDqUPe7TR7NA2LNB4CwpFVCrsnZXmUEHgZVBEB1AA_1920_866
      2. 页面选择邮件服务模块发送方邮件配置-列表页,并配置URL路径。

        image
    2. 完成后,页面右上角单击发布。启动应用,可以直接通过URL访问该页面,以便对邮件服务模块进行初始化设置。URL形如: https://cluster-3.mobiapp.cloud/应用id/link/config/email。

      image
      1. 在发送方邮件配置-列表页单击添加发送方邮件配置进入编辑页。

        image
      2. 在发送方邮件配置-编辑页进行初始化配置。

        image
  • 通过管理后台,进行初始化配置。

    1. 应用发布后,可通过用户名、密码,登录数据管理后台。

      image
    2. 在应用管理后台页面,单击添加数据,对发送方邮件进行初始化配置。

      image

步骤三、使用自定义逻辑流操作

  1. 新建逻辑流,使用邮件服务模块中的自定义逻辑流操作来发送邮件。

    1. 侧功能区单击image> 后端逻辑流 > 添加逻辑流,填入逻辑流名称邮件发送示例。

      image..png
    2. 逻辑流拖入邮件发送逻辑流操作,设置基本入参。

      image..png
    3. 按照业务需求调用该逻辑流即可。

阿里云首页 多端低代码开发平台魔笔 相关技术圈