Subscribe Bookmark RSS Feed
aspancake

Community Member

Joined:

May 30, 2014

Tutorial: How to Update Your JMP Textbook Add-In

This guide will walk you through the steps needed to make changes to your JMP textbook add-in. Each of the textbook add-ins use the same general format and can be updated in the same way. Reasons you may wish to change an add-in include:


  • Updating current data sets (skip to step 3)
  • Adding new data sets
  • Removing current data sets
  • Moving current data sets to correct chapter/section
  • Fixing the organizational structure


For clarification purposes, it is important to note the difference between the add-in and the journal. The add-in is a script which launches a journal. The journal is what you are interacting with when you are scrolling through data sets. This process begins by first updating the journal, and then updating the add-in with this revised journal.


Step 1: Open the textbook add-in you wish to update


For this example I will be using Practical Data Analysis with JMP by Robert Carver. In order to open your add-in, you must have it installed. For information in installing add-ins see Step 4.

7504_1_1.png


Step 2: Edit the journal 


By opening your add-in, you are telling JMP to open the journal corresponding to that add-in. Now you can make changes you deem necessary. For example, I am going to show you how to add an additional data set.


2.1: Locate the current location of your data sets.

7508_2.png


2.2: Right click on the location you wish to add your new data set. In this case I will be adding to the ‘All Data Files’ section.


Right Click > Append Item > Add File Reference

7509_3.png

2.3: Locate the file you wish to add. In this case I will be adding a file called ‘Fuse Data.’ It is recommended that you convert your file into JMP format (with a .jmp extension) before adding it to your journal. Instructions on how to import various file types into JMP can be found here.

7510_4.png

2.4: Locate the file you added, it should appear at the bottom of the section you have chosen. Now we need to update where JMP looks to open this data set. If you are updating the add-in for personal use then this step is not necessary. However, if you wish to share the updated add-in with others then this step is essential.


Right Click Data Set > Edit > Set Script

7511_5.png

First, I simply remove the .jmp from the end of the file name. This is how the link to the file will display in the journal. 


The more important change involves adjusting the script that will open the file. The current script is following a path specific to your computer. In order to make the script usable by anyone, simply remove the path in front of the file name (see below) and then click OK.


Before

7512_6.png

After

7513_7.png

We have now added a command in the journal telling JMP to open this file.


Step 3: Add the file to the add-in


Now, we must add the file to the add-in so that the file is installed with the add-in.


3.1:  From the main JMP window, access the add-in file – File > Open > (Locate File) > Open using Add-In Builder

7514_8.png

3.2: Within the add-in builder interface, select the “Additional Files” tab. Here you will find all the files that can be opened with the add-in.

    • To update an existing file: Locate the current version of the file on the list > Highlight > Remove. Now, click ‘Add’ and select the new version of your file and save the file.
    • To add a new file: Add > (Locate the corresponding file) > Save
    • Common Mistake - Make sure you delete the existing journal file (the only file with a .jrn extension.) Then, add the revised journal file which you created in step 2.
    • To remove a file: Highlight file you wish to remove > Remove > Save

7515_9.png

Step 4: Test the add-in


We will now install the updated add-in to make sure that the add-in and the changes are functional.


4.1: From the main JMP window go to File > Open > (Locate Add-In) > Open


This should prompt the following message:

7516_10.png

Click “Install.”


4.2: Now that your add-in has been successfully installed we can open it up directly from the main JMP window. Locate the ‘Add-Ins’ menu select the add-in you have updated. This should open he journal for the add-in.

7517_1_1.png


Click on the links to the files you have changed/added to ensure they are opening properly. If they are not then walk through the steps listed and ensure that there are no errors.


If you have any questions about using these add-ins please contact Mia Stephens mia.stephens.


Note: If you are interested in creating your own add-in see this blog for instructions.

Article Tags
Contributors