Conférencier | Transcription |
| Jean Moore | Salut, merci de m'avoir rejoint. Je m'appelle John Moore et aujourd'hui, nous parlerons de Lupin, un cadre que j'ai développé pour créer, publier, gérer et surveiller les compléments JMP. |
| Alors d'abord juste un tout petit peu sur moi. Je m'appelle John Moore et mes diplômes sont en ingénierie et en gestion, mais je suis vraiment un geek des données dans l'âme. Je travaille chez Elanco Animal Health en tant qu'analyste depuis 19 ans. |
| J'ai un fils, un mari, un chien et, en ce moment, environ 80 000 abeilles. |
| Alors, vous savez, comment en sommes-nous arrivés là ? Eh bien, chez Elanco, nous avons des TC, qui sont des consultants techniques généralement comme des vétérinaires ou des nutritionnistes répartis dans le monde entier, et leur ont fait utiliser JMP et utiliser les scripts JMP. |
| Et bon nombre de ces TC n'ont qu'un accès intermittent à Internet, simplement parce qu'ils sont si éloignés. |
| Nous avions donc en quelque sorte un état où nous avions des scripts ad hoc passant d'une personne à l'autre. Il n'y avait pas de contrôle de version. Il n'y a aucune idée de qui utilise quel script. |
| Et sortir le script était difficile, mettre à jour les scripts était difficile. J'ai donc créé Lupin pour essayer de nous amener à un état où nous avions des scripts standardisés, nous avions un contrôle de version, nous pouvions facilement savoir qui faisait quoi, qui utilisait quels scripts. |
| Nous pouvions facilement distribuer des mises à jour et, en prime, nous avons ajouté quelques formules dans l'éditeur de formules. |
| Alors jetons un coup d'œil à Lupin ici. D'accord, donc une fois que vous aurez installé Lupin, vous verrez s'il n'y a pas grand-chose. Il n'y a qu'un seul menu Lupin sur JMP et vous n'avez qu'à vérifier la mise à jour. |
| Lorsque vous recherchez les mises à jour, vous verrez qu'il répertorie tous les compléments contrôlés par Lupin. |
| Et si ce n'est pas à jour, ça dira à jour. Si c'est à jour. Il va juste dire, d'accord, donc c'est très simple. Juste pour dire, voici les compléments qui sont disponibles. As-tu la version la plus récente ou pas ? |
| Également dans l'éditeur de formules, juste parce que nous nous sommes retrouvés à utiliser beaucoup ces formules particulières, vous savez, comme, mois/année, qui renvoie le premier jour du |
| du mois du de la date lui est passé. Nous avons le trimestre de l'année, nous avons la saison. Nous avons également un compteur de semaine où vous pouvez faire des choses comme le début de la semaine, la fin de la semaine, faire ce genre de choses. |
| Aussi dans Lupin, nous avons une journalisation de l'utilisation. Ainsi, chaque fois qu'un utilisateur utilise un script géré par Lupin, nous créons un fichier journal. Nous savons donc qui a utilisé quel script et quel ajout à quel horodatage. Et cela nous aide vraiment à déterminer lesquels de nos scripts sont utiles et lesquels ne le sont pas. |
| Supposons que vous souhaitiez configurer Lupin dans votre organisation. |
| D'accord, première étape, nous allons télécharger des fichiers zip. Nous avons un fichier zip Lupin, un gestionnaire Lupin et un modèle Lupin. |
| Et nous avons aussi l'exemple de Lupin. Je vous suggère donc de trouver un dossier quelque part et de télécharger simplement les trois qui s'y trouvent. |
| La prochaine chose que vous devez décider en tant que responsable de la configuration est, où vais-je mettre mes dossiers réseau ? Il existe deux dossiers réseau qui sont vraiment importants pour Lupin. |
| La première est que vous ajoutez des dossiers de dépôt. Il s'agit donc d'un dossier qui contiendra tous vos compléments et le fichier PublishedAddins.jmp qui contient des métadonnées sur ces compléments. |
| L'autre auquel nous devons penser est notre dossier de journaux central. Il s'agit donc du dossier qui contiendra tous les fichiers journaux téléchargés que les utilisateurs créent chaque fois qu'ils exécutent un script géré par Lupin. |
| Vous pouvez donc voir ici que nous avons un exemple de tous les compléments que nous avons dans notre fichier de compléments publiés. Et voici juste un exemple de |
| fichiers journaux. Ainsi, chaque fichier journal a un identifiant unique. Et nous en reparlerons plus tard, mais chaque fois que nous entrons et prenons ceux-ci, nous ne prenons que le nouveau pour que vous n'ayez pas à tout télécharger, à chaque fois. |
| Donc, une fois que vous avez décidé où vous voulez les mettre, nous devons dire à Lupin où ils se trouvent. Et la façon dont nous faisons cela est d'aller dans ce dossier Lupin, après l'avoir décompressé, |
| et sous le sous-dossier add in management, vous verrez ce fichier appelé setup et c'est la partie à rechercher dans setup. |
| C'est donc ici que vous définissez notre chemin d'accès au dépôt d'ajout et notre chemin d'accès aux journaux centraux. Maintenant, en production, vous aurez besoin de ces emplacements réseau, mais juste pour ce petit exemple simple, je les ai créés ici sur ma propre machine, mais c'est là que vous définiriez votre chemin réseau. |
| Une fois que vous avez fait cela, il est maintenant temps de créer Lupin pour votre propre organisation. Donc, dans le dossier Lupin, vous voulez tout récupérer sauf si vous avez un fichier gitattributes dedans. J'utilise GitHub Desktop pour gérer mes |
| scripts. Je le recommande fortement. Cela a rendu ma vie tellement meilleure. Mais vous ne voulez pas les mettre dans votre script, alors récupérez tout sauf le fichier gitattributes. Vous allez faire un clic droit dessus, dire envoyer à et |
| envoyez-les dans un dossier zip compressé. Cela créera un fichier zip de tous ceux-ci. Désormais, les fichiers d'ajout JMP ne sont en réalité que des fichiers zip. Donc, ce que nous allons faire, c'est renommer ce Lupin.jmpaddin. |
| Et une fois que vous l'avez nommé, il vous suffit de double-cliquer dessus, et il l'installera. Ensuite, vous aurez Lupin sur votre machine. Maintenant, nous n'allons rien faire avec, mais c'est là. Si vous regardez dans votre barre de menu, vous verrez Lupin. |
| Parlons ensuite de Lupin Manager. Il s'agit d'un ajout distinct conçu pour la personne qui administre, |
| et suivre et mettre à jour tous les compléments au sein d'une organisation. Donc, cela ne sera probablement pas sur la machine de votre utilisateur typique, simplement parce que |
| ce n'est pas utile. Donc, ce qu'il a, c'est une collection d'outils qui vous aideront en tant que gestionnaire à gérer les compléments. |
| La première chose que vous faites lorsque vous ouvrez Lupin Manager est simplement de passer à la configuration, puis nous dirons |
| notre fichier d'utilisateurs uniques, qui récupère tous les utilisateurs uniques de votre organisation et les données de journalisation. |
| OK, donc la table des utilisateurs uniques relie les ID utilisateur. Nous récupérons donc les ID utilisateur de votre ordinateur |
| identité, mais généralement ceux-ci ne disent rien de particulièrement significatif. Comme par exemple, le mien est 00126545. |
| Nous aimerions lier ce quelque chose qui dit John Moore. C'est donc ce que font les utilisateurs uniques. Le fichier de données de journal contient une ligne pour chaque journal. Voici donc un résumé de tous ces fichiers journaux que nous avons créés auparavant. Nous pouvons donc les analyser à notre guise. |
| Bon, disons que vous voulez commencer à utiliser Lupin Manager. |
| La première chose que vous devez faire est de lui dire quels compléments vous souhaitez gérer. Pour ce faire, nous allons créer un complément, puis continuer pour gérer les compléments disponibles. |
| Et puis ce sera vide. Lorsque vous y arrivez, cliquez sur Ajouter un complément et vous pouvez sélectionner les dossiers contenant les fichiers des compléments que vous souhaitez contrôler. |
| Une fois que vous l'avez fait, vous verrez que ceux-ci seront répertoriés dans les compléments disponibles, cliquez sur les compléments de construction. D'accord, vous avez donc deux options ici. Le complément de build va juste créer |
| un fichier complémentaire dans le dossier où se trouvent les scripts, c'est donc idéal pour, par exemple, tester. Je veux faire une construction rapide afin que je puisse tester pour voir si cela fonctionne. |
| La création et la publication feront la même chose, mais elles prendront également ce complément, le copieront dans votre dossier de dépôt de compléments et mettront à jour votre fichier de compléments publiés. C'est donc lorsque vous êtes prêt à le distribuer à l'entreprise, que vous avez fait vos tests, qu'il est prêt à partir. |
| Maintenant, si vous souhaitez importer toutes ces données de journal, tout ce que vous avez à faire est d'importer et de traiter les données de journal et tous les nouveaux fichiers journaux seront importés et ajoutés à votre fichier de données de journal. |
| Nous avons ici un résumé de l'utilisateur, qui n'est qu'un tableau rapide pour dire qui utilise quel complément. Cela vous donne donc une vue très rapide de |
| qui sont mes plus grands utilisateurs dont s'ajoutent. Vous savez ici nous pouvons voir, pour cet exemple, que Lupin et LupinManager ont beaucoup utilisé ; LupinExample1 certains ; LupinExemple, pas tellement. |
| Bon, disons que vous avez installé Lupin, vous avez installé Lupin Manager. Vous avez maintenant quelques compléments que vous aimeriez gérer sous Lupin. Parlons donc des étapes pour cela. |
| La première chose que vous devez faire est d'accéder à ce modèle d'ajout, le fichier de modèle Lupin, que nous avons et de le copier quelque part. Cela contient donc tous les scripts nécessaires et toutes les choses qui font que Lupin fonctionne avec votre complément. Alors allez-y et copiez cela. |
| Ensuite, nous allons en quelque sorte travailler à travers quelques étapes ici. La première est que nous allons éditer le fichier addin.def. |
| Nous allons créer tous les scripts que vous allez avoir dans votre complément ou les mettre à jour si vous avez déjà les scripts. |
| Construire le complément personnalisera les menus, de sorte que le menu ait l'air correct. En supposant que vous cliquez dessus, cela ressemble à ce que vous voulez. Nous allons reconstruire le complément, une fois que nous aurons corrigé le menu afin que nous puissions le tester, assurez-vous qu'il est correct. Une fois les tests terminés, nous pouvons le publier. |
| Parlons donc de ce fichier addin.def ; addin.def est vraiment un tout petit fichier texte, mais il est requis pour chaque complément. Il contient les principales informations importantes sur le complément, |
| quel est son ID et quel est son nom. Vous devrez donc entrer et modifier cela pour le changer en ce que sera le nom de votre complément. |
| Et c'est une chose unique. Une fois que vous avez fait cela, vous ne devriez pas avoir à changer cela pour l'ajout à l'avenir. Donc, c'est juste une fois... vous le faites une fois lorsque vous le configurez. |
| Ensuite, vous devez décider quel script vais-je mettre dans ce complément ? Maintenant, j'ai créé un, |
| Lupin crée un fichier journal. |
| Et c'est ce qui va créer ce fichier journal pour tout ajout qui utilise Lupin. C'est donc ce qui crée réellement les journaux et vous permet de surveiller la version. |
| Je recommande donc de mettre cet en-tête à la fin... au début de tous vos fichiers. Votre script que vous allez utiliser, car c'est ce qui va vous permettre de surveiller les choses. |
| Maintenant que vous avez tous vos scripts là-dedans, la prochaine chose à faire est de donner au fichier de menu l'apparence que vous souhaitez. Pour l'instant, il va juste dire modèles. Donc |
| nous allons d'abord construire cette chose. Donc, tout comme nous avons construit Lupin auparavant, où nous avons tout sélectionné sauf les fichiers gitattributes, cliquez avec le bouton droit, zip, changez le nom. |
| Nous allons faire la même chose. Et puis nous aurons le mauvais menu, car pour le moment, il a toujours ce menu modèle. Nous devons donc entrer et mettre à jour ce menu de modèles pour faire ce que nous voulons faire. |
| D'accord, donc une fois que vous l'avez installé, vous savez, vous verrez en quelque sorte votre nouveau script ici, votre nouveau complément ici, votre modèle. Nous allons faire un clic droit |
| dans le menu et vous verrez cette longue liste. Et tout en bas, nous verrons personnaliser et tout ce que nous voulons faire, c'est aller dans les menus et les barres d'outils. D'accord, une fois que nous y serons, vous verrez quelque chose comme ça. |
| Nous, la première chose que nous devons faire est de dire à JMP, eh bien, ce que nous voulons éditer. Nous voulons modifier le menu associé à notre complément particulier, qui s'appelle actuellement modèle. |
| Nous allons donc remonter jusqu'à ce bouton de modification. Cliquez dessus et nous avons une multitude de choix ici. Mais ce que nous voulons faire, c'est cliquer sur le bouton radio des compléments JMP ici, puis descendre à |
| l'ajout qui nous intéresse. D'accord. Maintenant, ici, je viens de laisser ceci comme modèle, mais si vous ... puisque vous l'avez déjà modifié dans le fichier addin.def, ce sera ce que c'est. |
| Une fois que vous faites cela, ce que vous allez voir, ce sont les morceaux |
| qui appartiennent à votre complément vont apparaître en bleu sur la gauche ici. |
| C'est donc ce que nous allons modifier et modifier pour en faire ce que nous voulons pour notre nouveau complément. |
| Jetons donc un coup d'œil à cela. J'ai inclus le propos dans les nouveautés en tant que scripts standard, mais lorsque vous l'obtenez, ce que vous verrez, c'est qu'il pointe vers |
| ce modèle s'ajoute, ce qui n'est pas ce que vous voulez. Vous avez votre propre nom d'ajout que vous voulez. Donc, ce que nous allons faire, c'est cliquer sur le run add dans ce fichier. |
| Cliquez sur ce dossier d'ajout d'utilisation, puis sélectionnez cet ajout que vous voulez ici. Cela va donc pointer JMP vers les nouveaux scripts que vous venez de créer. Et puis nous pouvons cliquer sur Parcourir. |
| Et puis nous pouvons parcourir et naviguer et aller à ce script particulier que nous voulons et dire, "Non, non, je ne veux pas l'utiliser dans le modèle. Je veux que vous l'utilisiez dans mon nouveau complément." |
| De même, nous pouvons faire la même chose avec l'élément nouveautés du menu. |
| Et une fois que vous les avez faites, il s'agit simplement de mettre le reste que nous voulons. |
| Si vous faites un clic droit sur la zone bleue, vous verrez ces options pour insérer avant, insérer après, où vous pouvez ajouter ou supprimer des éléments de votre menu. |
| Vous pouvez donc ajouter des choses, la plupart d'entre elles seront des commandes. Vous pouvez également faire un sous-menu pour qu'il puisse aller plus loin, ou vous pouvez mettre un séparateur là où il fait une belle petite ligne là-bas. |
| Et donc vous allez construire votre menu, y mettre tous les éléments que vous... pour les scripts que vous venez de créer. |
| Et puis on va le sauver, mais on va le sauver deux fois. |
| Lorsque vous l'enregistrez ici, cela ne fera que le modifier dans la version du complément installé sur votre machine. |
| Et c'est bien, mais ce que nous aurions également besoin de faire, c'est de l'enregistrer dans le dossier où vous construisez le complément. Nous devons donc l'enregistrer ici pour que la prochaine fois que nous construisons le complément, il ait le bon fichier de menu. |
| Ainsi, après avoir cliqué sur Enregistrer, nous allons cliquer sur Enregistrer sous et accéder au dossier contenant nos fichiers complémentaires. |
| Bon, nous avons donc nos scripts. Nous avons défini notre addin.def, nous avons élaboré notre menu. |
| La prochaine chose que nous devons faire est de construire cette chose et de la tester. Donc, généralement, je l'enverrai aux utilisateurs. Ils peuvent me dire ce qui fonctionne, ce qui ne fonctionne pas. |
| Après cela, je peux entrer et le publier. Ainsi, lorsque vous entrez et publiez, cela vous demandera de dire, mettez à jour les informations. |
| La chose la plus importante, et c'est dans Lupin Manager, la chose la plus importante est de changer la date de sortie. C'est donc ce qui permet aux gens de savoir qu'il existe un courant plus |
| version disponible, à droite. Donc, ce qui va se passer, c'est que cela est comparé à la date qui n'a pas été publiée, et c'est ce que Lupin va utiliser et dire, hé, il y a une version plus récente à télécharger. |
| Ainsi, vous pouvez également y ajouter des notes comme des notes de révision. Ce sont les choses que j'ai changées cette fois. Ce sont les grandes mises à jour et les choses que j'ai faites pour mon complément. Et une fois que vous faites cela, si vous cliquez sur Publier, |
| alors Lupin Manager prendra une copie de ce complément, le placera dans le dossier qui crée le complément, où vous avez le code source. |
| Il le publiera également dans le dépôt de compléments et mettra à jour le fichier de compléments publié pour disposer de la version la plus récente, |
| qui plus important encore, votre date de sortie en elle. Et puis quand, si vous, si un utilisateur cliquait sur vérifier les mises à jour, il dirait, hé, ce complément a une nouvelle version disponible, voudriez-vous le télécharger ? Ils peuvent cliquer dessus et ça va l'installer, ce sera sur votre machine... sur leur machine. |
| D'accord, c'était une très brève introduction. |
| J'espère qu'il y a suffisamment de matériel ici pour que vous puissiez le faire vous-même. Sinon, veuillez me contacter à john_moore@elanco.com. Je suis heureux de vous aider à mettre cela en place. |
| Merci beaucoup, et encore merci. Bye Bye. |
