Haftungsausschluss:
Dies wird ein ziemlich langer Beitrag und es hat ziemlich viel Zeit gedauert, ihn zu schreiben. Es wird auch etwas unstrukturiert sein, da ich beim Schreiben weitere Dinge hinzugefügt habe, die mir in den Sinn gekommen sind. Dies sind alles meine eigenen (starken) Meinungen, die auf meinen wenigen Jahren (4) Jahren der JMP-Nutzung basieren. Ich habe auch eine Liste von Problemen mit der Online-Hilfeseite von JMP, aber ich versuche, die meisten dieser Rückmeldungen hier zu vermeiden.
JMP Scripting Index ist eine großartige (und notwendige) Hilfe beim Schreiben von JMP-Skripten. Ich verwende es sogar als allgemeine Suche nach JMP-Funktionen. Ich werde diesen Beitrag in verschiedene Abschnitte unterteilen und möglicherweise Artikel auf der Wunschliste erstellen, die auf der Diskussion hier basieren.
Scripting Index, JMP Help, Scripting Guide und JSL Syntax Reference
Auf welche Dokumentation sollte ich mich verlassen? All diese bieten unterschiedliche/gleiche Informationen in unterschiedlichem/gleichem Format. Manchmal haben sie auch widersprüchliche Informationen (siehe zum Beispiel Items() unten). Ich möchte, dass JSL Syntax Reference und Scripting Index die gleichen Informationen haben. Zum Beispiel fehlen derzeit dem Scripting Index Argumente und Rückgabeinformationen und Sie müssen sie aus der Beschreibung entschlüsseln.
Auch die Erfahrung mit der Suche in der Online-Version der JMP-Hilfe ist ziemlich schlecht. Die einzige zuverlässige Möglichkeit, es zu verwenden, die ich gefunden habe, besteht darin, entweder zuerst die Funktion/das Feature im Scripting-Index zu finden und zu hoffen, dass Sie eine funktionierende Hilfeschaltfläche haben, oder in einigen Fällen die Google-Suche mit "jmp help Suchbegriff "Aber das ist nicht allzu zuverlässig. Das Durchsuchen der Informationen in den .pdf-Versionen des Scripting Guide und der JSL-Syntaxreferenz ist normalerweise schneller, als sich nur auf die Suche auf den Online-Hilfeseiten zu verlassen. Wenn ich beispielsweise versuche, die Funktion „Entfernen aus“ mithilfe der Suchfunktion von JMP Help zu finden, wird sie nicht einmal in der Liste aufgeführt.
Außerdem habe ich die Suchfunktion von JMP17 nicht wirklich verwendet, aber ich denke, sie ist nicht für JSL-Zwecke gemacht, da sie kontextbezogen ist.
Links für einige der Dokumentationen:
Skriptleitfaden (online) , Skriptleitfaden (pdf)
JSL-Syntaxreferenz (online) , JSL-Syntaxreferenz (pdf)
Scripting-Indexformat
Ist es wirklich notwendig, "Beschreibung" zu lesen, um alle Parameter zu verstehen und was zurückgegeben wird? Könnten sie als ihre eigenen fettgedruckten Teile auf ähnliche Weise wie Version Added in JMP17 hinzugefügt werden?
Unten ist ein außergewöhnliches Malbeispiel mit Kehrt zurück hinzugefügt (mit fehlenden Wörtern "eine Liste"), im besten Fall sollten auch Argumente dabei sein (und vielleicht sogar Würfe).
Beschreibung/Format der JMP-Parameterliste
Gibt es so etwas für JSL Parameterliste (Visual Basic) wie in wird die Syntax der JSL-Parameterliste irgendwo erklärt? Als ich anfing, Skripte zu schreiben, war ich ziemlich verwirrt von einigen davon (auch würde ich gerne dasselbe Format verwenden, wenn ich meine eigenen benutzerdefinierten Funktionen schreibe). Was bedeuten zum Beispiel |, <>, = usw.? Meine Vermutungen: | -> oder, <> -> optionaler Parameter, = -> Standardwert.
Woher weiß der Benutzer, was im Funktionsaufruf geschrieben werden soll? Woher kennt der Benutzer die Standardparameterwerte? OHNE Beschreibung jedes Mal lesen. Unten sind einige schnelle Beispiele, die ich kenne:
Enthält():
pos = Contains(x, item, <START>)</START>
Die Parameterbenennung ist hier definitiv nicht die beste (x?), aber ansonsten ganz ok. Standardwert für starten ist hier definiert, aber woher weiß der Benutzer, ob starten soll ausgeschrieben werden oder nicht? Kann es übersprungen werden, weil es mit = anstelle von () geschrieben wird (was es zu einer Funktion machen würde?)?
Artikel():
wl = Items(<[first last]>, s, <DELIM>, <INCLUDE boundary="" delimiters="">);
</INCLUDE></DELIM>
Standardwert für delim? Sollte Begrenzungszeichen einschließen ausgeschrieben werden oder nicht? Was ist standardmäßig? Was macht [zuerst zuletzt] bedeuten? Es wird in der Dokumentation nicht erklärt (welche Dokumentation soll ich verwenden ...?) Items(string, , ) es fehlt sogar in der Syntaxreferenz, wurde aber im Scripting Index gefunden.
Wird es in zukünftigen Versionen von JMP entfernt (also möchte ich es nicht verwenden), weil es in der Dokumentation fehlt? Wurde es kürzlich hinzugefügt, so dass einige Dokumentationen einfach veraltet sind (also kann ich es verwenden, aber ich habe einfach keine Ahnung, was es tut, ohne es auszuprobieren).
Verhexen():
h = Hex(value, <"integer">|<ENCODING>|<BASE />,<PAD to="">));
</PAD></ENCODING>
Standardwerte? Warum ich das nicht schreiben muss Codierung , aber ich muss ausschreiben Base und Pad zu (zumindest basierend auf Scripting Index Beispiel). Kann ich das an Klammern () nach dem Parameter sehen?
Und es gibt viele weitere ähnliche Beispiele im Scripting Index.
Berichterstattung über Probleme mit der Skriptdokumentation
Wie soll ich mögliche Probleme im Scripting Index (und anderer Dokumentation) melden? Das Erstellen von Artikeln auf der Wunschliste oder das Versenden von Support-Tickets kommt dafür nicht in Frage. Ich möchte nicht Hunderte von Nachrichten an einen der beiden Orte spammen, nur um einige Tippfehler zu beheben.
Kurzes Beispiel mit Remove From(), für den Anfang unterscheiden sich die Beschreibungen in Scripting Index und JSL Syntax Reference und JSL Syntax bietet mehr Informationen darüber, was die Funktion tut, aber es fehlen Beispiele. Auch die Funktionsbeschreibungen unterscheiden sich in Scripting Index vs. JSL Syntax Reference ... und die Funktionen sollten sich basierend darauf unterschiedlich verhalten?
Entfernen aus( x, , ) vs Entfernen aus(Quelle, Position, ) ,
Erstens ist zu sagen, dass i und n optional sind, aber aus irgendeinem Grund hat i keinen Standardwert (es scheint -1 zu sein).
Das zweite besagt, dass das zweite Argument obligatorisch und n optional ist und keinen Standardwert hat.
Scripting Index (Remove From soll darauf basierend nichts zurückgeben?)
Online-Syntaxreferenz hat falsche Informationen zu Rückgaben (es gibt die entfernten Elemente und Änderungen zurück Quelle an Ort und Stelle).
