Disclaimer:
Questo sarà un post abbastanza lungo e ci è voluto un bel po' di tempo per scriverlo. Sarà anche un po' destrutturato poiché ho aggiunto altre cose quando mi sono venute in mente mentre lo scrivevo. Queste sono tutte le mie (forti) opinioni basate sui miei pochi anni (4) di utilizzo di JMP. Ho anche un elenco di problemi con la pagina della Guida in linea di JMP, ma cerco di evitare la maggior parte di quel feedback qui.
JMP Scripting Index è un grande (e necessario) aiuto durante la scrittura di script JMP. Lo uso persino come ricerca generale per le funzionalità di JMP. Dividerò questo post in un paio di sezioni diverse e potrei creare gli elementi della Lista dei desideri in base alla discussione qui.
Indice di scripting, guida di JMP, guida di scripting e riferimento alla sintassi JSL
Su quale documentazione devo fare affidamento? Tutti questi forniscono informazioni diverse/stesse in formato diverso/stesso. Inoltre a volte hanno informazioni contrastanti (vedi Items() sotto per esempio). Vorrei che JSL Syntax Reference e Scripting Index avessero le stesse informazioni. Ad esempio, attualmente Scripting Index è privo di argomenti e informazioni restituite e devi decrittografarle dalla descrizione.
Anche l'esperienza nell'utilizzo della ricerca della versione online della Guida di JMP è piuttosto negativa. L'unico modo affidabile per usarlo che ho trovato è trovare prima la funzione/caratteristica da Scripting Index e sperare che tu abbia il pulsante Guida funzionante o in alcuni casi Ricerca Google con "jmp help termine di ricerca " ma questo non è troppo affidabile. La ricerca delle informazioni dalle versioni .pdf di Scripting Guide e JSL Syntax Reference è in genere più veloce rispetto alla semplice ricerca nelle pagine della guida in linea. Se, ad esempio, provo a trovare la funzione Rimuovi da utilizzando la ricerca della Guida di JMP, non sarà nemmeno nell'elenco.
Inoltre non ho davvero utilizzato la funzione di ricerca di JMP17, ma penso che non sia stata creata per scopi JSL poiché è correlata al contesto.
Link per parte della documentazione:
Guida allo scripting (online) , Guida agli script (pdf)
Riferimento alla sintassi JSL (online) , Riferimento alla sintassi JSL (pdf)
Formato dell'indice di scripting
È davvero necessario leggere "Descrizione" per comprendere tutti i parametri e cosa viene restituito? Potrebbero essere aggiunti come parti in grassetto in modo simile alla versione aggiunta in JMP17?
Di seguito è riportato un eccezionale esempio di vernice con ritorna aggiunto (con le parole mancanti "un elenco"), nel migliore dei casi dovrebbero esserci anche gli argomenti (e forse anche i tiri).
Descrizione/formato dell'elenco dei parametri JMP
C'è qualcosa di simile per JSL Elenco dei parametri (Visual Basic) come nella sintassi dell'elenco dei parametri JSL spiegata da qualche parte? Quando ho iniziato a scrivere script ero abbastanza confuso da alcuni di questi (anche io vorrei usare lo stesso formato quando scrivo le mie funzioni personalizzate). Ad esempio cosa significano |, <>, = e così via? Le mie supposizioni: | -> o, <> -> parametro facoltativo, = -> valore predefinito.
Come fa l'utente a sapere cosa deve essere scritto nella chiamata di funzione? In che modo l'utente conosce i valori dei parametri predefiniti PRIVO DI leggendo la descrizione ogni volta. Di seguito sono riportati alcuni esempi rapidi che conosco:
Contiene():
pos = Contains(x, item, <START>)</START>
La denominazione dei parametri non è sicuramente la migliore qui (x?) ma per il resto è abbastanza ok. Valore predefinito per inizio è definito qui, ma come fa l'utente a sapere se inizio dovrebbe essere scritto o no? Può essere saltato perché è scritto usando = invece di () (che lo renderebbe una funzione?)?
Elementi():
wl = Items(<[first last]>, s, <DELIM>, <INCLUDE boundary="" delimiters="">);
</INCLUDE></DELIM>
Valore predefinito per delim? Dovrebbero Includi delimitatori di confine essere scritto o no? A cosa è predefinito? Cosa fa [primo ultimo] significare? Non è spiegato nella documentazione (quale documentazione dovrei usare...?) Items(string, , ) manca persino da Syntax Reference ma è stato trovato da Scripting Index.
Viene rimosso nella versione futura di JMP (quindi non voglio usarlo) perché manca dalla documentazione? È stato aggiunto di recente, quindi parte della documentazione è semplicemente obsoleta (quindi posso usarla ma non ho idea di cosa faccia senza provarla).
Esadecimale():
h = Hex(value, <"integer">|<ENCODING>|<BASE />,<PAD to="">));
</PAD></ENCODING>
Valori standard? Perché non devo scrivere codifica , ma devo scrivere Base e Pad a (almeno basato sull'esempio di Scripting Index). Posso vederlo dalle parentesi () dopo il parametro?
E ci sono molti altri esempi simili in Scripting Index.
Segnalazione dei problemi relativi alla documentazione di scripting
Come devo segnalare possibili problemi all'interno di Scripting Index (e altra documentazione)? La creazione di elementi della lista dei desideri o l'invio di ticket di supporto è fuori discussione per questo. Non voglio spammare centinaia di messaggi in nessuno dei due posti solo per correggere alcuni errori di battitura.
Esempio rapido utilizzando Remove From(), per cominciare le descrizioni sono diverse in Scripting Index e JSL Syntax Reference e JSL Syntax fornisce maggiori informazioni su cosa fa la funzione ma manca di esempi. Anche le descrizioni delle funzioni sono diverse in Scripting Index rispetto a JSL Syntax Reference ... e le funzioni dovrebbero comportarsi in modo diverso in base a questo?
Rimuovi da( x, , ) vs Rimuovi da(fonte, posizione, ) ,
Il primo è dire che i e n sono facoltativi, ma per qualche motivo i non ha un valore predefinito (sembra essere -1).
Il secondo dice che il secondo argomento è obbligatorio e n è facoltativo senza valore predefinito.
Indice di scripting (Remove From non dovrebbe restituire nulla in base a questo?)
Riferimento sintattico in linea ha informazioni errate sui resi (restituisce gli articoli rimossi e modifica fonte a posto).
