免責事項:
これはかなり長い投稿になり、書くのにかなりの時間がかかりました。 また、書いているときに頭に浮かんだときにさらに追加したため、少し構造化されていません。 これらはすべて、私の数年 (4) の JMP 使用に基づく私自身の (強い) 意見です。 JMP のオンライン ヘルプ ページにも問題のリストがありますが、ここではフィードバックのほとんどを避けるようにしています。
JMP Scripting Index は、JMP スクリプトを作成する際の大きな (そして必要な) ヘルプです。 JMP 機能の一般的な検索としても使用しています。 この投稿をいくつかの異なるセクションに分割し、ここでの議論に基づいてウィッシュ リストの項目を作成する可能性があります。
Scripting Index、JMP Help、Scripting Guide、JSL Syntax Reference
どのドキュメントに依存する必要がありますか? これらはすべて、異なる/同じ情報を異なる/同じ形式で提供します。 また、矛盾する情報が含まれている場合もあります (たとえば、以下の Items() を参照してください)。 JSL Syntax Reference と Scripting Index に同じ情報が含まれていることを望みます。 たとえば、現在、Scripting Index には引数と戻り情報が不足しており、説明からそれらを解読する必要があります。
また、JMP ヘルプのオンライン版の検索の使用感もかなり悪いです。 私が見つけた唯一の信頼できる使用方法は、最初に Scripting Index から関数/機能を見つけて、[ヘルプ] ボタンが機能していることを期待するか、場合によっては「jmp ヘルプ」で Google 検索することです。検索語"しかし、これはあまり信頼できません。 Scripting Guide および JSL Syntax Reference の .pdf バージョンから情報を検索する方が、通常、オンライン ヘルプ ページの検索に頼るよりも高速です。 たとえば、JMP ヘルプの検索を使用して [削除元] 機能を見つけようとしても、リストにさえありません。
また、JMP17 の検索機能はあまり使用していませんが、コンテキストに関連しているため、JSL の目的で作成されたものではないと思います。
一部のドキュメントへのリンク:
スクリプト ガイド (オンライン) 、スクリプトガイド (pdf)
JSL 構文リファレンス (オンライン) 、 JSL 構文リファレンス (pdf)
スクリプティング インデックスの形式
すべてのパラメータと何が返されるかを理解するために、「説明」を読む必要はありますか? JMP17で追加されたバージョンと同様に、独自の太字部分として追加できますか?
以下は例外的なペイントの例です戻り値追加されました (「リスト」という単語が欠落しています)。最良の場合、引数もそこにある必要があります (そして、おそらくスローも)。
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の将来のバージョンで削除されますか（したがって、使用したくありません）？ 最近追加されたので、一部のドキュメントが古くなっています（使用できますが、試してみないと何をするのかわかりません）。
16 進数 ():
h = Hex(value, <"integer">|<ENCODING>|<BASE />,<PAD to="">));
</PAD></ENCODING>
デフォルト値？ なぜ書き出す必要がないのかエンコーディング、しかし、私は書き出さなければなりませんベースとパッドトゥ(少なくとも Scripting Index の例に基づく)。 パラメータの後の角かっこ () からこれを確認できますか?
Scripting Index には、同様の例が他にもたくさんあります。
スクリプトに関するドキュメントの問題の報告
Scripting Index (およびその他のドキュメント) 内で考えられる問題をどのように報告すればよいですか? ウィッシュ リストのアイテムを作成したり、サポート チケットを送信したりすることは問題外です。 タイプミスを修正するためだけに、どちらの場所にも何百ものメッセージをスパム送信したくありません。
Remove From() を使用した簡単な例。まず、スクリプト インデックスと JSL 構文リファレンスでは説明が異なります。JSL 構文では、関数の機能についてより多くの情報が提供されていますが、例が不足しています。 また、Scripting Index と JSL Syntax Reference では関数の説明が異なります...これに基づいて、関数の動作が異なるはずですか?
From( x, , ) を削除対削除元(ソース、位置、) 、
最初に i と n はオプションと言っていますが、なぜか i にはデフォルト値がありません (-1 のようです)。
2 番目の引数は、2 番目の引数が必須であり、n がオプションであり、デフォルト値がないことを示しています。
Scripting Index (Remove From は、これに基づいて何も返さないはずですか?)
オンライン構文リファレンス返品に関する間違った情報があります（削除されたアイテムを返品して変更しますソース所定の位置に）。
