【HULFT Square】JSONファイルをノーコードで読み込む方法について解説

Posted at 2026-04-10

はじめに

本記事はHULFT SquareでJSONファイルが読み込めないとお困りの方へ向けた記事です。
HULFT SquareではCSVやExcelといったよく使われるファイル種別を読み込むコネクタがあり、またREST APIの戻り値としてJSON形式のデータを読み込むことが可能です。ただ、ファイルとして存在しているJSONファイルを直接読み取る機能はございません。そこで、本記事ではAPIマネジメント機能を使ってJSONファイル読み取り、扱いやすいCSVファイルに変換する仕組みを作成します。

接続の流れ

設定は下記の流れで設定します。JSONファイルを直接読み込むことはできないため、REST APIのリクエストとして、JSONファイルを渡し、渡された側でJSON形式のデータをCSVに変換します。

１．JSON形式のデータをCSVファイルに変換するスクリプトを作成
２．上記スクリプトをAPIジョブ化
３．作成したAPIジョブへJSONファイルをコール

１．JSON形式のデータをCSVファイルに変換するスクリプトを作成

１－１．JSONスキーマの登録

まずは読み込みたいJSONファイルの形式をスキーマに登録します。今回は下記形式で登録します。

{
  "seminars": [
    {
      "seminar_id": "SEM001",
      "title": "生成AI活用セミナー",
      "date": "2024-01-15",
      "participants": 75
    }
  ]
}

１－２．JSON-CSV変換スクリプトの作成

次に任意のスクリプトを作成し、スクリプト変数を作成します。

名前は「受領Jsonファイル」とし、「スクリプト入力変数として使用する」に☑を入れておきます。この入力変数にJSONファイルが入ってくるイメージです。

次にCSV書き込みのアイコンをスクリプトに配置し、下記のように設定してください。

「ファイルパス/名」は任意で設定いただき、「列一覧」には先ほど登録したJSON形式と同様の内容となるように設定します。例のJSONだと画像のように設定します。

下記のように「Start」から「CSV書き込み」までプロセスフローとデータフローを引き、マッピングを追加します。

マッピングアイコンを開きます。左上「受領Jsonファイル」を右クリックし、「リソースからスキーマを選択」、先ほど作成したスキーマを選択します。

あとは下図のように、JSONファイルの各要素を右側のCSVの各要素と紐づけます。また、JSON形式の繰り返し部分と、CSVの「row」を「単純な繰り返しロジック」で繋ぎます。

これで、変換スクリプトは完成です。