開発者向け機能：サーバスクリプト：$ps.file.import
## 概要
[サーバスクリプト](/ja/manual/table-management-server-script)で[$ps.file](/ja/manual/server-script-ps-file)を使用してインポートをする際に使用します。
## 前提条件
1. [Script.json](/ja/manual/script-json)のDisableServerScriptFileを false に設定することが必要です。
2. [テーブル](/ja/manual/table)の「インポート権限」が必要です。
## 構文
```
$ps.file.import(section, path, siteId, json);
```
## パラメータ
|パラメータ|型|必須|説明|
|:----------|:----------|:---:|:---------------------------|
|section|string|○|セクション名。セクションについては[$ps.file](/ja/manual/server-script-ps-file)の「セクションについて」を参照ください。|
|path|string|○|ファイル名。ディレクトリの区切り文字はWindow、Linux共に「/」を利用する。|
|siteId|string|○|サイトID|
|json|string|○|インポート用パラメータ|
## 戻り値
成功した場合に新規登録数と更新数を返します。失敗した場合はnullを返します。
## 例外
C#内で例外が発生した場合はサーバスクリプト内に例外クラス名とエラーメッセージをErrorオブジェクトに入れて例外を発生させます。
## 使用例
以下の例では、Webサーバ内のcsvファイルのインポートを行い、結果をログに出力します。
##### JavaScript
```
const siteId = 100;
const param = {
};
const result = $ps.file.import('01_develop', 'parts/01_parts.csv', siteId, $ps.JSON.stringify(param));
context.Log($ps.JSON.stringify(result));
```
##### 出力例
```
{insertCount:10,updateCount:0}
```
文字コード：Shift-JIS の例
```
const siteId = 100;
const param = {
Encoding: 'Shift-JIS'
};
const result = $ps.file.import('01_develop', 'parts/01_parts.csv', siteId, $ps.JSON.stringify(param));
context.Log($ps.JSON.stringify(result));
```
##### 出力例
```
{insertCount:10,updateCount:0}
```
キーが一致するレコードを更新 の例
```
const siteId = 100;
const param = {
UpdatableImport: true,
Key: 'ClassA'
};
const result = $ps.file.import('01_develop', 'parts/01_parts.csv', siteId, $ps.JSON.stringify(param));
context.Log($ps.JSON.stringify(result));
```
##### 出力例
```
{insertCount:10,updateCount:10}
```
## 対応バージョン
|対応バージョン|内容|
|:--|:--|
|1.4.13.0 以降|機能追加|
## 関連情報
<div id="ManualList"><ul><li><a href="/ja/manual/script-json">パラメータ設定：Script.json</a><span>2025/01/14 up</span></li></ul></article>
<ul><li><a href="/ja/manual/table">テーブル機能</a><span>2023/04/12 up</span></li></ul></article>
<ul><li><a href="/ja/manual/table-management-server-script">テーブルの管理：サーバスクリプト</a><span>2025/01/14 up</span></li></ul></article>
<ul><li><a href="/ja/manual/server-script">開発者向け機能：サーバスクリプト</a><span>2023/06/01 up</span></li>
<li><a href="/ja/manual/server-script-ps-file">開発者向け機能：サーバスクリプト：$ps.file</a><span>2025/01/23 up</span></li></ul></article>
<ul><li><a href="/ja/manual/faq-server-script-log">FAQ：サーバスクリプトのエラーログを出力したい</a><span>2024/04/29 up</span></li></ul></article></div><input id="SearchTextHidden" type="hidden" value="" />
