パス変数は、ディレクトリやファイルへのショートカットです。ディレクトリやファイルへのパス全体を入力する代わりに、JSLスクリプト内でパス変数を使用できます。パス変数は特殊な文字列であり、常に二重引用符で囲んで使用します。
JMPで広く使用される定義済みのパス変数の1つに$SAMPLE_DATAがあります。この変数はJMPまたはJMP Proインストールフォルダ内のサンプルデータのフォルダを指します。次の例は、「Big Class.jmp」サンプルデータテーブルを開きます。
Open( "$SAMPLE_DATA/Big Class.jmp" );
JMPではいくつかのパス変数が定義済みです。次の表は、現在のJMPバージョンの定義をまとめたものです。旧バージョンのJMPの変数はこれとは異なる場合があります。
|
変数 |
Path |
|---|---|
|
ADDIN_HOME(com.your.addin.id) 指定されたアドインが保存されているフォルダを定義します。 |
アドインビルダーは、指定されたアドインを、オペレーティングシステムの種類に基づいて次のフォルダに保存します。 • Windows: C: ¥ユーザー¥<ユーザ名>¥AppData¥Roaming¥JMP¥JMP¥Addins • Apple macOS: /Users/<ユーザ名>/Library/Application Support/JMP/Addins たとえば、Convert File Path( "$ADDIN_HOME(com.your.addin.id)" )は、結果がcom.your.addin.idアドインの場所になります。 アドインを共有ネットワークにインストールするには、Register Addin()関数を使用します。JSLを使ったアドインの登録を参照してください。 |
|
ALL_HOME マシン上のすべてのユーザがアクセスできるフォルダを定義します。 |
• Windows（JMP）: C:¥ProgramData¥JMP¥JMP¥19 • Windows（JMP Pro）: C:¥ProgramData¥JMP¥JMPPro¥19 • Apple macOS: /Library/Application Support/JMP/19 ディレクトリが存在するかどうかを確認するには、Is Directory("$ALL_HOME");スクリプトを実行します。フォルダが存在する場合は、1が戻されます。 |
|
BUILTIN_SCRIPTS |
• Windows（JMP）: C:¥Program Files¥JMP¥JMP¥19¥Resources¥Builtins • Windows（JMP Pro）: C:¥Program Files¥JMP¥JMPPRO¥19¥Resources¥ • Apple macOS: /Applications/JMP 19.app/Contents/Resources/Builtins |
|
DESKTOP |
• Windows: C:¥ユーザー¥<ユーザ名>¥Desktop • Apple macOS: /ユーザ/<ユーザ名>/Desktop/ |
|
DOCUMENTS |
• Windows: C:¥ユーザー¥<ユーザ名>¥Documents • Apple macOS: /ユーザ/<ユーザ名>/Documents/ |
|
DOWNLOADS |
• Windows: C:¥ユーザー¥<ユーザ名>¥Downloads • Apple macOS: /ユーザ/<ユーザ名>/Downloads/ |
|
GENOMICS_HOME |
/<JMP Genomicsのインストールディレクトリ> |
|
HOME |
• Windows（JMP）: • Windows（JMP Pro）: • Apple macOS: /ユーザ/<ユーザ名>/ |
|
JMP_HOME |
• Windows: C:¥<JMPのインストールディレクトリ> メモ: この変数はApple macOSでは使用できません。 |
|
SAMPLE_APPS |
• Windows: C:¥<JMPのインストールディレクトリ>¥Samples¥Apps • Apple macOS: /Library/Application Support/JMP/19/Samples/Apps/ |
|
SAMPLE_DASHBOARDS |
• Windows: C:¥<JMPのインストールディレクトリ>¥Samples¥Dashboards • Apple macOS: /Library/Application Support/JMP/19/Samples/Dashboards |
|
SAMPLE_DATA |
• Windows: C:¥<JMPのインストールディレクトリ>¥Samples¥Data • Apple macOS: /Library/Application Support/JMP/19/Samples/Data/ |
|
SAMPLE_IMAGES |
• Windows: C:¥<JMPのインストールディレクトリ>¥Samples¥Images • Apple macOS: /Library/Application Support/JMP/19/Samples/Images |
|
SAMPLE_IMPORT_DATA |
• Windows: C:¥<JMPのインストールディレクトリ>¥Samples¥Import Data • Apple macOS: /Library/Application Support/JMP/19/Samples/Import Data |
|
SAMPLE_PROJECTS |
• Windows: C:¥<JMPのインストールディレクトリ>¥Samples¥Projects • Apple macOS: /Library/Application Support/JMP/19/Samples/Projects |
|
SAMPLE_SCRIPTS |
• Windows: C:¥<JMPのインストールディレクトリ>¥Samples¥Scripts • Apple macOS: /Library/Application Support/JMP/19/Samples/Scripts |
|
SAMPLE_WORKFLOWS |
• Windows: C:¥<JMPのインストールディレクトリ>¥Samples¥Workflows • Apple macOS: /Library/Application Support/JMP/19/Samples/Workflows |
|
TEMP |
• Windows: C:¥ユーザー¥<ユーザ名>¥AppData¥Local¥Temp • Apple macOS: var/folders/... |
|
USER_APPDATA JMP環境設定やメニュー、ホームウィンドウに加えた変更、およびデバッガセッションの設定がここに保存されます。 |
• Windows（JMP）: • Windows（JMP Pro）: • Apple macOS: /ユーザ/<ユーザ名>/Library/Application Support/JMP/19 |
パス変数の定義は、使用しているJMPのバージョンに応じたものとなります。たとえば、JMP 14で作成されたスクリプトであっても、JMP 19で実行した場合は、JMP 19におけるパス変数の定義が使用されます。
パス変数の定義を確認するには、Get Path Variable関数を使用します。
Get Path Variable( "HOME" );
"/C:/Users/<ユーザ名>/AppData/Roaming/JMP/JMP/19/"
Set Path Variable()またはGet Path Variable()にはドル記号は指定しません。ただし、スクリプト内で変数を使用する際には、ドル記号を指定する必要があります。
パスの指定にパス変数を使用する場合は、パス変数の末尾にスラッシュを付けてください。次の例では、dtName変数に"Big Class"というルート名が割り当てられています。Open()式は、$SAMPLE_DATAと末尾のスラッシュを評価し、dtNameの値とファイル拡張子の.jmpを付加します。
dtName = "Big Class";
dt = Open( "$SAMPLE_DATA/" || dtName || ".jmp" );
このパスは、次のように解釈されます。
C:¥Program Files¥JMP¥JMP¥19¥Samples¥Data¥Big Class.jmp
$SAMPLE_DATAの後にスラッシュがない場合、パスは次のように解釈されます。
C:¥Program Files¥JMP¥JMP¥19¥Samples¥DataBig Class.jmp