| Oratore |
Trascrizione |
| John Moore |
Ciao, grazie per essere qui con me. Mi chiamo John Moore e oggi parleremo di Lupine, un framework che ho sviluppato per creare, pubblicare, gestire e monitorare i componenti aggiuntivi JMP. |
| |
Innanzitutto, due parole su di me. Mi chiamo John Moore e ho una laurea in ingegneria e management, ma in realtà sono un appassionato di dati. Lavoro presso Elanco Animal Health come analista da 19 anni. |
| |
Ho un figlio, un marito, un cane e, al momento, circa 80.000 api. |
| |
Quindi, come siamo arrivati a questo punto? Beh, in Elanco abbiamo dei TC, consulenti tecnici in genere come veterinari o nutrizionisti sparsi in tutto il mondo, che abbiamo fatto usare loro JMP e il suo scripting. |
| |
E molti di questi TC hanno accesso a Internet solo in modo intermittente, semplicemente perché sono molto remoti. |
| |
Quindi eravamo in un certo senso in una situazione in cui gli script venivano trasmessi da persona a persona. Non c'era alcun controllo di versione. Non si sapeva chi stesse usando quale script. |
| |
E pubblicare gli script era difficile, aggiornarli era complicato. Così ho creato Lupine per cercare di arrivare a uno stato in cui avessimo script standardizzati, avessimo il controllo di versione, potessimo sapere facilmente chi stava facendo cosa, chi stava usando quali script. |
| |
Abbiamo potuto distribuire facilmente gli aggiornamenti e, come ulteriore vantaggio, abbiamo inserito un paio di formule nell'editor delle formule. |
| |
Diamo un'occhiata a Lupine. Ok, una volta installato Lupine, vedrai che non c'è molto da fare. C'è solo un menu Lupine su JMP e hai solo la possibilità di controllare gli aggiornamenti. |
| |
Quando controlli gli aggiornamenti, vedrai che sono elencati tutti i componenti aggiuntivi controllati da Lupine. |
| |
E se non è aggiornato, dirà "aggiornato". Se è aggiornato, dirà semplicemente: "Ok, è molto semplice". Ecco i componenti aggiuntivi disponibili. Hai la versione più recente o no? |
| |
Anche nell'editor di formule, semplicemente perché ci siamo ritrovati a usare molto queste formule particolari, sai, come mese/anno, che restituisce il primo giorno del |
| |
del mese in cui la data è passata. Abbiamo il trimestre dell'anno, abbiamo la stagione. Abbiamo anche il contatore della settimana, dove puoi fare cose come l'inizio della settimana, la fine della settimana, e cose del genere. |
| |
Anche in Lupine abbiamo la registrazione dell'utilizzo. Ogni volta che un utente utilizza uno script gestito da Lupine, creiamo un file di log. In questo modo sappiamo chi ha utilizzato quale script e quale componente aggiuntivo in quale timestamp. Questo ci aiuta davvero a capire quali dei nostri script sono utili e quali no. |
| |
Supponiamo che tu voglia installare Lupine nella tua organizzazione. |
| |
Bene, per prima cosa scaricheremo alcuni file zip. Abbiamo un file zip di Lupine, un gestore di Lupine e un template di Lupine. |
| |
E abbiamo anche l'esempio di Lupine. Quindi ti consiglio di trovare una cartella da qualche parte e di scaricare lì tutti e tre. |
| |
La prossima cosa che devi decidere come manager che imposta tutto questo è: dove collocherò le mie cartelle di rete? Ci sono due cartelle di rete che sono davvero importanti per Lupine. |
| |
La prima è che aggiungi le cartelle depot. Questa è una cartella che conterrà tutti i tuoi componenti aggiuntivi e il file PublishedAddins.jmp che contiene i metadati relativi a tali componenti aggiuntivi. |
| |
L'altro aspetto a cui dobbiamo pensare è la nostra cartella centrale dei log. Questa è la cartella che conterrà tutti i file di log caricati che gli utenti creano ogni volta che eseguono uno script gestito da Lupine. |
| |
Quindi puoi vedere qui, abbiamo un esempio di tutti i componenti aggiuntivi che abbiamo nel nostro file dei componenti aggiuntivi pubblicati. Ed ecco solo un esempio di |
| |
File di registro. Ogni file di registro ha un ID univoco. Ne parleremo più avanti, ma ogni volta che li scarichiamo, scarichiamo solo quello nuovo, così non dovrete scaricare tutto ogni volta. |
| |
Quindi, una volta deciso dove metterli, dobbiamo dire a Lupine dove si trovano. E il modo per farlo è andare nella cartella di Lupine, dopo averla decompressa, |
| |
e nella sottocartella di gestione dei componenti aggiuntivi, vedrai questo file chiamato setup e questa è la parte da cercare nel setup. |
| |
Ecco dove definire il percorso del nostro deposito aggiuntivo e il percorso dei log centrali. Ora, in produzione, avrai bisogno di questi percorsi di rete, ma solo per questo piccolo e semplice esempio, li ho creati solo sulla mia macchina qui, ma è qui che dovresti definire il tuo percorso di rete. |
| |
Una volta fatto questo, è il momento di compilare Lupine per la tua organizzazione. Quindi, nella cartella Lupine, devi prendere tutto, tranne il file gitattributes. Io uso GitHub Desktop per gestire il mio |
| |
script. Lo consiglio vivamente. Mi ha migliorato la vita. Ma non metterli nello script, quindi prendi tutto tranne il file gitattributes. Fai clic destro su di essi, dici "Invia a" e |
| |
Inviali a una cartella zip compressa. Questo creerà un file zip con tutti i file. Ora, i file aggiuntivi JMP sono in realtà solo file zip. Quindi, quello che faremo è rinominarlo Lupine.jmpaddin. |
| |
E una volta che gli hai dato un nome, ti basta fare doppio clic su quella cosa e verrà installata. A questo punto avrai Lupine sul tuo computer. Non ci faremo ancora nulla, ma è lì. Se guardi in alto nella barra dei menu, vedrai Lupine. |
| |
Ora parliamo di Lupine Manager. Si tratta di un componente aggiuntivo separato, progettato per chi amministra, |
| |
e tenere traccia e aggiornare tutti i componenti aggiuntivi all'interno di un'organizzazione. Quindi probabilmente non sarà disponibile sul computer del tuo utente tipico, semplicemente perché |
| |
Non è utile. Quindi, quello che offre è una raccolta di strumenti che ti aiuteranno... come manager a gestire i componenti aggiuntivi. |
| |
La prima cosa che fai quando apri Lupine Manager è semplicemente andare su Impostazioni e poi diremo |
| |
il nostro file utenti univoci, che contiene tutti gli utenti univoci della tua organizzazione e i dati di registro. |
| |
OK, quindi la tabella utente univoca collega gli ID utente. Quindi stiamo prendendo gli ID utente dal tuo computer |
| |
identità, ma di solito non dicono nulla di particolarmente significativo. Ad esempio, il mio è 00126545. |
| |
Vorremmo collegare qualcosa che dice John Moore. Ecco cosa fa l'utente univoco. Il file di dati di log ha una riga per ogni log. Questo è un riepilogo di tutti i file di log che abbiamo creato in precedenza. Così possiamo analizzarli a nostro piacimento. |
| |
Bene, supponiamo che tu voglia iniziare a utilizzare Lupine Manager. |
| |
La prima cosa da fare è specificare quali componenti aggiuntivi si desidera gestire. Per farlo, andiamo su "Crea componente aggiuntivo", poi andiamo su "Gestisci componenti aggiuntivi disponibili". |
| |
A questo punto, questa sezione sarà vuota. Una volta aperta, clicca su "Aggiungi componente aggiuntivo" e potrai selezionare le cartelle che contengono i file dei componenti aggiuntivi che vuoi mettere sotto controllo. |
| |
Una volta fatto, vedrai che saranno elencati tra i componenti aggiuntivi disponibili, clicca su "Crea componenti aggiuntivi". Bene, quindi hai due opzioni qui. "Crea componente aggiuntivo" creerà semplicemente |
| |
Un file aggiuntivo nella cartella in cui si trovano gli script, quindi è ottimo per fare dei test. Voglio fare una build veloce per testare se funziona. |
| |
"Build and publish" farà la stessa cosa, ma prenderà il componente aggiuntivo, lo copierà nella cartella "Add-in Depot" e aggiornerà il file dei componenti aggiuntivi pubblicati. A questo punto, sarai pronto a distribuirlo all'azienda, avrai completato i test e sarà pronto per l'uso. |
| |
Ora, se vuoi importare tutti i dati di registro, tutto ciò che devi fare è andare su Importa ed elabora i dati di registro; tutti i nuovi file di registro verranno importati e aggiunti al tuo file di dati di registro. |
| |
Abbiamo qui un riepilogo utente, che è solo una rapida tabella per dire chi sta utilizzando quale componente aggiuntivo. Quindi questo ti dà una visione molto rapida di |
| |
Chi sono i miei maggiori utilizzatori di quale componente aggiuntivo? Come puoi vedere, in questo esempio, Lupine e LupineManager sono stati usati molto; LupineExample1 un po'; LupinExample, non così tanto. |
| |
Ok, supponiamo che tu abbia installato Lupine e Lupine Manager. Ora hai alcuni componenti aggiuntivi che vorresti gestire con Lupine. Vediamo i passaggi da seguire. |
| |
La prima cosa che devi fare è andare al template del componente aggiuntivo, il file template di Lupine, e copiarlo da qualche parte. Questo contiene tutti gli script necessari e tutto ciò che fa funzionare Lupine con il tuo componente aggiuntivo. Quindi, copialo. |
| |
Ora procederemo con alcuni passaggi. Il primo consiste nel modificare il file addin.def. |
| |
Creeremo tutti gli script che avrai nel tuo componente aggiuntivo oppure li aggiorneremo se li hai già. |
| |
Integrare il componente aggiuntivo personalizzerà i menu, in modo che il menu abbia l'aspetto desiderato. Supponendo che ci clicchiate sopra, apparirà come desiderate. Integraremo nuovamente il componente aggiuntivo una volta sistemato il menu, in modo da poterlo testare e assicurarci che sia corretto. Una volta completati i test, potremo pubblicarlo. |
| |
Parliamo quindi di questo file addin.def; addin.def è in realtà un piccolo file di testo, ma è necessario per ogni componente aggiuntivo. Contiene le informazioni principali importanti sul componente aggiuntivo, |
| |
Qual è il suo ID e qual è il suo nome? Quindi dovrai modificarlo per cambiare il nome del tuo componente aggiuntivo. |
| |
E questa è una cosa che fai una volta sola. Una volta fatto questo, non dovresti più dover modificare questa impostazione per il componente aggiuntivo. Quindi è una cosa che fai una volta sola... quando lo configuri. |
| |
Ora devi decidere quale script inserirò in questo componente aggiuntivo. Ora ho creato un, |
| |
File di registro di creazione di Lupine. |
| |
Ed è questo che creerà il file di registro per qualsiasi componente aggiuntivo che utilizza Lupine. Quindi è questo che crea effettivamente i registri e consente di monitorare la versione. |
| |
Quindi consiglio di mettere questa intestazione alla fine...all'inizio di tutti i file. Lo script che userai, perché è ciò che ti permetterà di monitorare tutto. |
| |
Ora, hai tutti gli script lì dentro, la prossima cosa che devi fare è dare al file del menu l'aspetto che desideri. Per ora, ci sarà solo la dicitura "modelli". Quindi |
| |
Per prima cosa, costruiremo questa cosa. Proprio come abbiamo fatto con Lupine prima, dove abbiamo selezionato tutto tranne i file gitattributes, fatto clic destro, compresso, cambiato nome. |
| |
Faremo la stessa cosa. E poi avremo il menu sbagliato, perché al momento ha ancora quel menu modello. Quindi dobbiamo entrare e aggiornare quel menu modello per fare ciò che vogliamo. |
| |
Ok, quindi una volta installato, vedrai il tuo nuovo script qui sopra, il tuo nuovo componente aggiuntivo qui sopra, il modello. Faremo clic con il pulsante destro del mouse |
| |
In alto nel menu vedrai questo lungo elenco. E in fondo, vedremo "Personalizza" e tutto ciò che vogliamo fare è andare su "Menu" e "Barre degli strumenti". Bene, una volta lì vedrai qualcosa di simile a questo. |
| |
La prima cosa che dobbiamo fare è dire a JMP cosa vogliamo modificare. Vogliamo modificare il menu associato al nostro componente aggiuntivo, che al momento si chiama template. |
| |
Quindi andiamo su questo pulsante di modifica. Cliccandoci sopra avremo una vasta gamma di opzioni. Ma quello che vogliamo fare è cliccare sul pulsante di opzione "Componenti aggiuntivi JMP" qui e poi andare giù a |
| |
il componente aggiuntivo che ci interessa. Okay. Ora, ecco, ho lasciato questo come modello, ma se tu... dato che l'hai già modificato nel file addin.def, rimarrà quello che è. |
| |
Una volta fatto questo, quello che vedrai saranno i pezzi e i frammenti |
| |
che appartengono al tuo componente aggiuntivo verranno visualizzati in blu sulla sinistra. |
| |
Ecco cosa modificheremo e cambieremo per ottenere ciò che desideriamo per il nostro nuovo componente aggiuntivo. |
| |
Diamo un'occhiata a questo. Ho incluso la sezione Informazioni nelle Novità come script standard, ma quando lo otterrai, quello che vedrai è che punta a |
| |
Questo componente aggiuntivo del modello, che non è quello che desideri. Hai già un nome per il componente aggiuntivo che ti interessa. Quindi, quello che faremo è cliccare su "Esegui componente aggiuntivo in questo file". |
| |
Fai clic su questa cartella "Usa componenti aggiuntivi" e seleziona il componente aggiuntivo desiderato. In questo modo JMP indirizzerà i nuovi script appena creati. A questo punto possiamo fare clic su "Sfoglia". |
| |
E poi possiamo navigare, andare a quello script specifico che vogliamo e dire: "No, no, non voglio usarlo nel modello uno. Voglio che tu lo usi nel mio nuovo componente aggiuntivo". |
| |
Allo stesso modo, possiamo fare la stessa cosa con la voce "Novità" nel menu. |
| |
E una volta fatto questo, in realtà non ci resta che aggiungere tutto il resto che vogliamo. |
| |
Se fai clic con il tasto destro del mouse sull'area blu, vedrai queste opzioni per Inserisci prima, Inserisci dopo, dove puoi aggiungere o eliminare elementi dal tuo menu. |
| |
Quindi puoi aggiungere cose, la maggior parte delle quali saranno comandi. Puoi anche creare un sottomenu per approfondire, oppure puoi inserire un separatore dove crea una bella lineetta. |
| |
Quindi creerai il tuo menu, inserirai tutti gli elementi che...per gli script che hai appena creato. |
| |
E poi lo salveremo, ma lo salveremo due volte. |
| |
Quando lo salvi qui, ciò che farà sarà semplicemente modificarlo nella versione del componente aggiuntivo installata sul tuo computer. |
| |
E questo è positivo, ma quello che dovremmo fare è salvarlo nella cartella in cui stiamo compilando il componente aggiuntivo. Quindi dobbiamo salvarlo lì, così la prossima volta che compileremo il componente aggiuntivo, avrà il file di menu corretto. |
| |
Dopo aver cliccato su Salva, cliccheremo su Salva con nome e andremo alla cartella che contiene i file del componente aggiuntivo. |
| |
Bene, abbiamo i nostri script. Abbiamo definito il nostro addin.def e abbiamo elaborato il nostro menu. |
| |
La prossima cosa che dobbiamo fare è effettivamente sviluppare questa cosa e testarla. Quindi, in genere, la mando agli utenti. Loro possono dirmi cosa funziona e cosa no. |
| |
Dopodiché, posso entrare e pubblicarlo effettivamente. Quindi, quando entri e pubblichi, ti verrà chiesto di aggiornare le informazioni. |
| |
La cosa più importante, e questo vale per Lupine Manager, è cambiare la data di rilascio. Questo è ciò che fa sapere alle persone che c'è una versione più aggiornata. |
| |
versione disponibile, giusto. Quindi... quello che succederà è che questo verrà confrontato con la data di pubblicazione, e questo è ciò che Lupine userà e dirà, ehi, c'è una versione più recente che puoi caricare. |
| |
Quindi puoi anche aggiungere note, come note di revisione. Queste sono le cose che ho cambiato questa volta. Questi sono gli ottimi aggiornamenti e le cose che ho apportato al mio componente aggiuntivo. E una volta fatto, se clicchi su Pubblica, |
| |
quindi Lupine Manager prenderà una copia di quel componente aggiuntivo e la metterà nella cartella che crea il componente aggiuntivo, dove si trova il codice sorgente. |
| |
Lo pubblicherà anche nel deposito dei componenti aggiuntivi e aggiornerà il file dei componenti aggiuntivi pubblicati per avere la versione più recente, |
| |
E, cosa più importante, la data di rilascio. E poi, se un utente cliccasse su "Verifica aggiornamenti", gli direbbe: "Ehi, questo componente aggiuntivo ha una nuova versione disponibile, vuoi scaricarla?". Potrebbe cliccare e verrà installato, sarà sul tuo computer... sul loro computer. |
| |
Ok, questa è stata un'introduzione davvero breve. |
| |
Spero che ci sia abbastanza materiale qui per permetterti di farlo da solo. In caso contrario, contattami all'indirizzo john_moore@elanco.com. Sarò felice di aiutarti a configurare il tutto. |
| |
Grazie mille, e ancora grazie. Ciao ciao. |
