公開日: 11/25/2021

ファイル関数

Close(<dt|query>, <noSave|Save(path)>)

説明

データテーブル、クエリー、またはJSONファイルを閉じる。引数が指定されていない場合は、現在のファイルを閉じます。ファイルが変更されている場合は、自動的に保存します。従属するウィンドウ（データテーブルを元に作成されたレポートウィンドウなど）もすべて閉じられます。

戻り値

なし

引数

データテーブル、クエリー、またはJSONファイルへの参照。

nosave|Save(path)

（オプション）ファイルを閉じる前に指定の引用付きパスに保存するか、または保存しないで閉じるかを指定する。

説明

指定されたタイプ（type）のウィンドウをすべて閉じる。

必須の引数

type

閉じるウィンドウのタイプ名を示す名前付き引数。使用できるタイプは、Data Tables、Reports、Journalsです。

オプションの引数

Project(title|index|display box|window)

指定のプロジェクトウィンドウを閉じる。

"Invisible"

非表示（invisible）のデータテーブルをすべて閉じる。

"Private"

プライベート（private）に指定したデータテーブルをすべて閉じる。

NoSaveまたはSave

指定されたタイプのウィンドウを閉じる前に保存するか、保存せずに閉じる。

Close Database Connection(db connection handle)

説明

Create Database Connectionで戻されたデータベース接続を閉じる。

Close Log(Boolean)

説明

ログウィンドウを閉じる。

Convert File Path(path, <"Absolute"|"Relative">, <"POSIX"|"Windows">, <Base(path)>, <Search>)

説明

引数に従ってファイルパスを変換する。

戻り値

変換したパス

必須の引数

path

WindowsまたはPOSIXの引用符付きパス名。

オプションの引数

"Absolute"|"Relative"

戻り値のパス名を絶対パスにするか相対パスにするかを指定する。デフォルト値は絶対パス（Absolute）。

"POSIX"|"Windows"

戻り値のパス名をWindows形式にするかPOSIX形式にするかを指定する。デフォルト値はPOSIX。

Base(path)

基準となるパス名を指定する。相対パス（Relative）を指定している場合に便利。デフォルト値はデフォルトのディレクトリ。Set Default Directory(path)を参照してください。

指定のディレクトリの中で指定の文字列を検索する。次の例では、JMPは$SAMPLE_DATA/と$SAMPLE_DATA/Time Series/の中でAir.jmpを探します。Air.jmpが両方のディレクトリにある場合は、最初のインスタンスが戻されます。検索オプションがない場合、Convert File Path()は、代わりにデフォルトのディレクトリを使用します。

例

Set File Search Path(

	{Convert File Path( "$SAMPLE_DATA/" ),

	Convert File Path( "$SAMPLE_DATA/Time Series/" )}

);

Convert File Path( "Air.jmp", Search );

Get File Search Path() = {"/C:/Program Files/SAS/JMPPRO/16/Samples/Data/", "/C:/Program Files/SAS/JMPPRO/16/Samples/Data/Time Series/"};

Convert File Path("Air.jmp", search) =
"/C:/Program Files/SAS/JMPPRO/16/Samples/Data/Time Series/Air.jmp";

Copy Directory(from path, to path, <Recursive(Boolean)>)

説明

ファイルをあるディレクトリから別のディレクトリにコピーする。オプションで、サブディレクトリもコピーできます。引数to pathで指定された場所にディレクトリが作成されるので、コピーするディレクトリの名前を引数to pathに含めてはいけません。

戻り値

ディレクトリがコピーされた場合は1、そうでない場合は0

必須の引数

from path

新しいディレクトリにコピーするファイルが含まれているディレクトリを指定する。from pathは引用符付き文字列。

to path

ファイルのコピー先となる新しいディレクトリの作成場所のパスを指定する。to path は引用符付き文字列。

オプションの引数

Recursive(Boolean)>

コピー元ディレクトリ（from path）のサブディレクトリ構造をコピー先（to path）にコピーするかどうかを指定する。

メモ

Copy Directory(from path, to path, Boolean)を用いることは、推奨されません。

Copy File(from path, to path)

説明

ファイルを、元のファイルと同名または別名の新しいファイルにコピーする。

戻り値

ファイルがコピーされた場合は1、そうでない場合は0

引数

from path

新しいファイルにコピーするファイルのパスとファイル名を指定する。from path は引用符付き文字列。

to path

新しいファイルのパスとファイル名を指定する。from path は引用符付き文字列。

Create Database Connection(dataSourceName|"Connect Dialog",<DriverPrompt(Boolean)>);

説明

指定したデータベースへの接続を確立するか、ユーザにログイン情報を入力するよう促す。

戻り値

データベース接続のハンドラ

必須の引数

dataSourceName

データソース名やユーザ名などの情報を含む引用符付きのサーバー接続文字列。

オプションの引数

"Connect Dialog"

［データソースの選択］ウィンドウを開く。ユーザはこのウィンドウでデータベースを選択する。

Driver Prompt(Boolean)

必要に応じてODBCドライバが接続情報の入力を促せるようにする。

例

データソース名、ユーザ名、およびパスワードを指定する例:

Create Database Connection( "dsn=Books;UID=johnsmith;password=Christmas" );

引用符付きの接続の文字列にはパスワードを含めず、ユーザに接続情報の入力を促すウィンドウを表示するようODBCドライバに要求する例:

Create Database Connection( "dsn=Books;UID=johnsmith", Driver Prompt( 1 ) );

"Connect Dialog"を指定してユーザによるデータソースの選択を可能とする例:

Create Database Connection( "Connect Dialog" );

Create Directory(path)

説明

path引数に指定した場所に新しいディレクトリを作成する。

戻り値

ディレクトリが作成された場合は1、そうでない場合は0

引数

path

新しいディレクトリの作成場所の引用符付きパスを指定する。

Creation Date(path)

説明

指定したファイルまたはディレクトリの作成日を戻す。

戻り値

作成日

引数

path

作成日を調べる対象の引用符付きディレクトリのパスまたはファイル名。

Delete Directory(path, <Allow Undo(Boolean)>)

説明

指定したディレクトリとその内容、およびサブディレクトリを削除する。

戻り値

ディレクトリが削除された場合は1、そうでない場合は0

引数

path

削除するディレクトリのパスとディレクトリ名。

Allow Undo(Boolean)

ごみ箱に移動するなどの「元に戻す」操作を許可する。

Delete File(path, <Allow Undo(Boolean)>)

説明

指定したファイルを削除する。

戻り値

ファイルが削除された場合は1、そうでない場合は0

必須の引数

path

削除するファイルの引用符付きパスとファイル名を指定する。

オプションの引数

Allow Undo(Boolean)

ごみ箱に移動するなどの「元に戻す」操作を許可する。

Directory Exists(path)

説明

指定したディレクトリが存在するかどうかを調べる。

戻り値

ディレクトリが存在するときは1、そうでない場合は0

引数

path

調べるディレクトリの引用符付きパスとディレクトリ名。

File Exists(path)

説明

指定したファイル名が指定したパスに存在するかどうかを調べる。

戻り値

ファイルが存在するときは1、そうでない場合は0

引数

path

検証するファイルの引用符付きパスとファイル名を指定する。

File Size(path)

説明

指定されたパス内のファイルのサイズを特定する。

引数

path

引用符付きパスとファイル名を指定する。

例

File Size( "$SAMPLE_DATA/Big Class.jmp" );

13142

Files In Directory(path, <Recursive(Boolean)>)

説明

pathで指定されたディレクトリ内のファイル名を、リストにして戻す。

戻り値

ファイル名のリスト。Recursive(Boolean)を指定しなかった場合は、ディレクトリ名がリストに含まれます。

必須の引数

path

有効な引用符付きパス名。

オプションの引数

Recursive(Boolean)

このオプションを指定すると、パスにある全フォルダ、およびそれらのフォルダに含まれる全サブフォルダから、ファイルが検索される。

メモ

Files In Directory(path, "Recursive"|Boolean)は廃止されました。

Find All(<Project(title|index|display box|window)>, type, <"Invisible"|"Private">)

説明

現在開いている特定のタイプのリソースをすべて戻す。

必須の引数

type

閉じるウィンドウのタイプ名を示す名前付き引数。使用できるタイプは、Data Tables、Reports、Journalsです。

オプションの引数

Project(title|index|display box|window)

指定のプロジェクトウィンドウを閉じる。

"Invisible"

非表示（invisible）のデータテーブルをすべて閉じる。

"Private"

プライベート（private）に指定したデータテーブルをすべて閉じる。

例

次の例は、開いているすべてのデータテーブルを戻します。

exdt1 = Open( "$SAMPLE_DATA/Big Class.jmp" );

exdt2 = Open( "$SAMPLE_DATA/Animals.jmp" );

windows = Find All( Data Tables );

For( i = 1, i <= N Items( windows ), i++,

	Write( Char( windows[i] << Get Window Title ) || "\!N" )

);

Big Class

Animals

Get Default Directory()

説明

ユーザのデフォルトのディレクトリを取得する。このパスが相対パスに使用されます。

Set Default Directory()関数を使ってデフォルトのディレクトリが設定されている場合、Get Default Directory()がそのSet Default Directory()関数と同じスクリプト内にある限り、その指定されたパスを戻します。

Set Default Directory(path)を参照してください。

戻り値

引用符付き文字列で示した絶対パス名

引数

なし

メモ

Get Default Directory()も、保存されたアクティブなスクリプトウィンドウのパスを取得します。

Get Excel Worksheets(absolute path)

説明

指定されたMicrosoft Excelワークブックに含まれるワークシートのリストを取得する。ワークシートがない場合は、空のリストを戻します。パスは引用符付き文字列。

メモ

この関数は、.xlsxおよびExcel 1997以降のワークブックに対応しています。

Get File Search Path()

説明

現在、ファイルを開く時に検索されるディレクトリの一覧をリストで戻す。

このリストは、Set File Search Path()関数を使って設定されます。Set File Search Path(path|{list of paths})を参照してください。

戻り値

引用符付き文字列で示したパス名のリスト

Get Path Variable(name)

説明

nameに指定されたパス変数の値を取得する。

戻り値

引用符付き文字列で示した絶対パス名

引数

name

パス変数を示す引用符付き文字列。（例: SAMPLE_DATAおよびSAMPLE_SCRIPTS）

Google Sheet Export(dt, email, spreadsheet URL|spreadsheet ID|new spreadsheet name, sheet name)

説明

データテーブルをGoogleスプレッドシートに書き出す。

戻り値

書き出しが正常に完了した場合は「1」を戻す。

引数

データテーブル。

引用符で囲んだGmailアドレス。@gmail.comは不要です。

spreadsheet URL|ID

引用符で囲んだスプレッドシートのURLまたはID（先頭に「spreadsheets/d/」が付く文字列）。

new spreadsheet name

新しく作成するスプレッドシートの引用符付きの名前。

sheet name

スプレッドシート内にあるシート（タブ）の引用符付きの名前。

メモ

– 計算式や「リストチェック」列プロパティなどのJMP特有の機能は、Googleスプレッドシートではサポートされません。

– 書き出したスプレッドシートが空白になってしまった場合は、JMPログにエラーメッセージがないかを確認してください。Windowsの場合は、［表示］>［ログ］を選択します。macOSの場合は、［ウィンドウ］>［ログ］を選択します。

次も参照

セキュリティ、各国の制限事項などについては、『JMPの使用法』のGoogleスプレッドシートの書き出しについてを参照してください。

Google Sheet Import(email, spreadsheet URL|spreadsheet ID, <sheet name|{sheet name, sheet name}, Google Sheet Settings>)

説明

Googleスプレッドシートからデータを読み込む。

戻り値

データテーブル（一度に複数のスプレッドシートを読み込む場合は最初に読み込まれたデータテーブル）

必須の引数

引用符で囲んだGmailアドレス。@gmail.comは不要です。

spreadsheet URL|ID

引用符で囲んだスプレッドシートのURLまたはID（先頭に「spreadsheets/d/」が付きます）。

オプションの引数

sheet name

読み込むスプレッドシートの引用符付きの名前。

Google Sheet Settings

データの読み込み方法の設定。

次も参照

セキュリティ、各国の制限事項などについては、『JMPの使用法』のGoogleスプレッドシートの書き出しについてを参照してください。

Is Directory(path)

説明

引用符付きpath引数がディレクトリのときは1、そうでなければ0を戻す。

Is Directory Writable(path)

説明

引用符付きpath引数に指定されたディレクトリが書き込み可能な場合は1、そうでなければ0を戻す。

Is File(path)

説明

引用符付きpath引数がファイルのときは1、そうでなければ0を戻す。

Is File Writable(path)

説明

引用符付きpath引数に指定されたファイルが書き込み可能な場合は1、そうでなければ0を戻す。

説明

引用符付きのJSON文字列をデータテーブルに変換する。

戻り値

データテーブルへの参照。空白の値や、""という文字列、欠測値、その他の無効な値を解析すると、空のデータテーブルが戻されます。

必須の引数

JSON string

引用符付きのJSON文字列。

オプションの引数

Private(Boolean)

データテーブルを完全に非表示にする。データテーブルでインタラクティブな操作を行う必要がない場合は、この引数を指定します。

Invisible(Boolean)

データテーブルを非表示にする。ただし、JMPホームウィンドウには表示されます。

Guess(Stack(Boolean)|"Tall"|"Wide"|"Huge"|"Pandas")

積み重ね（stack）は、行を作成する親ノード内で反復されるノードに適用されます。デフォルトでは、1つのテーブルセルに値がカンマで区切って保存されます。1を指定した場合は、繰り返す値は別の行となり積み重ねられます。データの積み重ねは、慎重に行ってください。見た目で判別しにくいデータエラーにつながる可能性があります。

"Tall"は、データを縦長のデータテーブルに読み込みます。JSONファイルの行数が多い場合は、このオプションを選択してください。これはデフォルトの設定です。

"Wide"は、データを横長のデータテーブルに読み込みます。JSONファイルの列数が多い場合は、このオプションを選択してください。

"Huge"は、データを縦長かつ横長のデータテーブルに読み込みます。

"Pandas"は、データをPandas形式で読み込みます。

例

dt = Open( "$SAMPLE_DATA/Big Class.jmp" );

dt = JSON to Data Table(

	"[ { \!"name\!": \!"KATIE\!", \!"age\!": 12, \!"sex\!": \!"F\!", \!"height\!": 59, \!"weight\!": 95 }, { \!"name\!": \!"LOUISE\!", \!"age\!": 12, \!"sex\!": \!"F\!", \!"height\!": 61, \!"weight\!": 123 }, { \!"name\!": \!"JANE\!", \!"age\!": 12, \!"sex\!": \!"F\!", \!"height\!": 55, \!"weight\!": 74 } ]"

);

メモ

データを積み重ねると、見た目では判別しにくいデータエラーにつながる可能性があります。同じ行にあるはずの値が別の行にある、などです。以下に、データの積み重ねの例を示します。

d =

"\[

       "おもちゃ": [{

              "車輪": 2,

              "色": "赤"

},

              "車輪": 4,

              "サイズ": "大"

}]

]\";

JSON to Data Table( d, Guess( Stack( 1 ) ) );

図2.1 積み重ねたデータのエラー例

Example of Stacking Data that Shows Errors

最初のおもちゃは、赤で2つの車輪が付いているはずです。2つ目のおもちゃは、サイズが大で、車輪が4つのはずです。

JSON To List(JSON string)

説明

引用符で囲んだJSON形式の文字列を、JSLのリストに変換する。戻されたリストの構造は、JSONテキストの構造を反映したものとなります。空白の値や、""という文字列、欠測値、その他の無効な値を解析すると、{}（空のリスト）が戻されます。

例

l = JSON To List(

	"[ { \!"name\!": \!"KATIE\!", \!"age\!": 12, \!"sex\!": \!"F\!", \!"height\!": 59, \!"weight\!": 95 }, { \!"name\!": \!"LOUISE\!", \!"age\!": 12, \!"sex\!": \!"F\!", \!"height\!": 61, \!"weight\!": 123 }, { \!"name\!": \!"JANE\!", \!"age\!": 12, \!"sex\!": \!"F\!", \!"height\!": 55, \!"weight\!": 74 } ]"

);

Show( l );

JSON Literal(JSON string)

説明

指定したパラメータによって、有効なJSONブールまたはNULLである定数の値を戻す。空白の値や、""という文字列、欠測値、その他の無効な値を解析すると、Empty()が戻されます。

Last Modification Date(path)

説明

パスの最終更新日を戻す。

戻り値

最終更新日

引数

path

引用符付きのディレクトリ名またはファイル名。

説明

指定されたパス（path）にあるテキストファイルを、JSL変数に読み込む。

戻り値

引用符付き文字列

必須の引数

path

テキストファイルを指す引用符付きのパス名。URLでも可。

オプションの引数

Charset("charater set")

文字セットを指定する。有効な文字セットには、"Best Guess"、"utf-8"、"utf-16"、"us-ascii"、"windows-1252"、"x-max-roman"、"x-mac-japanese"、"shift-jis"、"euc-jp"、"utf-16be"、"gb2312"があります。

Force("Throw"|"Alert"|"Silent")

文字セットが検出できない場合の処理を指定します。

Line Separator(character)

引用符で囲んだ行の区切り文字を指定します。たとえば、"\!n"（ラインフィード文字）や、"\!t"（タブ）を指定します。

"XMLParse"

XMLファイルをJSLに変換する。

"SASODSXML"

SASのODSにおけるデフォルトのXML形式として、テキストファイルを解釈する。

"JSON"

JSONをツリー構造に変換する。

BLOB(<arguments>)

ファイル内のデータを、引用符付き文字列ではなくBLOBとして戻す。ファイルの一部を読み込むには、以下の引数を使用できます。

– ReadOffsetFromBegin(n) ファイルの読み込み開始位置を、ファイル先頭からのオフセット値（ゼロベース）で指定する。

– ReadOffsetFromEnd(n) ファイルの読み込み開始位置を、ファイル末尾からのオフセット値（ゼロベース）で指定する。

– ReadLength(n) ファイルから読み込むバイト数を指定する（ファイルの先頭またはオフセット値から開始）。

– Base64Compressed(Boolean) BLOBを印字可能な形式に変換する方法を指定する。0を指定すると、JMPのASCII~HEX表記を使用します（デフォルトかつ推奨）。1を指定すると、BLOBをbase64形式で圧縮・変換して印字します。

Move Directory(from path, to path)

説明

ディレクトリとその内容（サブディレクトリも含む）を引用符付きパスから、別の引用符付きパスに移動する。

戻り値

ディレクトリが移動した場合は1、そうでない場合は0

引数

from path

移動元ディレクトリのパスとディレクトリ名。

to path

移動先ディレクトリのパスとディレクトリ名。

Move File(from path, to path)

説明

ファイルを引用符付きパスから、別の引用符付きパスに移動する。ファイル名は同一のままでも変更することもできます。

戻り値

ファイルが移動した場合は1、そうでない場合は0

引数

from path

移動するファイルの引用符付きパスとファイル名を指定する。

to path

移動先の引用符付きパスとファイル名を指定する。

メモ

Windowsでは、ファイルを存在しないフォルダに移動しようとすると、フォルダが作成され、1が戻されます。macOSでは、フォルダは作成されず、エラーが戻されます。

Open(path, <arguments>)

説明

path引数で指定されたファイルから作成されたデータテーブルやその他のJMPファイル、またはオブジェクトを開く。path引数が未指定の場合は、「開く」ウィンドウが表示されます。JSONまたはHDF5ファイルも開けます。具体的なファイルタイプに適用される引数の詳細については、JMPの［ヘルプ］メニューにある「スクリプトの索引」で例を参照してください。

必須の引数

path

開くファイルの引用符付きのパス。

オプションの引数

Add to Recent Files(Boolean)

ホームウィンドウの「最近使ったファイル」リストにファイルを追加するかどうかを指定する。

Charset(character set)

テキストファイルの読み込みに使用できる文字セットのオプションは、"Best Guess"、"utf-8"、"utf-16"、"us-ascii"、"windows-1252"、"x-max-roman"、"x-mac-japanese"、"shift-jis"、"euc-jp"、"utf-16be"、および"gb2312"。

Column Names Start(n)|Column Names are on Line(n)

読み込み対象のテキストファイル内で、列名が入力されている最初の行の番号を指定する。テキストファイルでセル間に改行が使われている場合、列名が複数行に分かれていることがあります。

Columns(colName=colType(colWidth),...)

テキストファイル内の列のうち、データテーブルに読み込む対象の列を名前で指定する。

– colName: 読み込まれたデータの列の名前を指定する。

– colType("Character"|"Numeric"): 指定した列を文字タイプとするか、数値タイプとするかを指定する。

– colWidth(n): 指定した列の幅を整数で指定する。

Columns(<arguments>)

ESRIシェープファイル（.shp）の場合、この引数とその設定は以下のようになります。

– Shape=numeric(n): 読み込み対象のESRIシェープファイル内で、シェープ番号が記載されている列の番号を指定する。

– Part=numeric(n): 読み込み対象のESRIシェープファイル内で、パーツ番号が記載されている列の番号を指定する。

– X=numeric(n): 読み込み対象のESRIシェープファイル内で、10進数表記の経度（±180°の範囲）が記載されている列の番号を指定する。

– Y=numeric(n): 読み込み対象のESRIシェープファイル内で、10進数表記の緯度（±90°の範囲）が記載されている列の番号を指定する。

"Column Names Only"

列名のリストを戻す。

Compress Allow List Check(Boolean)

読み込んだテキストファイルから作成したデータテーブルをJMPで圧縮するかどうかを指定する。

Compress Character Columns(Boolean)

テキストファイルから読み込んだ文字タイプの列をJMPで圧縮するかどうかを指定する。

Compress Numeric Columns(Boolean)

テキストファイルから読み込んだ数値タイプの列を圧縮するかどうかを指定する。

Concatenate Worksheets(Boolean)

読み込み対象の複数のExcelワークシートを1つのデータテーブルに連結するかどうかを指定する。

Create Concatenation Column(Boolean)

読み込み対象のExcelファイルの列を1列にまとめるかどうかを指定する。

Data Starts(n)|Data Starts on Line(n)

読み込み対象のテキストファイル内で、データが始まっている行の番号を指定する。

Debug JSL(Boolean)

指定されたJSLスクリプトを開かずに、デバッガ内に開く。

読み込み対象のテキストファイルでフィールドの区切り文字として使用されている引用符付き文字を指定する。複数の文字を指定するには、各文字をカンマで区切ってください。"Other"を指定した場合は、EOF Other()引数で区切り文字を指定してください。

End Of Line("CRLF"|"CR"|"LF"|"Semicolon"|"Other")

読み込み対象のテキストファイルで行の区切り文字として使用されている引用符付き文字を指定する。複数の文字を指定するには、各文字をカンマで区切ってください。"Other"を指定した場合は、EOL Other()引数で区切り文字を指定してください。

EOF Other(char)

読み込み対象のテキストファイルで、End of Field()で指定できる文字とは異なるフィールド区切り文字が使用されている場合は、使用する文字をこの引数で指定する。

EOL Other(char)

読み込み対象のテキストファイルで、End of Line()で指定できる文字とは異なる行の区切り文字が使用されている場合は、使用する文字をこの引数で指定する。

"Excel Wizard"

Microsoft Excelワークシートを、Excel読み込みウィザードで開く。この引数を指定しないと、ワークシートはそのままデータテーブルとして開かれます。

File Type(type)

（オプション）開くファイルの種類を指定する引用符付き文字列（たとえば、"text"、"journal"、"sas"、"script"、"png"、"jmp"）。ファイルに拡張子がない場合や、ファイルの拡張子とファイルの内容が一致しない場合、JSL BLOBを読み込む場合などに便利です。この文字列を指定しない場合は、ファイル拡張子のデフォルトのプログラムでファイルが開きます。

メモ: zipアーカイブの場合は、path引数を指定します。拡張子（.zip）は必要ありません。zipアーカイブに送るメッセージについては、Zipアーカイブを参照してください。基本的な機能は、zipアーカイブ内のファイルのリストを取得すること、zipアーカイブ内のファイルを引用符付き文字列またはBLOBに読み込むこと、ファイルをzipアーカイブに書き込むことです。zipアーカイブを読み取ると、内容が一時的にメモリに格納されます。非常に大きなzipアーカイブを読み取ると、エラーが発生する場合があります。

"Force Refresh"

指定されたJMPファイル（.jrn、.jsl、.jrp、または .jmpappsource）を保存せずに閉じ、ディスクから再び開きます。ファイルを最後に開いてから変更していた場合、その変更内容は削除されます。

HTML Table(n, <ColumnNames(n)>, <DataStarts(n)>)

ファイルパスに指定されたURLのHTML Webページから、表（テーブル）を読み込む。オプションの引数nで、Webページ上の開きたい表の番号nを指定します。値を省略した場合、ページ上の最初の表だけが読み込まれます。オプションの引数ColumnNames(n)で、列名となる行を指定できます。オプションの引数DataStarts(n)では、データが始まる行を指定できます。

ヒント: 読み込もうとしているテーブルにイメージが含まれている場合、それらは最初テキストとして読み込まれます。JMPデータテーブルにイメージをロードするには、自動的に生成されるLoad Picturesというテーブルスクリプトを実行します。すると、イメージを含む新しい式の列が作成されます。式列の詳細については、『JMPの使用法』の式の役割を参照してください。

Ignore Columns(col1, ...)

JMPデータテーブルまたはその他のJMPファイル内の列のうち、データテーブルには含めない列の引用符付きの名前を指定する。

"Invisible"

ファイルを非表示で開く。この引用符付き引数は、データテーブル、JMPファイル、外部ファイル、テキストファイル、Excelファイル、SASファイル、ESRIシェープファイル、およびHTMLファイルにのみ適用されます。データテーブルは、「JMPホームウィンドウ」と［ウィンドウ］メニューにのみ表示されます。

Labels(Boolean)

読み込み対象のテキストファイルの最初の行にラベルや列見出しが含まれているかどうかを指定する。デフォルト値は1（真）。

Lines to Read(n)

テキストファイル内の読み込み対象とする行の数を指定する。JMPでは、列名が読み取られた行の次の行から行数のカウントを開始します。

Number of Columns(n)

読み込み対象のテキストファイルに含まれている列の数を指定する。

Run JSL(Boolean)

指定されたJSLファイルを、開かずに実行する。ブール値またはブール値を含む式を引数として指定します。スクリプトが、スクリプトを自動的に実行する//!で始まっている場合、そのスクリプトを開くにはブール値（0）を指定します。

Password(password)

パスワードで保護されたSASファイルの引用符付きパスワードを指定する。ここで指定しておくと、手動で入力する必要がなくなります。パスワードは暗号化されません。（パスワードで保護されたMicrosoft Excelファイルは読み込むことができません。）

"PDF Wizard"

PDFファイルをPDF読み込みウィザードで開く。このウィザードで、データの読み込み方法を指定できます。

"Private"

データテーブルを非表示で開き、JMPホームウィンドウにも［ウィンドウ］メニューにもテーブル名を表示しない。ユーザが見る必要のない一時的なデータテーブルを作成したいときに使用してください。この引用符付き引数はデータテーブル、JMPファイル、外部ファイル、テキストファイル、Excelファイル、SASファイル、ESRIシェープファイル、またはHTMLファイルにのみ適用されます。プライベートのデータテーブルを作成すると、データへのアクセスが高速化しますが、データテーブルのデータを保持するために必要なメモリが少なくなるわけではありません。

Quarantine Action("Allow Scripts"|"Block Scripts"|"Do Not Open"|"Show Dialog")

ダウンロードしたデータテーブルを開いたときにスクリプトが実行されるかどうかを指定する。オプションにより、ユーザーに対し、データテーブルを確認するか、そのまま開くかを指定してもらうウィンドウを表示することもできます。ユーザーが［確認する］をクリックした場合、スクリプトは実行されません。『スクリプトガイド』のスクリプトを含むデータテーブルをダウンロードした場合のオプションを参照してください。

Scan Whole File(Boolean)

列のデータタイプを判断するためにどれくらいJMPがテキストファイルをスキャンするかを指定する。値はブール値。デフォルトの値は真で、データの種類が特定できるまでファイル全体をスキャンします。大きいファイルを読み込むときは、値を偽に設定すると、ファイルが5秒間だけスキャンされます。

Select Columns(col1, ...)

JMPデータテーブルまたはその他のJMPファイル内の列のうち、データテーブルに含める列の引用符付きの名前を指定する。

"Strip Quotes"|Strip Enclosing Quotes(Boolean)

テキストファイル内のフィールドが引用符で囲まれているとき、この引数が真の場合は引用符を削除し、偽の場合は引用符を削除しない。デフォルト値は1（真）。

Table Contains Column Headers(Boolean)

読み込み対象のテキストファイルの最初の行にラベルや列見出しが含まれているかどうかを指定する。デフォルト値は1（真）。

"Text Wizard"

テキストファイルを、テキスト読み込みプレビューで開く。このウィンドウで、読み込みオプションを選択できます。このオプションを指定しない場合は、JMPの環境設定の［テキストデータファイル］の設定に従って、データテーブルとして自動的に読み込まれます。

Treat Empty Columns as Numeric(Boolean)

テキストファイル内の欠測値データの列を文字タイプではなく数値タイプとするかどうかを指定する。ピリオド、Unicodeのドット、NaN、引用符付き空白文字列は欠測値と判断されます。デフォルト値は0（偽）。

Use Apostrophe as Quotation Mark(Boolean)

テキストファイルの読み込み時にアポストロフィを引用符として使用することを宣言する。テキストデータが標準的な形式ではなく、フィールドが引用符ではなくアポストロフィで囲まれている場合以外、このオプションは推奨されません。デフォルト値は0（偽）。

Use Labels for Var Names(Boolean)

SASデータセットの場合、SASラベルをJMPの列名として使用するかどうかを指定する。デフォルト値は0（偽）。

Use for All Sheets(Boolean)

Worksheetsの設定を、データテーブルとして開くExcelファイルのすべてのワークシートで使用するかどうかを指定する。

Worksheet Settings(Boolean, <options>)

ExcelファイルのJMPデータテーブルへの読み込みオプションを指定する。次のいずれかのオプションを指定できます。

– Has Column Headers(Boolean): Excelファイルの第1行目が列見出しであることを指定する。

– Number of Rows in Headers(n): Excelファイル内で列見出しとして使用されている行の数を指定する。

– Headers Start on Row(n): Excelファイル内で列見出しが入力されている最初の行の番号を指定する。デフォルト値は1です。

– Data Starts on Row(n): Excelファイル内でデータが入力されている最初の行の番号を指定する。

– Data Starts on Column(n): Excelファイル内でデータが入力されている最初の列の番号を指定する。

– Data Ends on Row(n): Excelファイル内でデータが入力されている最後の行の番号を指定する。

– Data Ends on Column(n): Excelファイル内でデータが入力されている最後の列の番号を指定する。

– Replicated Spanned Rows(Boolean): Excelファイル内にあるセルが結合された行のデータを複製して読み込むかどうかを指定する。

– Suppress Hidden Rows(Boolean): Excelファイルで非表示になっている行をJMPに読み込まないかどうかを指定する。

– Suppress Hidden Columns(Boolean): Excelファイルで非表示になっている列をJMPに読み込まないかどうかを指定する。

– Treat as Hierarchy(Boolean): JMPにExcelファイルを読み込むときに、複数の列見出しを階層として扱うかどうかを指定する。真の場合、Excelファイルは、複数の見出し行が名が階層構造になった状態で読み込まれます。

Worksheets("Sheet Name"|{"Sheet Name", "Sheet Name",...}|n)

名前が指定されたワークシート、名前リスト内のすべてのワークシート、またはインデックス番号が指定されたワークシートを開く。ワークシートが未指定の場合は、スプレッドシート内のすべてのワークシートが個別のデータテーブルとして開きます。

メモ: Worksheets引数を指定することで、Webサイトから.xlsワークシートを読み込むことができます。Open()を使ってWebサイトから.xlsxワークシートを読み込むことはできません。

"XML Wizard"

XMLファイルをXML読み込みウィザードで開く。この引数を指定しないと、XMLファイルはデータテーブルとして開かれます。

Year Rule | Two Digit Year Rule ("1900-1999"|"1910-2009"|"1920-2019"|"1930-2029"|"1940-2039"| "1950-2049"|"1960-2059"|"1970-2069"|"1980-2079"|"1990-2089"|"2000-2099")

読み込み対象のテキストファイルで使用されている2桁の年の範囲を指定する。たとえば、一番古い日付が1979年の場合は、"1970-2069"と指定します。

Open Database(dataSourceName|"Connect Dialog", "SELECT ..."|"SQLFILE..."|tableName, <"Invisible"|"Private">, <outputTableName>)

説明

SELECT、SQLFILE、tableNameなどの引数を伴うdataSourceNameで指定されたデータベースを開く。

戻り値

outputTableNameで指定した名前のデータテーブル

必須の引数

dataSourceName|"Connect Dialog"

dataSourceNameは、データソースの名前を指定する。"Connect Dialog"は、データソースを選択するためのウィンドウを開きます。

オプションの引数

"Invisible"

非表示のデータテーブルを作成する。データテーブルは非表示になりますが、「JMPホームウィンドウ」や［ウィンドウ］メニューにはリストされます。

"Private"

データテーブルを完全に非表示にする。プライベートのデータテーブルを作成すると、データへのアクセスが高速化しますが、データテーブルデータを保持するために必要なメモリが少なくなるわけではありません。

outputTableName

読み込まれたJMPデータテーブルの名前。

例

Open Database(

	"DSN=dBASE Files;DBQ=C:/Program Files/SAS/JMPPRO/16/Samples/Import Data/;",

	// SQLステートメント

	"SELECT HEIGHT, WEIGHT FROM Bigclass", // 列の選択

	"hw" // 出力データテーブルの名前

);

Parse JSON(JSON string)

説明

JSON文字列を、その構造に従って連想配列またはリストに変換する。解析されたJSONオブジェクトに2つ以上のメンバーがある場合は、結果をリストに変換します。空白の値や、""という引用符付き文字列、欠測値、その他の無効な値を解析すると、Empty()が戻されます。

例

次の例は、JSONをリストに変換します。

j = Parse JSON(

	"[ { \!"name\!": \!"KATIE\!", \!"age\!": 12, \!"sex\!": \!"F\!", \!"height\!": 59, \!"weight\!": 95 }, { \!"name\!": \!"LOUISE\!", \!"age\!": 12, \!"sex\!": \!"F\!", \!"height\!": 61, \!"weight\!": 123 }, { \!"name\!": \!"JANE\!", \!"age\!": 12, \!"sex\!": \!"F\!", \!"height\!": 55, \!"weight\!": 74 } ]"

);

Show( j );

j = {["age" => 12, "height" => 59, "name" => "KATIE", "sex" => "F", "weight" => 95], ["age" => 12, "height" => 61, "name" => "LOUISE", "sex" => "F", "weight" => 123], ["age" => 12, "height" => 55, "name" => "JANE", "sex" => "F", "weight" => 74]};

Pick Directory(<"Prompt">, <path>, <Show Files(Boolean)>)

説明

ユーザにディレクトリの選択を促し、ディレクトリパスを引用符付き文字列で戻す。

戻り値

ユーザが選択したディレクトリのパス

オプションの引数

"Prompt"

引用符付き文字列は「参照」ウィンドウのタイトル部分（Windows）またはFinderウィンドウ（macOS）に表示されます。

path

ディレクトリの選択ウィンドウで最初に開く場所を、引用符付き文字列で指定する。

Show Files(Boolean)

1はディレクトリの選択ウィンドウにファイルを表示し、0はファイルを非表示にする。デフォルト値は0。

Pick File(<"Prompt">, <initial directory>, <{filter list}>, <first filter>, <Save Flag(Boolean)>, <default file>), <"Multiple">)

説明

「開く」ウィンドウを表示し、ユーザにファイルの選択を促す。

戻り値

ユーザが選択したファイルのパス

オプションの引数

"Prompt"

引用符付き文字。指定した文字列は、Windows上の「開く」ウィンドウの最上部に表示されます。

initial directory

フォルダへの有効なファイルパスである引用符付き文字列。指定したパスは、ファイルを開くウィンドウの開始ディレクトリとして使用されます。これを指定しない場合、または空の文字列を指定した場合は、JMPのデフォルトのディレクトリが使用されます。

filter list

ファイルを開くウィンドウに表示するファイルの種類のリストである引用符付き文字列。構文については、次の例を参照してください。

first filter

フィルタリスト内のどのフィルタを最初に使用するかを示す整数。大きすぎる整数（項目数が3のリストに対して4など）または小さすぎる整数を指定した場合、リスト内の最初のフィルタが使用されます。

Save Flag(Boolean)

「開く」ウィンドウと「名前を付けて保存」ウィンドウのどちらを使用するかを指定するブール値。0を指定した場合、ユーザはJMPで開くファイルを選択できます。1を指定した場合、ユーザは、選択した種類の新しい空のファイルを、選択したフォルダに保存できます。デフォルト値は0です。

default file

デフォルトでウィンドウに表示されるファイルの引用符付きの名前。

"Multiple"

Save Flagが0の場合に、ユーザが複数のファイルを選択できるようにする引用符付きの名前。

メモ

すべての引数はオプションですが、位置に依存します。たとえば、caption（キャプション）と、initial directory（最初のディレクトリ）の両方を指定しないと、filter list（フィルタリスト）を指定することはできません。

コンピュータの物理メモリ内のバッファサイズは、ユーザが開くことのできるファイルの数に影響します。

例

次のスクリプトは、ウィンドウのタイトルを「JMPファイルの選択」としたファイルを開くウィンドウにおいて、JMPの「Samples/Data」ディレクトリを開き、ファイルの種類のリストに「JMPファイル」と「すべてのファイル」を含め、そのうち「JMPファイル」が選択された状態とし、ファイル名のフィールドに「Hollywood Movies.jmp」を表示します。

Pick File(

	"JMPファイルの選択",

	"$SAMPLE_DATA",

	{"JMP Files|jmp;jsl;jrn", "All Files|*"},

1,

0,

	"Hollywood Movies.jmp"

);

Rename Directory(old path name, new directory name)

説明

ディレクトリを移動またはコピーせずに名前を変更する。

戻り値

ディレクトリの名前を変更した場合は1、そうでない場合は0

引数

old path name

変更前のディレクトリのパスと名前を指定する引用符付き文字列。

new directory name

新しいディレクトリ名を指定する引用符付き文字列。

メモ

新しいディレクトリ名を指定するときは、フルパスではなくディレクトリ名だけを含めます。

Rename File(old path name, new file name)

説明

ファイルを移動またはコピーせずに名前を変更する。

戻り値

ファイル名を変更した場合は1、そうでない場合は0

引数

old path name

変更前のファイルのパスと名前を指定する。

new file name

新しいファイル名を指定する。

メモ

新しい名前を指定するときは、フルパスではなくファイル名だけを含めます。

Save Text File(path, text|BLOB, <Mode("Replace"|"Append")>)

説明

作成されたファイルのパス名を戻す。textは引用符付き文字列。

Set Default Directory(path)

説明

デフォルトのディレクトリを設定する。以降、このディレクトリが相対パスの基準となります。

次も参照

Get Default Directory()

Set File Search Path(path|{list of paths})

説明

ファイルを開く時に検索されるディレクトリを設定する。パスとして{"."}を設定すると、カレントディレクトリが使用されます。

例

Set File Search Path( {"C:¥JMP¥13¥source", "C:¥Program Files¥SAS¥JMPPRO¥16¥Samples"} );

次も参照

Get File Search Path()

Set Path Variable(name, <path>)

説明

パス変数に、パスを格納する。

必須の引数

Name

変数の引用符付きの名前。

オプションの引数

path

パス。

TripleS Import(path, <arguments>)

説明

指定されたTriple-S（SSS）形式のファイル（調査ファイル）を読み込む。SSS形式は、.xmlまたは.sssのいずれかと、.csv、.dat、または.ascのいずれかのファイルのペアで構成されます。ペアのファイルは拡張子以外同じ名前で、同じフォルダになければなりません。

必須の引数

path

xmlまたはsssファイルのフルパスを指定する引用符付き文字列。

オプションの引数

"Invisible"

テーブルを非表示にする引用符付きキーワード。データテーブルは、「JMPホームウィンドウ」と［ウィンドウ］メニューにのみ表示されます。なお、非表示のデータテーブルは、明示的に閉じるまでメモリ内にとどまるため、不要になったものは閉じるよう注意してください。非表示のテーブルを明示的に閉じるには、Close(dt)を実行します。ここで、dt はTripleS Import関数から戻されたデータテーブル参照の変数です。

Use Labels for Imported Column Names(Boolean)

ラベル名を列見出しとして使用します。デフォルト値は1です。

例

dt = TripleS Import( "C:/Data/airlines.sss", "Invisible", Use Labels for Imported Column Names( 0 ) );

より詳細な情報が必要な場合や、質問があるときは、JMPユーザーコミュニティで答えを見つけましょう (community.jmp.com).