[建议]移动开发帮助文档急需完善 - 专家坐堂 - 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、怎样都可以，做窗口是为了方便测试管理。

2、写*有什么不对？你可以具体指定，测试的时候，写*就行了。

3、为什么就不能有多个端口？

4、重复写表头方便用户直接复制代码直接测试。不然还得回头找。

5、foxtable屏蔽了css、js、html的知识，是不想增加用户学习量，如果需要学习，可以访问 w3cschool 自行学习

6、用http做独占编辑，比不上用OpenQQ。原理都是差不多的。

7、

8、先理解帮助，如果如此浅显的帮助文档都没有理解，你无法做网页开发。

9、手机端，只是做一个辅助，不深入探讨。处理数据，尽量是单条处理，也就会修改提交而已。

10、没有忽略，你还没有理解http。

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有关吗？用户在应用方法、属性的时候，是以帮助文档为依据的。

楼主，审批也是提交数据，只是通常通过按钮用get参数提交，帮助有大量用get提交数据的例子。

建议好好学习，你目前提出的建议和批评，让人崩溃。

可以说审批一行数据，和删除一行数据，是一回事。

都是提交行的主键值到约定的接收页面，由服务端执行审批或删除操作。

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

呃，楼主，看帮助文档，先看完先理解，再评论吧。

我赞成楼主的大部分观点。。。

帮助写的真心让小白串不起来。。。

我断断续续晚上研究详情授权，说实话我研究了4个晚上吧，每个晚上一两个小时，才入门，还不知道跟现有的后台怎么合起来用。。。。开发效率比pc端低得一塌糊涂。。。。也许是真的太小白的问题。。

我发帖吧，论坛管理员喊我看那个有订单案例的那个。。。那个我研究了1晚上果断放弃，压根小白都看不透。。。

回头继续研究详情授权，这个帮助又没得个啥案例。。。又是发帖求助。。。真心开发效率之低下。。。

不过开发网页倒是简单 wbui框架确实好用，这点不可否认。。。

当初看pc端的帮助文档差点放弃了，真心太散入不了门，还是看小白的视频入门的。。。。。

这个网页端。。完全靠自己摸索。。。太累了。。。

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

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