免責聲明:
這將是一篇相當冗長的文章,並且花費了相當多的時間來撰寫。 它也會有點鬆散,因為我在編寫它時想到了更多的東西。 這些都是我自己的(強烈的)意見,基於我幾年 (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 不應該基於此返回任何內容?)

在線語法參考關於退貨的信息有誤(它確實退回了已移除的物品並修改了資源到位)。
