免责声明:
这将是一篇相当冗长的文章,并且花费了相当多的时间来撰写。 它也会有点松散,因为我在编写它时想到了更多的东西。 这些都是我自己的(强烈的)意见,基于我几年 (4) 的 JMP 使用情况。 我还有 JMP 在线帮助页面的问题列表,但我尽量避免在此处提供大部分反馈。
JMP 脚本索引在编写 JMP 脚本时提供了巨大(且必要)的帮助。 我什至将其用作 JMP 功能的一般搜索。 我会将这篇文章分成几个不同的部分,并可能会根据此处的讨论制作愿望清单项目。
脚本索引、JMP 帮助、脚本指南和 JSL 语法参考
我应该依赖哪个文档? 所有这些都以不同/相同的格式提供不同/相同的信息。 有时他们也会有相互矛盾的信息(例如,请参见下面的 Items())。 我希望 JSL Syntax Reference 和 Scripting Index 具有相同的信息。 例如,当前脚本索引缺少参数和返回信息,您必须从描述中解密它们。
另外使用JMP Help在线版的搜索体验也很差。 我发现使用它的唯一可靠方法是首先从 Scripting Index 中找到功能/特性并希望您有可用的帮助按钮,或者在某些情况下使用“jmp help”进行 Google 搜索搜索词“但这不太可靠。 从 Scripting Guide 和 JSL Syntax Reference 的 .pdf 版本中搜索信息通常比仅依赖联机帮助页面搜索更快。 例如,如果我尝试使用 JMP 帮助的搜索来查找 Remove From 函数,它甚至不会出现在列表中。
此外,我还没有真正使用过 JMP17 的搜索功能,但我认为它不是为 JSL 目的而设计的,因为它与上下文相关。
一些文档的链接:
脚本指南(在线) ,脚本指南 (pdf)
JSL 语法参考(在线) , JSL 语法参考 (pdf)
脚本索引格式
真的有必要阅读“说明”以了解所有参数和返回的内容吗? 能否以与 JMP17 中添加的版本类似的方式将它们添加为自己的粗体部分?
下面是特殊的 Paint 示例退货添加(缺少单词“列表”),在最好的情况下也应该有参数(甚至可能抛出)。

JMP 参数列表说明/格式
JSL有这样的东西吗参数列表 (Visual Basic) JSL 参数列表语法在任何地方都有解释吗? 当我开始编写脚本时,我对其中的一些感到相当困惑(我也想在编写自己的自定义函数时使用相同的格式)。 例如,|、<>、= 等是什么意思? 我的猜测: | -> 或者,<> -> 可选参数,= -> 默认值。
用户如何知道应该在函数调用中写出什么? 用户如何知道默认参数值没有每次阅读描述。 以下是我知道的一些简单示例:
包含():
pos = Contains(x, item, <START>)</START>
参数命名在这里绝对不是最好的(x?),但其他方面都很好。 默认值开始在这里定义,但用户如何知道开始应该写出来还是不写? 是否可以跳过它,因为它是使用 = 而不是 () 编写的(这会使它成为一个函数?)?
项目():
wl = Items(<[first last]>, s, <DELIM>, <INCLUDE boundary="" delimiters="">);
</INCLUDE></DELIM>
delim 的默认值? 应该包括边界定界符写出来还是不写? 它默认是什么? 做什么[倒数第一]意思? 文档中没有解释(我应该使用哪个文档......?) Items(string, , )它甚至在 Syntax Reference 中丢失,但可在 Scripting Index 中找到。

它是否在 JMP 的未来版本中被删除(所以我不想使用它)因为它在文档中丢失了? 它是最近添加的吗,所以一些文档刚刚过时(所以我可以使用,但是,如果不尝试,我只是不知道它的作用)。
十六进制():
h = Hex(value, <"integer">|<ENCODING>|<BASE />,<PAD to="">));
</PAD></ENCODING>
默认值? 为什么我不必写出来编码,但我必须写出来根据和垫到(至少基于脚本索引示例)。 我可以从参数后面的括号()中看到这个吗?
在 Scripting Index 中还有更多类似的示例。
脚本文档问题报告
我应该如何报告脚本索引(和其他文档)中可能存在的问题? 创建愿望清单项目或发送支持票是不可能的。 我不想仅仅为了修复一些拼写错误而向任何一个地方发送数百条垃圾邮件。
使用 Remove From() 的快速示例,对于初学者来说,脚本索引和 JSL 语法参考中的描述不同,JSL 语法提供了函数功能的更多信息,但缺少示例。 此外,Scripting Index 与 JSL Syntax Reference 中的函数描述不同......并且函数应该基于此表现不同?
从 ( x, , ) 移除对比删除自(来源,位置,) ,
首先是说 i 和 n 是可选的,但由于某种原因 i 没有默认值(它似乎是 -1)。
第二个说第二个参数是强制的,n 是可选的,没有默认值。
脚本索引(Remove From 不应该基于此返回任何内容?)

在线语法参考关于退货的信息有误(它确实退回了已移除的物品并修改了资源到位)。
