Snapfax Plus - 透过「传真文件夹」功能,你可以轻易地在Windows作业系统中将要发送的传真文件放进指定的文件夹,Snapfax Plus便会替你将传真发送出去。

传真文件夹

概述

概述

透过「传真文件夹」功能,你可以轻易地在Windows作业系统中,将要发送的传真文件放进指定的文件夹,Snapfax Plus便会替你将传真发送出去。你既可以简单地将传真作业文件手动放进文件夹中,也可以用编程方式自动化这过程来满足业务需求。

传真作业文件一般包含收件人的传真号码和所需要传真的 PDF 文档的文件名等参数。在后台运行的 Snapfax Plus 服务会定期检查这些文件夹是否有新的传真作业。当找到时,它便会自动将传真作业文件转换成传真,经由 Snapfax 云服务发送出去。你可以在 Snapfax Plus 中查看你所提交的传真作业当前的状态。当传真作业完成处理后,在默认的情况下会自动产生一个结果文件。

以下部份将为你提供相关的详情:

如何在 Snapfax Plus 中设置传真文件夹

要使用「传真文件夹」功能,首先你需要下载 Snapfax Plus 并将其安装到你的 Windows 作业系统上。如果你尚未安装,请从以下链结下载 Snapfax Plus 的安装文件。下载后,执行安装文件并按照屏幕上的说明完成安装。

Snapfax Plus 安装文件  (版本 1.1.0):
https://snapfaxapp.com/download/Snapfax-Plus-1.1.0.msi

成功安装 Snapfax Plus 后,你可以在 Snapfax Plus 设置新的传真文件夹,以便之后将要发送的传真作业放进去该文件夹中。在安装 Snapfax Plus 时,会同时安装一个名叫「Snapfax Plus Service」的 Windows 服务,它会定时检查传真文件夹中有没有新的传真作业需要处理。

创建传真文件夹的步骤
  1. 点击主屏幕左侧菜单面板中的设定图标(即齿轮图标)。
  2. 在“设定”屏幕中,点击“传真文件夹”部分的加号图标。
    Snapfax Plus - 创建传真文件夹
  3. 从系统中拣择所需的本地文件夹(例如 C:\MyFaxFolder)作为新传真文件夹。请注意,传真文件夹并不支持根目录(例如 C:\、D:\、E:\ 等)和网络文件夹。
  4. 按“选择文件夹”按钮便可添加这个新传真文件夹。

当成功添加传真文件夹后,主屏幕将会自动更新,这样你便可以从主屏幕切换到自动产生的「传真文件夹屏幕」。
Snapfax Plus - 切换到「传真文件夹屏幕」「传真文件夹屏幕」将显示相关传真文件夹的传真记录。最初,由于尚未提交和处理任何传真作业,因此这个新「传真文件夹屏幕」是空的,不会显示任何记录。

删除传真文件夹的步骤
  1. 点击主屏幕左侧菜单面板中的设定图标(即齿轮图标)。
  2. 在“设定”屏幕中,选择要删除的传真文件夹。
  3. 点击减号图标以删除所选定的传真文件夹。

如何创建和提交传真作业

设置好传真文件夹后,可尝试创建传真作业并将其放入文件夹中进行处理。创建传真作业的方法有两个:

  1. 方法(一):将特别命名的 PDF 文件放进指定的传真文件夹。
  2. 方法(二):将传真作业文件和可选的 PDF 文件放进指定的传真文件夹。

如果你只需要传真一份PDF 文件,并不需要添加封面页的话,那么将特殊命名的 PDF 文件放进传真文件夹会是最简单的方法。可是,如果你需要添加封面页或设置其他传真选项,创建一个传真作业文件并将其与可选的 PDF 文件放进传真文件夹会是更合适的方法。

将特殊命名的 PDF 文件放进传真文件夹来创建传真作业

您可以按照以下步骤来准备一个特殊命名的 PDF 文件:

  1. 为你要发送的 PDF 文件复制一个副本。
  2. 按照Snapfax Plus所指定的文件名语法来修改副本的文件名:

    fax={+86xxxxxxxxxx}可选文本部分.pdf

    • 文件名必须以fax= 为首并以.pdf 结尾。
    • 在文件名中,传真号码必须用大括号 {} 括起来。
    • 传真号码必须以国家/地区代码前缀(例如中国的 +86)为首,并将之后的 xxxxxxxx替换成收件人的传真号码。
    • 可选文本部分 可替换成所需的文字,或者把它留空。

    例子:
    如果你想将 PDF 文件发送到传真号码 +861022223333,你可以将复制的 PDF 文件命名为 fax={+861022223333}.pdf。

  3. 重新命名复制的 PDF 文件后,你可以将其复制并粘贴到传真文件夹中。 Snapfax Plus 服务会将该文件转换为传真作业,并尝试通过 Snapfax 云服务将传真发送出去。
创建传真作业文件并将其与可选的 PDF 文件放进传真文件夹来创建传真作业

你可以使用任何文本编辑器来创建传真作业文件。传真作业文件的文件扩展名必须是“.efj”。传真作业文件内容为 JSON 格式,便于阅读和编辑。创建传真作业文件后,你可以将其与 PDF 文档一起放进传真文件夹中进行处理。

以下是传真作业文件中可包含的 JSON 元素列表:

根对象
传真作业文件必须以一个没命名的根对象为首。
to 数组
to 数组必须至少包含一个对象。当中每个对象包含传真收件人的详情。
name 项目
传真封面页中收件人栏位所显示的收件人姓名。 (可选的)
faxNumber 项目
收件人的传真号码,必须以国家/地区代码前缀为首(例如 +86 表示中国)。 (必须的)
attachment 数组
附件数组可以包含一个或多个对象。当中每个对象包含所要发送的 PDF 文档的详情。 (可选的)
path 项目
要发送的 PDF 文档的文件名。它不区分大小写。 (在附件对象中是必需的)
delete 项目
当传真作业处理完后,决定是否删除 PDF 文档。默认为 true「是」。 (可选的)
coversheet 项目
将要使用的封面页之名称,必须与 Snapfax 服务器端所支援的封面页名称匹配,例如 “0001.Hans”。 (可选的)
如果此项目设置了封面页名称,传真将包含封面页。
如果此项目不存在或设置为空白,传真将不包含封面。
可用的封面页值列表:
普通传真封面页
0001.en 英语
0001.de-DE 德语
0001.es 西班牙语
0001.fr-FR 法语
0001.it-IT 意大利语
0001.ja-JP 日语
0001.ko-KR 韩语
0001.pt-PT 葡萄牙语
0001.ru-RU 俄语
0001.th-TH 泰语
0001.zh-Hans 简体中文
0001.zh-Hant 繁体中文
Confidential Fax Cover Page
0002.en 英语
0002.de-DE 德语
0002.es 西班牙语
0002.fr-FR 法语
0002.it-IT 意大利语
0002.ja-JP 日语
0002.ko-KR 韩语
0002.pt-PT 葡萄牙语
0002.ru-RU 俄语
0002.th-TH 泰语
0002.zh-Hans 简体中文
0002.zh-Hant 繁体中文
from 项目
传真封面页中寄件人栏位所显示的寄件人姓名。 (可选的)
subject 项目
传真封面页中主题栏位所显示的文字。 (可选的)
body 项目
传真封面页中内容栏位所显示的文字。 (可选的)
你可以 \n 作为换行符号。
result 项目
当传真作业处理完后,决定是否产生一个结果文件。默认为 true「是」。 (可选的)
>

让我们看一些示例,以便更好地了解传真作业文件的内容。

示例 1:
假设你想将一个名为“my_document.pdf”的 PDF 文件传真到传真号码“+861022223333”,而这传真不用添加封面页的话,你可以创建一个传真作业文件(即 .efj 文件),其内容如下所示,然后将这.efj文件和my_document.pdf一并复制到传真文件夹中进行处理。

传真作业文件内容:


{
	"to": [
		{
			"faxNumber": "+861022223333"
		}
	],
	"attachment": [
		{
			"path": "my_document.pdf"
		}
	]
}
							

示例 2:
假设你想将两个 PDF 文件(例如“my_document_1.pdf”和“my_document_2.pdf”)发送到传真号码“+861022223333”,而这传真不用添加封面页的话,你可以创建一个传真作业文件(即 .efj 文件),其内容如下所示,然后将这.efj文件连同那两个 PDF 文件一并复制到传真文件夹中进行处理。

传真作业文件内容:


{
	"to": [
		{
			"faxNumber": "+861022223333"
		}
	],
	"attachment": [
		{
			"path": "my_document_1.pdf"
		},
		{
			"path": "my_document_2.pdf"
		}
	]
}
							

示例 3:
假设你想将一个名为“my_document.pdf”的 PDF 文件和封面页发送传真给两个收件人(“张三”和“李四”,传真号码分别为“+861022223333”和“+861022224444”),你可以创建一个传真作业文件(即 .efj 文件),其内容如下所示,然后将这.efj文件和my_document.pdf一并复制到传真文件夹中进行处理。

传真作业文件内容:


{
	"to": [
		{
			"name": "张三",
			"faxNumber": "+861022223333"
		},
		{
			"name": "李四",
			"faxNumber": "+861022224444"
		}
	],
	"attachment": [
		{
			"path": "my_document.pdf",
			"delete": true
		}
	],
	"coversheet": "0001.zh-Hans",
	"from": "我的公司",
	"subject": "传真测试",
	"body": "您好,\n希望一切顺利。",
	"result": true
}
							

如何查看所提交的传真作业并理解结果文件

当你把新传真作业添加到传真文件夹之后,Snapfax Plus 服务将接收它并进行处理。这时,Snapfax Plus 将自动创建一个新传真纪录。你可以在 Snapfax Plus 切换相关的传真文件夹屏幕来查看传真纪录,并可点击刷新按钮来更新传真文件夹屏幕所显示的资料。
Snapfax Plus - 重新加载传真文件夹屏幕

你可以从传真文件夹屏幕中点击你想查看的传真纪录,Snapfax Plus 便会显示相应的传真详细,而你也可在当中下载这传真的传输报告。
Snapfax Plus - 查看传真详细

如果你的传真作业是通过把特别命名的 PDF 文件放进传真文件夹中而创建的,在处理传真作业期间,Snapfax Plus 服务将首先把 PDF 文件的扩展名由 .pdf 改成 .PROCESSING。 当传真作业完成处理,Snapfax Plus 服务将删除这个 .PROCESSING 文件,并自动产生一个 .RESULT 文件。这 .RESULT 文件是个 JSON 格式的纯文本文件,其中包含有关传真作业处理和传送结果的讯息。

如果你的传真作业是通过将传真作业文件和可选 PDF 文件放进传真文件夹来创建的,在处理传真作业期间,Snapfax Plus 服务首先会将传真作业文件的扩展名由 .efj 改成 .PROCESSING,而 PDF 文件则保持不变。当传真作业完成处理,Snapfax Plus 服务将删除这个 .PROCESSING 文件,并自动产生一个 .RESULT 文件。 在默认的设定下,Snapfax Plus 服务还会将相关的 PDF 文件从传真文件夹中自动删除。

.RESULT 文件中可包含的元素列表:

根对象
结果文件总是以一个没命名的根对象为首。
Start 项目
传真作业的开始时间。
End 项目
传真作业的最后更新时间。
RefNo 项目
传真作业的参考编号。
JobSubmissionError 项目
准备提交传真作业时所发生的错误讯息。
Recipients 数组
Recipients 数组可包含一个或多个对象。当中每个对象包含收件人的详情。
To 项目
收件人的姓名。
FaxNumber 项目
收件人的传真号码。
Status 项目
传真最后的传送状态。
CompletedTime 项目
完成传送的时间。
CSID 项目
收件人传真设备的被呼叫的订阅者ID字符串(CSID)。
Duration 项目
传真传送的持续时间(以秒为单位)。
PagesSent 项目
传真发送了的页数。
Error 项目
发送传真时所产生的错误讯息。

示例 1:发送成功的传真作业的 .RESULT 文件。


{
	"Start":"2020-10-22T08:10:35.000Z",
	"End":"2020-10-22T08:13:57.000Z",
	"RefNo":"F58F4F",
	"JobSubmissionError":"",
	"Recipients":[
		{
			"To":"张三",
			"FaxNumber":"+861022223333",
			"Status":"SENT",
			"CompletedTime":"2020-10-22T08:11:16.000Z",
			"CSID":"",
			"Duration":1.0,
			"PagesSent":2,
			"Error":""
		}
	]
}
							

示例 2:具有发送成功和发送失败的传真作业的 .RESULT 文件。


{
	"Start":"2020-10-22T08:10:35.000Z",
	"End":"2020-10-22T08:15:28.000Z",
	"RefNo":"F58F4F",
	"JobSubmissionError":"",
	"Recipients":[
		{
			"To":"张三",
			"FaxNumber":"+861022223333",
			"Status":"SENT",
			"CompletedTime":"2020-10-22T08:11:16.000Z",
			"CSID":"",
			"Duration":1.0,
			"PagesSent":2,
			"Error":""
		},
		{
			"To":"李四",
			"FaxNumber":"+861022224444",
			"Status":"ERROR",
			"CompletedTime":"2020-10-22T08:12:47.000Z",
			"CSID":"861022224444",
			"Duration":1.0,
			"PagesSent":0,
			"Error":"Busy"
		}
	]
}
							

示例 3: 具有提交错误的传真作业的 .RESULT 文件。


{
	"Start":"2020-10-23T05:13:12.000Z",
	"End":"2020-10-23T05:13:12.000Z",
	"RefNo":null,
	"JobSubmissionError":"Invalid recipient fax number: '+8612345'.",
	"Recipients":null
}
							

出现问题时如何排除故障

请看以下常见问题解答能否帮助。


问题:安装 Snapfax Plus 时出现错误“此应用程序需要支持 Visual Studio 2015、2017 和 2019 的 Microsoft Visual C++可再发行程序包”。我可怎样做?
Snapfax Plus - 欠缺支援 Visual Studio 2015、2017、2019 和 2022 的 Microsoft Visual C++可转散发套件

“支持 Visual Studio 2015、2017、2019 和 2022 的 Microsoft Visual C++可再发行程序包”是运行 Snapfax Plus 时所需用的软体,因此要预先安装。请在安装 Snapfax Plus 之前下载并安装它。
https://docs.microsoft.com/zh-CN/cpp/windows/latest-supported-vc-redist?view=msvc-170


问题:启动 Snapfax Plus 后出现错误“LoadWatchedFolder() : Status(StatusCode=Unavailable, Detail="failed to connect to all addresses")”。我可怎样做?
Snapfax Plus - Snapfax Plus 服务出现错误未能启动

  1. 请检查 Snapfax Plus 服务是否已经启动:
    1. 启动 Windows 服务应用程序(按 Windows+R 键打开“运行”对话框,键入 services.msc,然后按 Enter)
    2. 确保“Snapfax Plus 服务”列为其中一项服务。
    3. 确保“Snapfax Plus 服务”的“启动类型”设置为“自动”。
    4. 确保“Snapfax Plus 服务”已启动。如果没启动,请尝试启动它。
  2. 如果 Snapfax Plus 服务无法启动,请尝试下载并安装“支持 Visual Studio 2015、2017、2019 和 2022 的 Microsoft Visual C++可再发行程序包”。
    https://docs.microsoft.com/zh-CN/cpp/windows/latest-supported-vc-redist?view=msvc-170

问题:我已将新的传真作业放进传真文件夹中,但是即使我尝试刷新屏幕超过 5 分钟,也无法从 Snapfax Plus 中相应的传真文件夹屏幕中看到任何新的传真作业。此外,在传真文件夹中也没有产生 .PROCESSING 文件。我可怎样做?

  1. 请检查 Snapfax Plus 服务是否已经启动:
    1. 启动 Windows 服务应用程序(按 Windows+R 键打开“运行”对话框,键入 services.msc,然后按 Enter)
    2. 确保“Snapfax Plus 服务”列为其中一项服务。
    3. 确保“Snapfax Plus 服务”的“启动类型”设置为“自动”。
    4. 确保“Snapfax Plus 服务”已启动。如果没启动,请尝试启动它。
  2. 确保你已经在 Snapfax Plus 中为Windows系统的文件夹创建了一个对应的传真文件夹。您可以从 Snapfax Plus 的设定屏幕中查看已经设置了的传真文件夹。

问题:即使当前没有其他传真作业正在处理,我的传真作业状态在“传真文件夹”屏幕中仍一直保持着“处理中”并已经超过 5 分钟。发生了什么问题吗?

可能你的电脑因某原因无法通过 HTTPS(通讯端口 443)连接互联网。请检查你的互联网连接并确保网络流量没有被代理服务器或防火墙阻止。


问题:我已经阅读了上面所有的常见问题,但问题仍然无法解决。我可怎样做?

请随时与我们联系。如果 Snapfax Plus 仍能启动起来,你可以从 Snapfax Plus 中点击“设定联络我们”,它会尝试启动你的电邮软件并创建一个新的电子邮件,当中有些默认好的讯息。另一方面,如果 Snapfax Plus 无法启动,你可以直接发送电子邮件给我们(support@snapfaxapp.com )。

请在你的电子邮件中提供更多讯息来描述你所遇到的问题。我们会尽快回覆和协助。