PDF《翻译说明》

翻译说明 非常感谢您选择阅读阿江(info@ajiang.

net)翻译的《w3 JMail 4.3 中文用户 手册》. 阿江的英文并不好,所以翻译是结合着翻译工具和自己的使用体会来写的, 不懂的地方就不翻译,感觉翻译得不是很明确或者可能有错误的地方就提供英文 原文的对照.PGP 加密和邮件合并两功能免费版不支持,所以这些部分的多数内 容我都没有翻译,请大家谅解. 这是翻译后的第一次发布,难免遗漏和错误之处,请大家批评指正. 也希望您可以到我的个人主页(阿江守候 http://www.ajiang.net )去看看. 这里有我写的程序和我翻译的其他资料,比如 JMail 3.7 的手册,要使用 smtpmail 对象发信的朋友可以下载阅读.另外,即将编写的 w3 JMail 系列教程也将在我的 网站上发布. 译者:阿江

2002 年3月21 日,郑州 w3 JMail 4.3 http://tech.dimac.net 在这里! [手册] www.dimac.net websolution s w3 JMail 目录 目录・

2 国际流行的邮件组件

3 w3 JMail 4.3 的新特性

4 安装

5 卸载

5 设置和使用微软 Pickup 文件夹

6 使用 PGP 加密(英文)

7 开始使用

8 使用 Dimac w3 JMail 发送邮件

8 使用 Dimac w3 JMail 收取邮件

9 使用 w3 JMail 实现邮件加密传输(英文)

11 使用 w3 JMail 集群发送个性化邮件(邮件合并) (英文)

12 对象参考

14 JMail.POP3

15 JMail.Messages

17 JMail.Message

18 JMail.Headers

27 JMail.Recipients

28 JMail.Recipient

29 JMail.Attachments

30 JMail.Attachment

31 JMail.MailMerge

32 JMail.PGPKeys(英文)

33 JMail.PGPKeyInfo(英文)

34 JMail.SpeedMailer

35 JMail.PGPDecodeResults(英文)

36 JMail.PGPDecodeResult(英文)

37 JMail.PGPDecodeResultCollection(英文)

38 附录

39 w3 JMail 的注册表项设置

39 软件许可协议和有限授权(英文)

41 阿江(Info@ajiang.net)翻译 阿江守候 http://www.ajiang.net

2 w3 JMail 国际流行的邮件组件 世界上有至少

40 万程序员在使用 Dimac 公司的 w3 JMail 组件. 由于 w3 JMail 基于组件技术,所以它可以被使用到大多数的编程语言中,尽管它往往只是被用 在ASP 中. 我们为我们最后发行的版本可以轻松完成邮件发送、接收、加密和集群传输 等工作而感到自豪.我们相信我们可以将这个邮件组件做得更好.我们常常得到 大家的意见,而且很多都已经在新的版本中解决了,事实上我们加入了我们能加 入的所有功能. 你可以使用 w3 JMail 做些什么呢?我们告诉您:非常多!您第一个想做的事 情是在您的网站上发送一些邮件通知,然后您可以使用我们崭新的 POP3 功能建 立你基于 WEB 的信箱,使用集群发送功能可以使您轻松安全得将新闻消息发送 到您的客户手中而不通过专业的邮件列表服务器.这一切的一切,都是 w3 JMail 带给您的极具震撼力的 WEB 应用. 现在, 请运行安装程序 (您可能已经安装了) , 感受这个国际流行的邮件组件. Dimac

电话: +46

42 160200 Garnisonsgatan

25 A 传真: +46

42 160230 Box

222 28 网站: http://www.dimac.net

250 24 Helsingborg 邮件: info@dimac.net 阿江(Info@ajiang.net)翻译 阿江守候 http://www.ajiang.net

3 w3 JMail w3 JMail 4.3 的新特性 Dimac w3 JMail 4.3 使用了新的内核,使其更加可靠和稳定.比如: 重新设计了内部结构,现在使用 message 对象发送邮件,代替原来的 单一对象(Jmail.smtpmail) ,并且已拥有超过

10 个对象.多数针对 Jmail.message 对象的操作和原来的操作非常类似,w3 JMail 将永远保 持对旧版本的兼容. 注意:w3 JMail 4.0 以上版本仍然支持 Jmail.smtpmail 对象发信,但并 不推荐这么做,有关该对象的用法,请参考 w3 JMail 3.7 的使用手册. 支持从 POP3 服务器收取邮件. 您可以使用 w3 JMail 的集群发送功能发送成千上万的邮件. 并且还能通 过使用 mailmerge(邮件合并)对象使每一封信都足够的个性化. 支持加密邮件传输. 快速邮件发送,一次会话即完成邮件发送. 所以,读下去,学习这个流行的邮件组件. 阿江(Info@ajiang.net)翻译 阿江守候 http://www.ajiang.net

4 w3 JMail 安装 要使用 Dimac'

s w3 JMail,你必须在您的服务器上注册 jamil.dll.这可以通过 以下方法实现: 方法一:使用我们提供的安装程序安装. 方法二:将jmail.dll 复制到您的服务器上并运行 regsvr32 jmail.dll. 在安装 JMail 之前,原有任何版本的 JMail 都必须先卸载掉.要运行安装程 序,您还必须具有服务器的超级管理员的权限. 双击 weJMail4.exe 运行安装程序,安装程序默认将该组件安装到 C:Program FilesDimacw3JMail4, 并同时复制使用手册 (英文版) 和示例文件到这个文件夹. 更多的示例可以到我们的网站 http://tech.dimac.net 上查看.安装程序将注册 jmail.dll 文件为一个组件. 卸载 您可以从您的控制面板中的 添加/删除程序 项目中卸载 JMail,您也可以 直接取消对 jamil.dll 的注册 (使用命令 regsvr32 /U jmail.dll ) , 然后删除这个文件. 阿江(Info@ajiang.net)翻译 阿江守候 http://www.ajiang.net

5 w3 JMail 设置和使用微软 Pickup 文件夹 在使用 Dimac w3 JMail 的集群发送功能时,你可能用到 nq()方法.nq()方法 要使用 IIS 服务器的 SMTP 服务来发送邮件. SMTP 服务使用一个特殊的文件夹来保存即将发送的邮件,这个文件夹被称 为 微软 Pickup 文件夹 (MS Pickup directory) ,它一般位于 C:Inetpubmailroo tPickup,实际位置与 IIS 的安装选项有关.

1、在使用 w3 JMail 之前必须安装微软 SMTP 服务,或者在局域网上存在一 台可以被读取和写入其 Pickup 文件夹的服务器.当然,它们的 SMTP 服务必须能 够正常地通过 Pickup 文件夹发送邮件.

2、 队列功能是 w3 JMail 的附属功能, 该功能要求 w3 JMail 要具备写入 Pickup 文件夹的权限.所以,应该调整用户和文件系统,分配给 IIS 匿名用户(IUSR) 的读写权限.

3、如果你不是使用微软 Windows2000 或者更高版本,你必须为 w3 JMail 指名Pickup 文件夹的位置.你可以在运行时进行该设置,如: Message.MsPickupdirectory = c:inetpubmailrootpickup 如果你使用 mailmerge:对象,则应该这样: MailMerge.BulkMerge(myRS,true, c:inetpubmailrootpickup ) 你也可以从你的 WEB 服务器上进行一次性的设置,具体的设置方法请参考 JMail 注册设置一章.

4、对于某些特殊的安装,你需要为每一个用户设置读写 Pickup 文件夹的权 限. 阿江(Info@ajiang.net)翻译 阿江守候 http://www.ajiang.net

6 w3 JMail 注意:只有 w3 JMail 专业版才具有 PGP 加密邮件功能. 使用 PGP 加密(英文) As Dimac'

s w3 JMail uses the worldwide renowned PGP to encrypt e-mails, there are some preliminary steps to take before PGP support is enabled. First an appropriate license and installation of the PGP software has to be obtained. Useful internet links are http://www.nai.com, http://www.pgp.com and http://www.pgpi.com. PGP and its SDK dll (pgp_sdk.dll) must be installed on the machine where w3 JMail is to be used. Version 6.5.3 of PGP were used during development. In order to use w3 JMail and PGP from ASP pages (assuming a Windows NT/2000 system and IIS), the Internet Guest Account (most likely called IUSR _your-computer-name-here) must have at least read/write access to the PGP application and key ring files (where your encryption keys are stored). However, we recommend that you set these permissions for the EVERYONE user as well. Check PGP configuration for finding out where these files reside on your machine. PGP settings for each user on the system are typically stored in C:Document and Settings[UserName]Application DataPGP on Windows 2000. This means that the user who installed PGP, most likely the administrator, should have the PGP configuration files in his directoryC:Documents and Settings AdministratorApplication DataPGP. The IUSR account uses the folder Default User and therefore the needed PGP application data has to be copied into that directory (C:Document and SettingsDefault UserApplication DataPGP). The directories C:Document and SettingsDefault UserApplication DataPGP and sometimes also C:Document and SettingsAdministratorApplication Data PGP should have read/write permissions for the IUSR account. Replace Administrator with the user name valid in this case. This should be pretty much the same for NT4 systems, but the folders are located in C:WINNTProfiles instead. In most cases when encrypting e-mails with PGP using w3 JMail, the encryption key to be used is found by the e-mail addresses of the recipients. It is however possible to specify one or more encryption keys to use. A key is speci-fied either by an e-mail address john@hisdomain.com or a PGP key id (ex: 0xAABBCCDD). It is possible to supply multiple keys to w3 JMail by separating the identifiers with a comma (ex: john@hisdomain.com, 0xAABBCCDD, george@hisdomain.com ). Regarding support: please note that since PGP is NOT a Dimac product, support is not provided for problems directly related to the usage of PGP. 阿江(Info@ajiang.net)翻译 阿江守候 http://www.ajiang.net

7 w3 JMail 开始使用 本章分四个小节为您分别介绍如何使用 we JMail 发送邮件、接收邮件、加密 邮件和集群发送个性化邮件.所有的示例都是使用 ASP 中最常用的 VBScript 语 言编写的. 使用 Dimac w3 JMail 发送邮件 下面的例子将告诉你如何创建 w3 JMail 对象,并使用它创建一个新的邮件, 设置它的标题、内容并发送它. 首先我们应该创建一个 jmail.message 对象. set msg = Server.CreateOBject( JMail.Message ) 现在我们启动日志功能,这样好让我们的调试工作更容易一些. msg.Logging = true 设置邮件的发送者: msg.From = john.doe@mydomain.com msg.FromName = 某约翰 msg.AddRecipient lisa.simpson@springfield.com addRecipient 方法可以帮助你在必要的时候添加更多的收信人,你也可以为 每一个收信人设置不同的名字: msg.AddRecipient deliveryboy@futurama.com , 老油 msg.AddRecipient theblob@southpark.com , 阿司 现在,我们可以加入邮件的主题了. msg.Subject = 近来可好? 然后是正文.下面的例子也告诉你如何在正文中换行. msg.Body = 这是我学习 JMail 时的一个试验. &

vbCrLf 也可以使用 appendText 方法来创建邮件正文,这个方法常常用来为邮件正文 追加更多的内容. msg.appendText 一些文字. msg.appendText 你想添加的更多的文字. 邮件创建好了, 我们来发送它. 在这里需要输入一个有效的发信服务器地址. msg.Send( mail.myDomain.com ) 搞定!你已经知道了一些使用 w3 JMail 的基本方法,你可以到我们技术站点 http://tech.dimac.net 上去查找更多更精彩的例子. 阿江(Info@ajiang.net)翻译 阿江守候 http://www.ajiang.net

8 w3 JMail 使用 Dimac w3 JMail 收取邮件 w3 JMail

4 已经具备了从 POP3 服务器收取邮件的能力啦! 下面的例子将收取指定信箱中的第一封邮件,把它显示在网页上,并把附件 保存在服务器上. 首先,我们应该创建一个 JMail.POP3 对象实例: Set pop3 = Server.CreateObject( JMail.POP3 ) 然后通过用户名和密码来连接 POP3 服务器: pop3.Connect username , password , mail.mydomain.com 连接了服务器,现在我们来检查邮箱里共有多少封邮件: Response.Write( You have &

pop3.count &

_ e-mails in your mailbox! ) 如果信箱........