帮你打开活字格更神奇的功能：四十七，定时发送邮件提醒

收藏

本帖最后由 Tracy.Liu 于 2019-1-30 15:20 编辑

在我们日常的工作中，经常需要在某个固定的时间发送邮件提醒。如果通过人工手动发送，不仅繁琐，而且经常就忘记了。

比如，有个订单管理系统，每一条记录都有起始日期，期限天数和当前状态等信息。我们希望在订单快要过期前给未完成订单的负责人发送一封邮件提醒。这样的场景在工作中经常会碰到的。

话不多说，我们就拿上面的这个例子一步一步详细讲解一下。

1.配置邮箱服务器
我们要发邮件，那第一步当然就是配置邮箱服务器啦~我们已经有配置邮箱服务器的帖子，这里就不赘述啦~
还不会配置的盆友们，请看这里→https://gcdn.grapecity.com.cn/fo ... hlight=%C5%E4%D6%C3

2.创建定时发送邮件API
1）打开Visual Studio，在VS中创建类库项目。设置项目的Framework框架为.NET Framework 4.6。
image.png469560851.png

2）右键"引用"--"添加引用"，在活字格的安装目录下找到“GrapeCity.Forguncy.ServerApi.dll”和“Microsoft.Owin.dll”文件，如果之前在其他类库中引用过，那么在"最近"中会有显示，如果从未引用过，那么就点击下方的“浏览”，在活字格安装目录下找。
image.png212906493.png

这里注意一下

如果安装活字格服务端时，安装目录为默认目录，则此文件的路径为：

Windows系统为32位操作系统：C:\Program Files\ForguncyServer\Website\bin
Windows系统为64位操作系统：C:\Program Files (x86)\ForguncyServer\Website\bin

如果安装活字格服务端时，安装目录为自定义路径，则此文件的路径为“自定义路径\ForguncyServer\Website\bin”。

如果引用成功，在"引用"下就可以看到啦。
image.png311942748.png

3）给自己的API起个名儿，然后使其从GrapeCity.Forguncy.ServerApi命名空间的ForguncyApi类继承。
image.png558264464.png

4）我们现在要实现定时发送，那我们使用的就是 [ScheduleApi] 啦~ 可是要怎么定义时间间隔呢？看下表

[ScheduleApi("0:0:10")]	从网站启动时刻开始，每隔10秒执行一次
[ScheduleApi("17:00:00", "1")]	从网站启动时刻开始，每天下午5点执行一次
[ScheduleApi("0:0:0", "7")]	从网站启动时刻开始，每隔7天在夜里0点执行一次

   如果希望每个月的1号进行，可不是写成[ScheduleApi("0:0:0", "30")]哈，毕竟每个月的天数是不一样的。处理的方法是写成[ScheduleApi("0:0:0", "1")]，然后每次执行时先判定DateTime.Now.Day是不是等于1，即判定是不是月初1号就行啦~

回到正题，在这个例子中，我们是设定的每天17点发送邮件。

5）以上我们已经把定时的部分写好了，接写来就是功能的主体部分。本例中我们发邮件的条件是剩余天数不足10天且当前状态不是"已完成"，则给负责人发一封提醒邮件。
      这里我就不详细说每行代码是做什么用的啦，因为您直接在demo中的代码基础上做修改就ok了，接下来只说明您需要修改的地方~

      a.红框中的部分是您要从表中获取哪些字段，这段字符串您可以在设计器中通过odata公式生成，然后粘贴过来。
          image.png268557738.png