[建议]移动开发帮助文档急需完善 - 专家坐堂 - Foxtable(狐表) - 新一代数据库软件，完美融合Access、Foxpro、Excel、vb.net之优势，人人都能掌握的快速软件开发工具!

移动开发的主要目的不是填写数据，而是移动审批。填写数据没有流程，可以在办公室、家、宾馆；填写数据可以是自己，也可以委托别人；填写数据一般不急，故可以带自己的电脑、U盘出差或用网吧、宾馆的电脑下载项目软件，慢慢完成。但审批是有流程的，比较紧迫，下一个人在等待你完成。不过审批比较简单，可以在路上，但只能是自己，故考虑用人人都有的手机。Foxtable的移动开发就是针对手机。

移动开发对于Foxtable来说是新生事物，而且是很不成熟的。如果帮助文档再不给予详细的解释、举例，并提供相关的功能代码，则用户开发起来将非常低效。

粗略看了一下帮助文档，暂时发现存在以下一些主要问题需要改进和完善：

1、启动服务和关闭服务：实际上不需要窗口、按钮，更不需要两个按钮。只要在AfterOpenProject事件中采用如下代码即可，在“网络监视器”中修改代码后点“应用”，会自动执行下列代码进行关闭和启动：

If HttpServer.IsRunning Then

HttpServer.close()

End If

HttpServer.Prefixes.Add("http://*:888/")

HttpServer.Start()

2、IP地址：测试阶段用本机127.0.0.1，发布后公司服务器只有一个内网IP和一个外网IP，帮助文档不分测试和发布，直接建议用上述的“*”显然是不合适的。

3、IP端口：现在的用户连两个IP地址都记不住，还能记更多的端口吗？一个项目应该只用一个好记的端口，剩下的交由网页来处理，帮助文档有些啰嗦了。

4、事件头：帮助文档的每个例子都重复事件头，太啰嗦了。只需提醒用户实际操作时不要删除以前的事件头就行了。

5、css：只在介绍HTML时有一处代码“class='rd'”说明css如何用于显示文本前景，连显示背景都不顺便举例（不需增加代码，仅需修改css代码的前景色color为背景色background-color即可）。比起前4项，对css的功能和用法介绍确实算抠门的。

6、独占编辑：这是非常重要的功能。既然说Http客户端比OpenQQ简单，代码肯定也不多，为何不贴出呢？我想肯定不是怕用户说啰嗦，而是舍不得吧？用户能忍受反复出现的事件头，就不会说独占编辑的代码啰嗦，只是求之不得。

7、窗口：虽说移动端也是窗口，但与PC端的窗口不是同一个概念、更不是一个档次，差远了。所以，用户写代码的时候要考虑的问题更多，因而，帮助文档是否全面就非常重要。

8、输入内容获取：这是一个非常重要的功能。PC端无论是表还是窗口，不管保存与否，都能获取刚刚输入的内容，便于验证输入或用于动态列表。但移动端竟然没有现成的例子，只能靠用户自己去啃帮助，如果不得要领就不是事倍功半，而是徒劳无功。反正我到现在还没弄清楚。

9、获取已有记录并进行复核、审核、审批：帮助文档只介绍怎么新增记录进行输入、提交、显示提交的记录，而没有选择已有记录进行复核、审核、审批，背离了移动开发的目的。

10、动态列表选项：帮助目录中忽略了可用的PC端动态列表选项：DataTables("汽车").GetComboListString("品牌","国家='" & e.PostValues("国家") & "'")，这是在例子中发现的。

11、默认网页：多数例子没有采用默认网页，要求IP地址中附加输入test.htm等，帮助文档还专门开辟一节（“请输入正确网址”）予以强调（严格说是方法和技巧上的误导），与数据管理的目的之一——尽量简化、减少用户的输入——相悖。也就是说，用户只要输入IP地址和端口号就应该直接进入登录页面，而不必再输入logon.htm。在使用范例时，也只需输入127.0.0.1就直接运行。不管进入哪个网站、哪个页面，除了对已知的进行复制、粘贴，谁手工输入过页面名称？

12、奇怪的事件头：以下是“我想显示一个图片”中的代码，按正常的逻辑这个图片是显示不了的，但实际上if—else—endif中的两段代码都执行了，而帮助文档没做任何解释（是否每次请求都要从事件头开始执行吗?流量、效率、手机费电情况如何？辛辛苦苦开发的软件是否会因流量大、效率低、费电大而遭到抵触？），相信小白都会看得云里雾里。

Dim fl As String = "d:\web\" & e.path ’执行两次

MessageBox.Show(e.path) '第一次是空白，第二次是abc.jpg

If filesys.FileExists(fl) '如果是请求一个已经存在的文件

MessageBox.Show(2) ‘后显示2

MessageBox.Show(e.path) 'abc.jpg

Dim idx As Integer = fl.LastIndexOf(".")

Dim ext As String = fl.SubString(idx)

Select Case ext

Case ".jpg",".gif",".png",".bmp",".wmf" '只允许请求图片文件

e.WriteFile(fl)

End Select

Else

MessageBox.Show(1) '先显示1

Dim sb As New StringBuilder

sb.Appendline("我想显示一个图片<br/><br/>")

sb.AppendLine("<img src='abc.jpg'>")

e.WriteString(sb.ToString())

End If

13、（分享）错误信息“对于造型说明无效的字符值”的产生原因源于帮助文档的遗漏。先看网上审批中，编辑（或称审批，或称修改，但不是增加）一条记录时必须用到的下列代码（对于C/S是不会有这个问题的）：

With .AddInput("审核日期","审核日期","datetime-local")

1 If dr.Isnull("审核日期")=False Then

.value= Format(dr("审核日期"),"yyyy-MM-ddTHH:mm")

2 End If

.readonly=True

End With

如果“审核日期”为空，且没有上述1、2两条语句，则在执行保存记录时会出现该错误。由于帮助文档定位错误，没有网上审批的例子，且例子中的所有日期都不为空，不会遇到该错误。所以，我盲目照帮助文档省略if语句，直接引用.value，浪费了好几个小时。但发现当所有日期都不为空时（色版主认为是使用SQLFind造成的，经验证用find确实没问题），就不会出现该错误。

14、数值字段不能采用千分位格式，否则什么都不显示。但整个帮助文档只字不提千分位的事，format的例子也只对小数。

.AddInput("已签合同额","已签合同额","number").Value = format(dr("已签合同额"),"#,###")'因使用千分位不会显示数据

.AddInput("未签合同额","未签合同额","number").Value =dr("未签合同额") '不使用千分位会显示数据

[此贴子已经被作者于2017/6/5 16:21:03编辑过]

1、做窗口是多余的。在“网络监视器”中点“应用”（必须的）的时候，会自动执行AfterOpenProject事件中的代码进行关闭和启动。

2、帮助文档不分测试和发布两种情况，直接建议用“*”，显然是不合适的。

3、现在的用户连两个IP地址都记不住，还能记住更多的端口号吗？一个项目有必要用更多的端口吗？

4、用户只要保存一个测试项目，实际应用示例时不删除事件头，不就OK了？而帮助文档只需在代码前面标记“事件头略”。

5、移动端用css是临时的，主要采用背景色和前景色，便于识别输入框，应用不多，帮助文档应该说一下在WEUI中用.class引用css吧？顺便说一下，Attribute的相关应用也是支离破碎的，没有归纳整理。

6、既然用http做独占编辑比不上用OpenQQ，为什么还要强调HttpClient更简单呢？

8、http://www.foxtable.com/bbs/dispbbs.asp?BoardID=2&ID=100104&skin=0和http://www.foxtable.com/bbs/dispbbs.asp?BoardID=2&ID=100992&replyID=&skin=1虽然问题的形式不同，但可以归纳为解决同一个问题——怎么获得输入内容？前者需要获得输入内容“查询年月”赋给变量cxny，后者需要获得输入内容“申请部门”赋给变量sqbm，用于SqlGetComboListString。但你们的回答是前者用submitAjaxFileds，后者用sendAjaxText。到底是你对问题的理解或解决方法有问题，还是帮助文档有问题，导致我们都不会？

9、我一开头就承认你的观点——手机端只是一个辅助，主要用于少量、简单的审批，而不是用于大量、复杂的输入、统计、上传。但帮助文档的重点却是输入、统计、上传，已经不是辅助了，但看不到一点审批的代码，实用性太差。

10、帮助文档明明只列了三种动态列表方式。这跟我是否理解http有关吗？用户在应用方法、属性的时候，是以帮助文档为依据的。

11、默认网页：多数例子没有采用默认网页，要求IP地址中附加输入test.htm等，帮助文档还专门开辟一节（“请输入正确网址”）予以强调（严格说是方法和技巧上的误导），与数据管理的目的之一——尽量简化、减少用户的输入——相悖。也就是说，用户只要输入IP地址和端口号就应该直接进入登录页面，而不必再输入logon.htm。在使用范例时，只要将case "test.htm"改为 case "test.htm"，“”，即可只需输入127.0.0.1就直接运行。

有得，看看：http://www.foxtable.com/mobilehelp/scr/0245.htm

——————————————————————————————

帮助是有，我没否认。所以说”多数例子“，没说”全部“。

我的意思是很多例子还是没有采用case "test.htm",""

[此贴子已经被作者于2017/5/25 12:09:46编辑过]

蓝版主所言差矣。

1、帮助文档能不厌其烦地对一些例子加事件头，为什么就不能在缺省网页的case语句后顺便加上,“”三个字符呢？

能不能换位思考一下呢？

2、提意见的目的不为别的，就是想让帮助在简单明了的前提下，更具技术含量，让小白容易上手、少走弯路，甚至不用到论坛提问（而是到论坛分享），以节约作者、用户、版主的时间。

顺便说一下，我升级到永久版，是看上了OpenQQ，但内置聊天功能太差，且至今不予解决：

1、没有最近联系人功能。

2、没有按拼音首字母搜索联系人功能，迫使要先知道联系人所在部门、再在20多个部门中选择联系人所在部门、然后在几十个人中仔细查找联系人，效率太低。

3、“会议”两字不予改为“群组”。“群组”内可以召开“会议”，但“会议”永远不会被理解为“群组”。

现在推出移动开发功能，但帮助文档难以上手，比如缺少最常用的整套方法的系列介绍（我承认登录是完善的，但这只是开头，真正的任务还没开始）：

1、我输入了“申请部门”列的值，应该通过什么方法获得“申请部门”的值，并为下一语句所用？或能否为下一语句所用？

2、很多申请人提交了申请，并加入到“待批任务”表中。我点击"待批任务"按钮，从“待批任务”表中获得了需要我审批的记录。我选择了某条记录（如何知道该记录的_indentify？）并点“编辑”按钮，则展现编辑界面和审批按钮。我对该记录进行编辑，然后按“复核”、“审核”或“审批”等审批按钮提交，或点“取消”按钮返回。提交后根据审批按钮进行判断和保存，在“待批任务”中删除刚才点击的记录，并刷新“待批任务”表（可能有新的申请），再回到“待批任务”表。

——期待帮助文档增加这样现实的例子。

[此贴子已经被作者于2017/5/25 19:41:32编辑过]

12、奇怪的事件头：以下是“我想显示一个图片”中的代码，按正常的逻辑这个图片是显示不了的，但实际上if—else—endif中的两段代码都执行了，而帮助文档没做任何解释（是否每次请求都要从事件头开始执行吗？流量、效率、手机费电情况如何？辛辛苦苦开发的软件是否会因流量大、效率低、费电大而遭到抵触？），相信小白都会看得云里雾里。

Dim fl As String = "d:\web\" & e.path ’执行两次

MessageBox.Show(e.path) '第一次是空白，第二次是abc.jpg

If filesys.FileExists(fl) '如果是请求一个已经存在的文件

MessageBox.Show(2) ‘后显示2

MessageBox.Show(e.path) 'abc.jpg

Dim idx As Integer = fl.LastIndexOf(".")

Dim ext As String = fl.SubString(idx)

Select Case ext

Case ".jpg",".gif",".png",".bmp",".wmf" '只允许请求图片文件

e.WriteFile(fl)

End Select

Else

MessageBox.Show(1) '先显示1

Dim sb As New StringBuilder

sb.Appendline("我想显示一个图片<br/><br/>")

sb.AppendLine("<img src='abc.jpg'>")

e.WriteString(sb.ToString())

End If

[此贴子已经被作者于2017/5/27 10:24:43编辑过]

帮助文档说：“网页中引用的任何文件，包括js、css等等，都会单独向服务器发出下载这个文件的请求”：

1、这是否意味着，不管手机上是否有这个文件，每次都会自动重新下载而产生流量？

2、文件下载到哪儿（便于以后清理）？

3、默认引用weui.me.js、weui.me.css。计算公式、样式如果放在这两个文件中，采用weui框架可不需要增加引用代码。这点在帮助文档中好像没有提醒用户注意。

帮助文档中：单选列表项、多选列表项的例子，接收到的数据是"rdg1:bw2",而不是"浏览器：Google Chorme"；是"bw1:on
bm3:on"，而不是"Intenet Explorer:on FireFox:on"。希望举例的时候按照《接收表单数据》那样，用户就能理解了。

With .AddInput("审核日期","审核日期","datetime-local")

1 If dr.Isnull("审核日期")=False Then

.value= Format(dr("审核日期"),"yyyy-MM-ddTHH:mm")

2 End If

.readonly=True

End With

如果“审核日期”为空，且没有上述1、2两条语句，则在执行保存记录时会出现该错误。由于帮助文档定位错误，没有网上审批的例子，且例子中的所有日期都不为空，不会遇到该错误。所以，我盲目照帮助文档省略if语句，直接引用.value，浪费了好几个小时。但发现当所有日期都不为空时，就不会出现该错误。

[此贴子已经被作者于2017/6/5 8:26:48编辑过]

谢谢色版主。看来服务端加载所有行（定期清理早年的记录）、隐藏所有表能在安全的情况下简化大量代码。

[此贴子已经被作者于2017/6/5 10:39:39编辑过]

主题：[建议]移动开发 帮助文档急需完善

主题：[建议]移动开发帮助文档急需完善