パス変数は、ディレクトリやファイルへのショートカットです。ディレクトリやファイルへのパス全体を入力する代わりに、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:¥Users¥<ユーザ名>¥AppData¥Roaming¥SAS¥JMP¥ • macOS: "/Users/<ユーザ名>/Library/Application Support/JMP/ たとえば、Convert File Path( "$ADDIN_HOME(com.your.addin.id)は、結果がcom.your.addin.idアドインの場所になります。 アドインを共有ネットワークにインストールするには、Register Addin()関数を使用します。JSLを使ったアドインの登録を参照してください。 |
|
ALL_HOME マシン上のすべてのユーザがアクセスできるフォルダを定義します。 |
• Windows (JMP): "C:¥ProgramData¥SAS¥JMP¥17¥" • Windows (JMP Pro): "C:¥ProgramData¥SAS¥JMPPro¥17¥" • macOS: "/Library/Application Support/JMP/17/" ディレクトリが存在するかどうかを確認するには、 |
|
BUILTIN_SCRIPTS |
• Windows (JMP): "C:¥Program Files¥SAS¥JMP¥17¥Resources¥ • Windows (JMP Pro): "C:¥Program Files¥SAS¥JMPPRO¥17¥ • macOS: "/Applications/JMP 17.app/Contents/Resources/Builtins/" |
|
DESKTOP |
• Windows: "C:¥Users¥<ユーザ名>¥Desktop¥" • macOS "/Users/<ユーザ名>/Desktop/" |
|
DOCUMENTS |
• Windows: "C:¥Users¥<ユーザ名>¥Documents¥" • macOS: "/Users/<ユーザ名>/Documents/" |
|
DOWNLOADS |
• Windows: "C:¥Users¥<ユーザ名>¥Downloads¥" • macOS: "/Users/<ユーザ名>/Downloads/" |
|
GENOMICS_HOME |
"¥<JMP Genomicsのインストールディレクトリ>¥" |
|
HOME |
• Windows (JMP): "C:¥Users¥<ユーザ名>¥AppData¥Roaming¥SAS¥ • Windows (JMP Pro): "C:¥Users¥<ユーザ名>¥AppData¥Roaming¥ • macOS: "/Users/<ユーザ名>/" |
|
JMP_HOME |
• Windows: C:¥<JMPインストールディレクトリ> メモ: この変数はmacOSでは使用できません。 |
|
SAMPLE_APPS |
• Windows: C:¥<JMPインストールディレクトリ>¥Samples¥Apps¥" • macOS: "/Library/Application Support/JMP/17/Samples/Apps/" |
|
SAMPLE_DASHBOARDS |
• Windows: C:¥<JMPインストールディレクトリ>¥Samples¥ • macOS: "/Library/Application Support/JMP/17/Samples/ |
|
SAMPLE_DATA |
• Windows: "C:¥<JMPインストールディレクトリ>¥Samples¥Data¥" • macOS: "/Library/Application Support/JMP/17/Samples/Data/" |
|
SAMPLE_IMAGES |
• Windows: "C:¥<JMPインストールディレクトリ>¥Samples¥ • macOS "/Library/Application Support/JMP/17/Samples/Images/" |
|
SAMPLE_IMPORT_DATA |
• Windows: "C:¥<JMPインストールディレクトリ>¥Samples¥ • macOS: "/Library/Application Support/JMP/17/Samples/ |
|
SAMPLE_PROJECTS |
• Windows: "C:¥<JMPインストールディレクトリ>¥Samples¥ • macOS: "/Library/Application Support/JMP/17/Samples/Projects/" |
|
SAMPLE_SCRIPTS |
• Windows: "C:¥<JMPインストールディレクトリ>¥Samples¥ • macOS: "/Library/Application Support/JMP/17/Samples/Scripts/" |
|
TEMP |
• Windows: "C:¥Users¥<ユーザ名>¥AppData¥Local¥Temp¥" • macOS: "var/folders/..." |
|
USER_APPDATA JMP環境設定やメニュー、ホームウィンドウに加えた変更、およびデバッガセッションの設定がここに保存されます。 |
• Windows (JMP): "C:¥Users¥<ユーザ名>¥AppData¥Roaming¥SAS¥ • Windows (JMP Pro): "C:¥Users¥<ユーザ名>¥AppData¥Roaming¥ • macOS: "/Users/<ユーザ名>/Library/Application Support/JMP/17/" |
パス変数の定義は、使用しているJMPのバージョンに応じたものとなります。たとえば、JMP 14で作成されたスクリプトであっても、JMP 17で実行した場合は、JMP 17におけるパス変数の定義が使用されます。
パス変数の定義を確認するには、Get Path Variable関数を使用します。
Get Path Variable( "HOME" );
"/C:/Users/<ユーザ名>/AppData/Roaming/SAS/JMP/17/"
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¥SAS¥JMP¥17¥Samples¥Data¥Big Class.jmp
$SAMPLE_DATAの後にスラッシュがない場合、パスは次のように解釈されます。
C:¥Program Files¥SAS¥JMP¥17¥Samples¥DataBig Class.jmp