Descargo de responsabilidad:
Esta será una publicación bastante larga y tomó bastante tiempo escribirla. También estará un poco desestructurado ya que agregué más cosas cuando me vinieron a la mente mientras lo escribía. Estas son todas mis propias opiniones (fuertes) basadas en mis pocos años (4) de uso de JMP. También tengo una lista de problemas con la página de ayuda en línea de JMP, pero trato de evitar la mayoría de esos comentarios aquí.
JMP Scripting Index es una gran (y necesaria) ayuda al escribir JMP Scripts. Incluso lo uso como búsqueda general de características de JMP. Dividiré esta publicación en un par de secciones diferentes y podría hacer elementos de la lista de deseos según la discusión aquí.
Índice de secuencias de comandos, ayuda de JMP, guía de secuencias de comandos y referencia de sintaxis JSL
¿En qué documentación debo confiar? Todos estos proporcionan diferente/misma información en diferente/mismo formato. Además, a veces tienen información contradictoria (ver Items() a continuación, por ejemplo). Me gustaría que la referencia de sintaxis de JSL y el índice de secuencias de comandos tuvieran la misma información. Por ejemplo, actualmente Scripting Index carece de argumentos y devuelve información y debe descifrarlos de la descripción.
Además, la experiencia de usar la búsqueda de la versión en línea de la Ayuda de JMP es bastante mala. La única forma confiable de usarlo que he encontrado es encontrar primero la función/característica en Scripting Index y esperar que tenga un botón de Ayuda que funcione o, en algunos casos, buscar en Google con "jmp help". término de búsqueda " pero esto no es demasiado confiable. Buscar la información de las versiones .pdf de la Guía de secuencias de comandos y la Referencia de sintaxis de JSL suele ser más rápido que simplemente confiar en la búsqueda de páginas de ayuda en línea. Si, por ejemplo, trato de encontrar la función Eliminar de usando la búsqueda de la Ayuda de JMP, ni siquiera estará en la lista.
Además, realmente no he usado la función de búsqueda de JMP17, pero creo que no está hecha para propósitos de JSL, ya que está relacionada con el contexto.
Enlaces para parte de la documentación:
Guía de secuencias de comandos (en línea) , Guía de secuencias de comandos (pdf)
Referencia de sintaxis JSL (en línea) , Referencia de sintaxis JSL (pdf)
Formato de índice de secuencias de comandos
¿Es realmente necesario leer "Descripción" para comprender todos los parámetros y lo que se devuelve? ¿Podrían agregarse como sus propias partes en negrita de manera similar a la versión agregada en JMP17?
A continuación se muestra un ejemplo de pintura excepcional con Devoluciones agregado (con las palabras faltantes "una lista"), en el mejor de los casos, también los Argumentos deberían estar allí (y tal vez incluso lanzamientos).
Descripción/formato de la lista de parámetros JMP
¿Hay algo como esto para JSL? Lista de parámetros (Visual Basic) como en ¿Se explica la sintaxis de la lista de parámetros JSL en alguna parte? Cuando comencé a crear secuencias de comandos, estaba bastante confundido por algunos de estos (también me gustaría usar el mismo formato cuando escribo mis propias funciones personalizadas). Por ejemplo, ¿qué significan |, <>, =, etc.? Mis conjeturas: | -> o, <> -> parámetro opcional, = -> valor por defecto.
¿Cómo sabe el usuario lo que debe escribirse en la llamada de función? ¿Cómo sabe el usuario los valores de los parámetros predeterminados? SIN leyendo la descripción cada vez. A continuación hay algunos ejemplos rápidos que conozco:
Contiene():
pos = Contains(x, item, <START>)</START>
La denominación de parámetros definitivamente no es la mejor aquí (¿x?), pero por lo demás está bastante bien. Valor predeterminado para comienzo se define aquí, pero ¿cómo sabe el usuario si comienzo se debe escribir o no? ¿Se puede omitir porque está escrito usando = en lugar de () (lo que lo convertiría en una función?)?
Elementos():
wl = Items(<[first last]>, s, <DELIM>, <INCLUDE boundary="" delimiters="">);
</INCLUDE></DELIM>
¿Valor predeterminado para delim? Deberían Incluir delimitadores de límite estar escrito o no? ¿A qué está predeterminado? Que hace [primero último] ¿significar? No se explica en la documentación (¿qué documentación debo usar...?) Elementos (cadena, , ) incluso falta en Syntax Reference pero se encuentra en Scripting Index.
¿Se eliminará en una versión futura de JMP (por lo que no quiero usarlo) porque falta en la documentación? ¿Se agregó recientemente, por lo que parte de la documentación está desactualizada (por lo que puedo usar, pero no tengo idea de lo que hace sin probarlo).
Maleficio():
h = Hex(value, <"integer">|<ENCODING>|<BASE />,<PAD to="">));
</PAD></ENCODING>
¿Valores predeterminados? Por qué no tengo que escribir codificación , pero tengo que escribir Base y Almohadilla para (al menos basado en el ejemplo de Scripting Index). ¿Puedo ver esto entre corchetes () después del parámetro?
Y hay muchos más ejemplos similares en Scripting Index.
Informes de problemas de documentación de secuencias de comandos
¿Cómo debo informar posibles problemas dentro de Scripting Index (y otra documentación)? La creación de elementos de la lista de deseos o el envío de tickets de soporte está fuera de discusión para esto. No quiero enviar spam a cientos de mensajes a ningún lugar solo para corregir algunos errores tipográficos.
Ejemplo rápido usando Remove From(), para empezar, las descripciones son diferentes en Scripting Index y JSL Syntax Reference y JSL Syntax proporciona más información sobre lo que hace la función, pero carece de ejemplos. Además, las descripciones de las funciones son diferentes en el índice de secuencias de comandos frente a la referencia de sintaxis JSL ... ¿y las funciones deberían comportarse de manera diferente en función de esto?
Quitar de( x, , ) contra Eliminar de (fuente, posición, ) ,
Primero está diciendo que i y n son opcionales, pero por alguna razón i no tiene un valor predeterminado (parece ser -1).
El segundo dice que el segundo argumento es obligatorio y n es opcional sin valor predeterminado.
Índice de secuencias de comandos (¿Se supone que Eliminar de no devuelve nada basado en esto?)
Referencia de sintaxis en línea tiene información incorrecta en Devoluciones (devuelve los artículos eliminados y modifica fuente en su lugar).
