Foxtable(狐表)用户栏目专家坐堂 → [建议]移动开发 帮助文档急需完善


  共有8446人关注过本帖树形打印复制链接

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

帅哥哟,离线,有人找我吗?
shenyl0211
  11楼 | 信息 | 搜索 | 邮箱 | 主页 | UC


加好友 发短信
等级:四尾狐 帖子:977 积分:6835 威望:0 精华:0 注册:2012/4/2 21:49:00
  发帖心情 Post By:2017/5/25 12:08:00 [只看该作者]



——————————————————————————————
帮助是有,我没否认。所以说”多数例子“,没说”全部“。
我的意思是很多例子还是没有采用case "test.htm",""

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

 回到顶部
帅哥哟,离线,有人找我吗?
有点蓝
  12楼 | 信息 | 搜索 | 邮箱 | 主页 | UC


加好友 发短信
等级:超级版主 帖子:106209 积分:540168 威望:0 精华:9 注册:2015/6/24 9:21:00
  发帖心情 Post By:2017/5/25 12:34:00 [只看该作者]

额,如果不是必须要这样用的,也没有必要所有的地方都这样写吧。如果全部都写了那么不喜欢使用默认网页的人是不是也要投诉帮助误导他们呢

如果认真起来,作为入口是不是应该用index.htm,login.htm,而不能用test.htm呢。

我们的帮助往往关注的是怎么把一个功能的用法讲解清楚,不会去把所有的细节都抠一遍

Foxtable的帮助确实是比较零散,并且往往需要一些前置的知识才能理解后面的知识。如果没有耐心按照顺序阅读帮助的,确实学习起来比较费劲

 回到顶部
帅哥哟,离线,有人找我吗?
jspta
  13楼 | 信息 | 搜索 | 邮箱 | 主页 | UC


加好友 发短信
等级:七尾狐 帖子:1731 积分:11255 威望:0 精华:0 注册:2011/12/15 22:06:00
  发帖心情 Post By:2017/5/25 13:10:00 [只看该作者]

吐槽下帮助吧,确实很丰富,但是没有抓住重点讲解。以这个网址作为例子
http://www.foxtable.com/mobilehelp/scr/0245.htm

整个页面以 设置默认网页 为标题 通篇却没有讲哪句代码才是设置完成这个功能的关键。(实际上这种写法非常容易被忽略)
默认网页由e.Path = "" 时确定默认调取页面,因此
Dim wb As New WeUI '定义一个基于weui框架的网页生成器
if e.Path = "" then 
 wb.InsertHTML("这是默认页面addnew.htm") 
else

Select Case e.Path
    Case 
"addnew.htm"
        wb.InsertHTML(
"
这是默认页面addnew.htm") 

    Case "order.htm"
        
wb.InsertHTML(
"
这是普通页面order.htm")    
End
 Select

end if 

e.WriteString(wb.Build'生成网页


虽然以上代码比原来的复杂一点,但是把真正的关键点告诉了开发者,以后自己修改和扩展起来也会方便许多。


2.既然事件头那么通用,被你们强调了无数遍,为何不告诉用户规整到一个函数中或者你们自己写个通用帮助类给用户使用,然后专门开一个章节讲解这个帮助类,降低入门代码复杂度,也让希望提高的开发者升入学习。


3.随着狐表帮助越来越强大,随之而来的就是碎片化,不连贯性,是不是该考虑,论坛用户参与到帮助编写的过程中了,毕竟以开发者写的帮助,一般用户时难以理解的。





 回到顶部
帅哥哟,离线,有人找我吗?
有点色
  14楼 | 信息 | 搜索 | 邮箱 | 主页 | UC


加好友 发短信
等级:超级版主 帖子:13837 积分:69650 威望:0 精华:0 注册:2016/11/1 14:42:00
  发帖心情 Post By:2017/5/25 15:38:00 [只看该作者]

 嗯嗯,帮助文档确实有不完善的地方,就好像老师讲课不可能涵盖各个知识点甚至各个衍生的知识点,老师讲完以后还得自己琢磨一下灵活变通才行。

 回到顶部
帅哥哟,离线,有人找我吗?
shenyl0211
  15楼 | 信息 | 搜索 | 邮箱 | 主页 | UC


加好友 发短信
等级:四尾狐 帖子:977 积分:6835 威望:0 精华:0 注册:2012/4/2 21:49:00
  发帖心情 Post By:2017/5/25 19:15:00 [只看该作者]

蓝版主所言差矣。

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

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

顺便说一下,我升级到永久版,是看上了OpenQQ,但内置聊天功能太差,且至今不予解决:
1、没有最近联系人功能。
2、没有按拼音首字母搜索联系人功能,迫使要先知道联系人所在部门、再在20多个部门中选择联系人所在部门、然后在几十个人中仔细查找联系人,效率太低。
3、“会议”两字不予改为“群组”。“群组”内可以召开“会议”,但“会议”永远不会被理解为“群组”。

现在推出移动开发功能,但帮助文档难以上手,比如缺少最常用的整套方法的系列介绍(我承认登录是完善的,但这只是开头,真正的任务还没开始):
1、我输入了“申请部门”列的值,应该通过什么方法获得“申请部门”的值,并为下一语句所用?或能否为下一语句所用?
2、很多申请人提交了申请,并加入到“待批任务”表中。我点击"待批任务"按钮,从“待批任务”表中获得了需要我审批的记录。我选择了某条记录(如何知道该记录的_indentify?)并点“编辑”按钮,则展现编辑界面和审批按钮。我对该记录进行编辑,然后按“复核”、“审核”或“审批”等审批按钮提交,或点“取消”按钮返回。提交后根据审批按钮进行判断和保存,在“待批任务”中删除刚才点击的记录,并刷新“待批任务”表(可能有新的申请),再回到“待批任务”表。
——期待帮助文档增加这样现实的例子。


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

 回到顶部
帅哥哟,离线,有人找我吗?
18523982317
  16楼 | 信息 | 搜索 | 邮箱 | 主页 | UC


加好友 发短信
等级:四尾狐 帖子:852 积分:6103 威望:0 精华:0 注册:2015/12/24 13:02:00
  发帖心情 Post By:2017/5/25 19:26:00 [只看该作者]

我也吐槽一下,我今天在研究详情授权的例子,我还联系了官方的小黄给指导,才发现原来菜单的按钮不能直接定位到想要的网页,要定位合成的网页才能完成授权,帮助里压根就没讲这个,就算我发的贴,蓝大大的回帖也说得模糊,实在不知道怎么用。。。。

我觉得帮助确实是讲了各个功能的用法,但是功能如何串联,那不是小白一时半会能解决的。。。。

还是详情授权,我都研究了个遍,也得到了欢迎xxx光临的界面,就特么不知道怎么跟首页连起来。。。。。

 回到顶部
帅哥哟,离线,有人找我吗?
有点色
  17楼 | 信息 | 搜索 | 邮箱 | 主页 | UC


加好友 发短信
等级:超级版主 帖子:13837 积分:69650 威望:0 精华:0 注册:2016/11/1 14:42:00
  发帖心情 Post By:2017/5/25 21:08:00 [只看该作者]

以下是引用18523982317在2017/5/25 19:26:00的发言:

还是详情授权,我都研究了个遍,也得到了欢迎xxx光临的界面,就特么不知道怎么跟首页连起来。。。。。

 

你要动态合成uri地址

 

比如你访问 a.htm,你就要生成一个授权的地址,授权完成以后,跳转到 a.htm。

 

区分是自己点击进入的,还是微信跳转回来的 If e.GetValues.ContainsKey("code") Then

 

如果是自己点击进入的,合成授权地址,如果是微信跳转的,继续你的操作。


 回到顶部
帅哥哟,离线,有人找我吗?
bohe
  18楼 | 信息 | 搜索 | 邮箱 | 主页 | UC


加好友 发短信
等级:五尾狐 帖子:1074 积分:9872 威望:0 精华:0 注册:2008/9/2 11:34:00
  发帖心情 Post By:2017/5/25 21:58:00 [只看该作者]

你们后生都觉得难,像我老人家就更难理解了图片点击可在新窗口打开查看

官方的视频还是不错的,看视频比看帮助容易理解多了。官方的案例我是弄不懂,太复杂了,我太小白了。



 回到顶部
帅哥哟,离线,有人找我吗?
bohe
  19楼 | 信息 | 搜索 | 邮箱 | 主页 | UC


加好友 发短信
等级:五尾狐 帖子:1074 积分:9872 威望:0 精华:0 注册:2008/9/2 11:34:00
  发帖心情 Post By:2017/5/26 11:21:00 [只看该作者]

我的贴被删了?

建议狐表官方学习POPASP的开发者,放些移动案例开发视频上来,这样入门容易多了。


 回到顶部
帅哥哟,离线,有人找我吗?
shenyl0211
  20楼 | 信息 | 搜索 | 邮箱 | 主页 | UC


加好友 发短信
等级:四尾狐 帖子:977 积分:6835 威望:0 精华:0 注册:2012/4/2 21:49:00
  发帖心情 Post By:2017/5/27 10:08:00 [只看该作者]

    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编辑过]

 回到顶部
总数 59 上一页 1 2 3 4 5 6 下一页