Clause de non-responsabilité:
Ce sera un post assez long et a pris un peu de temps à écrire. Ce sera également un peu non structuré car j'ai ajouté plus de choses quand elles me sont venues à l'esprit en l'écrivant. Ce sont toutes mes propres opinions (fortes) basées sur mes quelques années (4) d'utilisation de JMP. J'ai également une liste de problèmes avec la page d'aide en ligne de JMP, mais j'essaie d'éviter la plupart de ces commentaires ici.
JMP Scripting Index est une aide précieuse (et nécessaire) lors de l'écriture de scripts JMP. Je l'utilise même comme recherche générale de fonctionnalités JMP. Je diviserai ce message en deux sections différentes et je créerai peut-être un ou plusieurs éléments de la liste de souhaits en fonction de la discussion ici.
Index de script, aide JMP, guide de script et référence de syntaxe JSL
Sur quelle documentation dois-je me baser ? Tous ces éléments fournissent des informations différentes / identiques dans un format différent / identique. Parfois aussi, ils ont des informations contradictoires (voir Items() ci-dessous par exemple). J'aimerais que JSL Syntax Reference et Scripting Index aient les mêmes informations. Par exemple, actuellement, Scripting Index manque d'arguments et d'informations de retour et vous devez les déchiffrer à partir de la description.
De plus, l'expérience d'utilisation de la recherche de la version en ligne de l'aide de JMP est assez mauvaise. Le seul moyen fiable de l'utiliser que j'ai trouvé est soit de trouver d'abord la fonction/fonctionnalité à partir de l'index de script et d'espérer que vous avez un bouton d'aide fonctionnel ou, dans certains cas, la recherche Google avec "jmp help terme de recherche " mais ce n'est pas trop fiable. La recherche d'informations à partir des versions .pdf du guide de script et de la référence de syntaxe JSL est généralement plus rapide que la simple recherche de pages d'aide en ligne. Si, par exemple, j'essaie de trouver la fonction Supprimer de en utilisant la recherche de l'aide de JMP, elle ne figurera même pas dans la liste.
De plus, je n'ai pas vraiment utilisé la fonction de recherche de JMP17, mais je pense qu'elle n'est pas conçue à des fins JSL car elle est liée au contexte.
Liens pour une partie de la documentation :
Guide de script (en ligne) , Guide de script (pdf)
Référence de syntaxe JSL (en ligne) , Référence de syntaxe JSL (pdf)
Format d'index de script
Est-il vraiment nécessaire de lire "Description" pour comprendre tous les paramètres et ce qui est renvoyé ? Pourraient-ils être ajoutés en tant que leurs propres parties en gras de la même manière que la version ajoutée dans JMP17 ?
Ci-dessous, un exemple de peinture exceptionnel avec Retour ajouté (avec les mots manquants "une liste"), dans le meilleur des cas, les Arguments devraient également être là (et peut-être même lancers).
Description/format de la liste des paramètres JMP
Existe-t-il quelque chose comme ça pour JSL Liste des paramètres (Visual Basic) comme dans la syntaxe de la liste de paramètres JSL expliquée n'importe où? Quand j'ai commencé à écrire des scripts, j'étais assez confus par certains d'entre eux (j'aimerais aussi utiliser le même format lorsque j'écris mes propres fonctions personnalisées). Par exemple, que signifient |, <>, =, etc. ? Mes suppositions : | -> ou, <> -> paramètre optionnel, = -> valeur par défaut.
Comment l'utilisateur sait-il ce qui doit être écrit dans l'appel de fonction ? Comment l'utilisateur connaît-il les valeurs de paramètre par défaut ? SANS POUR AUTANT lire la description à chaque fois. Voici quelques exemples rapides que je connais :
Contient():
pos = Contains(x, item, <START>)</START>
La dénomination des paramètres n'est certainement pas la meilleure ici (x ?) Mais sinon, c'est tout à fait correct. Valeur par défaut pour début est défini ici, mais comment l'utilisateur sait-il si début faut-il l'écrire ou pas ? Peut-il être ignoré car il est écrit en utilisant = au lieu de () (ce qui en ferait une fonction ?) ?
Articles():
wl = Items(<[first last]>, s, <DELIM>, <INCLUDE boundary="" delimiters="">);
</INCLUDE></DELIM>
Valeur par défaut pour delim ? Devraient Inclure les délimiteurs de limite être écrit ou pas ? À quoi correspond-il par défaut ? Que signifie [premier Dernier] moyenne? Ce n'est pas expliqué dans la documentation (quelle documentation dois-je utiliser... ?) Items(string, , ) il est même absent de Syntax Reference mais trouvé dans Scripting Index.
Est-il supprimé dans la future version de JMP (je ne veux donc pas l'utiliser) parce qu'il manque dans la documentation ? A-t-il été ajouté récemment, donc une documentation est juste obsolète (je peux donc l'utiliser, mais je n'ai aucune idée de ce qu'il fait sans l'essayer).
Hex() :
h = Hex(value, <"integer">|<ENCODING>|<BASE />,<PAD to="">));
</PAD></ENCODING>
Les valeurs par défaut? Pourquoi je n'ai pas à écrire codage , mais je dois écrire Base et Pad à (au moins basé sur l'exemple de Scripting Index). Puis-je voir cela entre parenthèses () après le paramètre ?
Et il existe de nombreux autres exemples similaires dans Scripting Index.
Rapport de problème de documentation de script
Comment dois-je signaler d'éventuels problèmes dans Scripting Index (et dans d'autres documents) ? Il est hors de question de créer des éléments de liste de souhaits ou d'envoyer des tickets d'assistance pour cela. Je ne veux pas spammer des centaines de messages à l'un ou l'autre endroit juste pour faire corriger une faute de frappe.
Exemple rapide en utilisant Remove From(), pour commencer les descriptions sont différentes dans Scripting Index et JSL Syntax Reference et JSL Syntax fournit plus d'informations sur ce que fait la fonction mais manque d'exemples. De plus, les descriptions de fonctions sont différentes dans Scripting Index vs JSL Syntax Reference... et les fonctions devraient se comporter différemment en fonction de cela ?
Supprimer de( x, , ) vs Supprimer de(source, position, ) ,
Le premier est de dire que i et n sont facultatifs, mais pour une raison quelconque, i n'a pas de valeur par défaut (il semble être -1).
Le second indique que le deuxième argument est obligatoire et n est facultatif sans valeur par défaut.
Index de script (Remove From n'est pas censé renvoyer quoi que ce soit sur cette base ?)
Référence de syntaxe en ligne contient des informations erronées sur les retours (il renvoie les articles supprimés et modifie la source en place).
